RELEASES.md

   1 Version 1.53.0 (2021-06-17)
   2 ============================
   3
   4 Language
   5 -----------------------
   6 - [You can now use unicode for identifiers.][83799] This allows multilingual
   7   identifiers but still doesn't allow glyphs that are not considered characters
   8   such as `◆` or `🦀`. More specifically you can now use any identifier that
   9   matches the UAX #31 "Unicode Identifier and Pattern Syntax" standard. This
  10   is the same standard as languages like Python, however Rust uses NFC
  11   normalization which may be different from other languages.
  12 - [You can now specify "or patterns" inside pattern matches.][79278]
  13   Previously you could only use `|` (OR) on complete patterns. E.g.
  14   ```rust
  15   let x = Some(2u8);
  16   // Before
  17   matches!(x, Some(1) | Some(2));
  18   // Now
  19   matches!(x, Some(1 | 2));
  20   ```
  21 - [Added the `:pat_param` `macro_rules!` matcher.][83386] This matcher
  22   has the same semantics as the `:pat` matcher. This is to allow `:pat`
  23   to change semantics to being a pattern fragment in a future edition.
  24
  25 Compiler
  26 -----------------------
  27 - [Updated the minimum external LLVM version to LLVM 10.][83387]
  28 - [Added Tier 3\* support for the `wasm64-unknown-unknown` target.][80525]
  29 - [Improved debuginfo for closures and async functions on Windows MSVC.][83941]
  30
  31 \* Refer to Rust's [platform support page][platform-support-doc] for more
  32 information on Rust's tiered platform support.
  33
  34 Libraries
  35 -----------------------
  36 - [Abort messages will now forward to `android_set_abort_message` on
  37   Android platforms when available.][81469]
  38 - [`slice::IterMut<'_, T>` now implements `AsRef<[T]>`][82771]
  39 - [Arrays of any length now implement `IntoIterator`.][84147]
  40   Currently calling `.into_iter()` as a method on an array will
  41   return `impl Iterator<Item=&T>`, but this may change in a
  42   future edition to change `Item` to `T`. Calling `IntoIterator::into_iter`
  43   directly on arrays will provide `impl Iterator<Item=T>` as expected.
  44 - [`leading_zeros`, and `trailing_zeros` are now available on all
  45   `NonZero` integer types.][84082]
  46 - [`{f32, f64}::from_str` now parse and print special values
  47   (`NaN`, `-0`) according to IEEE RFC 754.][78618]
  48 - [You can now index into slices using `(Bound<usize>, Bound<usize>)`.][77704]
  49 - [Add the `BITS` associated constant to all numeric types.][82565]
  50
  51 Stabilised APIs
  52 ---------------
  53 - [`AtomicBool::fetch_update`]
  54 - [`AtomicPtr::fetch_update`]
  55 - [`BTreeMap::retain`]
  56 - [`BTreeSet::retain`]
  57 - [`BufReader::seek_relative`]
  58 - [`DebugStruct::non_exhaustive`]
  59 - [`Duration::MAX`]
  60 - [`Duration::ZERO`]
  61 - [`Duration::is_zero`]
  62 - [`Duration::saturating_add`]
  63 - [`Duration::saturating_mul`]
  64 - [`Duration::saturating_sub`]
  65 - [`ErrorKind::Unsupported`]
  66 - [`Option::insert`]
  67 - [`Ordering::is_eq`]
  68 - [`Ordering::is_ge`]
  69 - [`Ordering::is_gt`]
  70 - [`Ordering::is_le`]
  71 - [`Ordering::is_lt`]
  72 - [`Ordering::is_ne`]
  73 - [`OsStr::is_ascii`]
  74 - [`OsStr::make_ascii_lowercase`]
  75 - [`OsStr::make_ascii_uppercase`]
  76 - [`OsStr::to_ascii_lowercase`]
  77 - [`OsStr::to_ascii_uppercase`]
  78 - [`Peekable::peek_mut`]
  79 - [`Rc::decrement_strong_count`]
  80 - [`Rc::increment_strong_count`]
  81 - [`Vec::extend_from_within`]
  82 - [`array::from_mut`]
  83 - [`array::from_ref`]
  84 - [`cmp::max_by_key`]
  85 - [`cmp::max_by`]
  86 - [`cmp::min_by_key`]
  87 - [`cmp::min_by`]
  88 - [`f32::is_subnormal`]
  89 - [`f64::is_subnormal`]
  90
  91 Cargo
  92 -----------------------
  93 - [Cargo now supports git repositories where the default `HEAD` branch is not
  94   "master".][cargo/9392] This also includes a switch to the version 3 `Cargo.lock` format
  95   which can handle default branches correctly.
  96 - [macOS targets now default to `unpacked` split-debuginfo.][cargo/9298]
  97 - [The `authors` field is no longer included in `Cargo.toml` for new
  98   projects.][cargo/9282]
  99
 100 Rustdoc
 101 -----------------------
 102 - [Added the `rustdoc::bare_urls` lint that warns when you have URLs
 103   without hyperlinks.][81764]
 104
 105 Compatibility Notes
 106 -------------------
 107 - [Implement token-based handling of attributes during expansion][82608]
 108 - [`Ipv4::from_str` will now reject octal format IP addresses in addition
 109   to rejecting hexadecimal IP addresses.][83652] The octal format can lead
 110   to confusion and potential security vulnerabilities and [is no
 111   longer recommended][ietf6943].
 112 - [The added `BITS` constant may conflict with external definitions.][85667]
 113   In particular, this was known to be a problem in the `lexical-core` crate,
 114   but they have published fixes for semantic versions 0.4 through 0.7. To
 115   update this dependency alone, use `cargo update -p lexical-core`.
 116 - Incremental compilation remains off by default, unless one uses the `RUSTC_FORCE_INCREMENTAL=1` environment variable added in 1.52.1.
 117
 118 Internal Only
 119 -------------
 120 These changes provide no direct user facing benefits, but represent significant
 121 improvements to the internals and overall performance of rustc and
 122 related tools.
 123
 124 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 125 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 126 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 127 - [Rework rustdoc const type][82873]
 128
 129 [85667]: https://github.com/rust-lang/rust/pull/85667
 130 [83386]: https://github.com/rust-lang/rust/pull/83386
 131 [82771]: https://github.com/rust-lang/rust/pull/82771
 132 [84147]: https://github.com/rust-lang/rust/pull/84147
 133 [84082]: https://github.com/rust-lang/rust/pull/84082
 134 [83799]: https://github.com/rust-lang/rust/pull/83799
 135 [83681]: https://github.com/rust-lang/rust/pull/83681
 136 [83652]: https://github.com/rust-lang/rust/pull/83652
 137 [83387]: https://github.com/rust-lang/rust/pull/83387
 138 [82873]: https://github.com/rust-lang/rust/pull/82873
 139 [82864]: https://github.com/rust-lang/rust/pull/82864
 140 [82608]: https://github.com/rust-lang/rust/pull/82608
 141 [82565]: https://github.com/rust-lang/rust/pull/82565
 142 [80525]: https://github.com/rust-lang/rust/pull/80525
 143 [79278]: https://github.com/rust-lang/rust/pull/79278
 144 [78618]: https://github.com/rust-lang/rust/pull/78618
 145 [77704]: https://github.com/rust-lang/rust/pull/77704
 146 [83941]: https://github.com/rust-lang/rust/pull/83941
 147 [83065]: https://github.com/rust-lang/rust/pull/83065
 148 [81764]: https://github.com/rust-lang/rust/pull/81764
 149 [81469]: https://github.com/rust-lang/rust/pull/81469
 150 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 151 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 152 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 153 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 154 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 155 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 156 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 157 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 158 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 159 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 160 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 161 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 162 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 163 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 164 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 165 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 166 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 167 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 168 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 169 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 170 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 171 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 172 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 173 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 174 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 175 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 176 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 177 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 178 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 179 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 180 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 181 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 182 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 183 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 184 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 185 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 186 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 187 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 188 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 189 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 190 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 191 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 192
 193
 194 Version 1.52.1 (2021-05-10)
 195 ============================
 196
 197 This release disables incremental compilation, unless the user has explicitly
 198 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 199
 200 This is due to the widespread, and frequently occuring, breakage encountered by
 201 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 202 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 203 newly added incremental verification are still present in past stable versions,
 204 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 205 Rust binaries.
 206
 207 These problems only affect incremental builds, so release builds with Cargo
 208 should not be affected unless the user has explicitly opted into incremental.
 209 Debug and check builds are affected.
 210
 211 See [84970] for more details.
 212
 213 [84970]: https://github.com/rust-lang/rust/issues/84970
 214
 215 Version 1.52.0 (2021-05-06)
 216 ============================
 217
 218 Language
 219 --------
 220 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 221   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 222   is allowed by default, and may become a warning or hard error in a
 223   future edition.
 224 - [You can now cast mutable references to arrays to a pointer of the same type as
 225   the element.][81479]
 226
 227 Compiler
 228 --------
 229 - [Upgraded the default LLVM to LLVM 12.][81451]
 230
 231 Added tier 3\* support for the following targets.
 232
 233 - [`s390x-unknown-linux-musl`][82166]
 234 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 235 - [`powerpc-unknown-openbsd`][82733]
 236
 237 \* Refer to Rust's [platform support page][platform-support-doc] for more
 238 information on Rust's tiered platform support.
 239
 240 Libraries
 241 ---------
 242 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 243 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 244 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 245 - [All integer division and remainder operations are now `const`.][80962]
 246
 247 Stabilised APIs
 248 -------------
 249 - [`Arguments::as_str`]
 250 - [`char::MAX`]
 251 - [`char::REPLACEMENT_CHARACTER`]
 252 - [`char::UNICODE_VERSION`]
 253 - [`char::decode_utf16`]
 254 - [`char::from_digit`]
 255 - [`char::from_u32_unchecked`]
 256 - [`char::from_u32`]
 257 - [`slice::partition_point`]
 258 - [`str::rsplit_once`]
 259 - [`str::split_once`]
 260
 261 The following previously stable APIs are now `const`.
 262
 263 - [`char::len_utf8`]
 264 - [`char::len_utf16`]
 265 - [`char::to_ascii_uppercase`]
 266 - [`char::to_ascii_lowercase`]
 267 - [`char::eq_ignore_ascii_case`]
 268 - [`u8::to_ascii_uppercase`]
 269 - [`u8::to_ascii_lowercase`]
 270 - [`u8::eq_ignore_ascii_case`]
 271
 272 Rustdoc
 273 -------
 274 - [Rustdoc lints are now treated as a tool lint, meaning that
 275   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 276   Using the old style is still allowed, and will become a warning in
 277   a future release.
 278 - [Rustdoc now supports argument files.][82261]
 279 - [Rustdoc now generates smart punctuation for documentation.][79423]
 280 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 281   ```markdown
 282   - [x] Complete
 283   - [ ] Todo
 284   ```
 285
 286 Misc
 287 ----
 288 - [You can now pass multiple filters to tests.][81356] E.g.
 289   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 290 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 291   allowing you to see `std` symbols when debugging.][82218]
 292
 293 Internal Only
 294 -------------
 295 These changes provide no direct user facing benefits, but represent significant
 296 improvements to the internals and overall performance of rustc and
 297 related tools.
 298
 299 - [Check the result cache before the DepGraph when ensuring queries][81855]
 300 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 301 - [Only store a LocalDefId in some HIR nodes][81611]
 302 - [Store HIR attributes in a side table][79519]
 303
 304 Compatibility Notes
 305 -------------------
 306 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 307 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 308 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 309 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 310   languages in code blocks.][78429]
 311 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 312 - [Changes in how proc macros handle whitespace may lead to panics when used
 313   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 314 - [Turn `#[derive]` into a regular macro attribute][79078]
 315
 316 [84136]: https://github.com/rust-lang/rust/issues/84136
 317 [80763]: https://github.com/rust-lang/rust/pull/80763
 318 [82166]: https://github.com/rust-lang/rust/pull/82166
 319 [82121]: https://github.com/rust-lang/rust/pull/82121
 320 [81879]: https://github.com/rust-lang/rust/pull/81879
 321 [82261]: https://github.com/rust-lang/rust/pull/82261
 322 [82218]: https://github.com/rust-lang/rust/pull/82218
 323 [82216]: https://github.com/rust-lang/rust/pull/82216
 324 [82202]: https://github.com/rust-lang/rust/pull/82202
 325 [81855]: https://github.com/rust-lang/rust/pull/81855
 326 [81766]: https://github.com/rust-lang/rust/pull/81766
 327 [81744]: https://github.com/rust-lang/rust/pull/81744
 328 [81611]: https://github.com/rust-lang/rust/pull/81611
 329 [81479]: https://github.com/rust-lang/rust/pull/81479
 330 [81451]: https://github.com/rust-lang/rust/pull/81451
 331 [81356]: https://github.com/rust-lang/rust/pull/81356
 332 [80962]: https://github.com/rust-lang/rust/pull/80962
 333 [80553]: https://github.com/rust-lang/rust/pull/80553
 334 [80527]: https://github.com/rust-lang/rust/pull/80527
 335 [79519]: https://github.com/rust-lang/rust/pull/79519
 336 [79423]: https://github.com/rust-lang/rust/pull/79423
 337 [79208]: https://github.com/rust-lang/rust/pull/79208
 338 [78429]: https://github.com/rust-lang/rust/pull/78429
 339 [82733]: https://github.com/rust-lang/rust/pull/82733
 340 [82594]: https://github.com/rust-lang/rust/pull/82594
 341 [79078]: https://github.com/rust-lang/rust/pull/79078
 342 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
 343 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
 344 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
 345 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
 346 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
 347 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
 348 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
 349 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
 350 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
 351 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
 352 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
 353 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
 354 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
 355 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
 356 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
 357 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
 358 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
 359 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
 360 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
 361 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
 362 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
 363 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
 364
 365 Version 1.51.0 (2021-03-25)
 366 ============================
 367
 368 Language
 369 --------
 370 - [You can now parameterize items such as functions, traits, and `struct`s by constant
 371   values in addition to by types and lifetimes.][79135] Also known as "const generics"
 372   E.g. you can now write the following. Note: Only values of primitive integers,
 373   `bool`, or `char` types are currently permitted.
 374   ```rust
 375   struct GenericArray<T, const LENGTH: usize> {
 376       inner: [T; LENGTH]
 377   }
 378
 379   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
 380       const fn last(&self) -> Option<&T> {
 381           if LENGTH == 0 {
 382               None
 383           } else {
 384               Some(&self.inner[LENGTH - 1])
 385           }
 386       }
 387   }
 388   ```
 389
 390
 391 Compiler
 392 --------
 393
 394 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
 395   This option controls whether debug information is split across multiple files
 396   or packed into a single file. **Note** This option is unstable on other platforms.
 397 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
 398   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
 399 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
 400 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
 401
 402 \* Refer to Rust's [platform support page][platform-support-doc] for more
 403 information on Rust's tiered platform support.
 404
 405 Libraries
 406 ---------
 407
 408 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
 409 - [`str` now implements `AsMut<str>`.][80279]
 410 - [`u64` and `u128` now implement `From<char>`.][79502]
 411 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
 412 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
 413 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
 414 - [`io::Empty` now implements `io::Seek`.][78044]
 415 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
 416   `T: ?Sized` types.][80764]
 417 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
 418
 419
 420 Stabilized APIs
 421 ---------------
 422
 423 - [`Arc::decrement_strong_count`]
 424 - [`Arc::increment_strong_count`]
 425 - [`Once::call_once_force`]
 426 - [`Peekable::next_if_eq`]
 427 - [`Peekable::next_if`]
 428 - [`Seek::stream_position`]
 429 - [`array::IntoIter`]
 430 - [`panic::panic_any`]
 431 - [`ptr::addr_of!`]
 432 - [`ptr::addr_of_mut!`]
 433 - [`slice::fill_with`]
 434 - [`slice::split_inclusive_mut`]
 435 - [`slice::split_inclusive`]
 436 - [`slice::strip_prefix`]
 437 - [`slice::strip_suffix`]
 438 - [`str::split_inclusive`]
 439 - [`sync::OnceState`]
 440 - [`task::Wake`]
 441 - [`VecDeque::range`]
 442 - [`VecDeque::range_mut`]
 443
 444 Cargo
 445 -----
 446 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
 447   codegen option.][cargo/9112]
 448 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
 449   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
 450   to avoid unifying features of dependencies where that unification could be unwanted.
 451   Such as using the same dependency with a `std` feature in a build scripts and
 452   proc-macros, while using the `no-std` feature in the final binary. See the
 453   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
 454
 455 Rustdoc
 456 -------
 457
 458 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
 459 - [You can now provide a `--default-theme` flag which sets the default theme to use for
 460   documentation.][79642]
 461
 462 Various improvements to intra-doc links:
 463
 464 - [You can link to non-path primitives such as `slice`.][80181]
 465 - [You can link to associated items.][74489]
 466 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
 467
 468 Misc
 469 ----
 470 - [You can now pass `--include-ignored` to tests (e.g. with
 471   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
 472
 473 Compatibility Notes
 474 -------------------
 475
 476 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
 477 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
 478   could fail.][80579]
 479 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
 480   for the distributed artifacts.][81521]
 481     - `armv5te-unknown-linux-gnueabi`
 482     - `sparc64-unknown-linux-gnu`
 483     - `thumbv7neon-unknown-linux-gnueabihf`
 484     - `armv7-unknown-linux-gnueabi`
 485     - `x86_64-unknown-linux-gnux32`
 486 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
 487
 488 Internal Only
 489 -------------
 490
 491 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
 492
 493 [79135]: https://github.com/rust-lang/rust/pull/79135
 494 [74489]: https://github.com/rust-lang/rust/pull/74489
 495 [76934]: https://github.com/rust-lang/rust/pull/76934
 496 [79570]: https://github.com/rust-lang/rust/pull/79570
 497 [80181]: https://github.com/rust-lang/rust/pull/80181
 498 [79642]: https://github.com/rust-lang/rust/pull/79642
 499 [80945]: https://github.com/rust-lang/rust/pull/80945
 500 [80279]: https://github.com/rust-lang/rust/pull/80279
 501 [80053]: https://github.com/rust-lang/rust/pull/80053
 502 [79502]: https://github.com/rust-lang/rust/pull/79502
 503 [75180]: https://github.com/rust-lang/rust/pull/75180
 504 [79135]: https://github.com/rust-lang/rust/pull/79135
 505 [81521]: https://github.com/rust-lang/rust/pull/81521
 506 [80968]: https://github.com/rust-lang/rust/pull/80968
 507 [80959]: https://github.com/rust-lang/rust/pull/80959
 508 [80718]: https://github.com/rust-lang/rust/pull/80718
 509 [80653]: https://github.com/rust-lang/rust/pull/80653
 510 [80579]: https://github.com/rust-lang/rust/pull/80579
 511 [79998]: https://github.com/rust-lang/rust/pull/79998
 512 [78044]: https://github.com/rust-lang/rust/pull/78044
 513 [81455]: https://github.com/rust-lang/rust/pull/81455
 514 [80764]: https://github.com/rust-lang/rust/pull/80764
 515 [80749]: https://github.com/rust-lang/rust/pull/80749
 516 [80662]: https://github.com/rust-lang/rust/pull/80662
 517 [79134]: https://github.com/rust-lang/rust/pull/79134
 518 [80966]: https://github.com/rust-lang/rust/pull/80966
 519 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
 520 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
 521 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
 522 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
 523 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
 524 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
 525 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 526 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 527 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
 528 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
 529 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
 530 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
 531 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
 532 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
 533 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
 534 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
 535 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
 536 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
 537 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
 538 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
 539 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
 540 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
 541 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
 542
 543 Version 1.50.0 (2021-02-11)
 544 ============================
 545
 546 Language
 547 -----------------------
 548 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
 549   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
 550 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
 551
 552 Compiler
 553 -----------------------
 554 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
 555 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
 556 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
 557 - [Dropped support for all cloudabi targets.][78439]
 558
 559 \* Refer to Rust's [platform support page][platform-support-doc] for more
 560 information on Rust's tiered platform support.
 561
 562 Libraries
 563 -----------------------
 564
 565 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
 566 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
 567 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
 568   This value cannot be a valid file descriptor, and now means `Option<File>` takes
 569   up the same amount of space as `File`.
 570
 571 Stabilized APIs
 572 ---------------
 573
 574 - [`bool::then`]
 575 - [`btree_map::Entry::or_insert_with_key`]
 576 - [`f32::clamp`]
 577 - [`f64::clamp`]
 578 - [`hash_map::Entry::or_insert_with_key`]
 579 - [`Ord::clamp`]
 580 - [`RefCell::take`]
 581 - [`slice::fill`]
 582 - [`UnsafeCell::get_mut`]
 583
 584 The following previously stable methods are now `const`.
 585
 586 - [`IpAddr::is_ipv4`]
 587 - [`IpAddr::is_ipv6`]
 588 - [`IpAddr::is_unspecified`]
 589 - [`IpAddr::is_loopback`]
 590 - [`IpAddr::is_multicast`]
 591 - [`Ipv4Addr::octets`]
 592 - [`Ipv4Addr::is_loopback`]
 593 - [`Ipv4Addr::is_private`]
 594 - [`Ipv4Addr::is_link_local`]
 595 - [`Ipv4Addr::is_multicast`]
 596 - [`Ipv4Addr::is_broadcast`]
 597 - [`Ipv4Addr::is_documentation`]
 598 - [`Ipv4Addr::to_ipv6_compatible`]
 599 - [`Ipv4Addr::to_ipv6_mapped`]
 600 - [`Ipv6Addr::segments`]
 601 - [`Ipv6Addr::is_unspecified`]
 602 - [`Ipv6Addr::is_loopback`]
 603 - [`Ipv6Addr::is_multicast`]
 604 - [`Ipv6Addr::to_ipv4`]
 605 - [`Layout::size`]
 606 - [`Layout::align`]
 607 - [`Layout::from_size_align`]
 608 - `pow` for all integer types.
 609 - `checked_pow` for all integer types.
 610 - `saturating_pow` for all integer types.
 611 - `wrapping_pow` for all integer types.
 612 - `next_power_of_two` for all unsigned integer types.
 613 - `checked_next_power_of_two` for all unsigned integer types.
 614
 615 Cargo
 616 -----------------------
 617
 618 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
 619   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
 620 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
 621   contents of that directory for changes.][cargo/8973]
 622 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
 623
 624 Misc
 625 ----
 626
 627 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
 628 - [Running tests will now print the total time taken to execute.][75752]
 629
 630 Compatibility Notes
 631 -------------------
 632
 633 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
 634   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
 635 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
 636   unhygenic `macro_rules!` macros.][79472]
 637 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
 638   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
 639 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
 640 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
 641   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
 642 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
 643
 644 [74989]: https://github.com/rust-lang/rust/pull/74989
 645 [79261]: https://github.com/rust-lang/rust/pull/79261
 646 [79896]: https://github.com/rust-lang/rust/pull/79896
 647 [79484]: https://github.com/rust-lang/rust/pull/79484
 648 [79472]: https://github.com/rust-lang/rust/pull/79472
 649 [79270]: https://github.com/rust-lang/rust/pull/79270
 650 [79003]: https://github.com/rust-lang/rust/pull/79003
 651 [78864]: https://github.com/rust-lang/rust/pull/78864
 652 [78636]: https://github.com/rust-lang/rust/pull/78636
 653 [78439]: https://github.com/rust-lang/rust/pull/78439
 654 [78343]: https://github.com/rust-lang/rust/pull/78343
 655 [78296]: https://github.com/rust-lang/rust/pull/78296
 656 [78068]: https://github.com/rust-lang/rust/pull/78068
 657 [75752]: https://github.com/rust-lang/rust/pull/75752
 658 [74699]: https://github.com/rust-lang/rust/pull/74699
 659 [78142]: https://github.com/rust-lang/rust/pull/78142
 660 [77484]: https://github.com/rust-lang/rust/pull/77484
 661 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
 662 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
 663 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
 664 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
 665 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
 666 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
 667 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
 668 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
 669 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
 670 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
 671 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
 672 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
 673 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
 674 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
 675 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
 676 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
 677 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
 678 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
 679 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
 680 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
 681 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
 682 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
 683 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
 684 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
 685 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
 686 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
 687 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
 688 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
 689 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
 690 [`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
 691 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
 692 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
 693 [`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
 694 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
 695
 696
 697 Version 1.49.0 (2020-12-31)
 698 ============================
 699
 700 Language
 701 -----------------------
 702
 703 - [Unions can now implement `Drop`, and you can now have a field in a union
 704   with `ManuallyDrop<T>`.][77547]
 705 - [You can now cast uninhabited enums to integers.][76199]
 706 - [You can now bind by reference and by move in patterns.][76119] This
 707   allows you to selectively borrow individual components of a type. E.g.
 708   ```rust
 709   #[derive(Debug)]
 710   struct Person {
 711       name: String,
 712       age: u8,
 713   }
 714
 715   let person = Person {
 716       name: String::from("Alice"),
 717       age: 20,
 718   };
 719
 720   // `name` is moved out of person, but `age` is referenced.
 721   let Person { name, ref age } = person;
 722   println!("{} {}", name, age);
 723   ```
 724
 725 Compiler
 726 -----------------------
 727
 728 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
 729 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
 730 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
 731 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
 732 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
 733 - [Output from threads spawned in tests is now captured.][78227]
 734 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
 735
 736 \* Refer to Rust's [platform support page][platform-support-doc] for more
 737 information on Rust's tiered platform support.
 738
 739 Libraries
 740 -----------------------
 741
 742 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
 743 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
 744
 745 Stabilized APIs
 746 ---------------
 747
 748 - [`slice::select_nth_unstable`]
 749 - [`slice::select_nth_unstable_by`]
 750 - [`slice::select_nth_unstable_by_key`]
 751
 752 The following previously stable methods are now `const`.
 753
 754 - [`Poll::is_ready`]
 755 - [`Poll::is_pending`]
 756
 757 Cargo
 758 -----------------------
 759 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
 760 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
 761 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
 762   variable will be set if the crate being built is one the user selected to build, either
 763   with `-p` or through defaults.
 764 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
 765
 766
 767 Compatibility Notes
 768 -------------------
 769
 770 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
 771 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
 772 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
 773   Previously such invalid or unused attributes could be ignored.
 774 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
 775   read [this post about the changes][rustdoc-ws-post] for more details.
 776 - [Trait bounds are no longer inferred for associated types.][79904]
 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 - [rustc's internal crates are now compiled using the `initial-exec` Thread
 785   Local Storage model.][78201]
 786 - [Calculate visibilities once in resolve.][78077]
 787 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
 788 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
 789
 790
 791 [75991]: https://github.com/rust-lang/rust/pull/75991
 792 [78951]: https://github.com/rust-lang/rust/pull/78951
 793 [78848]: https://github.com/rust-lang/rust/pull/78848
 794 [78746]: https://github.com/rust-lang/rust/pull/78746
 795 [78376]: https://github.com/rust-lang/rust/pull/78376
 796 [78228]: https://github.com/rust-lang/rust/pull/78228
 797 [78227]: https://github.com/rust-lang/rust/pull/78227
 798 [78201]: https://github.com/rust-lang/rust/pull/78201
 799 [78109]: https://github.com/rust-lang/rust/pull/78109
 800 [78077]: https://github.com/rust-lang/rust/pull/78077
 801 [77997]: https://github.com/rust-lang/rust/pull/77997
 802 [77703]: https://github.com/rust-lang/rust/pull/77703
 803 [77547]: https://github.com/rust-lang/rust/pull/77547
 804 [77015]: https://github.com/rust-lang/rust/pull/77015
 805 [76199]: https://github.com/rust-lang/rust/pull/76199
 806 [76119]: https://github.com/rust-lang/rust/pull/76119
 807 [75914]: https://github.com/rust-lang/rust/pull/75914
 808 [79004]: https://github.com/rust-lang/rust/pull/79004
 809 [78676]: https://github.com/rust-lang/rust/pull/78676
 810 [79904]: https://github.com/rust-lang/rust/issues/79904
 811 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
 812 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
 813 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
 814 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
 815 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
 816 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
 817 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
 818 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
 819 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
 820 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
 821 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
 822
 823 Version 1.48.0 (2020-11-19)
 824 ==========================
 825
 826 Language
 827 --------
 828
 829 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
 830   is still rejected *semantically*, but can now be parsed by procedural macros.
 831
 832 Compiler
 833 --------
 834 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
 835   `rustc` whether to link its own C runtime and libraries or to rely on a external
 836   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
 837 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
 838   Note: If you're using cargo you must explicitly pass the `--target` flag.
 839 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
 840
 841 \* Refer to Rust's [platform support page][platform-support-doc] for more
 842 information on Rust's tiered platform support.
 843
 844 Libraries
 845 ---------
 846 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
 847   and `&Stderr`.][76275]
 848 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
 849 - [The `matches!` macro now supports having a trailing comma.][74880]
 850 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
 851 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
 852
 853 Stabilized APIs
 854 ---------------
 855 - [`slice::as_ptr_range`]
 856 - [`slice::as_mut_ptr_range`]
 857 - [`VecDeque::make_contiguous`]
 858 - [`future::pending`]
 859 - [`future::ready`]
 860
 861 The following previously stable methods are now `const fn`'s:
 862
 863 - [`Option::is_some`]
 864 - [`Option::is_none`]
 865 - [`Option::as_ref`]
 866 - [`Result::is_ok`]
 867 - [`Result::is_err`]
 868 - [`Result::as_ref`]
 869 - [`Ordering::reverse`]
 870 - [`Ordering::then`]
 871
 872 Cargo
 873 -----
 874
 875 Rustdoc
 876 -------
 877 - [You can now link to items in `rustdoc` using the intra-doc link
 878   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
 879   a link to `std::future`'s documentation. See ["Linking to items by
 880   name"][intradoc-links] for more information.
 881 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
 882   when searching through `rustdoc`'s UI.][75740]
 883
 884 Compatibility Notes
 885 -------------------
 886 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
 887   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
 888   promoted to `'static` lifetime any more inside `const fn`s.
 889 - [Associated type bindings on trait objects are now verified to meet the bounds
 890   declared on the trait when checking that they implement the trait.][27675]
 891 - [When trait bounds on associated types or opaque types are ambiguous, the
 892   compiler no longer makes an arbitrary choice on which bound to use.][54121]
 893 - [Fixed recursive nonterminals not being expanded in macros during
 894   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
 895   correctly handling recursive nonterminal tokens.
 896 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
 897 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
 898   in places where they have no effect.][73461]
 899 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
 900   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
 901 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
 902   disallow zero-initialization.][71274]
 903 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
 904 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
 905   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
 906   see the [`catch_unwind`] documentation for further information.
 907
 908
 909
 910 Internal Only
 911 -------------
 912 These changes provide no direct user facing benefits, but represent significant
 913 improvements to the internals and overall performance of rustc and
 914 related tools.
 915
 916 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
 917   You can continue building with `make` by setting `ninja=false` in
 918   your `config.toml`.
 919 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
 920 - [Made `ensure_sufficient_stack()` non-generic][76680]
 921
 922 [78143]: https://github.com/rust-lang/rust/issues/78143
 923 [76680]: https://github.com/rust-lang/rust/pull/76680/
 924 [76030]: https://github.com/rust-lang/rust/pull/76030/
 925 [70212]: https://github.com/rust-lang/rust/pull/70212/
 926 [27675]: https://github.com/rust-lang/rust/issues/27675/
 927 [54121]: https://github.com/rust-lang/rust/issues/54121/
 928 [71274]: https://github.com/rust-lang/rust/pull/71274/
 929 [77386]: https://github.com/rust-lang/rust/pull/77386/
 930 [77153]: https://github.com/rust-lang/rust/pull/77153/
 931 [77055]: https://github.com/rust-lang/rust/pull/77055/
 932 [76275]: https://github.com/rust-lang/rust/pull/76275/
 933 [76310]: https://github.com/rust-lang/rust/pull/76310/
 934 [76420]: https://github.com/rust-lang/rust/pull/76420/
 935 [76158]: https://github.com/rust-lang/rust/pull/76158/
 936 [75857]: https://github.com/rust-lang/rust/pull/75857/
 937 [75585]: https://github.com/rust-lang/rust/pull/75585/
 938 [75740]: https://github.com/rust-lang/rust/pull/75740/
 939 [75502]: https://github.com/rust-lang/rust/pull/75502/
 940 [74880]: https://github.com/rust-lang/rust/pull/74880/
 941 [74922]: https://github.com/rust-lang/rust/pull/74922/
 942 [74430]: https://github.com/rust-lang/rust/pull/74430/
 943 [74194]: https://github.com/rust-lang/rust/pull/74194/
 944 [73461]: https://github.com/rust-lang/rust/pull/73461/
 945 [73166]: https://github.com/rust-lang/rust/pull/73166/
 946 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 947 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 948 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 949 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 950 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 951 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 952 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 953 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 954 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 955 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 956 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 957 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 958 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 959 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 960 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 961
 962
 963 Version 1.47.0 (2020-10-08)
 964 ==========================
 965
 966 Language
 967 --------
 968 - [Closures will now warn when not used.][74869]
 969
 970 Compiler
 971 --------
 972 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 973   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 974   platforms.
 975 - [Upgraded to LLVM 11.][73526]
 976 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 977 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 978 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 979
 980 \* Refer to Rust's [platform support page][platform-support-doc] for more
 981 information on Rust's tiered platform support.
 982
 983 Libraries
 984 ---------
 985 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 986 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 987   those of length less than 33.][74060]
 988 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 989 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 990   `PartialEq`, and `PartialOrd`.][73583]
 991
 992 Stabilized APIs
 993 ---------------
 994 - [`Ident::new_raw`]
 995 - [`Range::is_empty`]
 996 - [`RangeInclusive::is_empty`]
 997 - [`Result::as_deref`]
 998 - [`Result::as_deref_mut`]
 999 - [`Vec::leak`]
1000 - [`pointer::offset_from`]
1001 - [`f32::TAU`]
1002 - [`f64::TAU`]
1003
1004 The following previously stable APIs have now been made const.
1005
1006 - [The `new` method for all `NonZero` integers.][73858]
1007 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1008   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1009   methods for all integers.][73858]
1010 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1011   signed integers.][73858]
1012 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1013   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1014   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1015   `is_ascii_control` methods for `char` and `u8`.][73858]
1016
1017 Cargo
1018 -----
1019 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1020   You can override this by setting the following in your `Cargo.toml`.
1021   ```toml
1022   [profile.release.build-override]
1023   opt-level = 3
1024   ```
1025 - [`cargo-help` will now display man pages for commands rather just the
1026   `--help` text.][cargo/8456]
1027 - [`cargo-metadata` now emits a `test` field indicating if a target has
1028   tests enabled.][cargo/8478]
1029 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1030 - [`cargo-publish` will now use an alternative registry by default if it's the
1031   only registry specified in `package.publish`.][cargo/8571]
1032
1033 Misc
1034 ----
1035 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1036   type based search.][75366]
1037 - [Added the Ayu theme to rustdoc.][71237]
1038
1039 Compatibility Notes
1040 -------------------
1041 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1042 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1043 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1044   help to preserve more span information.][73084] These changes may cause
1045   compiliation errors if your macro was unhygenic or didn't correctly handle
1046   `Delimiter::None`.
1047 - [Moved support for the CloudABI target to tier 3.][75568]
1048 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1049 - [Added the `rustc-docs` component.][75560] This allows you to install
1050   and read the documentation for the compiler internal APIs. (Currently only
1051   available for `x86_64-unknown-linux-gnu`.)
1052
1053 Internal Only
1054 --------
1055
1056 - [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.
1057
1058 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1059 [75048]: https://github.com/rust-lang/rust/pull/75048/
1060 [74163]: https://github.com/rust-lang/rust/pull/74163/
1061 [71237]: https://github.com/rust-lang/rust/pull/71237/
1062 [74869]: https://github.com/rust-lang/rust/pull/74869/
1063 [73858]: https://github.com/rust-lang/rust/pull/73858/
1064 [75716]: https://github.com/rust-lang/rust/pull/75716/
1065 [75908]: https://github.com/rust-lang/rust/pull/75908/
1066 [75516]: https://github.com/rust-lang/rust/pull/75516/
1067 [75560]: https://github.com/rust-lang/rust/pull/75560/
1068 [75568]: https://github.com/rust-lang/rust/pull/75568/
1069 [75366]: https://github.com/rust-lang/rust/pull/75366/
1070 [75204]: https://github.com/rust-lang/rust/pull/75204/
1071 [74650]: https://github.com/rust-lang/rust/pull/74650/
1072 [74419]: https://github.com/rust-lang/rust/pull/74419/
1073 [73964]: https://github.com/rust-lang/rust/pull/73964/
1074 [74021]: https://github.com/rust-lang/rust/pull/74021/
1075 [74060]: https://github.com/rust-lang/rust/pull/74060/
1076 [73893]: https://github.com/rust-lang/rust/pull/73893/
1077 [73526]: https://github.com/rust-lang/rust/pull/73526/
1078 [73583]: https://github.com/rust-lang/rust/pull/73583/
1079 [73084]: https://github.com/rust-lang/rust/pull/73084/
1080 [73197]: https://github.com/rust-lang/rust/pull/73197/
1081 [72488]: https://github.com/rust-lang/rust/pull/72488/
1082 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1083 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1084 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1085 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1086 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1087 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1088 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1089 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1090 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1091 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1092 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1093 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1094 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1095 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1096 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1097
1098
1099 Version 1.46.0 (2020-08-27)
1100 ==========================
1101
1102 Language
1103 --------
1104 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1105 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1106   const functions.][73862]
1107 - [The `#[track_caller]` attribute can now be added to functions to use the
1108   function's caller's location information for panic messages.][72445]
1109 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1110   `x.0.0` over `(x.0).0`.
1111 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1112   You currently can't use `mem::transmute` in constant functions.
1113
1114 Compiler
1115 --------
1116 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1117 - [Enabled static "Position Independent Executables" by default
1118   for `x86_64-unknown-linux-musl`.][70740]
1119
1120 Libraries
1121 ---------
1122 - [`mem::forget` is now a `const fn`.][73887]
1123 - [`String` now implements `From<char>`.][73466]
1124 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1125   integer types.][73032]
1126 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1127 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1128   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1129 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1130 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1131 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1132
1133 Stabilized APIs
1134 ---------------
1135 - [`Option::zip`]
1136 - [`vec::Drain::as_slice`]
1137
1138 Cargo
1139 -----
1140 Added a number of new environment variables that are now available when
1141 compiling your crate.
1142
1143 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1144   the specific binary being compiled and the name of the crate.
1145 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1146 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1147
1148 Compatibility Notes
1149 -------------------
1150 - [The target configuration option `abi_blacklist` has been renamed
1151   to `unsupported_abis`.][74150] The old name will still continue to work.
1152 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1153   This was previously accepted but will become a hard error in a future release.
1154 - [Rustc will fail to compile if you have a struct with
1155   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1156   allowed on `enum`s.
1157 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1158   ensure that spans have the correct information, and may cause breakage if you
1159   were relying on receiving spans with dummy information.
1160 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1161   a legacy installer that was replaced by a MSI installer a few years ago but
1162   was still being built.
1163 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1164 - [Rustc will no longer accept overlapping trait implementations that only
1165   differ in how the lifetime was bound.][72493]
1166 - [Rustc now correctly relates the lifetime of an existential associated
1167   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1168   you to pass a shorter lifetime than expected.
1169 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1170   The library will need to be installed for `rustc` to work, even though we
1171   expect it to be already available on most systems.
1172 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1173   under QEMU.][74820]
1174 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1175   exact output returned by rustc's pretty printing is an unstable
1176   implementation detail: we recommend any macro relying on it to switch to a
1177   more robust parsing system.
1178
1179 [75453]: https://github.com/rust-lang/rust/issues/75453/
1180 [74820]: https://github.com/rust-lang/rust/issues/74820/
1181 [74420]: https://github.com/rust-lang/rust/issues/74420/
1182 [74109]: https://github.com/rust-lang/rust/pull/74109/
1183 [74150]: https://github.com/rust-lang/rust/pull/74150/
1184 [73862]: https://github.com/rust-lang/rust/pull/73862/
1185 [73887]: https://github.com/rust-lang/rust/pull/73887/
1186 [73466]: https://github.com/rust-lang/rust/pull/73466/
1187 [73516]: https://github.com/rust-lang/rust/pull/73516/
1188 [73293]: https://github.com/rust-lang/rust/pull/73293/
1189 [73007]: https://github.com/rust-lang/rust/pull/73007/
1190 [73032]: https://github.com/rust-lang/rust/pull/73032/
1191 [72920]: https://github.com/rust-lang/rust/pull/72920/
1192 [72569]: https://github.com/rust-lang/rust/pull/72569/
1193 [72583]: https://github.com/rust-lang/rust/pull/72583/
1194 [72584]: https://github.com/rust-lang/rust/pull/72584/
1195 [72717]: https://github.com/rust-lang/rust/pull/72717/
1196 [72437]: https://github.com/rust-lang/rust/pull/72437/
1197 [72445]: https://github.com/rust-lang/rust/pull/72445/
1198 [72486]: https://github.com/rust-lang/rust/pull/72486/
1199 [72493]: https://github.com/rust-lang/rust/pull/72493/
1200 [72331]: https://github.com/rust-lang/rust/pull/72331/
1201 [71896]: https://github.com/rust-lang/rust/pull/71896/
1202 [71660]: https://github.com/rust-lang/rust/pull/71660/
1203 [71322]: https://github.com/rust-lang/rust/pull/71322/
1204 [70740]: https://github.com/rust-lang/rust/pull/70740/
1205 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1206 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1207 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1208 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1209 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1210
1211
1212 Version 1.45.2 (2020-08-03)
1213 ==========================
1214
1215 * [Fix bindings in tuple struct patterns][74954]
1216 * [Fix track_caller integration with trait objects][74784]
1217
1218 [74954]: https://github.com/rust-lang/rust/issues/74954
1219 [74784]: https://github.com/rust-lang/rust/issues/74784
1220
1221
1222 Version 1.45.1 (2020-07-30)
1223 ==========================
1224
1225 * [Fix const propagation with references.][73613]
1226 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1227 * [Avoid spurious implicit region bound.][74509]
1228 * [Install clippy on x.py install][74457]
1229
1230 [73613]: https://github.com/rust-lang/rust/pull/73613
1231 [73078]: https://github.com/rust-lang/rust/issues/73078
1232 [74509]: https://github.com/rust-lang/rust/pull/74509
1233 [74457]: https://github.com/rust-lang/rust/pull/74457
1234
1235
1236 Version 1.45.0 (2020-07-16)
1237 ==========================
1238
1239 Language
1240 --------
1241 - [Out of range float to int conversions using `as` has been defined as a saturating
1242   conversion.][71269] This was previously undefined behaviour, but you can use the
1243    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1244    may be desirable in rare performance sensitive situations.
1245 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1246   using `u64`.][70705]
1247 - [Function like procedural macros can now be used in expression, pattern, and  statement
1248   positions.][68717] This means you can now use a function-like procedural macro
1249   anywhere you can use a declarative (`macro_rules!`) macro.
1250
1251 Compiler
1252 --------
1253 - [You can now override individual target features through the `target-feature`
1254   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1255   equivalent to `-C target-feature=+avx2,+fma`.
1256 - [Added the `force-unwind-tables` flag.][69984] This option allows
1257   rustc to always generate unwind tables regardless of panic strategy.
1258 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1259   to include LLVM bitcode into generated `rlib`s (this is on by default).
1260 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1261 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1262 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1263 - [Upgraded to LLVM 10.][67759]
1264
1265 \* Refer to Rust's [platform support page][platform-support-doc] for more
1266 information on Rust's tiered platform support.
1267
1268
1269 Libraries
1270 ---------
1271 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1272   and `Ord`.][72239]
1273 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1274 - [You can now use `char` with
1275   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1276   a range of codepoints.][72413] E.g.
1277   you can now write the following;
1278   ```rust
1279   for ch in 'a'..='z' {
1280       print!("{}", ch);
1281   }
1282   println!();
1283   // Prints "abcdefghijklmnopqrstuvwxyz"
1284   ```
1285 - [`OsString` now implements `FromStr`.][71662]
1286 - [The `saturating_neg` method has been added to all signed integer primitive
1287   types, and the `saturating_abs` method has been added for all integer
1288   primitive types.][71886]
1289 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1290   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1291   or `Path`.][71447]
1292 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1293 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1294   integer types.][69813]
1295 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1296   integer types.][72324]
1297 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1298
1299 Stabilized APIs
1300 ---------------
1301 - [`Arc::as_ptr`]
1302 - [`BTreeMap::remove_entry`]
1303 - [`Rc::as_ptr`]
1304 - [`rc::Weak::as_ptr`]
1305 - [`rc::Weak::from_raw`]
1306 - [`rc::Weak::into_raw`]
1307 - [`str::strip_prefix`]
1308 - [`str::strip_suffix`]
1309 - [`sync::Weak::as_ptr`]
1310 - [`sync::Weak::from_raw`]
1311 - [`sync::Weak::into_raw`]
1312 - [`char::UNICODE_VERSION`]
1313 - [`Span::resolved_at`]
1314 - [`Span::located_at`]
1315 - [`Span::mixed_site`]
1316 - [`unix::process::CommandExt::arg0`]
1317
1318 Cargo
1319 -----
1320
1321 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1322   time.][cargo/8066]
1323
1324 Misc
1325 ----
1326 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1327   `~~outdated information~~` becomes "~~outdated information~~".
1328 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1329
1330 Compatibility Notes
1331 -------------------
1332 - [Trying to self initialize a static value (that is creating a value using
1333   itself) is unsound and now causes a compile error.][71140]
1334 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1335   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1336 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1337   previously undocumented and not intended for public use. Rustdoc still provides
1338   a non-zero exit code on errors.
1339 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1340   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1341   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1342   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1343   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1344
1345 Internals Only
1346 --------------
1347 - [Make clippy a git subtree instead of a git submodule][70655]
1348 - [Unify the undo log of all snapshot types][69464]
1349
1350 [71848]: https://github.com/rust-lang/rust/issues/71848/
1351 [73420]: https://github.com/rust-lang/rust/issues/73420/
1352 [72324]: https://github.com/rust-lang/rust/pull/72324/
1353 [71843]: https://github.com/rust-lang/rust/pull/71843/
1354 [71886]: https://github.com/rust-lang/rust/pull/71886/
1355 [72234]: https://github.com/rust-lang/rust/pull/72234/
1356 [72239]: https://github.com/rust-lang/rust/pull/72239/
1357 [72397]: https://github.com/rust-lang/rust/pull/72397/
1358 [72413]: https://github.com/rust-lang/rust/pull/72413/
1359 [72014]: https://github.com/rust-lang/rust/pull/72014/
1360 [72062]: https://github.com/rust-lang/rust/pull/72062/
1361 [72094]: https://github.com/rust-lang/rust/pull/72094/
1362 [72133]: https://github.com/rust-lang/rust/pull/72133/
1363 [67759]: https://github.com/rust-lang/rust/pull/67759/
1364 [71900]: https://github.com/rust-lang/rust/pull/71900/
1365 [71928]: https://github.com/rust-lang/rust/pull/71928/
1366 [71662]: https://github.com/rust-lang/rust/pull/71662/
1367 [71716]: https://github.com/rust-lang/rust/pull/71716/
1368 [71447]: https://github.com/rust-lang/rust/pull/71447/
1369 [71269]: https://github.com/rust-lang/rust/pull/71269/
1370 [71095]: https://github.com/rust-lang/rust/pull/71095/
1371 [71140]: https://github.com/rust-lang/rust/pull/71140/
1372 [70655]: https://github.com/rust-lang/rust/pull/70655/
1373 [70705]: https://github.com/rust-lang/rust/pull/70705/
1374 [69984]: https://github.com/rust-lang/rust/pull/69984/
1375 [69813]: https://github.com/rust-lang/rust/pull/69813/
1376 [69464]: https://github.com/rust-lang/rust/pull/69464/
1377 [68717]: https://github.com/rust-lang/rust/pull/68717/
1378 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1379 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1380 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1381 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1382 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1383 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1384 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1385 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1386 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1387 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1388 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1389 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1390 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1391 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1392 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1393 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1394 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1395
1396
1397 Version 1.44.1 (2020-06-18)
1398 ===========================
1399
1400 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1401 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1402 * [Fix crashes when finding backtrace on macOS.][71397]
1403 * [Clippy applies lint levels into different files.][clippy/5356]
1404
1405 [71397]: https://github.com/rust-lang/rust/issues/71397
1406 [73078]: https://github.com/rust-lang/rust/issues/73078
1407 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1408 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1409
1410
1411 Version 1.44.0 (2020-06-04)
1412 ==========================
1413
1414 Language
1415 --------
1416 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1417 - [Added the `unused_braces` lint.][70081]
1418
1419 **Syntax-only changes**
1420
1421 - [Expansion-driven outline module parsing][69838]
1422 ```rust
1423 #[cfg(FALSE)]
1424 mod foo {
1425     mod bar {
1426         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1427     }
1428 }
1429 ```
1430
1431 These are still rejected semantically, so you will likely receive an error but
1432 these changes can be seen and parsed by macros and conditional compilation.
1433
1434 Compiler
1435 --------
1436 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1437   Additionally when in incremental mode rustc defaults to 256 codegen units.
1438 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1439   a panic is thrown.][67502]
1440 - [Added tier 3\* support for the `aarch64-unknown-none` and
1441   `aarch64-unknown-none-softfloat` targets.][68334]
1442 - [Added tier 3 support for `arm64-apple-tvos` and
1443   `x86_64-apple-tvos` targets.][68191]
1444
1445
1446 Libraries
1447 ---------
1448 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1449   `vec![]` to be able to be used in `const` contexts.
1450 - [`convert::Infallible` now implements `Hash`.][70281]
1451 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1452   a `&mut OsStr`.][70048]
1453 - [Unicode 13 is now supported.][69929]
1454 - [`String` now implements `From<&mut str>`.][69661]
1455 - [`IoSlice` now implements `Copy`.][69403]
1456 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1457 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1458 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1459   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1460   integer types.][69373]
1461
1462 Stabilized APIs
1463 ---------------
1464 - [`PathBuf::with_capacity`]
1465 - [`PathBuf::capacity`]
1466 - [`PathBuf::clear`]
1467 - [`PathBuf::reserve`]
1468 - [`PathBuf::reserve_exact`]
1469 - [`PathBuf::shrink_to_fit`]
1470 - [`f32::to_int_unchecked`]
1471 - [`f64::to_int_unchecked`]
1472 - [`Layout::align_to`]
1473 - [`Layout::pad_to_align`]
1474 - [`Layout::array`]
1475 - [`Layout::extend`]
1476
1477 Cargo
1478 -----
1479 - [Added the `cargo tree` command which will print a tree graph of
1480   your dependencies.][cargo/8062] E.g.
1481   ```
1482     mdbook v0.3.2 (/Users/src/rust/mdbook)
1483   ├── ammonia v3.0.0
1484   │   ├── html5ever v0.24.0
1485   │   │   ├── log v0.4.8
1486   │   │   │   └── cfg-if v0.1.9
1487   │   │   ├── mac v0.1.1
1488   │   │   └── markup5ever v0.9.0
1489   │   │       ├── log v0.4.8 (*)
1490   │   │       ├── phf v0.7.24
1491   │   │       │   └── phf_shared v0.7.24
1492   │   │       │       ├── siphasher v0.2.3
1493   │   │       │       └── unicase v1.4.2
1494   │   │       │           [build-dependencies]
1495   │   │       │           └── version_check v0.1.5
1496   ...
1497   ```
1498   You can also display dependencies on multiple versions of the same crate with
1499   `cargo tree -d` (short for `cargo tree --duplicates`).
1500
1501 Misc
1502 ----
1503 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1504   the version in the sidebar.][69494]
1505
1506 Compatibility Notes
1507 -------------------
1508 - [Rustc now correctly generates static libraries on Windows GNU targets with
1509   the `.a` extension, rather than the previous `.lib`.][70937]
1510 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1511 - [The `file_name` property in JSON output of macro errors now points the actual
1512   source file rather than the previous format of `<NAME macros>`.][70969]
1513   **Note:** this may not point to a file that actually exists on the user's system.
1514 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1515 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1516   not allow zero initialization such as `NonZeroU8`.][66059] This was
1517   previously a warning.
1518 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1519   operator has been defined as a saturating operation.][71269] This was previously
1520   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1521   continue using the current behaviour, which may be desirable in rare performance
1522   sensitive situations.
1523
1524 Internal Only
1525 -------------
1526 These changes provide no direct user facing benefits, but represent significant
1527 improvements to the internals and overall performance of rustc and
1528 related tools.
1529
1530 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1531 - [Replace big JS dict with JSON parsing.][71250]
1532
1533 [69373]: https://github.com/rust-lang/rust/pull/69373/
1534 [66059]: https://github.com/rust-lang/rust/pull/66059/
1535 [68191]: https://github.com/rust-lang/rust/pull/68191/
1536 [68899]: https://github.com/rust-lang/rust/pull/68899/
1537 [71147]: https://github.com/rust-lang/rust/pull/71147/
1538 [71250]: https://github.com/rust-lang/rust/pull/71250/
1539 [70937]: https://github.com/rust-lang/rust/pull/70937/
1540 [70969]: https://github.com/rust-lang/rust/pull/70969/
1541 [70632]: https://github.com/rust-lang/rust/pull/70632/
1542 [70281]: https://github.com/rust-lang/rust/pull/70281/
1543 [70345]: https://github.com/rust-lang/rust/pull/70345/
1544 [70048]: https://github.com/rust-lang/rust/pull/70048/
1545 [70081]: https://github.com/rust-lang/rust/pull/70081/
1546 [70156]: https://github.com/rust-lang/rust/pull/70156/
1547 [71269]: https://github.com/rust-lang/rust/pull/71269/
1548 [69838]: https://github.com/rust-lang/rust/pull/69838/
1549 [69929]: https://github.com/rust-lang/rust/pull/69929/
1550 [69661]: https://github.com/rust-lang/rust/pull/69661/
1551 [69778]: https://github.com/rust-lang/rust/pull/69778/
1552 [69494]: https://github.com/rust-lang/rust/pull/69494/
1553 [69403]: https://github.com/rust-lang/rust/pull/69403/
1554 [69033]: https://github.com/rust-lang/rust/pull/69033/
1555 [68692]: https://github.com/rust-lang/rust/pull/68692/
1556 [68334]: https://github.com/rust-lang/rust/pull/68334/
1557 [67502]: https://github.com/rust-lang/rust/pull/67502/
1558 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1559 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1560 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1561 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1562 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1563 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1564 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1565 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1566 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1567 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1568 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1569 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1570 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1571
1572
1573 Version 1.43.1 (2020-05-07)
1574 ===========================
1575
1576 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1577 * [Fixed the stabilization of AVX-512 features.][71473]
1578 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1579
1580 [71430]: https://github.com/rust-lang/rust/pull/71430
1581 [71473]: https://github.com/rust-lang/rust/issues/71473
1582 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1583
1584
1585 Version 1.43.0 (2020-04-23)
1586 ==========================
1587
1588 Language
1589 --------
1590 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1591   the type inferred correctly.][68129]
1592 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1593
1594 **Syntax only changes**
1595 - [Allow `type Foo: Ord` syntactically.][69361]
1596 - [Fuse associated and extern items up to defaultness.][69194]
1597 - [Syntactically allow `self` in all `fn` contexts.][68764]
1598 - [Merge `fn` syntax + cleanup item parsing.][68728]
1599 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1600   For example, you may now write:
1601   ```rust
1602   macro_rules! mac_trait {
1603       ($i:item) => {
1604           trait T { $i }
1605       }
1606   }
1607   mac_trait! {
1608       fn foo() {}
1609   }
1610   ```
1611
1612 These are still rejected *semantically*, so you will likely receive an error but
1613 these changes can be seen and parsed by macros and
1614 conditional compilation.
1615
1616
1617 Compiler
1618 --------
1619 - [You can now pass multiple lint flags to rustc to override the previous
1620   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1621   everything in the `unused` lint group except `unused-variables` which
1622   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1623   everything in the `unused` lint group **including** `unused-variables` since
1624   the allow flag is specified before the deny flag (and therefore overridden).
1625 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1626   if they are available on `windows-gnu`.][67429]
1627 - [rustc now buffers errors/warnings printed in JSON.][69227]
1628
1629 Libraries
1630 ---------
1631 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1632   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1633   respectively.][69538] **Note** These conversions are only available when `N`
1634   is `0..=32`.
1635 - [You can now use associated constants on floats and integers directly, rather
1636   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1637   `f32::NAN` with no imports.
1638 - [`u8::is_ascii` is now `const`.][68984]
1639 - [`String` now implements `AsMut<str>`.][68742]
1640 - [Added the `primitive` module to `std` and `core`.][67637] This module
1641   reexports Rust's primitive types. This is mainly useful in macros
1642   where you want avoid these types being shadowed.
1643 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1644 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1645
1646 Stabilized APIs
1647 ---------------
1648 - [`Once::is_completed`]
1649 - [`f32::LOG10_2`]
1650 - [`f32::LOG2_10`]
1651 - [`f64::LOG10_2`]
1652 - [`f64::LOG2_10`]
1653 - [`iter::once_with`]
1654
1655 Cargo
1656 -----
1657 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1658   your environment.][cargo/7823]
1659 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1660   executable path when running integration tests or benchmarks.][cargo/7697]
1661   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1662   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1663
1664 Misc
1665 ----
1666 - [Certain checks in the `const_err` lint were deemed unrelated to const
1667   evaluation][69185], and have been moved to the `unconditional_panic` and
1668   `arithmetic_overflow` lints.
1669
1670 Compatibility Notes
1671 -------------------
1672
1673 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1674   has been a warning since 1.36.0.
1675 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1676   led to some instances being accepted, and now correctly emits a hard error.
1677
1678 [69340]: https://github.com/rust-lang/rust/pull/69340
1679
1680 Internal Only
1681 -------------
1682 These changes provide no direct user facing benefits, but represent significant
1683 improvements to the internals and overall performance of `rustc` and
1684 related tools.
1685
1686 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1687 - [Improved how rustc generates drop code.][67332]
1688 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1689 - [traits: preallocate 2 Vecs of known initial size][69022]
1690 - [Avoid exponential behaviour when relating types][68772]
1691 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1692 - [Improve performance of coherence checks][68966]
1693 - [Deduplicate types in the generator witness][68672]
1694 - [Invert control in struct_lint_level.][68725]
1695
1696 [67332]: https://github.com/rust-lang/rust/pull/67332/
1697 [67429]: https://github.com/rust-lang/rust/pull/67429/
1698 [67637]: https://github.com/rust-lang/rust/pull/67637/
1699 [67642]: https://github.com/rust-lang/rust/pull/67642/
1700 [67878]: https://github.com/rust-lang/rust/pull/67878/
1701 [67885]: https://github.com/rust-lang/rust/pull/67885/
1702 [68129]: https://github.com/rust-lang/rust/pull/68129/
1703 [68672]: https://github.com/rust-lang/rust/pull/68672/
1704 [68725]: https://github.com/rust-lang/rust/pull/68725/
1705 [68728]: https://github.com/rust-lang/rust/pull/68728/
1706 [68738]: https://github.com/rust-lang/rust/pull/68738/
1707 [68742]: https://github.com/rust-lang/rust/pull/68742/
1708 [68764]: https://github.com/rust-lang/rust/pull/68764/
1709 [68772]: https://github.com/rust-lang/rust/pull/68772/
1710 [68943]: https://github.com/rust-lang/rust/pull/68943/
1711 [68952]: https://github.com/rust-lang/rust/pull/68952/
1712 [68966]: https://github.com/rust-lang/rust/pull/68966/
1713 [68984]: https://github.com/rust-lang/rust/pull/68984/
1714 [69022]: https://github.com/rust-lang/rust/pull/69022/
1715 [69185]: https://github.com/rust-lang/rust/pull/69185/
1716 [69194]: https://github.com/rust-lang/rust/pull/69194/
1717 [69201]: https://github.com/rust-lang/rust/pull/69201/
1718 [69227]: https://github.com/rust-lang/rust/pull/69227/
1719 [69548]: https://github.com/rust-lang/rust/pull/69548/
1720 [69256]: https://github.com/rust-lang/rust/pull/69256/
1721 [69361]: https://github.com/rust-lang/rust/pull/69361/
1722 [69366]: https://github.com/rust-lang/rust/pull/69366/
1723 [69538]: https://github.com/rust-lang/rust/pull/69538/
1724 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1725 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1726 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1727 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1728 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1729 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1730 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1731 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1732
1733
1734 Version 1.42.0 (2020-03-12)
1735 ==========================
1736
1737 Language
1738 --------
1739 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1740   ```rust
1741   fn foo(words: &[&str]) {
1742       match words {
1743           ["Hello", "World", "!", ..] => println!("Hello World!"),
1744           ["Foo", "Bar", ..] => println!("Baz"),
1745           rest => println!("{:?}", rest),
1746       }
1747   }
1748   ```
1749 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1750   that you can create an enum that has the exact layout and ABI of the type
1751   it contains.
1752 - [You can now use outer attribute procedural macros on inline modules.][64273]
1753 - [There are some *syntax-only* changes:][67131]
1754    - `default` is syntactically allowed before items in `trait` definitions.
1755    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1756      leave out their bodies in favor of `;`.
1757    - Bounds on associated types in `impl`s are now syntactically allowed
1758      (e.g. `type Foo: Ord;`).
1759    - `...` (the C-variadic type) may occur syntactically directly as the type of
1760       any function parameter.
1761
1762   These are still rejected *semantically*, so you will likely receive an error
1763   but these changes can be seen and parsed by procedural macros and
1764   conditional compilation.
1765
1766 Compiler
1767 --------
1768 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1769 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1770 - [`Option::{expect,unwrap}` and
1771    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1772    pointing to the location where they were called, rather than
1773    `core`'s internals. ][67887]
1774
1775 \* Refer to Rust's [platform support page][platform-support-doc] for more
1776 information on Rust's tiered platform support.
1777
1778 Libraries
1779 ---------
1780 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1781 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1782    to implement `Sized`.][67935]
1783 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1784 - [`Layout::new` is now `const`.][66254]
1785 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1786
1787
1788 Stabilized APIs
1789 ---------------
1790 - [`CondVar::wait_while`]
1791 - [`CondVar::wait_timeout_while`]
1792 - [`DebugMap::key`]
1793 - [`DebugMap::value`]
1794 - [`ManuallyDrop::take`]
1795 - [`matches!`]
1796 - [`ptr::slice_from_raw_parts_mut`]
1797 - [`ptr::slice_from_raw_parts`]
1798
1799 Cargo
1800 -----
1801 - [You no longer need to include `extern crate proc_macro;` to be able to
1802   `use proc_macro;` in the `2018` edition.][cargo/7700]
1803
1804 Compatibility Notes
1805 -------------------
1806 - [`Error::description` has been deprecated, and its use will now produce a
1807   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1808
1809 [68253]: https://github.com/rust-lang/rust/pull/68253/
1810 [68348]: https://github.com/rust-lang/rust/pull/68348/
1811 [67935]: https://github.com/rust-lang/rust/pull/67935/
1812 [68339]: https://github.com/rust-lang/rust/pull/68339/
1813 [68122]: https://github.com/rust-lang/rust/pull/68122/
1814 [64273]: https://github.com/rust-lang/rust/pull/64273/
1815 [67712]: https://github.com/rust-lang/rust/pull/67712/
1816 [67887]: https://github.com/rust-lang/rust/pull/67887/
1817 [67131]: https://github.com/rust-lang/rust/pull/67131/
1818 [67233]: https://github.com/rust-lang/rust/pull/67233/
1819 [66899]: https://github.com/rust-lang/rust/pull/66899/
1820 [66919]: https://github.com/rust-lang/rust/pull/66919/
1821 [66254]: https://github.com/rust-lang/rust/pull/66254/
1822 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1823 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1824 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1825 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1826 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1827 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1828 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1829 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1830 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1831
1832
1833 Version 1.41.1 (2020-02-27)
1834 ===========================
1835
1836 * [Always check types of static items][69145]
1837 * [Always check lifetime bounds of `Copy` impls][69145]
1838 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1839
1840 [69225]: https://github.com/rust-lang/rust/issues/69225
1841 [69145]: https://github.com/rust-lang/rust/pull/69145
1842
1843
1844 Version 1.41.0 (2020-01-30)
1845 ===========================
1846
1847 Language
1848 --------
1849
1850 - [You can now pass type parameters to foreign items when implementing
1851   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1852 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1853   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1854   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1855 - [You can now use any valid identifier in a `format_args` macro.][66847]
1856   Previously identifiers starting with an underscore were not allowed.
1857 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1858   enum variants.][66183] These are still rejected semantically, but
1859   can be seen and parsed by procedural macros and conditional compilation.
1860
1861 Compiler
1862 --------
1863
1864 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1865 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1866 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1867 - [You can now pass an arguments file passing the `@path` syntax
1868   to rustc.][66172] Note that the format differs somewhat from what is
1869   found in other tooling; please see [the documentation][argfile-docs] for
1870   more information.
1871 - [You can now provide `--extern` flag without a path, indicating that it is
1872   available from the search path or specified with an `-L` flag.][64882]
1873
1874 \* Refer to Rust's [platform support page][platform-support-doc] for more
1875 information on Rust's tiered platform support.
1876
1877 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1878
1879 Libraries
1880 ---------
1881
1882 - [The `core::panic` module is now stable.][66771] It was already stable
1883   through `std`.
1884 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1885   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1886 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1887
1888 Stabilized APIs
1889 ---------------
1890
1891 - [`Result::map_or`]
1892 - [`Result::map_or_else`]
1893 - [`std::rc::Weak::weak_count`]
1894 - [`std::rc::Weak::strong_count`]
1895 - [`std::sync::Weak::weak_count`]
1896 - [`std::sync::Weak::strong_count`]
1897
1898 Cargo
1899 -----
1900
1901 - [Cargo will now document all the private items for binary crates
1902   by default.][cargo/7593]
1903 - [`cargo-install` will now reinstall the package if it detects that it is out
1904   of date.][cargo/7560]
1905 - [Cargo.lock now uses a more git friendly format that should help to reduce
1906   merge conflicts.][cargo/7579]
1907 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1908   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1909   optimisation level to `2` for debug builds. You can also use
1910   `[profile.<profile>.build-override]` to override build scripts and
1911   their dependencies.
1912
1913 Misc
1914 ----
1915
1916 - [You can now specify `edition` in documentation code blocks to compile the block
1917   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1918   should be compiled the 2018 edition of Rust.
1919 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1920   current theme with `--check-theme`.][54733]
1921 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1922
1923 Compatibility Notes
1924 -------------------
1925
1926 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1927   Apple targets.][apple-32bit-drop] This means that the source code is still
1928   available to build, but the targets are no longer being tested and release
1929   binaries for those platforms will no longer be distributed by the Rust project.
1930   Please refer to the linked blog post for more information.
1931
1932 [54733]: https://github.com/rust-lang/rust/pull/54733/
1933 [61351]: https://github.com/rust-lang/rust/pull/61351/
1934 [67255]: https://github.com/rust-lang/rust/pull/67255/
1935 [66661]: https://github.com/rust-lang/rust/pull/66661/
1936 [66771]: https://github.com/rust-lang/rust/pull/66771/
1937 [66847]: https://github.com/rust-lang/rust/pull/66847/
1938 [66238]: https://github.com/rust-lang/rust/pull/66238/
1939 [66277]: https://github.com/rust-lang/rust/pull/66277/
1940 [66325]: https://github.com/rust-lang/rust/pull/66325/
1941 [66172]: https://github.com/rust-lang/rust/pull/66172/
1942 [66183]: https://github.com/rust-lang/rust/pull/66183/
1943 [65879]: https://github.com/rust-lang/rust/pull/65879/
1944 [65013]: https://github.com/rust-lang/rust/pull/65013/
1945 [64882]: https://github.com/rust-lang/rust/pull/64882/
1946 [64325]: https://github.com/rust-lang/rust/pull/64325/
1947 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1948 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1949 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1950 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1951 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1952 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1953 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1954 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1955 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1956 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1957 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1958
1959 Version 1.40.0 (2019-12-19)
1960 ===========================
1961
1962 Language
1963 --------
1964 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1965   `const` contexts.][65188] e.g.
1966
1967   ```rust
1968   pub struct Point(i32, i32);
1969
1970   const ORIGIN: Point = {
1971       let constructor = Point;
1972
1973       constructor(0, 0)
1974   };
1975   ```
1976
1977 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1978   indicate that there may be variants or fields added in the future.][64639]
1979   For example this requires adding a wild-card branch (`_ => {}`) to any match
1980   statements on a non-exhaustive `enum`. [(RFC 2008)]
1981 - [You can now use function-like procedural macros in `extern` blocks and in
1982   type positions.][63931] e.g. `type Generated = macro!();`
1983 - [Function-like and attribute procedural macros can now emit
1984   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1985 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1986   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1987   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1988
1989 Compiler
1990 --------
1991 - [Added tier 3 support\* for the
1992   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1993 - [Added tier 3 support for the
1994   `aarch64-unknown-none-softfloat` target.][64589]
1995 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1996   `mips64el-unknown-linux-muslabi64` targets.][65843]
1997
1998 \* Refer to Rust's [platform support page][platform-support-doc] for more
1999   information on Rust's tiered platform support.
2000
2001 Libraries
2002 ---------
2003 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2004
2005 Stabilized APIs
2006 ---------------
2007 - [`BTreeMap::get_key_value`]
2008 - [`HashMap::get_key_value`]
2009 - [`Option::as_deref_mut`]
2010 - [`Option::as_deref`]
2011 - [`Option::flatten`]
2012 - [`UdpSocket::peer_addr`]
2013 - [`f32::to_be_bytes`]
2014 - [`f32::to_le_bytes`]
2015 - [`f32::to_ne_bytes`]
2016 - [`f64::to_be_bytes`]
2017 - [`f64::to_le_bytes`]
2018 - [`f64::to_ne_bytes`]
2019 - [`f32::from_be_bytes`]
2020 - [`f32::from_le_bytes`]
2021 - [`f32::from_ne_bytes`]
2022 - [`f64::from_be_bytes`]
2023 - [`f64::from_le_bytes`]
2024 - [`f64::from_ne_bytes`]
2025 - [`mem::take`]
2026 - [`slice::repeat`]
2027 - [`todo!`]
2028
2029 Cargo
2030 -----
2031 - [Cargo will now always display warnings, rather than only on
2032   fresh builds.][cargo/7450]
2033 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2034   now produce an error.][cargo/7507] Previously these flags were ignored.
2035 - [You can now publish `dev-dependencies` without including
2036   a `version`.][cargo/7333]
2037
2038 Misc
2039 ----
2040 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2041   when running documentation tests with `rustdoc`.][63803]
2042
2043 Compatibility Notes
2044 -------------------
2045 - [As previously announced, any previous NLL warnings in the 2015 edition are
2046   now hard errors.][64221]
2047 - [The `include!` macro will now warn if it failed to include the
2048   entire file.][64284] The `include!` macro unintentionally only includes the
2049   first _expression_ in a file, and this can be unintuitive. This will become
2050   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2051 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2052   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2053   or `extern` blocks now correctly emits a hard error.
2054
2055 [65294]: https://github.com/rust-lang/rust/pull/65294/
2056 [66103]: https://github.com/rust-lang/rust/pull/66103/
2057 [65843]: https://github.com/rust-lang/rust/pull/65843/
2058 [65188]: https://github.com/rust-lang/rust/pull/65188/
2059 [65092]: https://github.com/rust-lang/rust/pull/65092/
2060 [64589]: https://github.com/rust-lang/rust/pull/64589/
2061 [64639]: https://github.com/rust-lang/rust/pull/64639/
2062 [64221]: https://github.com/rust-lang/rust/pull/64221/
2063 [64284]: https://github.com/rust-lang/rust/pull/64284/
2064 [63931]: https://github.com/rust-lang/rust/pull/63931/
2065 [64035]: https://github.com/rust-lang/rust/pull/64035/
2066 [63674]: https://github.com/rust-lang/rust/pull/63674/
2067 [63803]: https://github.com/rust-lang/rust/pull/63803/
2068 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2069 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2070 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2071 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2072 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2073 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2074 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2075 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2076 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2077 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2078 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2079 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2080 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2081 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2082 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2083 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2084 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2085 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2086 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2087 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2088 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2089 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2090 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2091 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2092 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2093 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2094
2095
2096 Version 1.39.0 (2019-11-07)
2097 ===========================
2098
2099 Language
2100 --------
2101 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2102   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2103 - [You can now use certain attributes on function, closure, and function pointer
2104   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2105   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2106   attributes applied to items. e.g.
2107   ```rust
2108   fn len(
2109       #[cfg(windows)] slice: &[u16],
2110       #[cfg(not(windows))] slice: &[u8],
2111   ) -> usize {
2112       slice.len()
2113   }
2114   ```
2115 - [You can now take shared references to bind-by-move patterns in the `if` guards
2116   of `match` arms.][63118] e.g.
2117   ```rust
2118   fn main() {
2119       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2120
2121       match array {
2122           nums
2123   //      ---- `nums` is bound by move.
2124               if nums.iter().sum::<u8>() == 10
2125   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2126           => {
2127               drop(nums);
2128   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2129           }
2130           _ => unreachable!(),
2131       }
2132   }
2133   ```
2134
2135
2136
2137 Compiler
2138 --------
2139 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2140 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2141 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2142   **Note** Cargo currently doesn't use this feature. Refer to
2143   [cargo#7315][cargo/7315] to track this feature's progress.
2144 - [You can now pass `--show-output` argument to test binaries to print the
2145   output of successful tests.][62600]
2146
2147
2148 \* Refer to Rust's [platform support page][platform-support-doc] for more
2149 information on Rust's tiered platform support.
2150
2151 Libraries
2152 ---------
2153 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2154 - [`LinkedList::new` is now a `const` function.][63684]
2155 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2156 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2157   now `const`.][63786]
2158
2159 Stabilized APIs
2160 ---------------
2161 - [`Pin::into_inner`]
2162 - [`Instant::checked_duration_since`]
2163 - [`Instant::saturating_duration_since`]
2164
2165 Cargo
2166 -----
2167 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2168 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2169   `--all` is now deprecated.
2170
2171 Misc
2172 ----
2173 - [You can now pass `-Clinker` to rustdoc to control the linker used
2174   for compiling doctests.][63834]
2175
2176 Compatibility Notes
2177 -------------------
2178 - [Code that was previously accepted by the old borrow checker, but rejected by
2179   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2180   previously a warning, and will also become a hard error in the Rust 2015
2181   edition in the 1.40.0 release.
2182 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2183   run tests.][63827] This should improve performance when running a large
2184   amount of doctests.
2185 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2186   recommended to use the `?` operator instead.
2187 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2188   returned `0.0`.
2189
2190 [62600]: https://github.com/rust-lang/rust/pull/62600/
2191 [62672]: https://github.com/rust-lang/rust/pull/62672/
2192 [63118]: https://github.com/rust-lang/rust/pull/63118/
2193 [63209]: https://github.com/rust-lang/rust/pull/63209/
2194 [63402]: https://github.com/rust-lang/rust/pull/63402/
2195 [63565]: https://github.com/rust-lang/rust/pull/63565/
2196 [63595]: https://github.com/rust-lang/rust/pull/63595/
2197 [63684]: https://github.com/rust-lang/rust/pull/63684/
2198 [63698]: https://github.com/rust-lang/rust/pull/63698/
2199 [63770]: https://github.com/rust-lang/rust/pull/63770/
2200 [63786]: https://github.com/rust-lang/rust/pull/63786/
2201 [63827]: https://github.com/rust-lang/rust/pull/63827/
2202 [63834]: https://github.com/rust-lang/rust/pull/63834/
2203 [63927]: https://github.com/rust-lang/rust/pull/63927/
2204 [63933]: https://github.com/rust-lang/rust/pull/63933/
2205 [63934]: https://github.com/rust-lang/rust/pull/63934/
2206 [63938]: https://github.com/rust-lang/rust/pull/63938/
2207 [63940]: https://github.com/rust-lang/rust/pull/63940/
2208 [63941]: https://github.com/rust-lang/rust/pull/63941/
2209 [63945]: https://github.com/rust-lang/rust/pull/63945/
2210 [64010]: https://github.com/rust-lang/rust/pull/64010/
2211 [64028]: https://github.com/rust-lang/rust/pull/64028/
2212 [64334]: https://github.com/rust-lang/rust/pull/64334/
2213 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2214 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2215 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2216 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2217 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2218 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2219
2220 Version 1.38.0 (2019-09-26)
2221 ==========================
2222
2223 Language
2224 --------
2225 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2226 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2227
2228 Compiler
2229 --------
2230 - [Added pipelined compilation support to `rustc`.][62766] This will
2231   improve compilation times in some cases. For further information please refer
2232   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2233 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2234   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2235   `x86_64-uwp-windows-msvc` targets.][60260]
2236 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2237   `armv7-unknown-linux-musleabi` targets.][63107]
2238 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2239 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2240 - [Upgraded to LLVM 9.][62592]
2241
2242 \* Refer to Rust's [platform support page][platform-support-doc] for more
2243 information on Rust's tiered platform support.
2244
2245 Libraries
2246 ---------
2247 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2248 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2249   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2250   is available at `std::clone::Clone`). This also makes all built-in macros
2251   available in `std`/`core` root. e.g. `std::include_bytes!`.
2252 - [`str::Chars` now implements `Debug`.][63000]
2253 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2254 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2255 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2256 - [Added euclidean remainder and division operations (`div_euclid`,
2257   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2258   `overflowing`, and `wrapping` versions are available for all
2259   integer primitives.
2260 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2261   `PartialEq`.][61491]
2262 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2263
2264 Stabilized APIs
2265 ---------------
2266 - [`<*const T>::cast`]
2267 - [`<*mut T>::cast`]
2268 - [`Duration::as_secs_f32`]
2269 - [`Duration::as_secs_f64`]
2270 - [`Duration::div_f32`]
2271 - [`Duration::div_f64`]
2272 - [`Duration::from_secs_f32`]
2273 - [`Duration::from_secs_f64`]
2274 - [`Duration::mul_f32`]
2275 - [`Duration::mul_f64`]
2276 - [`any::type_name`]
2277
2278 Cargo
2279 -----
2280 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2281 - [You can now pass the `--features` option multiple times to enable
2282   multiple features.][cargo/7084]
2283
2284 Rustdoc
2285 -------
2286
2287 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2288
2289 Misc
2290 ----
2291 - [`rustc` will now warn about some incorrect uses of
2292   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2293
2294 Compatibility Notes
2295 -------------------
2296 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2297   1.38.0.
2298 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2299   issues][62896] with certain crates such as libc.
2300
2301 [60260]: https://github.com/rust-lang/rust/pull/60260/
2302 [61457]: https://github.com/rust-lang/rust/pull/61457/
2303 [61491]: https://github.com/rust-lang/rust/pull/61491/
2304 [61884]: https://github.com/rust-lang/rust/pull/61884/
2305 [61953]: https://github.com/rust-lang/rust/pull/61953/
2306 [62042]: https://github.com/rust-lang/rust/pull/62042/
2307 [62528]: https://github.com/rust-lang/rust/pull/62528/
2308 [62583]: https://github.com/rust-lang/rust/pull/62583/
2309 [62735]: https://github.com/rust-lang/rust/pull/62735/
2310 [62766]: https://github.com/rust-lang/rust/pull/62766/
2311 [62784]: https://github.com/rust-lang/rust/pull/62784/
2312 [62592]: https://github.com/rust-lang/rust/pull/62592/
2313 [62785]: https://github.com/rust-lang/rust/issues/62785/
2314 [62814]: https://github.com/rust-lang/rust/pull/62814/
2315 [62896]: https://github.com/rust-lang/rust/issues/62896/
2316 [63000]: https://github.com/rust-lang/rust/pull/63000/
2317 [63056]: https://github.com/rust-lang/rust/pull/63056/
2318 [63107]: https://github.com/rust-lang/rust/pull/63107/
2319 [63346]: https://github.com/rust-lang/rust/pull/63346/
2320 [63421]: https://github.com/rust-lang/rust/pull/63421/
2321 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2322 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2323 [63048]: https://github.com/rust-lang/rust/pull/63048
2324 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2325 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2326 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2327 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2328 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2329 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2330 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2331 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2332 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2333 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2334 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2335 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2336 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2337
2338 Version 1.37.0 (2019-08-15)
2339 ==========================
2340
2341 Language
2342 --------
2343 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2344   [`Box`][62228], or an [array][62235] and unused.
2345 - [You can now use the `cfg` and `cfg_attr` attributes on
2346   generic parameters.][61547]
2347 - [You can now use enum variants through type alias.][61682] e.g. You can
2348   write the following:
2349   ```rust
2350   type MyOption = Option<u8>;
2351
2352   fn increment_or_zero(x: MyOption) -> u8 {
2353       match x {
2354           MyOption::Some(y) => y + 1,
2355           MyOption::None => 0,
2356       }
2357   }
2358   ```
2359 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2360   `const _: u32 = 5;`.
2361 - [You can now use `#[repr(align(X)]` on enums.][61229]
2362 - [The  `?` Kleene macro operator is now available in the
2363   2015 edition.][60932]
2364
2365 Compiler
2366 --------
2367 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2368   and `-C profile-use` flags.][61268] For more information on how to use profile
2369   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2370 - [The `rust-lldb` wrapper script should now work again.][61827]
2371
2372 Libraries
2373 ---------
2374 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2375
2376 Stabilized APIs
2377 ---------------
2378 - [`BufReader::buffer`]
2379 - [`BufWriter::buffer`]
2380 - [`Cell::from_mut`]
2381 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2382 - [`DoubleEndedIterator::nth_back`]
2383 - [`Option::xor`]
2384 - [`Wrapping::reverse_bits`]
2385 - [`i128::reverse_bits`]
2386 - [`i16::reverse_bits`]
2387 - [`i32::reverse_bits`]
2388 - [`i64::reverse_bits`]
2389 - [`i8::reverse_bits`]
2390 - [`isize::reverse_bits`]
2391 - [`slice::copy_within`]
2392 - [`u128::reverse_bits`]
2393 - [`u16::reverse_bits`]
2394 - [`u32::reverse_bits`]
2395 - [`u64::reverse_bits`]
2396 - [`u8::reverse_bits`]
2397 - [`usize::reverse_bits`]
2398
2399 Cargo
2400 -----
2401 - [`Cargo.lock` files are now included by default when publishing executable crates
2402   with executables.][cargo/7026]
2403 - [You can now specify `default-run="foo"` in `[package]` to specify the
2404   default executable to use for `cargo run`.][cargo/7056]
2405
2406 Misc
2407 ----
2408
2409 Compatibility Notes
2410 -------------------
2411 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2412   Please transition your code to using the `..=` syntax for inclusive
2413   ranges instead.
2414 - [Using a trait object without the `dyn` will now warn by default.][61203]
2415   Please transition your code to use `dyn Trait` for trait objects instead.
2416
2417 [62228]: https://github.com/rust-lang/rust/pull/62228/
2418 [62235]: https://github.com/rust-lang/rust/pull/62235/
2419 [61802]: https://github.com/rust-lang/rust/pull/61802/
2420 [61827]: https://github.com/rust-lang/rust/pull/61827/
2421 [61547]: https://github.com/rust-lang/rust/pull/61547/
2422 [61682]: https://github.com/rust-lang/rust/pull/61682/
2423 [61268]: https://github.com/rust-lang/rust/pull/61268/
2424 [61342]: https://github.com/rust-lang/rust/pull/61342/
2425 [61347]: https://github.com/rust-lang/rust/pull/61347/
2426 [61100]: https://github.com/rust-lang/rust/pull/61100/
2427 [61203]: https://github.com/rust-lang/rust/pull/61203/
2428 [61229]: https://github.com/rust-lang/rust/pull/61229/
2429 [60932]: https://github.com/rust-lang/rust/pull/60932/
2430 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2431 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2432 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2433 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2434 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2435 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2436 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2437 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2438 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2439 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2440 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2441 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2442 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2443 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2444 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2445 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2446 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2447 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2448 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2449 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2450 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2451 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2452 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2453 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2454
2455
2456 Version 1.36.0 (2019-07-04)
2457 ==========================
2458
2459 Language
2460 --------
2461 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2462 - [The order of traits in trait objects no longer affects the semantics of that
2463   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2464   `dyn fmt::Debug + Send`, where this was previously not the case.
2465
2466 Libraries
2467 ---------
2468 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2469 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2470 - [`mem::needs_drop` is now available as a const fn.][60364]
2471 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2472 - [`String` now implements `BorrowMut<str>`.][60404]
2473 - [`io::Cursor` now implements `Default`.][60234]
2474 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2475 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2476   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2477   environment has access to heap memory allocation.
2478 - [`String` now implements `From<&String>`.][59825]
2479 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2480   return a tuple of each argument when there is multiple arguments.
2481 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2482   not used.][59648]
2483
2484 Stabilized APIs
2485 ---------------
2486 - [`VecDeque::rotate_left`]
2487 - [`VecDeque::rotate_right`]
2488 - [`Iterator::copied`]
2489 - [`io::IoSlice`]
2490 - [`io::IoSliceMut`]
2491 - [`Read::read_vectored`]
2492 - [`Write::write_vectored`]
2493 - [`str::as_mut_ptr`]
2494 - [`mem::MaybeUninit`]
2495 - [`pointer::align_offset`]
2496 - [`future::Future`]
2497 - [`task::Context`]
2498 - [`task::RawWaker`]
2499 - [`task::RawWakerVTable`]
2500 - [`task::Waker`]
2501 - [`task::Poll`]
2502
2503 Cargo
2504 -----
2505 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2506 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2507
2508 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2509
2510 Clippy
2511 ------
2512 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2513
2514 Misc
2515 ----
2516
2517 Compatibility Notes
2518 -------------------
2519 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2520   longer recommended, and will be deprecated in 1.39.0.
2521
2522 [60318]: https://github.com/rust-lang/rust/pull/60318/
2523 [60364]: https://github.com/rust-lang/rust/pull/60364/
2524 [60370]: https://github.com/rust-lang/rust/pull/60370/
2525 [60404]: https://github.com/rust-lang/rust/pull/60404/
2526 [60234]: https://github.com/rust-lang/rust/pull/60234/
2527 [60244]: https://github.com/rust-lang/rust/pull/60244/
2528 [58623]: https://github.com/rust-lang/rust/pull/58623/
2529 [59648]: https://github.com/rust-lang/rust/pull/59648/
2530 [59675]: https://github.com/rust-lang/rust/pull/59675/
2531 [59825]: https://github.com/rust-lang/rust/pull/59825/
2532 [59826]: https://github.com/rust-lang/rust/pull/59826/
2533 [59445]: https://github.com/rust-lang/rust/pull/59445/
2534 [59114]: https://github.com/rust-lang/rust/pull/59114/
2535 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2536 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2537 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2538 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2539 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2540 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2541 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2542 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2543 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2544 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2545 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2546 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2547 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2548 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2549 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2550 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2551 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2552 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2553 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2554 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2555
2556
2557 Version 1.35.0 (2019-05-23)
2558 ==========================
2559
2560 Language
2561 --------
2562 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2563   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2564 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2565   ```rust
2566   unsafe fn call_unsafe(func: unsafe fn()) {
2567       func()
2568   }
2569
2570   pub fn main() {
2571       unsafe { call_unsafe(|| {}); }
2572   }
2573   ```
2574
2575
2576 Compiler
2577 --------
2578 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2579   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2580 - [Added the `wasm32-unknown-wasi` target.][59464]
2581
2582
2583 Libraries
2584 ---------
2585 - [`Thread` will now show its ID in `Debug` output.][59460]
2586 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2587 - [`alloc::System` now implements `Default`.][59451]
2588 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2589   last field.][59076]
2590 - [`char::{ToLowercase, ToUppercase}` now
2591   implement `ExactSizeIterator`.][58778]
2592 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2593 - [Removed the `Read` trait bounds
2594   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2595 - [You can now call the `dbg!` macro without any parameters to print the file
2596   and line where it is called.][57847]
2597 - [In place ASCII case conversions are now up to 4× faster.][59283]
2598   e.g. `str::make_ascii_lowercase`
2599 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2600   and `Send`.][58369]
2601
2602 Stabilized APIs
2603 ---------------
2604 - [`f32::copysign`]
2605 - [`f64::copysign`]
2606 - [`RefCell::replace_with`]
2607 - [`RefCell::map_split`]
2608 - [`ptr::hash`]
2609 - [`Range::contains`]
2610 - [`RangeFrom::contains`]
2611 - [`RangeTo::contains`]
2612 - [`RangeInclusive::contains`]
2613 - [`RangeToInclusive::contains`]
2614 - [`Option::copied`]
2615
2616 Cargo
2617 -----
2618 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2619   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2620   platform specific.
2621
2622 Misc
2623 ----
2624 - [The Rust toolchain is now available natively for musl based distros.][58575]
2625
2626 [59460]: https://github.com/rust-lang/rust/pull/59460/
2627 [59464]: https://github.com/rust-lang/rust/pull/59464/
2628 [59500]: https://github.com/rust-lang/rust/pull/59500/
2629 [59512]: https://github.com/rust-lang/rust/pull/59512/
2630 [59580]: https://github.com/rust-lang/rust/pull/59580/
2631 [59283]: https://github.com/rust-lang/rust/pull/59283/
2632 [59451]: https://github.com/rust-lang/rust/pull/59451/
2633 [59076]: https://github.com/rust-lang/rust/pull/59076/
2634 [58778]: https://github.com/rust-lang/rust/pull/58778/
2635 [58717]: https://github.com/rust-lang/rust/pull/58717/
2636 [58369]: https://github.com/rust-lang/rust/pull/58369/
2637 [58423]: https://github.com/rust-lang/rust/pull/58423/
2638 [58080]: https://github.com/rust-lang/rust/pull/58080/
2639 [57847]: https://github.com/rust-lang/rust/pull/57847/
2640 [58575]: https://github.com/rust-lang/rust/pull/58575
2641 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2642 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2643 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2644 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2645 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2646 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2647 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2648 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2649 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2650 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2651 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2652 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2653
2654 Version 1.34.2 (2019-05-14)
2655 ===========================
2656
2657 * [Destabilize the `Error::type_id` function due to a security
2658    vulnerability][60785] ([CVE-2019-12083])
2659
2660 [60785]: https://github.com/rust-lang/rust/pull/60785
2661 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2662
2663 Version 1.34.1 (2019-04-25)
2664 ===========================
2665
2666 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2667 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2668 * [Fix Clippy panic when checking some macros][clippy/3805]
2669
2670 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2671 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2672 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2673
2674 Version 1.34.0 (2019-04-11)
2675 ==========================
2676
2677 Language
2678 --------
2679 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2680   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2681   but had no effect.
2682 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2683   `#[attr{}]` procedural macros.][57367]
2684 - [You can now write `extern crate self as foo;`][57407] to import your
2685   crate's root into the extern prelude.
2686
2687
2688 Compiler
2689 --------
2690 - [You can now target `riscv64imac-unknown-none-elf` and
2691   `riscv64gc-unknown-none-elf`.][58406]
2692 - [You can now enable linker plugin LTO optimisations with
2693   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2694   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2695   boundaries.
2696 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2697
2698
2699 Libraries
2700 ---------
2701 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2702   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2703   the `Hash` trait to create an iterator.
2704 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2705   methods.][58421] Most notably you no longer require the `Ord` trait to create
2706   an iterator.
2707 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2708   for all numeric types.][58044]
2709 - [Indexing a `str` is now generic over all types that
2710   implement `SliceIndex<str>`.][57604]
2711 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2712   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2713   produce a warning if their returning type is unused.
2714 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2715   `overflowing_pow` are now available for all numeric types.][57873] These are
2716   equivalent to methods such as `wrapping_add` for the `pow` operation.
2717
2718
2719 Stabilized APIs
2720 ---------------
2721
2722 #### std & core
2723 * [`Any::type_id`]
2724 * [`Error::type_id`]
2725 * [`atomic::AtomicI16`]
2726 * [`atomic::AtomicI32`]
2727 * [`atomic::AtomicI64`]
2728 * [`atomic::AtomicI8`]
2729 * [`atomic::AtomicU16`]
2730 * [`atomic::AtomicU32`]
2731 * [`atomic::AtomicU64`]
2732 * [`atomic::AtomicU8`]
2733 * [`convert::Infallible`]
2734 * [`convert::TryFrom`]
2735 * [`convert::TryInto`]
2736 * [`iter::from_fn`]
2737 * [`iter::successors`]
2738 * [`num::NonZeroI128`]
2739 * [`num::NonZeroI16`]
2740 * [`num::NonZeroI32`]
2741 * [`num::NonZeroI64`]
2742 * [`num::NonZeroI8`]
2743 * [`num::NonZeroIsize`]
2744 * [`slice::sort_by_cached_key`]
2745 * [`str::escape_debug`]
2746 * [`str::escape_default`]
2747 * [`str::escape_unicode`]
2748 * [`str::split_ascii_whitespace`]
2749
2750 #### std
2751 * [`Instant::checked_add`]
2752 * [`Instant::checked_sub`]
2753 * [`SystemTime::checked_add`]
2754 * [`SystemTime::checked_sub`]
2755
2756 Cargo
2757 -----
2758 - [You can now use alternative registries to crates.io.][cargo/6654]
2759
2760 Misc
2761 ----
2762 - [You can now use the `?` operator in your documentation tests without manually
2763   adding `fn main() -> Result<(), _> {}`.][56470]
2764
2765 Compatibility Notes
2766 -------------------
2767 - [`Command::before_exec` is being replaced by the unsafe method
2768   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2769 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2770   can now use `const` functions in `static` variables.
2771
2772 [58370]: https://github.com/rust-lang/rust/pull/58370/
2773 [58406]: https://github.com/rust-lang/rust/pull/58406/
2774 [58421]: https://github.com/rust-lang/rust/pull/58421/
2775 [58166]: https://github.com/rust-lang/rust/pull/58166/
2776 [58044]: https://github.com/rust-lang/rust/pull/58044/
2777 [58057]: https://github.com/rust-lang/rust/pull/58057/
2778 [58059]: https://github.com/rust-lang/rust/pull/58059/
2779 [57809]: https://github.com/rust-lang/rust/pull/57809/
2780 [57873]: https://github.com/rust-lang/rust/pull/57873/
2781 [57604]: https://github.com/rust-lang/rust/pull/57604/
2782 [57367]: https://github.com/rust-lang/rust/pull/57367/
2783 [57407]: https://github.com/rust-lang/rust/pull/57407/
2784 [57425]: https://github.com/rust-lang/rust/pull/57425/
2785 [57106]: https://github.com/rust-lang/rust/pull/57106/
2786 [56470]: https://github.com/rust-lang/rust/pull/56470/
2787 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2788 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2789 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2790 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2791 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2792 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2793 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2794 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2795 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2796 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2797 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2798 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2799 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2800 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2801 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2802 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2803 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2804 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2805 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2806 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2807 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2808 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2809 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2810 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2811 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2812 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2813 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2814 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2815 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2816 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2817 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2818
2819
2820 Version 1.33.0 (2019-02-28)
2821 ==========================
2822
2823 Language
2824 --------
2825 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2826   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2827 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2828   E.g. You can have match statement on a `u8` that covers `0..=255` and
2829   you would no longer be required to have a `_ => unreachable!()` case.
2830 - [You can now have multiple patterns in `if let` and `while let`
2831   expressions.][57532] You can do this with the same syntax as a `match`
2832   expression. E.g.
2833   ```rust
2834   enum Creature {
2835       Crab(String),
2836       Lobster(String),
2837       Person(String),
2838   }
2839
2840   fn main() {
2841       let state = Creature::Crab("Ferris");
2842
2843       if let Creature::Crab(name) | Creature::Person(name) = state {
2844           println!("This creature's name is: {}", name);
2845       }
2846   }
2847   ```
2848 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2849   this feature will by default produce a warning as this behaviour can be
2850   unintuitive. E.g. `if let _ = 5 {}`
2851 - [You can now use `let` bindings, assignments, expression statements,
2852   and irrefutable pattern destructuring in const functions.][57175]
2853 - [You can now call unsafe const functions.][57067] E.g.
2854   ```rust
2855   const unsafe fn foo() -> i32 { 5 }
2856   const fn bar() -> i32 {
2857       unsafe { foo() }
2858   }
2859   ```
2860 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2861   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2862 - [You can now specify a specific alignment with the `#[repr(packed)]`
2863   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2864   with an alignment of 2 bytes and a size of 6 bytes.
2865 - [You can now import an item from a module as an `_`.][56303] This allows you to
2866   import a trait's impls, and not have the name in the namespace. E.g.
2867   ```rust
2868   use std::io::Read as _;
2869
2870   // Allowed as there is only one `Read` in the module.
2871   pub trait Read {}
2872   ```
2873 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2874
2875 Compiler
2876 --------
2877 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2878   command line argument.][56351]
2879 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2880 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2881 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2882   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2883   information on Rust's platform support.
2884 - [Added support for the `thumbv7neon-linux-androideabi` and
2885   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2886 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2887
2888 Libraries
2889 ---------
2890 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2891   functions for all numeric types.][57566]
2892 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2893   are now `const` functions for all numeric types.][57105]
2894 - [The methods `is_positive` and `is_negative` are now `const` functions for
2895   all signed numeric types.][57105]
2896 - [The `get` method for all `NonZero` types is now `const`.][57167]
2897 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2898   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2899   numeric types.][57234]
2900 - [`Ipv4Addr::new` is now a `const` function][57234]
2901
2902 Stabilized APIs
2903 ---------------
2904 - [`unix::FileExt::read_exact_at`]
2905 - [`unix::FileExt::write_all_at`]
2906 - [`Option::transpose`]
2907 - [`Result::transpose`]
2908 - [`convert::identity`]
2909 - [`pin::Pin`]
2910 - [`marker::Unpin`]
2911 - [`marker::PhantomPinned`]
2912 - [`Vec::resize_with`]
2913 - [`VecDeque::resize_with`]
2914 - [`Duration::as_millis`]
2915 - [`Duration::as_micros`]
2916 - [`Duration::as_nanos`]
2917
2918
2919 Cargo
2920 -----
2921 - [You can now publish crates that require a feature flag to compile with
2922   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2923 - [Cargo should now rebuild a crate if a file was modified during the initial
2924   build.][cargo/6484]
2925
2926 Compatibility Notes
2927 -------------------
2928 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2929   are now deprecated in the standard library, and their usage will now produce a warning.
2930   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2931   methods instead.
2932 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2933   downcasting.
2934 - [Libtest no longer creates a new thread for each test when
2935   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2936
2937 [55982]: https://github.com/rust-lang/rust/pull/55982/
2938 [56243]: https://github.com/rust-lang/rust/pull/56243
2939 [56303]: https://github.com/rust-lang/rust/pull/56303/
2940 [56351]: https://github.com/rust-lang/rust/pull/56351/
2941 [56362]: https://github.com/rust-lang/rust/pull/56362
2942 [56642]: https://github.com/rust-lang/rust/pull/56642/
2943 [56769]: https://github.com/rust-lang/rust/pull/56769/
2944 [56805]: https://github.com/rust-lang/rust/pull/56805
2945 [56947]: https://github.com/rust-lang/rust/pull/56947/
2946 [57049]: https://github.com/rust-lang/rust/pull/57049/
2947 [57067]: https://github.com/rust-lang/rust/pull/57067/
2948 [57105]: https://github.com/rust-lang/rust/pull/57105
2949 [57130]: https://github.com/rust-lang/rust/pull/57130/
2950 [57167]: https://github.com/rust-lang/rust/pull/57167/
2951 [57175]: https://github.com/rust-lang/rust/pull/57175/
2952 [57234]: https://github.com/rust-lang/rust/pull/57234/
2953 [57332]: https://github.com/rust-lang/rust/pull/57332/
2954 [57465]: https://github.com/rust-lang/rust/pull/57465/
2955 [57532]: https://github.com/rust-lang/rust/pull/57532/
2956 [57535]: https://github.com/rust-lang/rust/pull/57535/
2957 [57566]: https://github.com/rust-lang/rust/pull/57566/
2958 [57615]: https://github.com/rust-lang/rust/pull/57615/
2959 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2960 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2961 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2962 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2963 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2964 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2965 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2966 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2967 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2968 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2969 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2970 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2971 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2972 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2973 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2974 [platform-support]: https://forge.rust-lang.org/platform-support.html
2975
2976 Version 1.32.0 (2019-01-17)
2977 ==========================
2978
2979 Language
2980 --------
2981 #### 2018 edition
2982 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2983   operator allows you to specify zero or one repetitions similar to the `*` and
2984   `+` operators.
2985 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2986   now always resolve to the item (`enum`, `struct`, etc.) available in the
2987   module if present, before resolving to a external crate or an item the prelude.][56759]
2988   E.g.
2989   ```rust
2990   enum Color { Red, Green, Blue }
2991
2992   use Color::*;
2993   ```
2994
2995 #### All editions
2996 - [You can now match against `PhantomData<T>` types.][55837]
2997 - [You can now match against literals in macros with the `literal`
2998   specifier.][56072] This will match against a literal of any type.
2999   E.g. `1`, `'A'`, `"Hello World"`
3000 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
3001   ```rust
3002   struct Point(i32, i32);
3003
3004   impl Point {
3005       pub fn new(x: i32, y: i32) -> Self {
3006           Self(x, y)
3007       }
3008
3009       pub fn is_origin(&self) -> bool {
3010           match self {
3011               Self(0, 0) => true,
3012               _ => false,
3013           }
3014       }
3015   }
3016   ```
3017 - [Self can also now be used in type definitions.][56366] E.g.
3018   ```rust
3019   enum List<T>
3020   where
3021       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3022   {
3023       Nil,
3024       Cons(T, Box<Self>) // likewise here
3025   }
3026   ```
3027 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3028   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3029
3030 Compiler
3031 --------
3032 - [The default allocator has changed from jemalloc to the default allocator on
3033   your system.][55238] The compiler itself on Linux & macOS will still use
3034   jemalloc, but programs compiled with it will use the system allocator.
3035 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3036
3037 Libraries
3038 ---------
3039 - [`PathBuf` now implements `FromStr`.][55148]
3040 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3041 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3042   easily debug expressions in your rust program. E.g.
3043   ```rust
3044   let a = 2;
3045   let b = dbg!(a * 2) + 1;
3046   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3047   assert_eq!(b, 5);
3048   ```
3049
3050 The following APIs are now `const` functions and can be used in a
3051 `const` context.
3052
3053 - [`Cell::as_ptr`]
3054 - [`UnsafeCell::get`]
3055 - [`char::is_ascii`]
3056 - [`iter::empty`]
3057 - [`ManuallyDrop::new`]
3058 - [`ManuallyDrop::into_inner`]
3059 - [`RangeInclusive::start`]
3060 - [`RangeInclusive::end`]
3061 - [`NonNull::as_ptr`]
3062 - [`slice::as_ptr`]
3063 - [`str::as_ptr`]
3064 - [`Duration::as_secs`]
3065 - [`Duration::subsec_millis`]
3066 - [`Duration::subsec_micros`]
3067 - [`Duration::subsec_nanos`]
3068 - [`CStr::as_ptr`]
3069 - [`Ipv4Addr::is_unspecified`]
3070 - [`Ipv6Addr::new`]
3071 - [`Ipv6Addr::octets`]
3072
3073 Stabilized APIs
3074 ---------------
3075 - [`i8::to_be_bytes`]
3076 - [`i8::to_le_bytes`]
3077 - [`i8::to_ne_bytes`]
3078 - [`i8::from_be_bytes`]
3079 - [`i8::from_le_bytes`]
3080 - [`i8::from_ne_bytes`]
3081 - [`i16::to_be_bytes`]
3082 - [`i16::to_le_bytes`]
3083 - [`i16::to_ne_bytes`]
3084 - [`i16::from_be_bytes`]
3085 - [`i16::from_le_bytes`]
3086 - [`i16::from_ne_bytes`]
3087 - [`i32::to_be_bytes`]
3088 - [`i32::to_le_bytes`]
3089 - [`i32::to_ne_bytes`]
3090 - [`i32::from_be_bytes`]
3091 - [`i32::from_le_bytes`]
3092 - [`i32::from_ne_bytes`]
3093 - [`i64::to_be_bytes`]
3094 - [`i64::to_le_bytes`]
3095 - [`i64::to_ne_bytes`]
3096 - [`i64::from_be_bytes`]
3097 - [`i64::from_le_bytes`]
3098 - [`i64::from_ne_bytes`]
3099 - [`i128::to_be_bytes`]
3100 - [`i128::to_le_bytes`]
3101 - [`i128::to_ne_bytes`]
3102 - [`i128::from_be_bytes`]
3103 - [`i128::from_le_bytes`]
3104 - [`i128::from_ne_bytes`]
3105 - [`isize::to_be_bytes`]
3106 - [`isize::to_le_bytes`]
3107 - [`isize::to_ne_bytes`]
3108 - [`isize::from_be_bytes`]
3109 - [`isize::from_le_bytes`]
3110 - [`isize::from_ne_bytes`]
3111 - [`u8::to_be_bytes`]
3112 - [`u8::to_le_bytes`]
3113 - [`u8::to_ne_bytes`]
3114 - [`u8::from_be_bytes`]
3115 - [`u8::from_le_bytes`]
3116 - [`u8::from_ne_bytes`]
3117 - [`u16::to_be_bytes`]
3118 - [`u16::to_le_bytes`]
3119 - [`u16::to_ne_bytes`]
3120 - [`u16::from_be_bytes`]
3121 - [`u16::from_le_bytes`]
3122 - [`u16::from_ne_bytes`]
3123 - [`u32::to_be_bytes`]
3124 - [`u32::to_le_bytes`]
3125 - [`u32::to_ne_bytes`]
3126 - [`u32::from_be_bytes`]
3127 - [`u32::from_le_bytes`]
3128 - [`u32::from_ne_bytes`]
3129 - [`u64::to_be_bytes`]
3130 - [`u64::to_le_bytes`]
3131 - [`u64::to_ne_bytes`]
3132 - [`u64::from_be_bytes`]
3133 - [`u64::from_le_bytes`]
3134 - [`u64::from_ne_bytes`]
3135 - [`u128::to_be_bytes`]
3136 - [`u128::to_le_bytes`]
3137 - [`u128::to_ne_bytes`]
3138 - [`u128::from_be_bytes`]
3139 - [`u128::from_le_bytes`]
3140 - [`u128::from_ne_bytes`]
3141 - [`usize::to_be_bytes`]
3142 - [`usize::to_le_bytes`]
3143 - [`usize::to_ne_bytes`]
3144 - [`usize::from_be_bytes`]
3145 - [`usize::from_le_bytes`]
3146 - [`usize::from_ne_bytes`]
3147
3148 Cargo
3149 -----
3150 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3151 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3152
3153 Misc
3154 ----
3155 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3156
3157 Compatibility Notes
3158 -------------------
3159 - [The argument types for AVX's
3160   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3161   been changed from `*const` to `*mut` as the previous implementation
3162   was unsound.
3163
3164
3165 [55148]: https://github.com/rust-lang/rust/pull/55148/
3166 [55238]: https://github.com/rust-lang/rust/pull/55238/
3167 [55280]: https://github.com/rust-lang/rust/pull/55280/
3168 [55610]: https://github.com/rust-lang/rust/pull/55610/
3169 [55663]: https://github.com/rust-lang/rust/pull/55663/
3170 [55702]: https://github.com/rust-lang/rust/pull/55702/
3171 [55837]: https://github.com/rust-lang/rust/pull/55837/
3172 [55843]: https://github.com/rust-lang/rust/pull/55843/
3173 [56072]: https://github.com/rust-lang/rust/pull/56072/
3174 [56245]: https://github.com/rust-lang/rust/pull/56245/
3175 [56365]: https://github.com/rust-lang/rust/pull/56365/
3176 [56366]: https://github.com/rust-lang/rust/pull/56366/
3177 [56395]: https://github.com/rust-lang/rust/pull/56395/
3178 [56759]: https://github.com/rust-lang/rust/pull/56759/
3179 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3180 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3181 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3182 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3183 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3184 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3185 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3186 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3187 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3188 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3189 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3190 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3191 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3192 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3193 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3194 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3195 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3196 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3197 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3198 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3199 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3200 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3201 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3202 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3203 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3204 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3205 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3206 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3207 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3208 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3209 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3210 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3211 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3212 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3213 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3214 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3215 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3216 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3217 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3218 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3219 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3220 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3221 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3222 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3223 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3224 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3225 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3226 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3227 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3228 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3229 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3230 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3231 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3232 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3233 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3234 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3235 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3236 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3237 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3238 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3239 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3240 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3241 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3242 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3243 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3244 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3245 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3246 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3247 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3248 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3249 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3250 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3251 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3252 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3253 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3254 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3255 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3256 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3257 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3258 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3259 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3260 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3261 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3262 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3263 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3264 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3265 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3266 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3267 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3268 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3269 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3270 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3271 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3272
3273
3274 Version 1.31.1 (2018-12-20)
3275 ===========================
3276
3277 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3278 - [Fix broken go-to-definition in RLS][rls/1171]
3279 - [Fix infinite loop on hover in RLS][rls/1170]
3280
3281 [56562]: https://github.com/rust-lang/rust/pull/56562
3282 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3283 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3284
3285 Version 1.31.0 (2018-12-06)
3286 ==========================
3287
3288 Language
3289 --------
3290 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3291 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3292   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3293   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3294   in structs.
3295 - [You can now define and use `const` functions.][54835] These are currently
3296   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3297   [language reference][const-reference] for what exactly is available.
3298 - [You can now use tool lints, which allow you to scope lints from external
3299   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3300 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3301   a crate, not just in exported functions.][54451]
3302 - [You can now use parentheses in pattern matches.][54497]
3303
3304 Compiler
3305 --------
3306 - [Updated musl to 1.1.20][54430]
3307
3308 Libraries
3309 ---------
3310 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3311   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3312 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3313   into `Option<&mut T>` using the `From` trait.][53218]
3314 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3315
3316
3317 Stabilized APIs
3318 ---------------
3319 - [`slice::align_to`]
3320 - [`slice::align_to_mut`]
3321 - [`slice::chunks_exact`]
3322 - [`slice::chunks_exact_mut`]
3323 - [`slice::rchunks`]
3324 - [`slice::rchunks_mut`]
3325 - [`slice::rchunks_exact`]
3326 - [`slice::rchunks_exact_mut`]
3327 - [`Option::replace`]
3328
3329 Cargo
3330 -----
3331 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3332 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3333   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3334
3335 [52813]: https://github.com/rust-lang/rust/pull/52813/
3336 [53218]: https://github.com/rust-lang/rust/pull/53218/
3337 [53555]: https://github.com/rust-lang/rust/issues/53555/
3338 [54057]: https://github.com/rust-lang/rust/pull/54057/
3339 [54240]: https://github.com/rust-lang/rust/pull/54240/
3340 [54430]: https://github.com/rust-lang/rust/pull/54430/
3341 [54451]: https://github.com/rust-lang/rust/pull/54451/
3342 [54497]: https://github.com/rust-lang/rust/pull/54497/
3343 [54778]: https://github.com/rust-lang/rust/pull/54778/
3344 [54835]: https://github.com/rust-lang/rust/pull/54835/
3345 [54870]: https://github.com/rust-lang/rust/pull/54870/
3346 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3347 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3348 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3349 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3350 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3351 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3352 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3353 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3354 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3355 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3356 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3357 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3358 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3359 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3360
3361 Version 1.30.1 (2018-11-08)
3362 ===========================
3363
3364 - [Fixed overflow ICE in rustdoc][54199]
3365 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3366
3367 [54199]: https://github.com/rust-lang/rust/pull/54199
3368 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3369
3370 Version 1.30.0 (2018-10-25)
3371 ==========================
3372
3373 Language
3374 --------
3375 - [Procedural macros are now available.][52081] These kinds of macros allow for
3376   more powerful code generation. There is a [new chapter available][proc-macros]
3377   in the Rust Programming Language book that goes further in depth.
3378 - [You can now use keywords as identifiers using the raw identifiers
3379   syntax (`r#`),][53236] e.g. `let r#for = true;`
3380 - [Using anonymous parameters in traits is now deprecated with a warning and
3381   will be a hard error in the 2018 edition.][53272]
3382 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3383   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3384 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3385   Previously, using a external crate in a module without a use statement
3386   required `let json = ::serde_json::from_str(foo);` but can now be written
3387   as `let json = serde_json::from_str(foo);`.
3388 - [You can now apply the `#[used]` attribute to static items to prevent the
3389   compiler from optimising them away, even if they appear to be unused,][51363]
3390   e.g. `#[used] static FOO: u32 = 1;`
3391 - [You can now import and reexport macros from other crates with the `use`
3392   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3393   the root module of the crate. If your macro relies on calling other local
3394   macros, it is recommended to export with the
3395   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3396   those macros.
3397 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3398   using the `vis` specifier.][53370]
3399 - [Non-macro attributes now allow all forms of literals, not just
3400   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3401   write `#[attr(true)]`.
3402 - [You can now specify a function to handle a panic in the Rust runtime with the
3403   `#[panic_handler]` attribute.][51366]
3404
3405 Compiler
3406 --------
3407 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3408 - [Added the `aarch64-unknown-netbsd` target][53165]
3409 - [Upgraded to LLVM 8.][53611]
3410
3411 Libraries
3412 ---------
3413 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3414
3415 Stabilized APIs
3416 ---------------
3417 - [`Ipv4Addr::BROADCAST`]
3418 - [`Ipv4Addr::LOCALHOST`]
3419 - [`Ipv4Addr::UNSPECIFIED`]
3420 - [`Ipv6Addr::LOCALHOST`]
3421 - [`Ipv6Addr::UNSPECIFIED`]
3422 - [`Iterator::find_map`]
3423
3424   The following methods are replacement methods for `trim_left`, `trim_right`,
3425   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3426   in 1.33.0:
3427 - [`str::trim_end_matches`]
3428 - [`str::trim_end`]
3429 - [`str::trim_start_matches`]
3430 - [`str::trim_start`]
3431
3432 Cargo
3433 ----
3434 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3435 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3436   equivalent to calling `rustdoc --error-format=json`.
3437 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3438
3439 Misc
3440 ----
3441 - [`rustdoc` allows you to specify what edition to treat your code as with the
3442   `--edition` option.][54057]
3443 - [`rustdoc` now has the `--color` (specify whether to output color) and
3444   `--error-format` (specify error format, e.g. `json`) options.][53003]
3445 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3446   debug symbols.][53774]
3447 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3448   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3449
3450 [50911]: https://github.com/rust-lang/rust/pull/50911/
3451 [51363]: https://github.com/rust-lang/rust/pull/51363/
3452 [51366]: https://github.com/rust-lang/rust/pull/51366/
3453 [52081]: https://github.com/rust-lang/rust/pull/52081/
3454 [53003]: https://github.com/rust-lang/rust/pull/53003/
3455 [53033]: https://github.com/rust-lang/rust/pull/53033/
3456 [53044]: https://github.com/rust-lang/rust/pull/53044/
3457 [53165]: https://github.com/rust-lang/rust/pull/53165/
3458 [53611]: https://github.com/rust-lang/rust/pull/53611/
3459 [53213]: https://github.com/rust-lang/rust/pull/53213/
3460 [53236]: https://github.com/rust-lang/rust/pull/53236/
3461 [53272]: https://github.com/rust-lang/rust/pull/53272/
3462 [53370]: https://github.com/rust-lang/rust/pull/53370/
3463 [53459]: https://github.com/rust-lang/rust/pull/53459/
3464 [53774]: https://github.com/rust-lang/rust/pull/53774/
3465 [53822]: https://github.com/rust-lang/rust/pull/53822/
3466 [54057]: https://github.com/rust-lang/rust/pull/54057/
3467 [54146]: https://github.com/rust-lang/rust/pull/54146/
3468 [54404]: https://github.com/rust-lang/rust/pull/54404/
3469 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3470 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3471 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3472 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3473
3474 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3475 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3476 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3477 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3478 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3479 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3480 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3481 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3482 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3483 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3484
3485
3486 Version 1.29.2 (2018-10-11)
3487 ===========================
3488
3489 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3490 - The `rls-preview` component on the windows-gnu targets has been restored.
3491
3492 [54639]: https://github.com/rust-lang/rust/pull/54639
3493
3494
3495 Version 1.29.1 (2018-09-25)
3496 ===========================
3497
3498 Security Notes
3499 --------------
3500
3501 - The standard library's `str::repeat` function contained an out of bounds write
3502   caused by an integer overflow. This has been fixed by deterministically
3503   panicking when an overflow happens.
3504
3505   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3506   us.
3507
3508
3509 Version 1.29.0 (2018-09-13)
3510 ==========================
3511
3512 Compiler
3513 --------
3514 - [Bumped minimum LLVM version to 5.0.][51899]
3515 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3516 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3517 - [Upgraded to LLVM 7.][51966]
3518
3519 Libraries
3520 ---------
3521 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3522 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3523 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3524 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3525   for `&str`.][51178]
3526 - [`Cell<T>` now allows `T` to be unsized.][50494]
3527 - [`SocketAddr` is now stable on Redox.][52656]
3528
3529 Stabilized APIs
3530 ---------------
3531 - [`Arc::downcast`]
3532 - [`Iterator::flatten`]
3533 - [`Rc::downcast`]
3534
3535 Cargo
3536 -----
3537 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3538   `--locked` to disable this behavior.
3539 - [`cargo-install` will now allow you to cross compile an install
3540   using `--target`.][cargo/5614]
3541 - [Added the `cargo-fix` subcommand to automatically move project code from
3542   2015 edition to 2018.][cargo/5723]
3543 - [`cargo doc` can now optionally document private types using the
3544   `--document-private-items` flag.][cargo/5543]
3545
3546 Misc
3547 ----
3548 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3549   the specified level to that level.][52354] For example `--cap-lints warn`
3550   will demote `deny` and `forbid` lints to `warn`.
3551 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3552   fails and `101` if there is a panic.][52197]
3553 - [A preview of clippy has been made available through rustup.][51122]
3554   You can install the preview with `rustup component add clippy-preview`.
3555
3556 Compatibility Notes
3557 -------------------
3558 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3559   Use `str::get_unchecked(begin..end)` instead.
3560 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3561   Consider using the `home_dir` function from
3562   https://crates.io/crates/dirs instead.
3563 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3564 - [`cfg` attributes and `--cfg` command line flags are now more
3565   strictly validated.][53893]
3566
3567 [53893]: https://github.com/rust-lang/rust/pull/53893/
3568 [52861]: https://github.com/rust-lang/rust/pull/52861/
3569 [51966]: https://github.com/rust-lang/rust/pull/51966/
3570 [52656]: https://github.com/rust-lang/rust/pull/52656/
3571 [52239]: https://github.com/rust-lang/rust/pull/52239/
3572 [52330]: https://github.com/rust-lang/rust/pull/52330/
3573 [52354]: https://github.com/rust-lang/rust/pull/52354/
3574 [52402]: https://github.com/rust-lang/rust/pull/52402/
3575 [52103]: https://github.com/rust-lang/rust/pull/52103/
3576 [52197]: https://github.com/rust-lang/rust/pull/52197/
3577 [51807]: https://github.com/rust-lang/rust/pull/51807/
3578 [51899]: https://github.com/rust-lang/rust/pull/51899/
3579 [51912]: https://github.com/rust-lang/rust/pull/51912/
3580 [51511]: https://github.com/rust-lang/rust/pull/51511/
3581 [51619]: https://github.com/rust-lang/rust/pull/51619/
3582 [51656]: https://github.com/rust-lang/rust/pull/51656/
3583 [51178]: https://github.com/rust-lang/rust/pull/51178/
3584 [51122]: https://github.com/rust-lang/rust/pull/51122
3585 [50494]: https://github.com/rust-lang/rust/pull/50494/
3586 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3587 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3588 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3589 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3590 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3591 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3592 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3593
3594
3595 Version 1.28.0 (2018-08-02)
3596 ===========================
3597
3598 Language
3599 --------
3600 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3601   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3602   the inner type across Foreign Function Interface (FFI) boundaries.
3603 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3604   and can now be used as identifiers.][51196]
3605 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3606   stable.][51241] This will allow users to specify a global allocator for
3607   their program.
3608 - [Unit test functions marked with the `#[test]` attribute can now return
3609   `Result<(), E: Debug>` in addition to `()`.][51298]
3610 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3611   allows macros to easily target lifetimes.
3612
3613 Compiler
3614 --------
3615 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3616   prioritise making smaller binary sizes. `z` is the same as `s` with the
3617   exception that it does not vectorise loops, which typically results in an even
3618   smaller binary.
3619 - [The short error format is now stable.][49546] Specified with
3620   `--error-format=short` this option will provide a more compressed output of
3621   rust error messages.
3622 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3623 - [Reduced the number of allocations in the macro parser.][50855] This can
3624   improve compile times of macro heavy crates on average by 5%.
3625
3626 Libraries
3627 ---------
3628 - [Implemented `Default` for `&mut str`.][51306]
3629 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3630 - [Implemented `Extend` for `()`.][50234]
3631 - [The `Debug` implementation of `time::Duration` should now be more easily
3632   human readable.][50364] Previously a `Duration` of one second would printed as
3633   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3634 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3635   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3636   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3637   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3638   for `PathBuf`.][50170]
3639 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3640   and `Wrapping<i128>`.][50465]
3641 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3642   possible.][51050] This can provide up to a 40% speed increase.
3643 - [Improved error messages when using `format!`.][50610]
3644
3645 Stabilized APIs
3646 ---------------
3647 - [`Iterator::step_by`]
3648 - [`Path::ancestors`]
3649 - [`SystemTime::UNIX_EPOCH`]
3650 - [`alloc::GlobalAlloc`]
3651 - [`alloc::Layout`]
3652 - [`alloc::LayoutErr`]
3653 - [`alloc::System`]
3654 - [`alloc::alloc`]
3655 - [`alloc::alloc_zeroed`]
3656 - [`alloc::dealloc`]
3657 - [`alloc::realloc`]
3658 - [`alloc::handle_alloc_error`]
3659 - [`btree_map::Entry::or_default`]
3660 - [`fmt::Alignment`]
3661 - [`hash_map::Entry::or_default`]
3662 - [`iter::repeat_with`]
3663 - [`num::NonZeroUsize`]
3664 - [`num::NonZeroU128`]
3665 - [`num::NonZeroU16`]
3666 - [`num::NonZeroU32`]
3667 - [`num::NonZeroU64`]
3668 - [`num::NonZeroU8`]
3669 - [`ops::RangeBounds`]
3670 - [`slice::SliceIndex`]
3671 - [`slice::from_mut`]
3672 - [`slice::from_ref`]
3673 - [`{Any + Send + Sync}::downcast_mut`]
3674 - [`{Any + Send + Sync}::downcast_ref`]
3675 - [`{Any + Send + Sync}::is`]
3676
3677 Cargo
3678 -----
3679 - [Cargo will now no longer allow you to publish crates with build scripts that
3680   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3681   considered to be immutable.
3682
3683 Misc
3684 ----
3685 - [The `suggestion_applicability` field in `rustc`'s json output is now
3686   stable.][50486] This will allow dev tools to check whether a code suggestion
3687   would apply to them.
3688
3689 Compatibility Notes
3690 -------------------
3691 - [Rust will consider trait objects with duplicated constraints to be the same
3692   type as without the duplicated constraint.][51276] For example the below code will
3693   now fail to compile.
3694   ```rust
3695   trait Trait {}
3696
3697   impl Trait + Send {
3698       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3699   }
3700
3701   impl Trait + Send + Send {
3702       fn test(&self) { println!("two"); }
3703   }
3704   ```
3705
3706 [49546]: https://github.com/rust-lang/rust/pull/49546/
3707 [50143]: https://github.com/rust-lang/rust/pull/50143/
3708 [50170]: https://github.com/rust-lang/rust/pull/50170/
3709 [50234]: https://github.com/rust-lang/rust/pull/50234/
3710 [50265]: https://github.com/rust-lang/rust/pull/50265/
3711 [50364]: https://github.com/rust-lang/rust/pull/50364/
3712 [50385]: https://github.com/rust-lang/rust/pull/50385/
3713 [50465]: https://github.com/rust-lang/rust/pull/50465/
3714 [50486]: https://github.com/rust-lang/rust/pull/50486/
3715 [50554]: https://github.com/rust-lang/rust/pull/50554/
3716 [50610]: https://github.com/rust-lang/rust/pull/50610/
3717 [50855]: https://github.com/rust-lang/rust/pull/50855/
3718 [51050]: https://github.com/rust-lang/rust/pull/51050/
3719 [51196]: https://github.com/rust-lang/rust/pull/51196/
3720 [51200]: https://github.com/rust-lang/rust/pull/51200/
3721 [51241]: https://github.com/rust-lang/rust/pull/51241/
3722 [51276]: https://github.com/rust-lang/rust/pull/51276/
3723 [51298]: https://github.com/rust-lang/rust/pull/51298/
3724 [51306]: https://github.com/rust-lang/rust/pull/51306/
3725 [51562]: https://github.com/rust-lang/rust/pull/51562/
3726 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3727 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3728 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3729 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3730 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3731 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3732 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3733 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3734 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3735 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3736 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3737 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3738 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3739 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3740 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3741 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3742 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3743 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3744 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3745 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3746 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3747 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3748 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3749 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3750 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3751 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3752 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3753 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3754 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3755 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3756
3757 Version 1.27.2 (2018-07-20)
3758 ===========================
3759
3760 Compatibility Notes
3761 -------------------
3762
3763 - The borrow checker was fixed to avoid potential unsoundness when using
3764   match ergonomics: [#52213][52213].
3765
3766 [52213]: https://github.com/rust-lang/rust/issues/52213
3767
3768 Version 1.27.1 (2018-07-10)
3769 ===========================
3770
3771 Security Notes
3772 --------------
3773
3774 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3775   when running, which enabled executing code as some other user on a
3776   given machine. This release fixes that vulnerability; you can read
3777   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3778
3779   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3780
3781 Compatibility Notes
3782 -------------------
3783
3784 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3785   match ergonomics: [#51415][51415], [#49534][49534].
3786
3787 [51415]: https://github.com/rust-lang/rust/issues/51415
3788 [49534]: https://github.com/rust-lang/rust/issues/49534
3789 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3790 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3791
3792 Version 1.27.0 (2018-06-21)
3793 ==========================
3794
3795 Language
3796 --------
3797 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3798   be used as an identifier.
3799 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3800   bare `Trait` syntax, and should make it clearer when being used in tandem with
3801   `impl Trait` because it is equivalent to the following syntax:
3802   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3803   `Box<Trait> == Box<dyn Trait>`.
3804 - [Attributes on generic parameters such as types and lifetimes are
3805   now stable.][48851] e.g.
3806   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3807 - [The `#[must_use]` attribute can now also be used on functions as well as
3808   types.][48925] It provides a lint that by default warns users when the
3809   value returned by a function has not been used.
3810
3811 Compiler
3812 --------
3813 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3814
3815 Libraries
3816 ---------
3817 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3818   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3819   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3820   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3821   the `cfg` attribute.
3822 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3823   std are now available in core.][49896]
3824 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3825   to `Self`.][49630]
3826 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3827   that the operation isn't done in place.
3828 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3829   the `#[must_use]` attribute][49533] to warn about unused potentially
3830   expensive allocations.
3831
3832 Stabilized APIs
3833 ---------------
3834 - [`DoubleEndedIterator::rfind`]
3835 - [`DoubleEndedIterator::rfold`]
3836 - [`DoubleEndedIterator::try_rfold`]
3837 - [`Duration::from_micros`]
3838 - [`Duration::from_nanos`]
3839 - [`Duration::subsec_micros`]
3840 - [`Duration::subsec_millis`]
3841 - [`HashMap::remove_entry`]
3842 - [`Iterator::try_fold`]
3843 - [`Iterator::try_for_each`]
3844 - [`NonNull::cast`]
3845 - [`Option::filter`]
3846 - [`String::replace_range`]
3847 - [`Take::set_limit`]
3848 - [`hint::unreachable_unchecked`]
3849 - [`os::unix::process::parent_id`]
3850 - [`ptr::swap_nonoverlapping`]
3851 - [`slice::rsplit_mut`]
3852 - [`slice::rsplit`]
3853 - [`slice::swap_with_slice`]
3854
3855 Cargo
3856 -----
3857 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3858   `readme`, and `repository` fields.][cargo/5386]
3859 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3860 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3861   a different directory than `target` for placing compilation artifacts.
3862 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3863   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3864   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3865   where cargo would infer a binary, Cargo will produce a warning. You can
3866   disable this feature ahead of time by setting any of the following to false:
3867   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3868 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3869   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3870
3871 Misc
3872 ----
3873 - [Added “The Rustc book” into the official documentation.][49707]
3874   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3875 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3876
3877 Compatibility Notes
3878 -------------------
3879 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3880   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3881   compile, `"".is_empty()` will still compile.
3882 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3883   will only print the inner type.][48553] E.g.
3884   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3885   not `AtomicBool(true)`.
3886 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3887   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3888   alignment should cover all use cases.
3889 - The `.description()` method on the `std::error::Error` trait
3890   [has been soft-deprecated][50163]. It is no longer required to implement it.
3891
3892 [48553]: https://github.com/rust-lang/rust/pull/48553/
3893 [48851]: https://github.com/rust-lang/rust/pull/48851/
3894 [48925]: https://github.com/rust-lang/rust/pull/48925/
3895 [49533]: https://github.com/rust-lang/rust/pull/49533/
3896 [49623]: https://github.com/rust-lang/rust/pull/49623/
3897 [49630]: https://github.com/rust-lang/rust/pull/49630/
3898 [49664]: https://github.com/rust-lang/rust/pull/49664/
3899 [49699]: https://github.com/rust-lang/rust/pull/49699/
3900 [49707]: https://github.com/rust-lang/rust/pull/49707/
3901 [49719]: https://github.com/rust-lang/rust/pull/49719/
3902 [49896]: https://github.com/rust-lang/rust/pull/49896/
3903 [49968]: https://github.com/rust-lang/rust/pull/49968/
3904 [50163]: https://github.com/rust-lang/rust/pull/50163
3905 [50177]: https://github.com/rust-lang/rust/pull/50177/
3906 [50378]: https://github.com/rust-lang/rust/pull/50378/
3907 [50398]: https://github.com/rust-lang/rust/pull/50398/
3908 [50423]: https://github.com/rust-lang/rust/pull/50423/
3909 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3910 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3911 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3912 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3913 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3914 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3915 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3916 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3917 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3918 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3919 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3920 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3921 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3922 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3923 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3924 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3925 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3926 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3927 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3928 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3929 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3930 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3931 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3932 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3933 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3934 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3935 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3936 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3937 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3938 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3939
3940
3941 Version 1.26.2 (2018-06-05)
3942 ==========================
3943
3944 Compatibility Notes
3945 -------------------
3946
3947 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3948
3949 [51117]: https://github.com/rust-lang/rust/issues/51117
3950
3951
3952 Version 1.26.1 (2018-05-29)
3953 ==========================
3954
3955 Tools
3956 -----
3957
3958 - [RLS now works on Windows.][50646]
3959 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3960
3961
3962 Compatibility Notes
3963 --------
3964
3965 - [`fn main() -> impl Trait` no longer works for non-Termination
3966   trait.][50656]
3967   This reverts an accidental stabilization.
3968 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3969 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3970
3971 [50646]: https://github.com/rust-lang/rust/issues/50646
3972 [50656]: https://github.com/rust-lang/rust/pull/50656
3973 [50812]: https://github.com/rust-lang/rust/pull/50812
3974 [50950]: https://github.com/rust-lang/rust/issues/50950
3975 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3976
3977 Version 1.26.0 (2018-05-10)
3978 ==========================
3979
3980 Language
3981 --------
3982 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3983   implement either or both traits.][49299]
3984 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3985 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3986   lifetime can be elided.][49458]
3987 - [`impl Trait` is now stable allowing you to have abstract types in returns
3988    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3989   `fn open(path: impl AsRef<Path>)`.
3990 - [Pattern matching will now automatically apply dereferences.][49394]
3991 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3992 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3993 - [A lot of operations are now available in a const context.][46882] E.g. You
3994   can now index into constant arrays, reference and dereference into constants,
3995   and use tuple struct constructors.
3996 - [Fixed entry slice patterns are now stable.][48516] E.g.
3997   ```rust
3998   let points = [1, 2, 3, 4];
3999   match points {
4000       [1, 2, 3, 4] => println!("All points were sequential."),
4001       _ => println!("Not all points were sequential."),
4002   }
4003   ```
4004
4005
4006 Compiler
4007 --------
4008 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4009 - [Fixed exponential projection complexity on nested types.][48296]
4010   This can provide up to a ~12% reduction in compile times for certain crates.
4011 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4012   to remap path prefixes outputted by the compiler.
4013 - [Added `powerpc-unknown-netbsd` target.][48281]
4014
4015 Libraries
4016 ---------
4017 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4018 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4019   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4020 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4021 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4022 - [`ascii::escape_default` is now available in libcore.][48735]
4023 - [Trailing commas are now supported in std and core macros.][48056]
4024 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4025 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4026
4027 Stabilized APIs
4028 ---------------
4029 - [`*const T::add`]
4030 - [`*const T::copy_to_nonoverlapping`]
4031 - [`*const T::copy_to`]
4032 - [`*const T::read_unaligned`]
4033 - [`*const T::read_volatile`]
4034 - [`*const T::read`]
4035 - [`*const T::sub`]
4036 - [`*const T::wrapping_add`]
4037 - [`*const T::wrapping_sub`]
4038 - [`*mut T::add`]
4039 - [`*mut T::copy_to_nonoverlapping`]
4040 - [`*mut T::copy_to`]
4041 - [`*mut T::read_unaligned`]
4042 - [`*mut T::read_volatile`]
4043 - [`*mut T::read`]
4044 - [`*mut T::replace`]
4045 - [`*mut T::sub`]
4046 - [`*mut T::swap`]
4047 - [`*mut T::wrapping_add`]
4048 - [`*mut T::wrapping_sub`]
4049 - [`*mut T::write_bytes`]
4050 - [`*mut T::write_unaligned`]
4051 - [`*mut T::write_volatile`]
4052 - [`*mut T::write`]
4053 - [`Box::leak`]
4054 - [`FromUtf8Error::as_bytes`]
4055 - [`LocalKey::try_with`]
4056 - [`Option::cloned`]
4057 - [`btree_map::Entry::and_modify`]
4058 - [`fs::read_to_string`]
4059 - [`fs::read`]
4060 - [`fs::write`]
4061 - [`hash_map::Entry::and_modify`]
4062 - [`iter::FusedIterator`]
4063 - [`ops::RangeInclusive`]
4064 - [`ops::RangeToInclusive`]
4065 - [`process::id`]
4066 - [`slice::rotate_left`]
4067 - [`slice::rotate_right`]
4068 - [`String::retain`]
4069
4070
4071 Cargo
4072 -----
4073 - [Cargo will now output path to custom commands when `-v` is
4074   passed with `--list`][cargo/5041]
4075 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4076
4077 Misc
4078 ----
4079 - [The second edition of "The Rust Programming Language" book is now recommended
4080   over the first.][48404]
4081
4082 Compatibility Notes
4083 -------------------
4084
4085 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4086   syntax is now invalid.
4087   ```
4088   use std::ops::Fn as dyn;
4089   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4090   ```
4091 - [The result of dereferences are no longer promoted to `'static`.][47408]
4092   e.g.
4093   ```rust
4094   fn main() {
4095       const PAIR: &(i32, i32) = &(0, 1);
4096       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4097   }
4098   ```
4099 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4100 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4101   an error.][48235]
4102 - [Removed hoedown from rustdoc.][48274]
4103 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4104
4105 [46882]: https://github.com/rust-lang/rust/pull/46882
4106 [47379]: https://github.com/rust-lang/rust/pull/47379
4107 [47408]: https://github.com/rust-lang/rust/pull/47408
4108 [47813]: https://github.com/rust-lang/rust/pull/47813
4109 [48056]: https://github.com/rust-lang/rust/pull/48056
4110 [48125]: https://github.com/rust-lang/rust/pull/48125
4111 [48166]: https://github.com/rust-lang/rust/pull/48166
4112 [48235]: https://github.com/rust-lang/rust/pull/48235
4113 [48274]: https://github.com/rust-lang/rust/pull/48274
4114 [48281]: https://github.com/rust-lang/rust/pull/48281
4115 [48296]: https://github.com/rust-lang/rust/pull/48296
4116 [48326]: https://github.com/rust-lang/rust/pull/48326
4117 [48359]: https://github.com/rust-lang/rust/pull/48359
4118 [48404]: https://github.com/rust-lang/rust/pull/48404
4119 [48481]: https://github.com/rust-lang/rust/pull/48481
4120 [48516]: https://github.com/rust-lang/rust/pull/48516
4121 [48628]: https://github.com/rust-lang/rust/pull/48628
4122 [48629]: https://github.com/rust-lang/rust/pull/48629
4123 [48657]: https://github.com/rust-lang/rust/pull/48657
4124 [48735]: https://github.com/rust-lang/rust/pull/48735
4125 [48978]: https://github.com/rust-lang/rust/pull/48978
4126 [49101]: https://github.com/rust-lang/rust/pull/49101
4127 [49109]: https://github.com/rust-lang/rust/pull/49109
4128 [49121]: https://github.com/rust-lang/rust/pull/49121
4129 [49162]: https://github.com/rust-lang/rust/pull/49162
4130 [49184]: https://github.com/rust-lang/rust/pull/49184
4131 [49234]: https://github.com/rust-lang/rust/pull/49234
4132 [49255]: https://github.com/rust-lang/rust/pull/49255
4133 [49299]: https://github.com/rust-lang/rust/pull/49299
4134 [49305]: https://github.com/rust-lang/rust/pull/49305
4135 [49394]: https://github.com/rust-lang/rust/pull/49394
4136 [49458]: https://github.com/rust-lang/rust/pull/49458
4137 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4138 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4139 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4140 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4141 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4142 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4143 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4144 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4145 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4146 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4147 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4148 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4149 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4150 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4151 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4152 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4153 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4154 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4155 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4156 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4157 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4158 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4159 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4160 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4161 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4162 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4163 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4164 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4165 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4166 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4167 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4168 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4169 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4170 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4171 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4172 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4173 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4174 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4175 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4176 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4177 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4178 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4179
4180
4181 Version 1.25.0 (2018-03-29)
4182 ==========================
4183
4184 Language
4185 --------
4186 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4187 - [You can now use nested groups of imports.][47948]
4188   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4189 - [You can now have `|` at the start of a match arm.][47947] e.g.
4190 ```rust
4191 enum Foo { A, B, C }
4192
4193 fn main() {
4194     let x = Foo::A;
4195     match x {
4196         | Foo::A
4197         | Foo::B => println!("AB"),
4198         | Foo::C => println!("C"),
4199     }
4200 }
4201 ```
4202
4203 Compiler
4204 --------
4205 - [Upgraded to LLVM 6.][47828]
4206 - [Added `-C lto=val` option.][47521]
4207 - [Added `i586-unknown-linux-musl` target][47282]
4208
4209 Libraries
4210 ---------
4211 - [Impl Send for `process::Command` on Unix.][47760]
4212 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4213 - [`UnsafeCell::into_inner` is now safe.][47204]
4214 - [Implement libstd for CloudABI.][47268]
4215 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4216 - [Implement `AsRef<Path>` for Component][46985]
4217 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4218 - [Moved `Duration` to libcore.][46666]
4219
4220 Stabilized APIs
4221 ---------------
4222 - [`Location::column`]
4223 - [`ptr::NonNull`]
4224
4225 The following functions can now be used in a constant expression.
4226 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4227 - [`Duration::new`][47300]
4228 - [`Duration::from_secs`][47300]
4229 - [`Duration::from_millis`][47300]
4230
4231 Cargo
4232 -----
4233 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4234 - [`cargo new` now defaults to creating a binary crate, instead of a
4235   library crate.][cargo/5029]
4236
4237 Misc
4238 ----
4239 - [Rust by example is now shipped with new releases][46196]
4240
4241 Compatibility Notes
4242 -------------------
4243 - [Deprecated `net::lookup_host`.][47510]
4244 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4245 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4246   around indexing operations (see [#47349][47349]). This has been fixed (which also
4247   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4248 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4249
4250 [33903]: https://github.com/rust-lang/rust/pull/33903
4251 [47947]: https://github.com/rust-lang/rust/pull/47947
4252 [47948]: https://github.com/rust-lang/rust/pull/47948
4253 [47760]: https://github.com/rust-lang/rust/pull/47760
4254 [47790]: https://github.com/rust-lang/rust/pull/47790
4255 [47828]: https://github.com/rust-lang/rust/pull/47828
4256 [47398]: https://github.com/rust-lang/rust/pull/47398
4257 [47510]: https://github.com/rust-lang/rust/pull/47510
4258 [47521]: https://github.com/rust-lang/rust/pull/47521
4259 [47204]: https://github.com/rust-lang/rust/pull/47204
4260 [47251]: https://github.com/rust-lang/rust/pull/47251
4261 [47268]: https://github.com/rust-lang/rust/pull/47268
4262 [47282]: https://github.com/rust-lang/rust/pull/47282
4263 [47300]: https://github.com/rust-lang/rust/pull/47300
4264 [47349]: https://github.com/rust-lang/rust/pull/47349
4265 [46931]: https://github.com/rust-lang/rust/pull/46931
4266 [46985]: https://github.com/rust-lang/rust/pull/46985
4267 [47006]: https://github.com/rust-lang/rust/pull/47006
4268 [46830]: https://github.com/rust-lang/rust/pull/46830
4269 [46095]: https://github.com/rust-lang/rust/pull/46095
4270 [46666]: https://github.com/rust-lang/rust/pull/46666
4271 [46196]: https://github.com/rust-lang/rust/pull/46196
4272 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4273 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4274 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4275 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4276 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4277
4278
4279 Version 1.24.1 (2018-03-01)
4280 ==========================
4281
4282  - [Do not abort when unwinding through FFI][48251]
4283  - [Emit UTF-16 files for linker arguments on Windows][48318]
4284  - [Make the error index generator work again][48308]
4285  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4286
4287 [48251]: https://github.com/rust-lang/rust/issues/48251
4288 [48308]: https://github.com/rust-lang/rust/issues/48308
4289 [48318]: https://github.com/rust-lang/rust/issues/48318
4290 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4291
4292
4293 Version 1.24.0 (2018-02-15)
4294 ==========================
4295
4296 Language
4297 --------
4298 - [External `sysv64` ffi is now available.][46528]
4299   eg. `extern "sysv64" fn foo () {}`
4300
4301 Compiler
4302 --------
4303 - [rustc now uses 16 codegen units by default for release builds.][46910]
4304   For the fastest builds, utilize `codegen-units=1`.
4305 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4306 - [Add `aarch64-unknown-openbsd` support][46760]
4307
4308 Libraries
4309 ---------
4310 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4311   improvement in performance in the majority of cases.
4312 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4313   with Windows.][46798]
4314 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4315 - [impl `From<bool>` for `AtomicBool`][46293]
4316 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4317 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4318 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4319 - [float::from_bits now just uses transmute.][46012] This provides
4320   some optimisations from LLVM.
4321 - [Copied `AsciiExt` methods onto `char`][46077]
4322 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4323 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4324 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4325 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4326
4327 Stabilized APIs
4328 ---------------
4329 - [`RefCell::replace`]
4330 - [`RefCell::swap`]
4331 - [`atomic::spin_loop_hint`]
4332
4333 The following functions can now be used in a constant expression.
4334 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4335
4336 - [`AtomicBool::new`][46287]
4337 - [`AtomicUsize::new`][46287]
4338 - [`AtomicIsize::new`][46287]
4339 - [`AtomicPtr::new`][46287]
4340 - [`Cell::new`][46287]
4341 - [`{integer}::min_value`][46287]
4342 - [`{integer}::max_value`][46287]
4343 - [`mem::size_of`][46287]
4344 - [`mem::align_of`][46287]
4345 - [`ptr::null`][46287]
4346 - [`ptr::null_mut`][46287]
4347 - [`RefCell::new`][46287]
4348 - [`UnsafeCell::new`][46287]
4349
4350 Cargo
4351 -----
4352 - [Added a `workspace.default-members` config that
4353   overrides implied `--all` in virtual workspaces.][cargo/4743]
4354 - [Enable incremental by default on development builds.][cargo/4817] Also added
4355   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4356   per-project or global basis respectively.
4357
4358 Misc
4359 ----
4360
4361 Compatibility Notes
4362 -------------------
4363 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4364 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4365   in accordance with IETF RFC 4291 §2.2.
4366 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4367 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4368   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4369 - [Leading zeros in tuple struct members is now an error][47084]
4370 - [`column!()` macro is one-based instead of zero-based][46977]
4371 - [`fmt::Arguments` can no longer be shared across threads][45198]
4372 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4373 - [Cargo sets a different working directory for the compiler][cargo/4788]
4374
4375 [44884]: https://github.com/rust-lang/rust/pull/44884
4376 [45198]: https://github.com/rust-lang/rust/pull/45198
4377 [45506]: https://github.com/rust-lang/rust/pull/45506
4378 [45904]: https://github.com/rust-lang/rust/pull/45904
4379 [45990]: https://github.com/rust-lang/rust/pull/45990
4380 [46012]: https://github.com/rust-lang/rust/pull/46012
4381 [46077]: https://github.com/rust-lang/rust/pull/46077
4382 [46094]: https://github.com/rust-lang/rust/pull/46094
4383 [46284]: https://github.com/rust-lang/rust/pull/46284
4384 [46287]: https://github.com/rust-lang/rust/pull/46287
4385 [46293]: https://github.com/rust-lang/rust/pull/46293
4386 [46528]: https://github.com/rust-lang/rust/pull/46528
4387 [46671]: https://github.com/rust-lang/rust/pull/46671
4388 [46713]: https://github.com/rust-lang/rust/pull/46713
4389 [46735]: https://github.com/rust-lang/rust/pull/46735
4390 [46749]: https://github.com/rust-lang/rust/pull/46749
4391 [46760]: https://github.com/rust-lang/rust/pull/46760
4392 [46798]: https://github.com/rust-lang/rust/pull/46798
4393 [46828]: https://github.com/rust-lang/rust/pull/46828
4394 [46831]: https://github.com/rust-lang/rust/pull/46831
4395 [46833]: https://github.com/rust-lang/rust/pull/46833
4396 [46910]: https://github.com/rust-lang/rust/pull/46910
4397 [46977]: https://github.com/rust-lang/rust/pull/46977
4398 [47018]: https://github.com/rust-lang/rust/pull/47018
4399 [47080]: https://github.com/rust-lang/rust/pull/47080
4400 [47084]: https://github.com/rust-lang/rust/pull/47084
4401 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4402 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4403 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4404 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4405 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4406 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4407
4408
4409 Version 1.23.0 (2018-01-04)
4410 ==========================
4411
4412 Language
4413 --------
4414 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4415 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4416   Which should fix some confusing errors in some operations.
4417
4418 Compiler
4419 --------
4420 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4421   undefined behavior.][45920]
4422 - [rustc now suggests renaming import if names clash.][45660]
4423 - [Display errors/warnings correctly when there are zero-width or
4424   wide characters.][45711]
4425 - [rustc now avoids unnecessary copies of arguments that are
4426   simple bindings][45380] This should improve memory usage on average by 5-10%.
4427 - [Updated musl used to build musl rustc to 1.1.17][45393]
4428
4429 Libraries
4430 ---------
4431 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4432 - [Implement Hash for raw pointers to unsized types][45483]
4433 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4434 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4435 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4436 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4437   and `<*mut T>::as_mut`][44932]
4438 - [Optimized `Thread::{park, unpark}` implementation][45524]
4439 - [Improved `SliceExt::binary_search` performance.][45333]
4440 - [impl `FromIterator<()>` for `()`][45379]
4441 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4442   is now deprecated.
4443
4444 Stabilized APIs
4445 ---------------
4446
4447 Cargo
4448 -----
4449 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4450   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4451 - [Added unit test checking to `cargo check`][cargo/4592]
4452 - [Cargo now lets you install a specific version
4453   using `cargo install --version`][cargo/4637]
4454
4455 Misc
4456 ----
4457 - [Releases now ship with the Cargo book documentation.][45692]
4458 - [rustdoc now prints rendering warnings on every run.][45324]
4459
4460 Compatibility Notes
4461 -------------------
4462 - [Changes have been made to type equality to make it more correct,
4463   in rare cases this could break some code.][45853] [Tracking issue for
4464   further information][45852]
4465 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4466 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4467   Android 9, the minimum supported version is Android 14.
4468 - [Bumped the minimum LLVM to 3.9][45326]
4469
4470 [44042]: https://github.com/rust-lang/rust/pull/44042
4471 [44932]: https://github.com/rust-lang/rust/pull/44932
4472 [45267]: https://github.com/rust-lang/rust/pull/45267
4473 [45324]: https://github.com/rust-lang/rust/pull/45324
4474 [45326]: https://github.com/rust-lang/rust/pull/45326
4475 [45333]: https://github.com/rust-lang/rust/pull/45333
4476 [45379]: https://github.com/rust-lang/rust/pull/45379
4477 [45380]: https://github.com/rust-lang/rust/pull/45380
4478 [45393]: https://github.com/rust-lang/rust/pull/45393
4479 [45435]: https://github.com/rust-lang/rust/pull/45435
4480 [45483]: https://github.com/rust-lang/rust/pull/45483
4481 [45524]: https://github.com/rust-lang/rust/pull/45524
4482 [45571]: https://github.com/rust-lang/rust/pull/45571
4483 [45580]: https://github.com/rust-lang/rust/pull/45580
4484 [45610]: https://github.com/rust-lang/rust/pull/45610
4485 [45660]: https://github.com/rust-lang/rust/pull/45660
4486 [45692]: https://github.com/rust-lang/rust/pull/45692
4487 [45711]: https://github.com/rust-lang/rust/pull/45711
4488 [45772]: https://github.com/rust-lang/rust/pull/45772
4489 [45852]: https://github.com/rust-lang/rust/issues/45852
4490 [45853]: https://github.com/rust-lang/rust/pull/45853
4491 [45887]: https://github.com/rust-lang/rust/pull/45887
4492 [45920]: https://github.com/rust-lang/rust/pull/45920
4493 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4494 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4495 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4496
4497
4498 Version 1.22.1 (2017-11-22)
4499 ==========================
4500
4501 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4502
4503 [46183]: https://github.com/rust-lang/rust/pull/46183
4504
4505 Version 1.22.0 (2017-11-22)
4506 ==========================
4507
4508 Language
4509 --------
4510 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4511 - [Now accepts underscores in unicode escapes][43716]
4512 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4513 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4514
4515 Compiler
4516 --------
4517 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4518 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4519   This should decrease compile times for debug builds.
4520 - [strict memory alignment now enabled on ARMv6][45094]
4521 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4522
4523 Libraries
4524 ---------
4525 - [Allow atomic operations up to 32 bits
4526   on `armv5te_unknown_linux_gnueabi`][44978]
4527 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4528 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4529 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4530 - [Properly detect overflow in `Instant += Duration`.][44220]
4531 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4532 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4533 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4534
4535 Stabilized APIs
4536 ---------------
4537
4538 Cargo
4539 -----
4540 - [Cargo will now build multi file examples in subdirectories of the `examples`
4541   folder that have a `main.rs` file.][cargo/4496]
4542 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4543   the old format will continue to work and can be updated with `cargo update`.
4544 - [Now supports vendoring git repositories][cargo/3992]
4545
4546 Misc
4547 ----
4548 - [`libbacktrace` is now available on Apple platforms.][44251]
4549 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4550   This now lets you specify that a given code example will fail to compile.
4551
4552 Compatibility Notes
4553 -------------------
4554 - [The minimum Android version that rustc can build for has been bumped
4555   to `4.0` from `2.3`][45656]
4556 - [Allowing `T op= &T` for numeric types has broken some type
4557   inference cases][45480]
4558
4559
4560 [42526]: https://github.com/rust-lang/rust/pull/42526
4561 [43017]: https://github.com/rust-lang/rust/pull/43017
4562 [43716]: https://github.com/rust-lang/rust/pull/43716
4563 [43949]: https://github.com/rust-lang/rust/pull/43949
4564 [44015]: https://github.com/rust-lang/rust/pull/44015
4565 [44220]: https://github.com/rust-lang/rust/pull/44220
4566 [44251]: https://github.com/rust-lang/rust/pull/44251
4567 [44287]: https://github.com/rust-lang/rust/pull/44287
4568 [44303]: https://github.com/rust-lang/rust/pull/44303
4569 [44456]: https://github.com/rust-lang/rust/pull/44456
4570 [44466]: https://github.com/rust-lang/rust/pull/44466
4571 [44895]: https://github.com/rust-lang/rust/pull/44895
4572 [44966]: https://github.com/rust-lang/rust/pull/44966
4573 [44978]: https://github.com/rust-lang/rust/pull/44978
4574 [45041]: https://github.com/rust-lang/rust/pull/45041
4575 [45064]: https://github.com/rust-lang/rust/pull/45064
4576 [45075]: https://github.com/rust-lang/rust/pull/45075
4577 [45094]: https://github.com/rust-lang/rust/pull/45094
4578 [45095]: https://github.com/rust-lang/rust/pull/45095
4579 [45480]: https://github.com/rust-lang/rust/issues/45480
4580 [45656]: https://github.com/rust-lang/rust/pull/45656
4581 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4582 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4583 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4584
4585
4586
4587
4588
4589
4590 Version 1.21.0 (2017-10-12)
4591 ==========================
4592
4593 Language
4594 --------
4595 - [You can now use static references for literals.][43838]
4596   Example:
4597   ```rust
4598   fn main() {
4599       let x: &'static u32 = &0;
4600   }
4601   ```
4602 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4603   Example:
4604   ```rust
4605   my_macro!(Vec<i32>::new); // Always worked
4606   my_macro!(Vec::<i32>::new); // Now works
4607   ```
4608
4609 Compiler
4610 --------
4611 - [Upgraded jemalloc to 4.5.0][43911]
4612 - [Enabled unwinding panics on Redox][43917]
4613 - [Now runs LLVM in parallel during translation phase.][43506]
4614   This should reduce peak memory usage.
4615
4616 Libraries
4617 ---------
4618 - [Generate builtin impls for `Clone` for all arrays and tuples that
4619   are `T: Clone`][43690]
4620 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4621 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4622   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4623
4624 Stabilized APIs
4625 ---------------
4626
4627 [`std::mem::discriminant`]
4628
4629 Cargo
4630 -----
4631 - [You can now call `cargo install` with multiple package names][cargo/4216]
4632 - [Cargo commands inside a virtual workspace will now implicitly
4633   pass `--all`][cargo/4335]
4634 - [Added a `[patch]` section to `Cargo.toml` to handle
4635   prepublication dependencies][cargo/4123] [RFC 1969]
4636 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4637   like patterns][cargo/4270]
4638 - [Added the `--all-targets` option][cargo/4400]
4639 - [Using required dependencies as a feature is now deprecated and emits
4640   a warning][cargo/4364]
4641
4642
4643 Misc
4644 ----
4645 - [Cargo docs are moving][43916]
4646   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4647 - [The rustdoc book is now available][43863]
4648   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4649 - [Added a preview of RLS has been made available through rustup][44204]
4650   Install with `rustup component add rls-preview`
4651 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4652   Previously only showed `std::os::unix`.
4653
4654 Compatibility Notes
4655 -------------------
4656 - [Changes in method matching against higher-ranked types][43880] This may cause
4657   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4658 - [rustc's JSON error output's byte position start at top of file.][42973]
4659   Was previously relative to the rustc's internal `CodeMap` struct which
4660   required the unstable library `libsyntax` to correctly use.
4661 - [`unused_results` lint no longer ignores booleans][43728]
4662
4663 [42565]: https://github.com/rust-lang/rust/pull/42565
4664 [42973]: https://github.com/rust-lang/rust/pull/42973
4665 [43348]: https://github.com/rust-lang/rust/pull/43348
4666 [43459]: https://github.com/rust-lang/rust/pull/43459
4667 [43506]: https://github.com/rust-lang/rust/pull/43506
4668 [43540]: https://github.com/rust-lang/rust/pull/43540
4669 [43690]: https://github.com/rust-lang/rust/pull/43690
4670 [43728]: https://github.com/rust-lang/rust/pull/43728
4671 [43838]: https://github.com/rust-lang/rust/pull/43838
4672 [43863]: https://github.com/rust-lang/rust/pull/43863
4673 [43880]: https://github.com/rust-lang/rust/pull/43880
4674 [43911]: https://github.com/rust-lang/rust/pull/43911
4675 [43916]: https://github.com/rust-lang/rust/pull/43916
4676 [43917]: https://github.com/rust-lang/rust/pull/43917
4677 [44204]: https://github.com/rust-lang/rust/pull/44204
4678 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4679 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4680 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4681 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4682 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4683 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4684 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4685 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4686 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4687
4688 Version 1.20.0 (2017-08-31)
4689 ===========================
4690
4691 Language
4692 --------
4693 - [Associated constants are now stabilised.][42809]
4694 - [A lot of macro bugs are now fixed.][42913]
4695
4696 Compiler
4697 --------
4698
4699 - [Struct fields are now properly coerced to the expected field type.][42807]
4700 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4701   `wasm32-experimental-emscripten` target.
4702 - [Changed some of the error messages to be more helpful.][42033]
4703 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4704   it.][43170]
4705 - [rustc now reports the total number of errors on compilation failure][43015]
4706   previously this was only the number of errors in the pass that failed.
4707 - [Expansion in rustc has been sped up 29x.][42533]
4708 - [added `msp430-none-elf` target.][43099]
4709 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4710   applicable][43178]
4711 - [Fixes backtraces on Redox][43228]
4712 - [rustc now identifies different versions of same crate when absolute paths of
4713   different types match in an error message.][42826]
4714
4715 Libraries
4716 ---------
4717
4718
4719 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4720 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4721   tuples.][43011]
4722 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4723   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4724 - [Impl `Clone` for `DefaultHasher`.][42799]
4725 - [Impl `Sync` for `SyncSender`.][42397]
4726 - [Impl `FromStr` for `char`][42271]
4727 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4728   NaN.][42431]
4729 - [allow messages in the `unimplemented!()` macro.][42155]
4730   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4731 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4732 - [Upgrade to Unicode 10.0.0][42999]
4733 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4734 - [Skip the main thread's manual stack guard on Linux][43072]
4735 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4736 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4737   previously 2^15.
4738 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4739
4740 Stabilized APIs
4741 ---------------
4742
4743 - [`CStr::into_c_string`]
4744 - [`CString::as_c_str`]
4745 - [`CString::into_boxed_c_str`]
4746 - [`Chain::get_mut`]
4747 - [`Chain::get_ref`]
4748 - [`Chain::into_inner`]
4749 - [`Option::get_or_insert_with`]
4750 - [`Option::get_or_insert`]
4751 - [`OsStr::into_os_string`]
4752 - [`OsString::into_boxed_os_str`]
4753 - [`Take::get_mut`]
4754 - [`Take::get_ref`]
4755 - [`Utf8Error::error_len`]
4756 - [`char::EscapeDebug`]
4757 - [`char::escape_debug`]
4758 - [`compile_error!`]
4759 - [`f32::from_bits`]
4760 - [`f32::to_bits`]
4761 - [`f64::from_bits`]
4762 - [`f64::to_bits`]
4763 - [`mem::ManuallyDrop`]
4764 - [`slice::sort_unstable_by_key`]
4765 - [`slice::sort_unstable_by`]
4766 - [`slice::sort_unstable`]
4767 - [`str::from_boxed_utf8_unchecked`]
4768 - [`str::as_bytes_mut`]
4769 - [`str::as_bytes_mut`]
4770 - [`str::from_utf8_mut`]
4771 - [`str::from_utf8_unchecked_mut`]
4772 - [`str::get_mut`]
4773 - [`str::get_unchecked_mut`]
4774 - [`str::get_unchecked`]
4775 - [`str::get`]
4776 - [`str::into_boxed_bytes`]
4777
4778
4779 Cargo
4780 -----
4781 - [Cargo API token location moved from `~/.cargo/config` to
4782   `~/.cargo/credentials`.][cargo/3978]
4783 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4784   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4785   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4786 - [You can now specify version of a binary when installed through
4787   `cargo install` using `--vers`.][cargo/4229]
4788 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4789   failure.][cargo/4248]
4790 - [Changed the convention around which file is the crate root.][cargo/4259]
4791 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4792   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4793
4794 Compatibility Notes
4795 -------------------
4796
4797 - [Functions with `'static` in their return types will now not be as usable as
4798   if they were using lifetime parameters instead.][42417]
4799 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4800   takes the sign of NaN into account where previously didn't.][42430]
4801
4802 [42033]: https://github.com/rust-lang/rust/pull/42033
4803 [42155]: https://github.com/rust-lang/rust/pull/42155
4804 [42271]: https://github.com/rust-lang/rust/pull/42271
4805 [42397]: https://github.com/rust-lang/rust/pull/42397
4806 [42417]: https://github.com/rust-lang/rust/pull/42417
4807 [42430]: https://github.com/rust-lang/rust/pull/42430
4808 [42431]: https://github.com/rust-lang/rust/pull/42431
4809 [42533]: https://github.com/rust-lang/rust/pull/42533
4810 [42571]: https://github.com/rust-lang/rust/pull/42571
4811 [42613]: https://github.com/rust-lang/rust/pull/42613
4812 [42799]: https://github.com/rust-lang/rust/pull/42799
4813 [42807]: https://github.com/rust-lang/rust/pull/42807
4814 [42809]: https://github.com/rust-lang/rust/pull/42809
4815 [42822]: https://github.com/rust-lang/rust/pull/42822
4816 [42826]: https://github.com/rust-lang/rust/pull/42826
4817 [42854]: https://github.com/rust-lang/rust/pull/42854
4818 [42913]: https://github.com/rust-lang/rust/pull/42913
4819 [42999]: https://github.com/rust-lang/rust/pull/42999
4820 [43011]: https://github.com/rust-lang/rust/pull/43011
4821 [43015]: https://github.com/rust-lang/rust/pull/43015
4822 [43072]: https://github.com/rust-lang/rust/pull/43072
4823 [43077]: https://github.com/rust-lang/rust/pull/43077
4824 [43097]: https://github.com/rust-lang/rust/pull/43097
4825 [43099]: https://github.com/rust-lang/rust/pull/43099
4826 [43170]: https://github.com/rust-lang/rust/pull/43170
4827 [43178]: https://github.com/rust-lang/rust/pull/43178
4828 [43185]: https://github.com/rust-lang/rust/pull/43185
4829 [43228]: https://github.com/rust-lang/rust/pull/43228
4830 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4831 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4832 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4833 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4834 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4835 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4836 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4837 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4838 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4839 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4840 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4841 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4842 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4843 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4844 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4845 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4846 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4847 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4848 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4849 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4850 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4851 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4852 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4853 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4854 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4855 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4856 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4857 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4858 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4859 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4860 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4861 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4862 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4863 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4864 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4865 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4866 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4867 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4868 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4869
4870
4871 Version 1.19.0 (2017-07-20)
4872 ===========================
4873
4874 Language
4875 --------
4876
4877 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4878   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4879 - [Macro recursion limit increased to 1024 from 64.][41676]
4880 - [Added lint for detecting unused macros.][41907]
4881 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4882   For example: `let x = loop { break 7; };`
4883 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4884   contain `Copy` types and cannot have a `Drop` implementation.
4885   Example: `union Foo { bar: u8, baz: usize }`
4886 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4887   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4888
4889 Compiler
4890 --------
4891
4892 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4893 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4894   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4895   you should use `--target armv7-linux-androideabi`.
4896 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4897 - [Minor optimisation of string operations.][42037]
4898 - [Compiler error message is now `aborting due to previous error(s)` instead of
4899   `aborting due to N previous errors`][42150] This was previously inaccurate and
4900   would only count certain kinds of errors.
4901 - [The compiler now supports Visual Studio 2017][42225]
4902 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4903 - [Added a lot][42264] of [new error codes][42302]
4904 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4905   libraries with C Run-time Libraries(CRT) to be statically linked.
4906 - [Fixed various ARM codegen bugs][42740]
4907
4908 Libraries
4909 ---------
4910
4911 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4912   `Extend<Cow<'a, str>>`][41449]
4913 - [`Vec` now implements `From<&mut [T]>`][41530]
4914 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4915 - [`SplitWhitespace` now implements `Clone`][41659]
4916 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4917   1.5x faster][41764]
4918 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4919   macros, but for printing to stderr.
4920
4921 Stabilized APIs
4922 ---------------
4923
4924 - [`OsString::shrink_to_fit`]
4925 - [`cmp::Reverse`]
4926 - [`Command::envs`]
4927 - [`thread::ThreadId`]
4928
4929 Cargo
4930 -----
4931
4932 - [Build scripts can now add environment variables to the environment
4933   the crate is being compiled in.
4934   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4935 - [Subcommands now replace the current process rather than spawning a new
4936   child process][cargo/3970]
4937 - [Workspace members can now accept glob file patterns][cargo/3979]
4938 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4939   the members in a given workspace.][cargo/3988]
4940 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4941 - [Target directory path is now in the cargo metadata][cargo/4022]
4942 - [Cargo no longer checks out a local working directory for the
4943   crates.io index][cargo/4026] This should provide smaller file size for the
4944   registry, and improve cloning times, especially on Windows machines.
4945 - [Added an `--exclude` option for excluding certain packages when using the
4946   `--all` option][cargo/4031]
4947 - [Cargo will now automatically retry when receiving a 5xx error
4948   from crates.io][cargo/4032]
4949 - [The `--features` option now accepts multiple comma or space
4950   delimited values.][cargo/4084]
4951 - [Added support for custom target specific runners][cargo/3954]
4952
4953 Misc
4954 ----
4955
4956 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4957   Windows Debugger.
4958 - [Rust will now release XZ compressed packages][rust-installer/57]
4959 - [rustup will now prefer to download rust packages with
4960   XZ compression][rustup/1100] over GZip packages.
4961 - [Added the ability to escape `#` in rust documentation][41785] By adding
4962   additional `#`'s ie. `##` is now `#`
4963
4964 Compatibility Notes
4965 -------------------
4966
4967 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4968 - [`-Z` flags are now no longer allowed to be used on the stable
4969   compiler.][41751] This has been a warning for a year previous to this.
4970 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4971   longer works][42844]. Users should migrate to the built-in `check`
4972   command, which has been available since 1.16.
4973 - [Ending a float literal with `._` is now a hard error.
4974   Example: `42._` .][41946]
4975 - [Any use of a private `extern crate` outside of its module is now a
4976   hard error.][36886] This was previously a warning.
4977 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4978   relative while the `::` prefix makes a path absolute, but was ignored and the
4979   path was relative regardless.
4980 - [Floating point constants in match patterns is now a hard error][36890]
4981   This was previously a warning.
4982 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4983   match patterns is now a hard error][36891] This was previously a warning.
4984 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4985   a warning.
4986 - [From the pound escape, lines consisting of multiple `#`s are
4987   now visible][41785]
4988 - [It is an error to re-export private enum variants][42460]. This is
4989   known to break a number of crates that depend on an older version of
4990   mustache.
4991 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4992   to use it to find the linker, and the build will fail where it did
4993   not previously][42607]
4994
4995 [36886]: https://github.com/rust-lang/rust/issues/36886
4996 [36888]: https://github.com/rust-lang/rust/issues/36888
4997 [36890]: https://github.com/rust-lang/rust/issues/36890
4998 [36891]: https://github.com/rust-lang/rust/issues/36891
4999 [36892]: https://github.com/rust-lang/rust/issues/36892
5000 [37406]: https://github.com/rust-lang/rust/issues/37406
5001 [39983]: https://github.com/rust-lang/rust/pull/39983
5002 [41145]: https://github.com/rust-lang/rust/pull/41145
5003 [41192]: https://github.com/rust-lang/rust/pull/41192
5004 [41258]: https://github.com/rust-lang/rust/pull/41258
5005 [41370]: https://github.com/rust-lang/rust/pull/41370
5006 [41449]: https://github.com/rust-lang/rust/pull/41449
5007 [41530]: https://github.com/rust-lang/rust/pull/41530
5008 [41624]: https://github.com/rust-lang/rust/pull/41624
5009 [41656]: https://github.com/rust-lang/rust/pull/41656
5010 [41659]: https://github.com/rust-lang/rust/pull/41659
5011 [41676]: https://github.com/rust-lang/rust/pull/41676
5012 [41751]: https://github.com/rust-lang/rust/pull/41751
5013 [41764]: https://github.com/rust-lang/rust/pull/41764
5014 [41785]: https://github.com/rust-lang/rust/pull/41785
5015 [41873]: https://github.com/rust-lang/rust/pull/41873
5016 [41907]: https://github.com/rust-lang/rust/pull/41907
5017 [41946]: https://github.com/rust-lang/rust/pull/41946
5018 [42016]: https://github.com/rust-lang/rust/pull/42016
5019 [42037]: https://github.com/rust-lang/rust/pull/42037
5020 [42068]: https://github.com/rust-lang/rust/pull/42068
5021 [42150]: https://github.com/rust-lang/rust/pull/42150
5022 [42162]: https://github.com/rust-lang/rust/pull/42162
5023 [42225]: https://github.com/rust-lang/rust/pull/42225
5024 [42264]: https://github.com/rust-lang/rust/pull/42264
5025 [42302]: https://github.com/rust-lang/rust/pull/42302
5026 [42460]: https://github.com/rust-lang/rust/issues/42460
5027 [42607]: https://github.com/rust-lang/rust/issues/42607
5028 [42740]: https://github.com/rust-lang/rust/pull/42740
5029 [42844]: https://github.com/rust-lang/rust/issues/42844
5030 [42948]: https://github.com/rust-lang/rust/pull/42948
5031 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5032 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5033 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5034 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5035 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5036 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5037 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5038 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5039 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5040 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5041 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5042 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5043 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5044 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5045 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5046 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5047 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5048 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5049 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5050 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5051 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5052 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5053
5054
5055 Version 1.18.0 (2017-06-08)
5056 ===========================
5057
5058 Language
5059 --------
5060
5061 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5062   make the item visible to just that module tree. Also accepts the keyword
5063   `crate` to make something public to the whole crate but not users of the
5064   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5065 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5066   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5067 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5068   types like `Write + Send`, trailing `+` are now supported in trait objects,
5069   and better error reporting for trait objects starting with `?Sized`.
5070 - [0e+10 is now a valid floating point literal][40589]
5071 - [Now warns if you bind a lifetime parameter to 'static][40734]
5072 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5073   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5074   representation in some cases.][40377]
5075
5076 Compiler
5077 --------
5078
5079 - [rustc can now emit mir with `--emit mir`][39891]
5080 - [Improved LLVM IR for trivial functions][40367]
5081 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5082 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5083   opportunities found through profiling
5084 - [Improved backtrace formatting when panicking][38165]
5085
5086 Libraries
5087 ---------
5088
5089 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5090   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5091   iteration or reallocation.
5092 - [Simplified HashMap Bucket interface][40561] provides performance
5093   improvements for iterating and cloning.
5094 - [Specialize Vec::from_elem to use calloc][40409]
5095 - [Fixed Race condition in fs::create_dir_all][39799]
5096 - [No longer caching stdio on Windows][40516]
5097 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5098   2.50%~ faster and in one case now 12.50% faster.
5099 - [Optimized `AtomicBool::fetch_nand`][41143]
5100
5101 Stabilized APIs
5102 ---------------
5103
5104 - [`Child::try_wait`]
5105 - [`HashMap::retain`]
5106 - [`HashSet::retain`]
5107 - [`PeekMut::pop`]
5108 - [`TcpStream::peek`]
5109 - [`UdpSocket::peek`]
5110 - [`UdpSocket::peek_from`]
5111
5112 Cargo
5113 -----
5114
5115 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5116   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5117 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5118 - [Added Android build support][cargo/3885]
5119 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5120   of a certain type, for example `cargo build --bins` will build all
5121   binaries.
5122 - [Added support for haiku][cargo/3952]
5123
5124 Misc
5125 ----
5126
5127 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5128 - [Added rust-windbg script for better debugging on Windows][39983]
5129 - [Rust now uses the official cross compiler for NetBSD][40612]
5130 - [rustdoc now accepts `#` at the start of files][40828]
5131 - [Fixed jemalloc support for musl][41168]
5132
5133 Compatibility Notes
5134 -------------------
5135
5136 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5137   always placed after the sign if it exists and before the digits. With the `#`
5138   flag the zeroes are placed after the prefix and before the digits.
5139 - [Due to the struct field optimisation][40377], using `transmute` on structs
5140   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5141   always been undefined behavior, but is now more likely to break in practice.
5142 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5143   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5144   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5145 - [Overlapping inherent `impl`s are now a hard error][40728]
5146 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5147 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5148   `out.asm` and `out.ll` instead of only one of the filetypes.
5149 - [ calling a function that returns `Self` will no longer work][41805] when
5150   the size of `Self` cannot be statically determined.
5151 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5152   this has caused a few regressions namely:
5153
5154   - Changed the link order of local static/dynamic libraries (respecting the
5155     order on given rather than having the compiler reorder).
5156   - Changed how MinGW is linked, native code linked to dynamic libraries
5157     may require manually linking to the gcc support library (for the native
5158     code itself)
5159
5160 [38165]: https://github.com/rust-lang/rust/pull/38165
5161 [39799]: https://github.com/rust-lang/rust/pull/39799
5162 [39891]: https://github.com/rust-lang/rust/pull/39891
5163 [39983]: https://github.com/rust-lang/rust/pull/39983
5164 [40043]: https://github.com/rust-lang/rust/pull/40043
5165 [40241]: https://github.com/rust-lang/rust/pull/40241
5166 [40338]: https://github.com/rust-lang/rust/pull/40338
5167 [40367]: https://github.com/rust-lang/rust/pull/40367
5168 [40377]: https://github.com/rust-lang/rust/pull/40377
5169 [40409]: https://github.com/rust-lang/rust/pull/40409
5170 [40516]: https://github.com/rust-lang/rust/pull/40516
5171 [40556]: https://github.com/rust-lang/rust/pull/40556
5172 [40561]: https://github.com/rust-lang/rust/pull/40561
5173 [40589]: https://github.com/rust-lang/rust/pull/40589
5174 [40612]: https://github.com/rust-lang/rust/pull/40612
5175 [40723]: https://github.com/rust-lang/rust/pull/40723
5176 [40728]: https://github.com/rust-lang/rust/pull/40728
5177 [40731]: https://github.com/rust-lang/rust/pull/40731
5178 [40734]: https://github.com/rust-lang/rust/pull/40734
5179 [40805]: https://github.com/rust-lang/rust/pull/40805
5180 [40807]: https://github.com/rust-lang/rust/pull/40807
5181 [40828]: https://github.com/rust-lang/rust/pull/40828
5182 [40870]: https://github.com/rust-lang/rust/pull/40870
5183 [41085]: https://github.com/rust-lang/rust/pull/41085
5184 [41143]: https://github.com/rust-lang/rust/pull/41143
5185 [41168]: https://github.com/rust-lang/rust/pull/41168
5186 [41270]: https://github.com/rust-lang/rust/issues/41270
5187 [41469]: https://github.com/rust-lang/rust/pull/41469
5188 [41805]: https://github.com/rust-lang/rust/issues/41805
5189 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5190 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5191 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5192 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5193 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5194 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5195 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5196 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5197 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5198 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5199 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5200 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5201 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5202 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5203
5204
5205 Version 1.17.0 (2017-04-27)
5206 ===========================
5207
5208 Language
5209 --------
5210
5211 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5212 * [Fields of structs may be initialized without duplicating the field/variable
5213   names][39761]. [RFC 1682]
5214 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5215 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5216   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5217   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5218   `'b`. Soundness fix.
5219 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5220 * [Static variables may contain references to other statics][40027]
5221
5222 Compiler
5223 --------
5224
5225 * [Exit quickly on only `--emit dep-info`][40336]
5226 * [Make `-C relocation-model` more correctly determine whether the linker
5227   creates a position-independent executable][40245]
5228 * [Add `-C overflow-checks` to directly control whether integer overflow
5229   panics][40037]
5230 * [The rustc type checker now checks items on demand instead of in a single
5231   in-order pass][40008]. This is mostly an internal refactoring in support of
5232   future work, including incremental type checking, but also resolves [RFC
5233   1647], allowing `Self` to appear in `impl` `where` clauses.
5234 * [Optimize vtable loads][39995]
5235 * [Turn off vectorization for Emscripten targets][39990]
5236 * [Provide suggestions for unknown macros imported with `use`][39953]
5237 * [Fix ICEs in path resolution][39939]
5238 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5239 * [Add clearer error message using `&str + &str`][39116]
5240
5241 Stabilized APIs
5242 ---------------
5243
5244 * [`Arc::into_raw`]
5245 * [`Arc::from_raw`]
5246 * [`Arc::ptr_eq`]
5247 * [`Rc::into_raw`]
5248 * [`Rc::from_raw`]
5249 * [`Rc::ptr_eq`]
5250 * [`Ordering::then`]
5251 * [`Ordering::then_with`]
5252 * [`BTreeMap::range`]
5253 * [`BTreeMap::range_mut`]
5254 * [`collections::Bound`]
5255 * [`process::abort`]
5256 * [`ptr::read_unaligned`]
5257 * [`ptr::write_unaligned`]
5258 * [`Result::expect_err`]
5259 * [`Cell::swap`]
5260 * [`Cell::replace`]
5261 * [`Cell::into_inner`]
5262 * [`Cell::take`]
5263
5264 Libraries
5265 ---------
5266
5267 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5268 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5269 * [`String` implements `FromIterator<&char>`][40028]
5270 * `Box` [implements][40009] a number of new conversions:
5271   `From<Box<str>> for String`,
5272   `From<Box<[T]>> for Vec<T>`,
5273   `From<Box<CStr>> for CString`,
5274   `From<Box<OsStr>> for OsString`,
5275   `From<Box<Path>> for PathBuf`,
5276   `Into<Box<str>> for String`,
5277   `Into<Box<[T]>> for Vec<T>`,
5278   `Into<Box<CStr>> for CString`,
5279   `Into<Box<OsStr>> for OsString`,
5280   `Into<Box<Path>> for PathBuf`,
5281   `Default for Box<str>`,
5282   `Default for Box<CStr>`,
5283   `Default for Box<OsStr>`,
5284   `From<&CStr> for Box<CStr>`,
5285   `From<&OsStr> for Box<OsStr>`,
5286   `From<&Path> for Box<Path>`
5287 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5288 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5289 * [Slightly optimize `slice::sort`][39538]
5290 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5291 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5292   `Box<str>` implements `From<&str>`][39438]
5293 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5294   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5295 * [`format!` estimates the needed capacity before writing a string][39356]
5296 * [Support unprivileged symlink creation in Windows][38921]
5297 * [`PathBuf` implements `Default`][38764]
5298 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5299 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5300   and poor hash functions.
5301
5302 Cargo
5303 -----
5304
5305 * [Add `cargo check --all`][cargo/3731]
5306 * [Add an option to ignore SSL revocation checking][cargo/3699]
5307 * [Add `cargo run --package`][cargo/3691]
5308 * [Add `required_features`][cargo/3667]
5309 * [Assume `build.rs` is a build script][cargo/3664]
5310 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5311
5312 Misc
5313 ----
5314
5315 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5316   `rustbook`][39633]
5317 * [The "Unstable Book" documents nightly-only features][ubook]
5318 * [Improve the style of the sidebar in rustdoc output][40265]
5319 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5320 * [Fix MSP430 breakage due to `i128`][40257]
5321 * [Preliminary Solaris/SPARCv9 support][39903]
5322 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5323   run without installing the MSVC runtime.
5324 * [`rustdoc --test` includes file names in test names][39788]
5325 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5326   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5327 * [Initial support for `aarch64-unknown-freebsd`][39491]
5328 * [Initial support for `i686-unknown-netbsd`][39426]
5329 * [This release no longer includes the old makefile build system][39431]. Rust
5330   is built with a custom build system, written in Rust, and with Cargo.
5331 * [Add Debug implementations for libcollection structs][39002]
5332 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5333 * [`--test-threads=0` produces an error][38945]
5334 * [`rustup` installs documentation by default][40526]
5335 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5336   WinDbg and Visual Studio to improve the debugging experience.
5337
5338 Compatibility Notes
5339 -------------------
5340
5341 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5342   workaround, either use MSVC 2015 or run vcvars.bat.
5343 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5344   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5345   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5346   fix.
5347 * [`format!` and `Display::to_string` panic if an underlying formatting
5348   implementation returns an error][40117]. Previously the error was silently
5349   ignored. It is incorrect for `write_fmt` to return an error when writing
5350   to a string.
5351 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5352   crates were marked stable and could be accessed from the stable toolchain.
5353 * [Rust git source no longer includes vendored crates][39728]. Those that need
5354   to build with vendored crates should build from release tarballs.
5355 * [Fix inert attributes from `proc_macro_derives`][39572]
5356 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5357   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5358   build system.
5359 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5360   existing code generally ignores the type of dead-code unless a type-hint is
5361   provided; this can cause surprising inference interactions particularly around
5362   defaulting. The new code uniformly ignores the result type of dead-code.
5363 * [Tuple-struct constructors with private fields are no longer visible][38932]
5364 * [Lifetime parameters that do not appear in the arguments are now considered
5365   early-bound][38897], resolving a soundness bug (#[32330]). The
5366   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5367   April of 2016.
5368 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5369 * [Make transmuting from fn item types to pointer-sized types a hard
5370   error][34198]
5371
5372 [27787]: https://github.com/rust-lang/rust/issues/27787
5373 [32330]: https://github.com/rust-lang/rust/issues/32330
5374 [34198]: https://github.com/rust-lang/rust/pull/34198
5375 [38161]: https://github.com/rust-lang/rust/pull/38161
5376 [38368]: https://github.com/rust-lang/rust/pull/38368
5377 [38584]: https://github.com/rust-lang/rust/issues/38584
5378 [38661]: https://github.com/rust-lang/rust/pull/38661
5379 [38764]: https://github.com/rust-lang/rust/pull/38764
5380 [38864]: https://github.com/rust-lang/rust/issues/38864
5381 [38897]: https://github.com/rust-lang/rust/pull/38897
5382 [38921]: https://github.com/rust-lang/rust/pull/38921
5383 [38932]: https://github.com/rust-lang/rust/pull/38932
5384 [38945]: https://github.com/rust-lang/rust/pull/38945
5385 [38981]: https://github.com/rust-lang/rust/pull/38981
5386 [39002]: https://github.com/rust-lang/rust/pull/39002
5387 [39116]: https://github.com/rust-lang/rust/pull/39116
5388 [39193]: https://github.com/rust-lang/rust/pull/39193
5389 [39265]: https://github.com/rust-lang/rust/pull/39265
5390 [39356]: https://github.com/rust-lang/rust/pull/39356
5391 [39372]: https://github.com/rust-lang/rust/pull/39372
5392 [39426]: https://github.com/rust-lang/rust/pull/39426
5393 [39431]: https://github.com/rust-lang/rust/pull/39431
5394 [39438]: https://github.com/rust-lang/rust/pull/39438
5395 [39440]: https://github.com/rust-lang/rust/pull/39440
5396 [39485]: https://github.com/rust-lang/rust/pull/39485
5397 [39491]: https://github.com/rust-lang/rust/pull/39491
5398 [39518]: https://github.com/rust-lang/rust/pull/39518
5399 [39538]: https://github.com/rust-lang/rust/pull/39538
5400 [39572]: https://github.com/rust-lang/rust/pull/39572
5401 [39633]: https://github.com/rust-lang/rust/pull/39633
5402 [39642]: https://github.com/rust-lang/rust/pull/39642
5403 [39728]: https://github.com/rust-lang/rust/pull/39728
5404 [39761]: https://github.com/rust-lang/rust/pull/39761
5405 [39788]: https://github.com/rust-lang/rust/pull/39788
5406 [39793]: https://github.com/rust-lang/rust/pull/39793
5407 [39837]: https://github.com/rust-lang/rust/pull/39837
5408 [39843]: https://github.com/rust-lang/rust/pull/39843
5409 [39851]: https://github.com/rust-lang/rust/pull/39851
5410 [39903]: https://github.com/rust-lang/rust/pull/39903
5411 [39939]: https://github.com/rust-lang/rust/pull/39939
5412 [39953]: https://github.com/rust-lang/rust/pull/39953
5413 [39960]: https://github.com/rust-lang/rust/pull/39960
5414 [39990]: https://github.com/rust-lang/rust/pull/39990
5415 [39995]: https://github.com/rust-lang/rust/pull/39995
5416 [40008]: https://github.com/rust-lang/rust/pull/40008
5417 [40009]: https://github.com/rust-lang/rust/pull/40009
5418 [40027]: https://github.com/rust-lang/rust/pull/40027
5419 [40028]: https://github.com/rust-lang/rust/pull/40028
5420 [40037]: https://github.com/rust-lang/rust/pull/40037
5421 [40117]: https://github.com/rust-lang/rust/pull/40117
5422 [40166]: https://github.com/rust-lang/rust/pull/40166
5423 [40245]: https://github.com/rust-lang/rust/pull/40245
5424 [40257]: https://github.com/rust-lang/rust/pull/40257
5425 [40261]: https://github.com/rust-lang/rust/pull/40261
5426 [40265]: https://github.com/rust-lang/rust/pull/40265
5427 [40319]: https://github.com/rust-lang/rust/pull/40319
5428 [40336]: https://github.com/rust-lang/rust/pull/40336
5429 [40526]: https://github.com/rust-lang/rust/pull/40526
5430 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5431 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5432 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5433 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5434 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5435 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5436 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5437 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5438 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5439 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5440 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5441 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5442 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5443 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5444 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5445 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5446 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5447 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5448 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5449 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5450 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5451 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5452 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5453 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5454 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5455 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5456 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5457 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5458 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5459 [mdbook]: https://crates.io/crates/mdbook
5460 [ubook]: https://doc.rust-lang.org/unstable-book/
5461
5462
5463 Version 1.16.0 (2017-03-16)
5464 ===========================
5465
5466 Language
5467 --------
5468
5469 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5470 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5471   match patterns][38069]
5472 * [Clean up semantics of `self` in an import list][38313]
5473 * [`Self` may appear in `impl` headers][38920]
5474 * [`Self` may appear in struct expressions][39282]
5475
5476 Compiler
5477 --------
5478
5479 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5480   a `.rmeta` file containing only crate metadata][38571]. This can be
5481   used by tools like the Rust Language Service to perform
5482   metadata-only builds.
5483 * [Levenshtein based typo suggestions now work in most places, while
5484   previously they worked only for fields and sometimes for local
5485   variables][38927]. Together with the overhaul of "no
5486   resolution"/"unexpected resolution" errors (#[38154]) they result in
5487   large and systematic improvement in resolution diagnostics.
5488 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5489   `U`][38670]
5490 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5491 * [`rustc` no longer attempts to provide "consider using an explicit
5492   lifetime" suggestions][37057]. They were inaccurate.
5493
5494 Stabilized APIs
5495 ---------------
5496
5497 * [`VecDeque::truncate`]
5498 * [`VecDeque::resize`]
5499 * [`String::insert_str`]
5500 * [`Duration::checked_add`]
5501 * [`Duration::checked_sub`]
5502 * [`Duration::checked_div`]
5503 * [`Duration::checked_mul`]
5504 * [`str::replacen`]
5505 * [`str::repeat`]
5506 * [`SocketAddr::is_ipv4`]
5507 * [`SocketAddr::is_ipv6`]
5508 * [`IpAddr::is_ipv4`]
5509 * [`IpAddr::is_ipv6`]
5510 * [`Vec::dedup_by`]
5511 * [`Vec::dedup_by_key`]
5512 * [`Result::unwrap_or_default`]
5513 * [`<*const T>::wrapping_offset`]
5514 * [`<*mut T>::wrapping_offset`]
5515 * `CommandExt::creation_flags`
5516 * [`File::set_permissions`]
5517 * [`String::split_off`]
5518
5519 Libraries
5520 ---------
5521
5522 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5523   their argument by `Borrow` parameter][37761]
5524 * [All public types in std implement `Debug`][38006]
5525 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5526 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5527 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5528   Windows][38274]
5529 * [std: Fix partial writes in `LineWriter`][38062]
5530 * [std: Clamp max read/write sizes on Unix][38062]
5531 * [Use more specific panic message for `&str` slicing errors][38066]
5532 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5533   functionality cannot be achieved in std currently.
5534 * [`writeln!`, like `println!`, now accepts a form with no string
5535   or formatting arguments, to just print a newline][38469]
5536 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5537 * [Reduce the size of static data in `std_unicode::tables`][38781]
5538 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5539   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5540   `Display`][38909]
5541 * [`Duration` implements `Sum`][38712]
5542 * [`String` implements `ToSocketAddrs`][39048]
5543
5544 Cargo
5545 -----
5546
5547 * [The `cargo check` command does a type check of a project without
5548   building it][cargo/3296]
5549 * [crates.io will display CI badges from Travis and AppVeyor, if
5550   specified in Cargo.toml][cargo/3546]
5551 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5552 * [Compilation profiles accept integer values for `debug`, in addition
5553   to `true` and `false`. These are passed to `rustc` as the value to
5554   `-C debuginfo`][cargo/3534]
5555 * [Implement `cargo --version --verbose`][cargo/3604]
5556 * [All builds now output 'dep-info' build dependencies compatible with
5557   make and ninja][cargo/3557]
5558 * [Build all workspace members with `build --all`][cargo/3511]
5559 * [Document all workspace members with `doc --all`][cargo/3515]
5560 * [Path deps outside workspace are not members][cargo/3443]
5561
5562 Misc
5563 ----
5564
5565 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5566   the path to the Rust implementation][38589]
5567 * [The `armv7-linux-androideabi` target no longer enables NEON
5568   extensions, per Google's ABI guide][38413]
5569 * [The stock standard library can be compiled for Redox OS][38401]
5570 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5571   available.
5572 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5573   builds available.
5574 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5575
5576 Compatibility Notes
5577 -------------------
5578
5579 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5580   match patterns][38069]
5581 * In this release, references to uninhabited types can not be
5582   pattern-matched. This was accidentally allowed in 1.15.
5583 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5584 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5585   Windows][38274]
5586 * [Clean up semantics of `self` in an import list][38313]
5587 * Reimplemented lifetime elision. This change was almost entirely compatible
5588   with existing code, but it did close a number of small bugs and loopholes,
5589   as well as being more accepting in some other [cases][41105].
5590
5591 [37057]: https://github.com/rust-lang/rust/pull/37057
5592 [37761]: https://github.com/rust-lang/rust/pull/37761
5593 [38006]: https://github.com/rust-lang/rust/pull/38006
5594 [38051]: https://github.com/rust-lang/rust/pull/38051
5595 [38062]: https://github.com/rust-lang/rust/pull/38062
5596 [38062]: https://github.com/rust-lang/rust/pull/38622
5597 [38066]: https://github.com/rust-lang/rust/pull/38066
5598 [38069]: https://github.com/rust-lang/rust/pull/38069
5599 [38131]: https://github.com/rust-lang/rust/pull/38131
5600 [38154]: https://github.com/rust-lang/rust/pull/38154
5601 [38274]: https://github.com/rust-lang/rust/pull/38274
5602 [38304]: https://github.com/rust-lang/rust/pull/38304
5603 [38313]: https://github.com/rust-lang/rust/pull/38313
5604 [38314]: https://github.com/rust-lang/rust/pull/38314
5605 [38327]: https://github.com/rust-lang/rust/pull/38327
5606 [38401]: https://github.com/rust-lang/rust/pull/38401
5607 [38413]: https://github.com/rust-lang/rust/pull/38413
5608 [38469]: https://github.com/rust-lang/rust/pull/38469
5609 [38559]: https://github.com/rust-lang/rust/pull/38559
5610 [38571]: https://github.com/rust-lang/rust/pull/38571
5611 [38580]: https://github.com/rust-lang/rust/pull/38580
5612 [38589]: https://github.com/rust-lang/rust/pull/38589
5613 [38670]: https://github.com/rust-lang/rust/pull/38670
5614 [38712]: https://github.com/rust-lang/rust/pull/38712
5615 [38726]: https://github.com/rust-lang/rust/pull/38726
5616 [38781]: https://github.com/rust-lang/rust/pull/38781
5617 [38798]: https://github.com/rust-lang/rust/pull/38798
5618 [38909]: https://github.com/rust-lang/rust/pull/38909
5619 [38920]: https://github.com/rust-lang/rust/pull/38920
5620 [38927]: https://github.com/rust-lang/rust/pull/38927
5621 [39048]: https://github.com/rust-lang/rust/pull/39048
5622 [39282]: https://github.com/rust-lang/rust/pull/39282
5623 [39379]: https://github.com/rust-lang/rust/pull/39379
5624 [41105]: https://github.com/rust-lang/rust/issues/41105
5625 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5626 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5627 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5628 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5629 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5630 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5631 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5632 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5633 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5634 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5635 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5636 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5637 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5638 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5639 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5640 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5641 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5642 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5643 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5644 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5645 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5646 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5647 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5648 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5649 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5650 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5651 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5652 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5653 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5654 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5655
5656
5657 Version 1.15.1 (2017-02-09)
5658 ===========================
5659
5660 * [Fix IntoIter::as_mut_slice's signature][39466]
5661 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5662
5663 [39466]: https://github.com/rust-lang/rust/pull/39466
5664 [39523]: https://github.com/rust-lang/rust/pull/39523
5665
5666
5667 Version 1.15.0 (2017-02-02)
5668 ===========================
5669
5670 Language
5671 --------
5672
5673 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5674   stable. This allows popular code-generating crates like Serde and Diesel to
5675   work ergonomically. [RFC 1681].
5676 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5677   with curly braces][36868]. Part of [RFC 1506].
5678 * [A number of minor changes to name resolution have been activated][37127].
5679   They add up to more consistent semantics, allowing for future evolution of
5680   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5681   details of what is different. The breaking changes here have been transitioned
5682   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5683 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5684   bounds][38279]
5685 * [`?Sized` can be used in `where` clauses][37791]
5686 * [There is now a limit on the size of monomorphized types and it can be
5687   modified with the `#![type_size_limit]` crate attribute, similarly to
5688   the `#![recursion_limit]` attribute][37789]
5689
5690 Compiler
5691 --------
5692
5693 * [On Windows, the compiler will apply dllimport attributes when linking to
5694   extern functions][37973]. Additional attributes and flags can control which
5695   library kind is linked and its name. [RFC 1717].
5696 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5697 * [The `--test` flag works with procedural macro crates][38107]
5698 * [Fix `extern "aapcs" fn` ABI][37814]
5699 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5700 * [The `format!` expander recognizes incorrect `printf` and shell-style
5701   formatting directives and suggests the correct format][37613].
5702 * [Only report one error for all unused imports in an import list][37456]
5703
5704 Compiler Performance
5705 --------------------
5706
5707 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5708 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5709 * [Don't clone in `UnificationTable::probe`][37848]
5710 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5711 * [Use small vectors in type walker][37760]
5712 * [Macro expansion performance was improved][37701]
5713 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5714 * [Replace FNV with a faster hash function][37229]
5715
5716 Stabilized APIs
5717 ---------------
5718
5719 * [`std::iter::Iterator::min_by`]
5720 * [`std::iter::Iterator::max_by`]
5721 * [`std::os::*::fs::FileExt`]
5722 * [`std::sync::atomic::Atomic*::get_mut`]
5723 * [`std::sync::atomic::Atomic*::into_inner`]
5724 * [`std::vec::IntoIter::as_slice`]
5725 * [`std::vec::IntoIter::as_mut_slice`]
5726 * [`std::sync::mpsc::Receiver::try_iter`]
5727 * [`std::os::unix::process::CommandExt::before_exec`]
5728 * [`std::rc::Rc::strong_count`]
5729 * [`std::rc::Rc::weak_count`]
5730 * [`std::sync::Arc::strong_count`]
5731 * [`std::sync::Arc::weak_count`]
5732 * [`std::char::encode_utf8`]
5733 * [`std::char::encode_utf16`]
5734 * [`std::cell::Ref::clone`]
5735 * [`std::io::Take::into_inner`]
5736
5737 Libraries
5738 ---------
5739
5740 * [The standard sorting algorithm has been rewritten for dramatic performance
5741   improvements][38192]. It is a hybrid merge sort, drawing influences from
5742   Timsort. Previously it was a naive merge sort.
5743 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5744 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5745   performance.
5746 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5747   and `char_indices().last()`][37882]
5748 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5749 * [Chinese characters display correctly in `fmt::Debug`][37855]
5750 * [Derive `Default` for `Duration`][37699]
5751 * [Support creation of anonymous pipes on WinXP/2k][37677]
5752 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5753 * [Don't pass overlapped handles to processes][38835]
5754
5755 Cargo
5756 -----
5757
5758 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5759   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5760   should instead check the variable at runtime with `std::env`. That the value
5761   was set at build time was a bug, and incorrect when cross-compiling. This
5762   change is known to cause breakage.
5763 * [Add `--all` flag to `cargo test`][cargo/3221]
5764 * [Compile statically against the MSVC CRT][cargo/3363]
5765 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5766 * [Link OpenSSL statically on OSX][cargo/3311]
5767 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5768 * [Test for bad path overrides with summaries][cargo/3336]
5769 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5770 * [Fix retrying crate downloads for network errors][cargo/3348]
5771 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5772 * [Emit more info on --message-format=json][cargo/3319]
5773 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5774 * [Don't ignore errors in workspace manifest][cargo/3409]
5775 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5776
5777 Tooling
5778 -------
5779
5780 * [Test runners (binaries built with `--test`) now support a `--list` argument
5781   that lists the tests it contains][38185]
5782 * [Test runners now support a `--exact` argument that makes the test filter
5783   match exactly, instead of matching only a substring of the test name][38181]
5784 * [rustdoc supports a `--playground-url` flag][37763]
5785 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5786
5787 Misc
5788 ----
5789
5790 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5791   continue to be used in this release by passing `--disable-rustbuild` to the
5792   configure script, but they will be deleted soon. Note that the new build
5793   system uses a different on-disk layout that will likely affect any scripts
5794   building Rust.
5795 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5796   releases.
5797 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5798 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5799   releases.
5800
5801 Compatibility Notes
5802 -------------------
5803
5804 * [A number of minor changes to name resolution have been activated][37127].
5805   They add up to more consistent semantics, allowing for future evolution of
5806   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5807   details of what is different. The breaking changes here have been transitioned
5808   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5809 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5810   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5811   should instead check the variable at runtime with `std::env`. That the value
5812   was set at build time was a bug, and incorrect when cross-compiling. This
5813   change is known to cause breakage.
5814 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5815   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5816   1.10 and is now an error by default. It will become a hard error in the near
5817   future.
5818 * [The semantics relating modules to file system directories are changing in
5819   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5820   lint, which is a warning in this release, and will become a hard error in the
5821   future.
5822 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5823 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5824   the underlying iterator][37834]
5825
5826 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5827 [33685]: https://github.com/rust-lang/rust/issues/33685
5828 [36868]: https://github.com/rust-lang/rust/pull/36868
5829 [37127]: https://github.com/rust-lang/rust/pull/37127
5830 [37229]: https://github.com/rust-lang/rust/pull/37229
5831 [37456]: https://github.com/rust-lang/rust/pull/37456
5832 [37527]: https://github.com/rust-lang/rust/pull/37527
5833 [37602]: https://github.com/rust-lang/rust/pull/37602
5834 [37613]: https://github.com/rust-lang/rust/pull/37613
5835 [37615]: https://github.com/rust-lang/rust/pull/37615
5836 [37636]: https://github.com/rust-lang/rust/pull/37636
5837 [37627]: https://github.com/rust-lang/rust/pull/37627
5838 [37642]: https://github.com/rust-lang/rust/pull/37642
5839 [37677]: https://github.com/rust-lang/rust/pull/37677
5840 [37699]: https://github.com/rust-lang/rust/pull/37699
5841 [37701]: https://github.com/rust-lang/rust/pull/37701
5842 [37705]: https://github.com/rust-lang/rust/pull/37705
5843 [37749]: https://github.com/rust-lang/rust/pull/37749
5844 [37760]: https://github.com/rust-lang/rust/pull/37760
5845 [37763]: https://github.com/rust-lang/rust/pull/37763
5846 [37764]: https://github.com/rust-lang/rust/pull/37764
5847 [37789]: https://github.com/rust-lang/rust/pull/37789
5848 [37791]: https://github.com/rust-lang/rust/pull/37791
5849 [37814]: https://github.com/rust-lang/rust/pull/37814
5850 [37817]: https://github.com/rust-lang/rust/pull/37817
5851 [37834]: https://github.com/rust-lang/rust/pull/37834
5852 [37848]: https://github.com/rust-lang/rust/pull/37848
5853 [37855]: https://github.com/rust-lang/rust/pull/37855
5854 [37882]: https://github.com/rust-lang/rust/pull/37882
5855 [37888]: https://github.com/rust-lang/rust/pull/37888
5856 [37973]: https://github.com/rust-lang/rust/pull/37973
5857 [37979]: https://github.com/rust-lang/rust/pull/37979
5858 [38086]: https://github.com/rust-lang/rust/pull/38086
5859 [38107]: https://github.com/rust-lang/rust/pull/38107
5860 [38117]: https://github.com/rust-lang/rust/pull/38117
5861 [38134]: https://github.com/rust-lang/rust/pull/38134
5862 [38146]: https://github.com/rust-lang/rust/pull/38146
5863 [38181]: https://github.com/rust-lang/rust/pull/38181
5864 [38182]: https://github.com/rust-lang/rust/pull/38182
5865 [38185]: https://github.com/rust-lang/rust/pull/38185
5866 [38192]: https://github.com/rust-lang/rust/pull/38192
5867 [38279]: https://github.com/rust-lang/rust/pull/38279
5868 [38835]: https://github.com/rust-lang/rust/pull/38835
5869 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5870 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5871 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5872 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5873 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5874 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5875 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5876 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5877 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5878 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5879 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5880 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5881 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5882 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5883 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5884 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5885 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5886 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5887 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5888 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5889 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5890 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5891 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5892 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5893 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5894 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5895 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5896 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5897 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5898 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5899 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5900 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5901 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5902 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5903 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5904 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5905 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5906 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5907
5908
5909 Version 1.14.0 (2016-12-22)
5910 ===========================
5911
5912 Language
5913 --------
5914
5915 * [`..` matches multiple tuple fields in enum variants, structs
5916   and tuples][36843]. [RFC 1492].
5917 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5918 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5919 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5920   dereferencing][36822]
5921
5922 Compiler
5923 --------
5924
5925 * [Mark enums with non-zero discriminant as non-zero][37224]
5926 * [Lower-case `static mut` names are linted like other
5927   statics and consts][37162]
5928 * [Fix ICE on some macros in const integer positions
5929    (e.g. `[u8; m!()]`)][36819]
5930 * [Improve error message and snippet for "did you mean `x`"][36798]
5931 * [Add a panic-strategy field to the target specification][36794]
5932 * [Include LLVM version in `--version --verbose`][37200]
5933
5934 Compile-time Optimizations
5935 --------------------------
5936
5937 * [Improve macro expansion performance][37569]
5938 * [Shrink `Expr_::ExprInlineAsm`][37445]
5939 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5940 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5941 * [Avoid more allocations when compiling html5ever][37373]
5942 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5943 * [Avoid some allocations in the macro parser][37318]
5944 * [Use a faster deflate setting][37298]
5945 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5946   during interning of slices][37270]
5947 * [Optimize `write_metadata`][37267]
5948 * [Don't process obligation forest cycles when stalled][37231]
5949 * [Avoid many `CrateConfig` clones][37161]
5950 * [Optimize `Substs::super_fold_with`][37108]
5951 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5952 * [Speed up `plug_leaks`][36917]
5953
5954 Libraries
5955 ---------
5956
5957 * [`println!()`, with no arguments, prints newline][36825].
5958   Previously, an empty string was required to achieve the same.
5959 * [`Wrapping` impls standard binary and unary operators, as well as
5960    the `Sum` and `Product` iterators][37356]
5961 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5962   Vec<T>`][37326]
5963 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5964   `VecDeque` iterators][37315]
5965 * [Improve `SipHasher` performance on small values][37312]
5966 * [Add Iterator trait TrustedLen to enable better FromIterator /
5967   Extend][37306]
5968 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5969 * [`ReadDir` implements `Debug`][37221]
5970 * [Implement `RefUnwindSafe` for atomic types][37178]
5971 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5972 * [Avoid allocations in `Decoder::read_str`][37064]
5973 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5974 * [Impl `Debug` for raw pointers to unsized data][36880]
5975 * [Don't reuse `HashMap` random seeds][37470]
5976 * [The internal memory layout of `HashMap` is more cache-friendly, for
5977   significant improvements in some operations][36692]
5978 * [`HashMap` uses less memory on 32-bit architectures][36595]
5979 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5980
5981 Cargo
5982 -----
5983
5984 * [Expose rustc cfg values to build scripts][cargo/3243]
5985 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5986 * [Fix passing --features when testing multiple packages][cargo/3280]
5987 * [Use a single profile set per workspace][cargo/3249]
5988 * [Load `replace` sections from lock files][cargo/3220]
5989 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5990
5991 Tooling
5992 -------
5993
5994 * [rustup is the recommended Rust installation method][1.14rustup]
5995 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5996   S390x. These are [tier 2] platforms and may have major defects. Follow the
5997   instructions on the website to install, or add the targets to an existing
5998   installation with `rustup target add`. The new target triples are:
5999   - `mips-unknown-linux-gnu`
6000   - `mipsel-unknown-linux-gnu`
6001   - `mips64-unknown-linux-gnuabi64`
6002   - `mips64el-unknown-linux-gnuabi64 `
6003   - `powerpc-unknown-linux-gnu`
6004   - `powerpc64-unknown-linux-gnu`
6005   - `powerpc64le-unknown-linux-gnu`
6006   - `s390x-unknown-linux-gnu `
6007 * This release includes target (std) builds for ARM Linux running MUSL
6008   libc. These are [tier 2] platforms and may have major defects. Add the
6009   following triples to an existing rustup installation with `rustup target add`:
6010   - `arm-unknown-linux-musleabi`
6011   - `arm-unknown-linux-musleabihf`
6012   - `armv7-unknown-linux-musleabihf`
6013 * This release includes [experimental support for WebAssembly][1.14wasm], via
6014   the `wasm32-unknown-emscripten` target. This target is known to have major
6015   defects. Please test, report, and fix.
6016 * rustup no longer installs documentation by default. Run `rustup
6017   component add rust-docs` to install.
6018 * [Fix line stepping in debugger][37310]
6019 * [Enable line number debuginfo in releases][37280]
6020
6021 Misc
6022 ----
6023
6024 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6025 * [Add support for Fuchsia OS][37313]
6026 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6027
6028 Compatibility Notes
6029 -------------------
6030
6031 * [A number of forward-compatibility lints used by the compiler
6032   to gradually introduce language changes have been converted
6033   to deny by default][36894]:
6034   - ["use of inaccessible extern crate erroneously allowed"][36886]
6035   - ["type parameter default erroneously allowed in invalid location"][36887]
6036   - ["detects super or self keywords at the beginning of global path"][36888]
6037   - ["two overlapping inherent impls define an item with the same name
6038     were erroneously allowed"][36889]
6039   - ["floating-point constants cannot be used in patterns"][36890]
6040   - ["constants of struct or enum type can only be used in a pattern if
6041      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6042   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6043 * [Prohibit patterns in trait methods without bodies][37378]
6044 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6045 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6046 * [The `$crate` macro variable is accepted in fewer locations][37213]
6047 * [Impls specifying extra region requirements beyond the trait
6048   they implement are rejected][37167]
6049 * [Enums may not be unsized][37111]. Unsized enums are intended to
6050   work but never have. For now they are forbidden.
6051 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6052
6053 [tier 2]: https://forge.rust-lang.org/platform-support.html
6054 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6055 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6056 [36430]: https://github.com/rust-lang/rust/pull/36430
6057 [36595]: https://github.com/rust-lang/rust/pull/36595
6058 [36595]: https://github.com/rust-lang/rust/pull/36595
6059 [36692]: https://github.com/rust-lang/rust/pull/36692
6060 [36767]: https://github.com/rust-lang/rust/pull/36767
6061 [36794]: https://github.com/rust-lang/rust/pull/36794
6062 [36798]: https://github.com/rust-lang/rust/pull/36798
6063 [36819]: https://github.com/rust-lang/rust/pull/36819
6064 [36822]: https://github.com/rust-lang/rust/pull/36822
6065 [36825]: https://github.com/rust-lang/rust/pull/36825
6066 [36843]: https://github.com/rust-lang/rust/pull/36843
6067 [36880]: https://github.com/rust-lang/rust/pull/36880
6068 [36886]: https://github.com/rust-lang/rust/issues/36886
6069 [36887]: https://github.com/rust-lang/rust/issues/36887
6070 [36888]: https://github.com/rust-lang/rust/issues/36888
6071 [36889]: https://github.com/rust-lang/rust/issues/36889
6072 [36890]: https://github.com/rust-lang/rust/issues/36890
6073 [36891]: https://github.com/rust-lang/rust/issues/36891
6074 [36892]: https://github.com/rust-lang/rust/issues/36892
6075 [36894]: https://github.com/rust-lang/rust/pull/36894
6076 [36917]: https://github.com/rust-lang/rust/pull/36917
6077 [36993]: https://github.com/rust-lang/rust/pull/36993
6078 [37037]: https://github.com/rust-lang/rust/pull/37037
6079 [37064]: https://github.com/rust-lang/rust/pull/37064
6080 [37094]: https://github.com/rust-lang/rust/pull/37094
6081 [37108]: https://github.com/rust-lang/rust/pull/37108
6082 [37111]: https://github.com/rust-lang/rust/pull/37111
6083 [37161]: https://github.com/rust-lang/rust/pull/37161
6084 [37162]: https://github.com/rust-lang/rust/pull/37162
6085 [37167]: https://github.com/rust-lang/rust/pull/37167
6086 [37178]: https://github.com/rust-lang/rust/pull/37178
6087 [37200]: https://github.com/rust-lang/rust/pull/37200
6088 [37213]: https://github.com/rust-lang/rust/pull/37213
6089 [37221]: https://github.com/rust-lang/rust/pull/37221
6090 [37224]: https://github.com/rust-lang/rust/pull/37224
6091 [37230]: https://github.com/rust-lang/rust/pull/37230
6092 [37231]: https://github.com/rust-lang/rust/pull/37231
6093 [37247]: https://github.com/rust-lang/rust/pull/37247
6094 [37267]: https://github.com/rust-lang/rust/pull/37267
6095 [37270]: https://github.com/rust-lang/rust/pull/37270
6096 [37273]: https://github.com/rust-lang/rust/pull/37273
6097 [37280]: https://github.com/rust-lang/rust/pull/37280
6098 [37298]: https://github.com/rust-lang/rust/pull/37298
6099 [37306]: https://github.com/rust-lang/rust/pull/37306
6100 [37310]: https://github.com/rust-lang/rust/pull/37310
6101 [37312]: https://github.com/rust-lang/rust/pull/37312
6102 [37313]: https://github.com/rust-lang/rust/pull/37313
6103 [37315]: https://github.com/rust-lang/rust/pull/37315
6104 [37318]: https://github.com/rust-lang/rust/pull/37318
6105 [37322]: https://github.com/rust-lang/rust/pull/37322
6106 [37326]: https://github.com/rust-lang/rust/pull/37326
6107 [37351]: https://github.com/rust-lang/rust/pull/37351
6108 [37356]: https://github.com/rust-lang/rust/pull/37356
6109 [37367]: https://github.com/rust-lang/rust/pull/37367
6110 [37373]: https://github.com/rust-lang/rust/pull/37373
6111 [37378]: https://github.com/rust-lang/rust/pull/37378
6112 [37389]: https://github.com/rust-lang/rust/pull/37389
6113 [37392]: https://github.com/rust-lang/rust/pull/37392
6114 [37427]: https://github.com/rust-lang/rust/pull/37427
6115 [37439]: https://github.com/rust-lang/rust/pull/37439
6116 [37445]: https://github.com/rust-lang/rust/pull/37445
6117 [37470]: https://github.com/rust-lang/rust/pull/37470
6118 [37569]: https://github.com/rust-lang/rust/pull/37569
6119 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6120 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6121 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6122 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6123 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6124 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6125 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6126
6127
6128 Version 1.13.0 (2016-11-10)
6129 ===========================
6130
6131 Language
6132 --------
6133
6134 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6135   errors, like the `try!` macro, described in [RFC 0243].
6136 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6137 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6138 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6139 * [Fix lifetime rules for 'if' conditions][36029]
6140 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6141
6142 Compiler
6143 --------
6144
6145 * [Add the `-C link-arg` argument][36574]
6146 * [Remove the old AST-based backend from rustc_trans][35764]
6147 * [Don't enable NEON by default on armv7 Linux][35814]
6148 * [Fix debug line number info for macro expansions][35238]
6149 * [Do not emit "class method" debuginfo for types that are not
6150   DICompositeType][36008]
6151 * [Warn about multiple conflicting #[repr] hints][34623]
6152 * [When sizing DST, don't double-count nested struct prefixes][36351]
6153 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6154 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6155 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6156 * [Expand macros without recursing to avoid stack overflows][36214]
6157
6158 Diagnostics
6159 -----------
6160
6161 * [Replace macro backtraces with labeled local uses][35702]
6162 * [Improve error message for misplaced doc comments][33922]
6163 * [Buffer unix and lock windows to prevent message interleaving][35975]
6164 * [Update lifetime errors to specifically note temporaries][36171]
6165 * [Special case a few colors for Windows][36178]
6166 * [Suggest `use self` when such an import resolves][36289]
6167 * [Be more specific when type parameter shadows primitive type][36338]
6168 * Many minor improvements
6169
6170 Compile-time Optimizations
6171 --------------------------
6172
6173 * [Compute and cache HIR hashes at beginning][35854]
6174 * [Don't hash types in loan paths][36004]
6175 * [Cache projections in trans][35761]
6176 * [Optimize the parser's last token handling][36527]
6177 * [Only instantiate #[inline] functions in codegen units referencing
6178   them][36524]. This leads to big improvements in cases where crates export
6179   define many inline functions without using them directly.
6180 * [Lazily allocate TypedArena's first chunk][36592]
6181 * [Don't allocate during default HashSet creation][36734]
6182
6183 Stabilized APIs
6184 ---------------
6185
6186 * [`checked_abs`]
6187 * [`wrapping_abs`]
6188 * [`overflowing_abs`]
6189 * [`RefCell::try_borrow`]
6190 * [`RefCell::try_borrow_mut`]
6191
6192 Libraries
6193 ---------
6194
6195 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6196 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6197   covariant][35354]
6198 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6199 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6200 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6201 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6202 * [Use arc4rand on FreeBSD][35884]
6203 * [memrchr: Correct aligned offset computation][35969]
6204 * [Improve Demangling of Rust Symbols][36059]
6205 * [Use monotonic time in condition variables][35048]
6206 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6207 * [Implement conversion traits for `char`][35755]
6208 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6209 * [Zero first byte of CString on drop][36264]
6210 * [Inherit overflow checks for sum and product][36372]
6211 * [Add missing Eq implementations][36423]
6212 * [Implement `Debug` for `DirEntry`][36631]
6213 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6214   `errno`][36754]
6215 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6216 * [Implement more traits for `std::io::ErrorKind`][35911]
6217 * [Optimize BinaryHeap bounds checking][36072]
6218 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6219   `extend_with_element`][36355]
6220 * [Fix overflow checking in unsigned pow()][34942]
6221
6222 Cargo
6223 -----
6224
6225 * This release includes security fixes to both curl and OpenSSL.
6226 * [Fix transitive doctests when panic=abort][cargo/3021]
6227 * [Add --all-features flag to cargo][cargo/3038]
6228 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6229 * [Don't parse the home directory more than once][cargo/3078]
6230 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6231 * [Update OpenSSL to 1.0.2j][cargo/3121]
6232 * [Add license and license_file to cargo metadata output][cargo/3110]
6233 * [Make crates-io registry URL optional in config; ignore all changes to
6234   source.crates-io][cargo/3089]
6235 * [Don't download dependencies from other platforms][cargo/3123]
6236 * [Build transitive dev-dependencies when needed][cargo/3125]
6237 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6238 * [Avoid updating registry when adding existing deps][cargo/3144]
6239 * [Warn about path overrides that won't work][cargo/3136]
6240 * [Use workspaces during `cargo install`][cargo/3146]
6241 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6242 * [Add --message-format flag][cargo/3000]
6243 * [Pass target environment for rustdoc][cargo/3205]
6244 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6245 * [Update curl and curl-sys][cargo/3241]
6246 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6247
6248 Tooling
6249 -------
6250
6251 * [rustdoc: Add the `--sysroot` argument][36586]
6252 * [rustdoc: Fix a couple of issues with the search results][35655]
6253 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6254 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6255 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6256
6257 Misc
6258 ----
6259
6260 * [Remove unmaintained style guide][35124]
6261 * [Add s390x support][36369]
6262 * [Initial work at Haiku OS support][36727]
6263 * [Add mips-uclibc targets][35734]
6264 * [Crate-ify compiler-rt into compiler-builtins][35021]
6265 * [Add rustc version info (git hash + date) to dist tarball][36213]
6266 * Many documentation improvements
6267
6268 Compatibility Notes
6269 -------------------
6270
6271 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6272 * [Deny (by default) transmuting from fn item types to pointer-sized
6273   types][34923]. Continuing the long transition to zero-sized fn items,
6274   per [RFC 401].
6275 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6276   Part of [RFC 1506].
6277 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6278 * [Fix lifetime rules for 'if' conditions][36029].
6279 * [Inherit overflow checks for sum and product][36372].
6280 * [Forbid user-defined macros named "macro_rules"][36730].
6281
6282 [33922]: https://github.com/rust-lang/rust/pull/33922
6283 [34623]: https://github.com/rust-lang/rust/pull/34623
6284 [34923]: https://github.com/rust-lang/rust/pull/34923
6285 [34942]: https://github.com/rust-lang/rust/pull/34942
6286 [34982]: https://github.com/rust-lang/rust/pull/34982
6287 [35021]: https://github.com/rust-lang/rust/pull/35021
6288 [35048]: https://github.com/rust-lang/rust/pull/35048
6289 [35074]: https://github.com/rust-lang/rust/pull/35074
6290 [35124]: https://github.com/rust-lang/rust/pull/35124
6291 [35234]: https://github.com/rust-lang/rust/pull/35234
6292 [35238]: https://github.com/rust-lang/rust/pull/35238
6293 [35354]: https://github.com/rust-lang/rust/pull/35354
6294 [35559]: https://github.com/rust-lang/rust/pull/35559
6295 [35585]: https://github.com/rust-lang/rust/pull/35585
6296 [35627]: https://github.com/rust-lang/rust/pull/35627
6297 [35655]: https://github.com/rust-lang/rust/pull/35655
6298 [35702]: https://github.com/rust-lang/rust/pull/35702
6299 [35707]: https://github.com/rust-lang/rust/pull/35707
6300 [35728]: https://github.com/rust-lang/rust/pull/35728
6301 [35734]: https://github.com/rust-lang/rust/pull/35734
6302 [35755]: https://github.com/rust-lang/rust/pull/35755
6303 [35761]: https://github.com/rust-lang/rust/pull/35761
6304 [35764]: https://github.com/rust-lang/rust/pull/35764
6305 [35814]: https://github.com/rust-lang/rust/pull/35814
6306 [35854]: https://github.com/rust-lang/rust/pull/35854
6307 [35871]: https://github.com/rust-lang/rust/pull/35871
6308 [35884]: https://github.com/rust-lang/rust/pull/35884
6309 [35911]: https://github.com/rust-lang/rust/pull/35911
6310 [35969]: https://github.com/rust-lang/rust/pull/35969
6311 [35975]: https://github.com/rust-lang/rust/pull/35975
6312 [36004]: https://github.com/rust-lang/rust/pull/36004
6313 [36008]: https://github.com/rust-lang/rust/pull/36008
6314 [36014]: https://github.com/rust-lang/rust/pull/36014
6315 [36029]: https://github.com/rust-lang/rust/pull/36029
6316 [36059]: https://github.com/rust-lang/rust/pull/36059
6317 [36072]: https://github.com/rust-lang/rust/pull/36072
6318 [36101]: https://github.com/rust-lang/rust/pull/36101
6319 [36104]: https://github.com/rust-lang/rust/pull/36104
6320 [36171]: https://github.com/rust-lang/rust/pull/36171
6321 [36173]: https://github.com/rust-lang/rust/pull/36173
6322 [36178]: https://github.com/rust-lang/rust/pull/36178
6323 [36213]: https://github.com/rust-lang/rust/pull/36213
6324 [36214]: https://github.com/rust-lang/rust/pull/36214
6325 [36264]: https://github.com/rust-lang/rust/pull/36264
6326 [36266]: https://github.com/rust-lang/rust/pull/36266
6327 [36289]: https://github.com/rust-lang/rust/pull/36289
6328 [36338]: https://github.com/rust-lang/rust/pull/36338
6329 [36351]: https://github.com/rust-lang/rust/pull/36351
6330 [36355]: https://github.com/rust-lang/rust/pull/36355
6331 [36369]: https://github.com/rust-lang/rust/pull/36369
6332 [36372]: https://github.com/rust-lang/rust/pull/36372
6333 [36423]: https://github.com/rust-lang/rust/pull/36423
6334 [36482]: https://github.com/rust-lang/rust/pull/36482
6335 [36505]: https://github.com/rust-lang/rust/pull/36505
6336 [36524]: https://github.com/rust-lang/rust/pull/36524
6337 [36527]: https://github.com/rust-lang/rust/pull/36527
6338 [36551]: https://github.com/rust-lang/rust/pull/36551
6339 [36574]: https://github.com/rust-lang/rust/pull/36574
6340 [36586]: https://github.com/rust-lang/rust/pull/36586
6341 [36592]: https://github.com/rust-lang/rust/pull/36592
6342 [36631]: https://github.com/rust-lang/rust/pull/36631
6343 [36639]: https://github.com/rust-lang/rust/pull/36639
6344 [36721]: https://github.com/rust-lang/rust/pull/36721
6345 [36727]: https://github.com/rust-lang/rust/pull/36727
6346 [36730]: https://github.com/rust-lang/rust/pull/36730
6347 [36734]: https://github.com/rust-lang/rust/pull/36734
6348 [36754]: https://github.com/rust-lang/rust/pull/36754
6349 [36995]: https://github.com/rust-lang/rust/pull/36995
6350 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6351 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6352 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6353 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6354 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6355 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6356 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6357 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6358 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6359 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6360 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6361 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6362 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6363 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6364 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6365 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6366 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6367 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6368 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6369 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6370 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6371 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6372 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6373 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6374 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6375 [rustup]: https://www.rustup.rs
6376 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6377 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6378 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6379 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6380 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6381 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6382 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6383
6384
6385 Version 1.12.1 (2016-10-20)
6386 ===========================
6387
6388 Regression Fixes
6389 ----------------
6390
6391 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6392 * [Confusion with double negation and booleans][36856]
6393 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6394 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6395 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6396 * [Corrupted memory after updated to 1.12][36936]
6397 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6398 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6399 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6400
6401 [36381]: https://github.com/rust-lang/rust/issues/36381
6402 [36856]: https://github.com/rust-lang/rust/issues/36856
6403 [36875]: https://github.com/rust-lang/rust/issues/36875
6404 [36924]: https://github.com/rust-lang/rust/issues/36924
6405 [36926]: https://github.com/rust-lang/rust/issues/36926
6406 [36936]: https://github.com/rust-lang/rust/issues/36936
6407 [37026]: https://github.com/rust-lang/rust/issues/37026
6408 [37112]: https://github.com/rust-lang/rust/issues/37112
6409 [37153]: https://github.com/rust-lang/rust/issues/37153
6410
6411
6412 Version 1.12.0 (2016-09-29)
6413 ===========================
6414
6415 Highlights
6416 ----------
6417
6418 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6419   This translation pass is far simpler than the previous AST->LLVM pass, and
6420   creates opportunities to perform new optimizations directly on the MIR. It
6421   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6422 * [`rustc` presents a new, more readable error format, along with
6423   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6424   Most common editors supporting Rust have been updated to work with it. It was
6425   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6426
6427 Compiler
6428 --------
6429
6430 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6431   This translation pass is far simpler than the previous AST->LLVM pass, and
6432   creates opportunities to perform new optimizations directly on the MIR. It
6433   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6434 * [Print the Rust target name, not the LLVM target name, with
6435   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6436 * [The computation of `TypeId` is correct in some cases where it was previously
6437   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6438 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6439 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6440   `--print relocation-models`, and `--print code-models` print the available
6441   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6442   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6443 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6444   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6445   These targets produce statically-linked binaries. There are no binary release
6446   builds yet though.
6447
6448 Diagnostics
6449 -----------
6450
6451 * [`rustc` presents a new, more readable error format, along with
6452   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6453   Most common editors supporting Rust have been updated to work with it. It was
6454   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6455 * [In error descriptions, references are now described in plain English,
6456   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6457 * [In error type descriptions, unknown numeric types are named `{integer}` or
6458   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6459 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6460
6461 Language
6462 --------
6463
6464 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6465 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6466 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6467   useful](https://github.com/rust-lang/rust/pull/34908)
6468 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6469   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6470 * [Semicolons are properly required as statement delimiters inside
6471   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6472 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6473
6474 Stabilized APIs
6475 ---------------
6476
6477 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6478 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6479 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6480 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6481 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6482 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6483 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6484 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6485 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6486 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6487   Both on Unix and Windows.
6488 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6489 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6490 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6491 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6492 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6493 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6494 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6495 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6496
6497 Libraries
6498 ---------
6499
6500 * [The `format!` macro and friends now allow a single argument to be formatted
6501   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6502 * [The lifetime bounds on `[T]::binary_search_by` and
6503   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6504 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6505 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6506 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6507 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6508 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6509 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6510 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6511 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6512   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6513 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6514   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6515 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6516 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6517   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6518 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6519 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6520 * [`mpsc::sync_channel` `Receiver`s return any available message before
6521   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6522 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6523 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6524
6525 Cargo
6526 -----
6527
6528 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6529 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6530 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6531 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6532 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6533 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6534 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6535 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6536 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6537 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6538 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6539 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6540 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6541 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6542 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6543 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6544
6545 Performance
6546 -----------
6547
6548 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6549 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6550
6551 Tooling
6552 -------
6553
6554 * [Test binaries now support a `--test-threads` argument to specify the number
6555   of threads used to run tests, and which acts the same as the
6556   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6557 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6558 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6559 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6560 * [Rust releases now come with source packages that can be installed by rustup
6561   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6562   The resulting source code can be used by tools and IDES, located in the
6563   sysroot under `lib/rustlib/src`.
6564
6565 Misc
6566 ----
6567
6568 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6569 * Many minor improvements to the documentation.
6570 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6571
6572 Compatibility Notes
6573 -------------------
6574
6575 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6576   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6577 * [When formatting strings, if "precision" is specified, the "fill",
6578   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6579 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6580
6581
6582 Version 1.11.0 (2016-08-18)
6583 ===========================
6584
6585 Language
6586 --------
6587
6588 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6589 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6590 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6591 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6592
6593 Stabilized APIs
6594 ---------------
6595
6596 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6597 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6598 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6599 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6600 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6601 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6602   (in libcore - previously stabilized in libstd)
6603 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6604   (in libcore - previously stabilized in libstd)
6605 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6606   (in libcore - previously stabilized in libstd)
6607 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6608   (in libcore - previously stabilized in libstd)
6609 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6610 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6611 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6612 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6613
6614 Libraries
6615 ---------
6616
6617 * [The `thread_local!` macro supports multiple definitions in a single
6618    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6619 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6620 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6621   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6622 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6623 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6624 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6625 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6626
6627 Cargo
6628 -----
6629
6630 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6631 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6632 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6633 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6634 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6635   and `-vv` prints warnings for all crates.
6636 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6637 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6638   This provides room for expansion by arbitrary tools.
6639 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6640 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6641 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6642 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6643 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6644 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6645 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6646
6647 Performance
6648 -----------
6649
6650 * [Caching projections speeds up type check dramatically for some
6651   workloads](https://github.com/rust-lang/rust/pull/33816)
6652 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6653   This hasher is faster, but is believed to provide sufficient
6654   protection from collision attacks.
6655 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6656
6657 Rustdoc
6658 -------
6659
6660 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6661 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6662 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6663 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6664 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6665
6666 Tooling
6667 -------
6668
6669 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6670 * [When emitting debug info, rustc emits frame pointers for closures,
6671   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6672 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6673 * Many more errors have been given error codes and extended
6674   explanations
6675 * API documentation continues to be improved, with many new examples
6676
6677 Misc
6678 ----
6679
6680 * [rustc no longer hangs when dependencies recursively re-export
6681   submodules](https://github.com/rust-lang/rust/pull/34542)
6682 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6683 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6684   rewritten](https://github.com/rust-lang/rust/pull/33895)
6685 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6686   No targets use this yet, but it works toward AVR support.
6687
6688 Compatibility Notes
6689 -------------------
6690
6691 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6692 * [The new follow-set rules that place restrictions on `macro_rules!`
6693   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6694   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6695   and has been a warning since 1.10.
6696 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6697   This causes breakage in some corner cases.
6698
6699
6700 Version 1.10.0 (2016-07-07)
6701 ===========================
6702
6703 Language
6704 --------
6705
6706 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6707   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6708 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6709 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6710 * [`panic!` can be converted to a runtime abort with the
6711   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6712   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6713 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6714   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6715   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6716   Note that Cargo does not yet directly support cdylibs.
6717
6718 Stabilized APIs
6719 ---------------
6720
6721 * `os::windows::fs::OpenOptionsExt::access_mode`
6722 * `os::windows::fs::OpenOptionsExt::share_mode`
6723 * `os::windows::fs::OpenOptionsExt::custom_flags`
6724 * `os::windows::fs::OpenOptionsExt::attributes`
6725 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6726 * `os::unix::fs::OpenOptionsExt::custom_flags`
6727 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6728 * `Default for sync::Weak`
6729 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6730 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6731 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6732 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6733 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6734 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6735 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6736 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6737 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6738 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6739 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6740 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6741 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6742 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6743 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6744 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6745 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6746 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6747 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6748 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6749 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6750 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6751 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6752 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6753 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6754 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6755 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6756 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6757 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6758 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6759 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6760 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6761 * Read/Write/RawFd impls for `UnixStream`
6762 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6763 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6764 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6765 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6766 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6767 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6768 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6769 * RawFd impls for `UnixListener`
6770 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6771 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6772 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6773 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6774 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6775 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6776 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6777 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6778 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6779 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6780 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6781 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6782 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6783 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6784 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6785 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6786 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6787 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6788 * RawFd impls for `UnixDatagram`
6789 * `{BTree,Hash}Map::values_mut`
6790 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6791
6792 Libraries
6793 ---------
6794
6795 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6796   The semantics of this minor method are subtle and probably not what
6797   most people want.
6798 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6799 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6800   will fall back to `/dev/urandom` temporarily to avoid blocking
6801   during early boot](https://github.com/rust-lang/rust/pull/33086).
6802 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6803 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6804 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6805 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6806 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6807 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6808   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6809
6810 Cargo
6811 -----
6812 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6813   This controls the runtime behavior of the `panic!` macro
6814   and can be either "unwind" (the default), or "abort".
6815   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6816 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6817 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6818 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6819   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6820 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6821 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6822 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6823   By default they are retried twice, which can be customized with the
6824   `net.retry` value in `.cargo/config`.
6825 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6826 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6827 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6828 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6829   Makes it possible to install multiple crates in parallel.
6830 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6831 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6832 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6833 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6834 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6835 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6836
6837 Performance
6838 -----------
6839
6840 * [rustc memory usage was reduced by refactoring the context used for
6841   type checking](https://github.com/rust-lang/rust/pull/33425).
6842 * [Speed up creation of `HashMap`s by caching the random keys used
6843   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6844 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6845 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6846 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6847   10x faster than the previous lookup tables.
6848 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6849
6850 Usability
6851 ---------
6852
6853 * Many incremental improvements to documentation and rustdoc.
6854 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6855 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6856 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6857 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6858 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6859 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6860 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6861
6862 Misc
6863 ----
6864
6865 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6866 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6867 * [`std` no longer prints backtraces on platforms where the running
6868   module must be loaded with `env::current_exe`, which can't be relied
6869   on](https://github.com/rust-lang/rust/pull/33554).
6870 * This release includes std binaries for the i586-unknown-linux-gnu,
6871   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6872   i586 target is for old x86 hardware without SSE2, and the armv7
6873   target is for Android running on modern ARM architectures.
6874 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6875   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6876 * [On Unix the runtime aborts by calling `libc::abort` instead of
6877   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6878 * [Rust is now bootstrapped from the previous release of Rust,
6879   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6880
6881 Compatibility Notes
6882 -------------------
6883
6884 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6885 * [`target_env` for Linux ARM targets is just `gnu`, not
6886   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6887 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6888 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6889 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6890   Affects how macros are parsed.
6891 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6892 * [Feature-gated attributes on macro-generated macro invocations are
6893   now rejected](https://github.com/rust-lang/rust/pull/32791).
6894 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6895   This caused some minor changes to type inference.
6896
6897
6898 Version 1.9.0 (2016-05-26)
6899 ==========================
6900
6901 Language
6902 --------
6903
6904 * The `#[deprecated]` attribute when applied to an API will generate
6905   warnings when used. The warnings may be suppressed with
6906   `#[allow(deprecated)]`. [RFC 1270].
6907 * [`fn` item types are zero sized, and each `fn` names a unique
6908   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6909   `transmute` on a `fn` type will generate a warning for a few cycles,
6910   then will be converted to an error.
6911 * [Field and method resolution understand visibility, so private
6912   fields and methods cannot prevent the proper use of public fields
6913   and methods][1.9fv].
6914 * [The parser considers unicode codepoints in the
6915   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6916
6917 Stabilized APIs
6918 ---------------
6919
6920 * [`std::panic`]
6921 * [`std::panic::catch_unwind`] (renamed from `recover`)
6922 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6923 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6924 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6925 * [`str::is_char_boundary`]
6926 * [`<*const T>::as_ref`]
6927 * [`<*mut T>::as_ref`]
6928 * [`<*mut T>::as_mut`]
6929 * [`AsciiExt::make_ascii_uppercase`]
6930 * [`AsciiExt::make_ascii_lowercase`]
6931 * [`char::decode_utf16`]
6932 * [`char::DecodeUtf16`]
6933 * [`char::DecodeUtf16Error`]
6934 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6935 * [`BTreeSet::take`]
6936 * [`BTreeSet::replace`]
6937 * [`BTreeSet::get`]
6938 * [`HashSet::take`]
6939 * [`HashSet::replace`]
6940 * [`HashSet::get`]
6941 * [`OsString::with_capacity`]
6942 * [`OsString::clear`]
6943 * [`OsString::capacity`]
6944 * [`OsString::reserve`]
6945 * [`OsString::reserve_exact`]
6946 * [`OsStr::is_empty`]
6947 * [`OsStr::len`]
6948 * [`std::os::unix::thread`]
6949 * [`RawPthread`]
6950 * [`JoinHandleExt`]
6951 * [`JoinHandleExt::as_pthread_t`]
6952 * [`JoinHandleExt::into_pthread_t`]
6953 * [`HashSet::hasher`]
6954 * [`HashMap::hasher`]
6955 * [`CommandExt::exec`]
6956 * [`File::try_clone`]
6957 * [`SocketAddr::set_ip`]
6958 * [`SocketAddr::set_port`]
6959 * [`SocketAddrV4::set_ip`]
6960 * [`SocketAddrV4::set_port`]
6961 * [`SocketAddrV6::set_ip`]
6962 * [`SocketAddrV6::set_port`]
6963 * [`SocketAddrV6::set_flowinfo`]
6964 * [`SocketAddrV6::set_scope_id`]
6965 * [`slice::copy_from_slice`]
6966 * [`ptr::read_volatile`]
6967 * [`ptr::write_volatile`]
6968 * [`OpenOptions::create_new`]
6969 * [`TcpStream::set_nodelay`]
6970 * [`TcpStream::nodelay`]
6971 * [`TcpStream::set_ttl`]
6972 * [`TcpStream::ttl`]
6973 * [`TcpStream::set_only_v6`]
6974 * [`TcpStream::only_v6`]
6975 * [`TcpStream::take_error`]
6976 * [`TcpStream::set_nonblocking`]
6977 * [`TcpListener::set_ttl`]
6978 * [`TcpListener::ttl`]
6979 * [`TcpListener::set_only_v6`]
6980 * [`TcpListener::only_v6`]
6981 * [`TcpListener::take_error`]
6982 * [`TcpListener::set_nonblocking`]
6983 * [`UdpSocket::set_broadcast`]
6984 * [`UdpSocket::broadcast`]
6985 * [`UdpSocket::set_multicast_loop_v4`]
6986 * [`UdpSocket::multicast_loop_v4`]
6987 * [`UdpSocket::set_multicast_ttl_v4`]
6988 * [`UdpSocket::multicast_ttl_v4`]
6989 * [`UdpSocket::set_multicast_loop_v6`]
6990 * [`UdpSocket::multicast_loop_v6`]
6991 * [`UdpSocket::set_multicast_ttl_v6`]
6992 * [`UdpSocket::multicast_ttl_v6`]
6993 * [`UdpSocket::set_ttl`]
6994 * [`UdpSocket::ttl`]
6995 * [`UdpSocket::set_only_v6`]
6996 * [`UdpSocket::only_v6`]
6997 * [`UdpSocket::join_multicast_v4`]
6998 * [`UdpSocket::join_multicast_v6`]
6999 * [`UdpSocket::leave_multicast_v4`]
7000 * [`UdpSocket::leave_multicast_v6`]
7001 * [`UdpSocket::take_error`]
7002 * [`UdpSocket::connect`]
7003 * [`UdpSocket::send`]
7004 * [`UdpSocket::recv`]
7005 * [`UdpSocket::set_nonblocking`]
7006
7007 Libraries
7008 ---------
7009
7010 * [`std::sync::Once` is poisoned if its initialization function
7011   fails][1.9o].
7012 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7013 * [Most types implement `fmt::Debug`][1.9db].
7014 * [The default buffer size used by `BufReader` and `BufWriter` was
7015   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7016   used by other languages.
7017 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7018   `Duration` additionally implements `*=` and `/=`][1.9ta].
7019 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7020 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7021 * [`Chain` implements `BufRead`][1.9ch].
7022 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7023
7024 Cargo
7025 -----
7026
7027 * [Cargo can now run concurrently][1.9cc].
7028 * [Top-level overrides allow specific revisions of crates to be
7029   overridden through the entire crate graph][1.9ct].  This is intended
7030   to make upgrades easier for large projects, by allowing crates to be
7031   forked temporarily until they've been upgraded and republished.
7032 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7033 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7034   on the commandline][1.9cf]. `rustc` arguments can also be specified
7035   in the `build.rustflags` configuration key.
7036
7037 Performance
7038 -----------
7039
7040 * [The time complexity of comparing variables for equivalence during type
7041   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7042   to major compilation time improvement in some scenarios.
7043 * [`ToString` is specialized for `str`, giving it the same performance
7044   as `to_owned`][1.9ts].
7045 * [Spawning processes with `Command::output` no longer creates extra
7046   threads][1.9sp].
7047 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7048   for C-like enums][1.9cl].
7049
7050 Misc
7051 ----
7052
7053 * [Passing the `--quiet` flag to a test runner will produce
7054   much-abbreviated output][1.9q].
7055 * The Rust Project now publishes std binaries for the
7056   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7057   `i586-pc-windows-msvc` targets.
7058
7059 Compatibility Notes
7060 -------------------
7061
7062 * [`std::sync::Once` is poisoned if its initialization function
7063   fails][1.9o].
7064 * [It is illegal to define methods with the same name in overlapping
7065   inherent `impl` blocks][1.9sn].
7066 * [`fn` item types are zero sized, and each `fn` names a unique
7067   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7068   `transmute` on a `fn` type will generate a warning for a few cycles,
7069   then will be converted to an error.
7070 * [Improvements to const evaluation may trigger new errors when integer
7071   literals are out of range][1.9ce].
7072
7073
7074 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7075 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7076 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7077 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7078 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7079 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7080 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7081 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7082 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7083 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7084 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7085 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7086 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7087 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7088 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7089 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7090 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7091 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7092 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7093 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7094 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7095 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7096 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7097 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7098 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7099 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7100 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7101 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7102 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7103 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7104 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7105 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7106 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7107 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7108 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7109 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7110 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7111 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7112 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7113 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7114 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7115 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7116 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7117 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7118 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7119 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7120 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7121 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7122 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7123 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7124 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7125 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7126 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7127 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7128 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7129 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7130 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7131 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7132 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7133 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7134 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7135 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7136 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7137 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7138 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7139 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7140 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7141 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7142 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7143 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7144 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7145 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7146 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7147 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7148 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7149 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7150 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7151 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7152 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7153 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7154 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7155 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7156 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7157 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7158 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7159 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7160 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7161 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7162 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7163 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7164 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7165 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7166 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7167 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7168 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7169 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7170 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7171 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7172 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7173 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7174 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7175 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7176 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7177 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7178 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7179 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7180 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7181 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7182 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7183 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7184
7185
7186 Version 1.8.0 (2016-04-14)
7187 ==========================
7188
7189 Language
7190 --------
7191
7192 * Rust supports overloading of compound assignment statements like
7193   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7194   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7195   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7196   traits. [RFC 953].
7197 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7198   addition to the non-braced form, `struct Foo;`. [RFC 218].
7199
7200 Libraries
7201 ---------
7202
7203 * Stabilized APIs:
7204   * [`str::encode_utf16`] (renamed from `utf16_units`)
7205   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7206   * [`Ref::map`]
7207   * [`RefMut::map`]
7208   * [`ptr::drop_in_place`]
7209   * [`time::Instant`]
7210   * [`time::SystemTime`]
7211   * [`Instant::now`]
7212   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7213   * [`Instant::elapsed`]
7214   * [`SystemTime::now`]
7215   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7216   * [`SystemTime::elapsed`]
7217   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7218   * [`SystemTimeError`]
7219   * [`SystemTimeError::duration`]
7220   * Various impls for `SystemTimeError`
7221   * [`UNIX_EPOCH`]
7222   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7223     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7224     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7225 * [The `write!` and `writeln!` macros correctly emit errors if any of
7226   their arguments can't be formatted][1.8w].
7227 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7228 * [The Unix-specific `raw` modules, which contain a number of
7229   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7230   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7231   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7232   across platforms was making it difficult to implement `std`
7233   correctly. Those that need these definitions should use the `libc`
7234   crate. [RFC 1415].
7235 * The Unix-specific `MetadataExt` traits, including
7236   `os::unix::fs::MetadataExt`, which expose values such as inode
7237   numbers [no longer return platform-specific types][1.8r], but
7238   instead return widened integers. [RFC 1415].
7239 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7240 * [Atomic loads and stores are not volatile][1.8a].
7241 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7242
7243 Performance
7244 -----------
7245
7246 * [Inlining hash functions lead to a 3% compile-time improvement in
7247   some workloads][1.8h].
7248 * When using jemalloc, its symbols are [unprefixed so that it
7249   overrides the libc malloc implementation][1.8h]. This means that for
7250   rustc, LLVM is now using jemalloc, which results in a 6%
7251   compile-time improvement on a specific workload.
7252 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7253
7254 Misc
7255 ----
7256
7257 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7258   i686-pc-windows-msvc is now considered a tier-1 platform.
7259 * [The `--print targets` flag prints a list of supported targets][1.8t].
7260 * [The `--print cfg` flag prints the `cfg`s defined for the current
7261   target][1.8cf].
7262 * [`rustc` can be built with an new Cargo-based build system, written
7263   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7264   build system. To enable it configure with `configure --rustbuild`.
7265 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7266   variants while also indicating the total number of missing variants
7267   if more than 3][1.8m].
7268 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7269 * The Rust Project now publishes binary releases of the standard
7270   library for a number of tier-2 targets:
7271   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7272   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7273   `x86_64-rumprun-netbsd`. These can be installed with
7274   tools such as [multirust][1.8mr].
7275
7276 Cargo
7277 -----
7278
7279 * [`cargo init` creates a new Cargo project in the current
7280   directory][1.8ci].  It is otherwise like `cargo new`.
7281 * [Cargo has configuration keys for `-v` and
7282   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7283   `[term]` section of `.cargo/config`.
7284 * [Configuration keys that evaluate to strings or integers can be set
7285   via environment variables][1.8ce]. For example the `build.jobs` key
7286   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7287   precedence over config files.
7288 * [Target-specific dependencies support Rust `cfg` syntax for
7289   describing targets][1.8cfg] so that dependencies for multiple
7290   targets can be specified together. [RFC 1361].
7291 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7292   `RUSTDOC` take precedence over the `build.target-dir`,
7293   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7294 * [The child process tree is killed on Windows when Cargo is
7295   killed][1.8ck].
7296 * [The `build.target` configuration value sets the target platform,
7297   like `--target`][1.8ct].
7298
7299 Compatibility Notes
7300 -------------------
7301
7302 * [Unstable compiler flags have been further restricted][1.8u]. Since
7303   1.0 `-Z` flags have been considered unstable, and other flags that
7304   were considered unstable additionally required passing `-Z
7305   unstable-options` to access. Unlike unstable language and library
7306   features though, these options have been accessible on the stable
7307   release channel. Going forward, *new unstable flags will not be
7308   available on the stable release channel*, and old unstable flags
7309   will warn about their usage. In the future, all unstable flags will
7310   be unavailable on the stable release channel.
7311 * [It is no longer possible to `match` on empty enum variants using
7312   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7313 * The Unix-specific `MetadataExt` traits, including
7314   `os::unix::fs::MetadataExt`, which expose values such as inode
7315   numbers [no longer return platform-specific types][1.8r], but
7316   instead return widened integers. [RFC 1415].
7317 * [Modules sourced from the filesystem cannot appear within arbitrary
7318   blocks, but only within other modules][1.8mf].
7319 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7320 * On Unix, [stack overflow triggers a runtime abort instead of a
7321   SIGSEGV][1.8so].
7322 * [`Command::spawn` and its equivalents return an error if any of
7323   its command-line arguments contain interior `NUL`s][1.8n].
7324 * [Tuple and unit enum variants from other crates are in the type
7325   namespace][1.8tn].
7326 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7327   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7328   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7329   instead of `foo.lib`.
7330
7331
7332 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7333 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7334 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7335 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7336 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7337 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7338 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7339 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7340 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7341 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7342 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7343 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7344 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7345 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7346 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7347 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7348 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7349 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7350 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7351 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7352 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7353 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7354 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7355 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7356 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7357 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7358 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7359 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7360 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7361 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7362 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7363 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7364 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7365 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7366 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7367 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7368 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7369 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7370 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7371 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7372 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7373 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7374 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7375 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7376 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7377 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7378 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7379 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7380 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7381 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7382 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7383 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7384 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7385 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7386 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7387 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7388 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7389 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7390 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7391 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7392
7393
7394 Version 1.7.0 (2016-03-03)
7395 ==========================
7396
7397 Libraries
7398 ---------
7399
7400 * Stabilized APIs
7401   * `Path`
7402     * [`Path::strip_prefix`] (renamed from relative_from)
7403     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7404   * `Ipv4Addr`
7405     * [`Ipv4Addr::is_loopback`]
7406     * [`Ipv4Addr::is_private`]
7407     * [`Ipv4Addr::is_link_local`]
7408     * [`Ipv4Addr::is_multicast`]
7409     * [`Ipv4Addr::is_broadcast`]
7410     * [`Ipv4Addr::is_documentation`]
7411   * `Ipv6Addr`
7412     * [`Ipv6Addr::is_unspecified`]
7413     * [`Ipv6Addr::is_loopback`]
7414     * [`Ipv6Addr::is_multicast`]
7415   * `Vec`
7416     * [`Vec::as_slice`]
7417     * [`Vec::as_mut_slice`]
7418   * `String`
7419     * [`String::as_str`]
7420     * [`String::as_mut_str`]
7421   * Slices
7422     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7423     be the same length
7424     * `<[T]>::`[`sort_by_key`]
7425   * checked, saturated, and overflowing operations
7426     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7427     * [`i32::saturating_mul`]
7428     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7429     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7430     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7431     * [`u32::saturating_mul`]
7432     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7433     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7434     * and checked, saturated, and overflowing operations for other primitive types
7435   * FFI
7436     * [`ffi::IntoStringError`]
7437     * [`CString::into_string`]
7438     * [`CString::into_bytes`]
7439     * [`CString::into_bytes_with_nul`]
7440     * `From<CString> for Vec<u8>`
7441   * `IntoStringError`
7442     * [`IntoStringError::into_cstring`]
7443     * [`IntoStringError::utf8_error`]
7444     * `Error for IntoStringError`
7445   * Hashing
7446     * [`std::hash::BuildHasher`]
7447     * [`BuildHasher::Hasher`]
7448     * [`BuildHasher::build_hasher`]
7449     * [`std::hash::BuildHasherDefault`]
7450     * [`HashMap::with_hasher`]
7451     * [`HashMap::with_capacity_and_hasher`]
7452     * [`HashSet::with_hasher`]
7453     * [`HashSet::with_capacity_and_hasher`]
7454     * [`std::collections::hash_map::RandomState`]
7455     * [`RandomState::new`]
7456 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7457   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7458   from bytes is faster.
7459 * [The performance of `LineWriter` (and thus `io::stdout`) was
7460   improved by using `memchr` to search for newlines][1.7m].
7461 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7462   `f64` variants were stabilized previously.
7463 * [`BTreeMap` was rewritten to use less memory and improve the performance
7464   of insertion and iteration, the latter by as much as 5x][1.7bm].
7465 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7466   covariant over their contained type][1.7bt].
7467 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7468   over their contained type][1.7ll].
7469 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7470   searching methods.
7471 * [`Any` is implemented for unsized types][1.7a].
7472 * [`Hash` is implemented for `Duration`][1.7h].
7473
7474 Misc
7475 ----
7476
7477 * [When running tests with `--test`, rustdoc will pass `--cfg`
7478   arguments to the compiler][1.7dt].
7479 * [The compiler is built with RPATH information by default][1.7rpa].
7480   This means that it will be possible to run `rustc` when installed in
7481   unusual configurations without configuring the dynamic linker search
7482   path explicitly.
7483 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7484   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7485   over `LD_LIBRARY_PATH`.
7486
7487 Cargo
7488 -----
7489
7490 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7491   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7492 * [The `rerun-if-changed` build script directive no longer causes the
7493   build script to incorrectly run twice in certain scenarios][1.7rr].
7494
7495 Compatibility Notes
7496 -------------------
7497
7498 * Soundness fixes to the interactions between associated types and
7499   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7500   code that violates the new rules. This is a significant change that
7501   is known to break existing code, so it has emitted warnings for the
7502   new error cases since 1.4 to give crate authors time to adapt. The
7503   details of what is changing are subtle; read the RFC for more.
7504 * [Several bugs in the compiler's visibility calculations were
7505   fixed][1.7v]. Since this was found to break significant amounts of
7506   code, the new errors will be emitted as warnings for several release
7507   cycles, under the `private_in_public` lint.
7508 * Defaulted type parameters were accidentally accepted in positions
7509   that were not intended. In this release, [defaulted type parameters
7510   appearing outside of type definitions will generate a
7511   warning][1.7d], which will become an error in future releases.
7512 * [Parsing "." as a float results in an error instead of 0][1.7p].
7513   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7514 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7515
7516 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7517 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7518 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7519 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7520 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7521 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7522 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7523 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7524 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7525 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7526 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7527 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7528 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7529 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7530 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7531 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7532 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7533 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7534 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7535 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7536 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7537 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7538 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7539 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7540 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7541 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7542 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7543 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7544 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7545 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7546 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7547 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7548 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7549 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7550 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7551 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7552 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7553 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7554 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7555 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7556 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7557 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7558 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7559 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7560 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7561 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7562 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7563 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7564 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7565 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7566 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7567 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7568 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7569 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7570 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7571 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7572 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7573 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7574 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7575 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7576 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7577 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7578 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7579 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7580 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7581 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7582 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7583 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7584 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7585 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7586 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7587 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7588 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7589 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7590 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7591 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7592 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7593 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7594 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7595
7596
7597 Version 1.6.0 (2016-01-21)
7598 ==========================
7599
7600 Language
7601 --------
7602
7603 * The `#![no_std]` attribute causes a crate to not be linked to the
7604   standard library, but only the [core library][1.6co], as described
7605   in [RFC 1184]. The core library defines common types and traits but
7606   has no platform dependencies whatsoever, and is the basis for Rust
7607   software in environments that cannot support a full port of the
7608   standard library, such as operating systems. Most of the core
7609   library is now stable.
7610
7611 Libraries
7612 ---------
7613
7614 * Stabilized APIs:
7615   [`Read::read_exact`],
7616   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7617   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7618   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7619   [`os::unix::fs::DirBuilderExt`],
7620   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7621   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7622   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7623   [`collections::hash_map::Drain`],
7624   [`collections::hash_map::HashMap::drain`],
7625   [`collections::hash_set::Drain`],
7626   [`collections::hash_set::HashSet::drain`],
7627   [`collections::binary_heap::Drain`],
7628   [`collections::binary_heap::BinaryHeap::drain`],
7629   [`Vec::extend_from_slice`] (renamed from `push_all`),
7630   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7631   [`RwLock::into_inner`],
7632   [`Iterator::min_by_key`] (renamed from `min_by`),
7633   [`Iterator::max_by_key`] (renamed from `max_by`).
7634 * The [core library][1.6co] is stable, as are most of its APIs.
7635 * [The `assert_eq!` macro supports arguments that don't implement
7636   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7637   `assert!`.
7638 * Several timer functions that take duration in milliseconds [are
7639   deprecated in favor of those that take `Duration`][1.6ms]. These
7640   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7641   `thread::park_timeout_ms`.
7642 * The algorithm by which `Vec` reserves additional elements was
7643   [tweaked to not allocate excessive space][1.6a] while still growing
7644   exponentially.
7645 * `From` conversions are [implemented from integers to floats][1.6f]
7646   in cases where the conversion is lossless. Thus they are not
7647   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7648   or `f64`. They are also not implemented for `isize` and `usize`
7649   because the implementations would be platform-specific. `From` is
7650   also implemented from `f32` to `f64`.
7651 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7652 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7653 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7654 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7655   improvements.
7656 * Sorting slices that are already sorted [is 50% faster in some
7657   cases][1.6s].
7658
7659 Cargo
7660 -----
7661
7662 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7663 * Cargo build scripts can specify their dependencies by emitting the
7664   [`rerun-if-changed`][1.6rr] key.
7665 * crates.io will reject publication of crates with dependencies that
7666   have a wildcard version constraint. Crates with wildcard
7667   dependencies were seen to cause a variety of problems, as described
7668   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7669   warning.
7670 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7671   release folder.  A variety of artifacts that Cargo failed to clean
7672   are now correctly deleted.
7673
7674 Misc
7675 ----
7676
7677 * The `unreachable_code` lint [warns when a function call's argument
7678   diverges][1.6dv].
7679 * The parser indicates [failures that may be caused by
7680   confusingly-similar Unicode characters][1.6uc]
7681 * Certain macro errors [are reported at definition time][1.6m], not
7682   expansion.
7683
7684 Compatibility Notes
7685 -------------------
7686
7687 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7688   environment variable when locating crates. This was a pre-cargo
7689   feature for integrating with the package manager that was
7690   accidentally never removed.
7691 * [A number of bugs were fixed in the privacy checker][1.6p] that
7692   could cause previously-accepted code to break.
7693 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7694 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7695   struct pattern syntax (`Foo(..)`) can no longer be used to match
7696   unit structs. This is a warning now, but will become an error in
7697   future releases. Patterns that share the same name as a const are
7698   now an error.
7699 * A bug was fixed that causes [rustc not to apply default type
7700   parameters][1.6xc] when resolving certain method implementations of
7701   traits defined in other crates.
7702
7703 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7704 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7705 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7706 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7707 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7708 [1.6co]: http://doc.rust-lang.org/core/index.html
7709 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7710 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7711 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7712 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7713 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7714 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7715 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7716 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7717 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7718 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7719 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7720 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7721 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7722 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7723 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7724 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7725 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7726 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7727 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7728 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7729 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7730 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7731 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7732 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7733 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7734 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7735 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7736 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7737 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7738 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7739 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7740 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7741 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7742 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7743 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7744 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7745 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7746 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7747 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7748 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7749 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7750
7751
7752 Version 1.5.0 (2015-12-10)
7753 ==========================
7754
7755 * ~700 changes, numerous bugfixes
7756
7757 Highlights
7758 ----------
7759
7760 * Stabilized APIs:
7761   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7762   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7763   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7764   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7765   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7766   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7767   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7768   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7769   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7770   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7771   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7772   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7773   [`Path::read_link`], [`Path::symlink_metadata`],
7774   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7775   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7776   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7777   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7778   [`slice::split_first_mut`], [`slice::split_first`],
7779   [`slice::split_last_mut`], [`slice::split_last`],
7780   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7781   [`str::MatchIndices`], [`str::RMatchIndices`],
7782   [`str::match_indices`], [`str::rmatch_indices`],
7783   [`str::slice_mut_unchecked`], [`string::ParseError`].
7784 * Rust applications hosted on crates.io can be installed locally to
7785   `~/.cargo/bin` with the [`cargo install`] command. Among other
7786   things this makes it easier to augment Cargo with new subcommands:
7787   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7788   invoked as `cargo foo`.
7789 * Crates with wildcard (`*`) dependencies will [emit warnings when
7790   published][1.5w]. In 1.6 it will no longer be possible to publish
7791   crates with wildcard dependencies.
7792
7793 Breaking Changes
7794 ----------------
7795
7796 * The rules determining when a particular lifetime must outlive
7797   a particular value (known as '[dropck]') have been [modified
7798   to not rely on parametricity][1.5p].
7799 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7800   and `Arc`][1.5a]. Because these smart pointer types implement
7801   `Deref`, this causes breakage in cases where the interior type
7802   contains methods of the same name.
7803 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7804   that they could drop their content. Soundness fix.
7805 * All method invocations are [properly checked][1.5wf1] for
7806   [well-formedness][1.5wf2]. Soundness fix.
7807 * Traits whose supertraits contain `Self` are [not object
7808   safe][1.5o]. Soundness fix.
7809 * Target specifications support a [`no_default_libraries`][1.5nd]
7810   setting that controls whether `-nodefaultlibs` is passed to the
7811   linker, and in turn the `is_like_windows` setting no longer affects
7812   the `-nodefaultlibs` flag.
7813 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7814 * The `#[inline]` and `#[repr]` attributes [can only appear
7815   in valid locations][1.5at].
7816 * Native libraries linked from the local crate are [passed to
7817   the linker before native libraries from upstream crates][1.5nl].
7818 * Two rarely-used attributes, `#[no_debug]` and
7819   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7820 * Negation of unsigned integers, which has been a warning for
7821   several releases, [is now behind a feature gate and will
7822   generate errors][1.5nu].
7823 * The parser accidentally accepted visibility modifiers on
7824   enum variants, a bug [which has been fixed][1.5ev].
7825 * [A bug was fixed that allowed `use` statements to import unstable
7826   features][1.5use].
7827
7828 Language
7829 --------
7830
7831 * When evaluating expressions at compile-time that are not
7832   compile-time constants (const-evaluating expressions in non-const
7833   contexts), incorrect code such as overlong bitshifts and arithmetic
7834   overflow will [generate a warning instead of an error][1.5ce],
7835   delaying the error until runtime. This will allow the
7836   const-evaluator to be expanded in the future backwards-compatibly.
7837 * The `improper_ctypes` lint [no longer warns about using `isize` and
7838   `usize` in FFI][1.5ict].
7839
7840 Libraries
7841 ---------
7842
7843 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7844   invariant][1.5c].
7845 * `Default` is [implemented for mutable slices][1.5d].
7846 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7847 * There are now `From` conversions [between floating point
7848   types][1.5f] where the conversions are lossless.
7849 * There are now `From` conversions [between integer types][1.5i] where
7850   the conversions are lossless.
7851 * [`fs::Metadata` implements `Clone`][1.5fs].
7852 * The `parse` method [accepts a leading "+" when parsing
7853   integers][1.5pi].
7854 * [`AsMut` is implemented for `Vec`][1.5am].
7855 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7856   been optimized][1.5cf] and no longer rely on the default impl.
7857 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7858   `unsafe extern "C"` function types now [implement `Clone`,
7859   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7860   `fmt::Debug` for up to 12 arguments][1.5fp].
7861 * [Dropping `Vec`s is much faster in unoptimized builds when the
7862   element types don't implement `Drop`][1.5dv].
7863 * A bug that caused in incorrect behavior when [combining `VecDeque`
7864   with zero-sized types][1.5vdz] was resolved.
7865 * [`PartialOrd` for slices is faster][1.5po].
7866
7867 Miscellaneous
7868 -------------
7869
7870 * [Crate metadata size was reduced by 20%][1.5md].
7871 * [Improvements to code generation reduced the size of libcore by 3.3
7872   MB and rustc's memory usage by 18MB][1.5m].
7873 * [Improvements to deref translation increased performance in
7874   unoptimized builds][1.5dr].
7875 * Various errors in trait resolution [are deduplicated to only be
7876   reported once][1.5te].
7877 * Rust has preliminary [support for rumprun kernels][1.5rr].
7878 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7879
7880 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7881 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7882 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7883 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7884 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7885 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7886 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7887 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7888 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7889 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7890 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7891 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7892 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7893 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7894 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7895 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7896 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7897 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7898 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7899 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7900 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7901 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7902 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7903 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7904 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7905 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7906 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7907 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7908 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7909 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7910 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7911 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7912 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7913 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7914 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7915 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7916 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7917 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7918 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7919 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7920 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7921 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7922 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7923 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7924 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7925 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7926 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7927 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7928 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7929 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7930 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7931 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7932 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7933 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7934 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7935 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7936 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7937 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7938 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7939 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7940 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7941 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7942 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7943 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7944 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7945 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7946 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7947 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7948 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7949 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7950 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7951 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7952 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7953 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7954 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7955 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7956 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7957 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7958 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7959 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7960 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7961 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7962 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7963 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7964 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7965 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7966 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7967 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7968 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7969
7970 Version 1.4.0 (2015-10-29)
7971 ==========================
7972
7973 * ~1200 changes, numerous bugfixes
7974
7975 Highlights
7976 ----------
7977
7978 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7979   GNU) are now supported and recommended for use.
7980
7981 Breaking Changes
7982 ----------------
7983
7984 * [Several changes have been made to fix type soundness and improve
7985   the behavior of associated types][sound]. See [RFC 1214]. Although
7986   we have mostly introduced these changes as warnings this release, to
7987   become errors next release, there are still some scenarios that will
7988   see immediate breakage.
7989 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7990   line breaks in addition to `\n`][crlf].
7991 * [Loans of `'static` lifetime extend to the end of a function][stat].
7992 * [`str::parse` no longer introduces avoidable rounding error when
7993   parsing floating point numbers. Together with earlier changes to
7994   float formatting/output, "round trips" like f.to_string().parse()
7995   now preserve the value of f exactly. Additionally, leading plus
7996   signs are now accepted][fp3].
7997
7998
7999 Language
8000 --------
8001
8002 * `use` statements that import multiple items [can now rename
8003   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8004 * [Binops work correctly on fat pointers][binfat].
8005 * `pub extern crate`, which does not behave as expected, [issues a
8006   warning][pec] until a better solution is found.
8007
8008 Libraries
8009 ---------
8010
8011 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8012   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8013   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8014   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8015   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8016   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8017   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8018   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8019   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8020   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8021   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8022   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8023   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8024   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8025   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8026   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8027   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8028   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8029   [`thread::sleep`].
8030 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8031   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8032   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8033   `f64::from_str_radix`.
8034 * [Reverse-searching strings is faster with the 'two-way'
8035   algorithm][s].
8036 * [`std::io::copy` allows `?Sized` arguments][cc].
8037 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8038   [override `count`, `nth` and `last` with an O(1)
8039   implementation][it].
8040 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8041 * [`IntoRawFd` has been added to the Unix-specific prelude,
8042   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8043   prelude][pr].
8044 * [`Extend<String>` and `FromIterator<String` are both implemented for
8045   `String`][es].
8046 * [`IntoIterator` is implemented for references to `Option` and
8047   `Result`][into2].
8048 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8049   Copy`][ext] as part of [RFC 839]. This will cause type inference
8050   breakage in rare situations.
8051 * [`BinaryHeap` implements `Debug`][bh2].
8052 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8053   arrays][bm].
8054 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8055   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8056 * [String comparison is faster][faststr].
8057 * `&mut T` where `T: std::fmt::Write` [also implements
8058   `std::fmt::Write`][mutw].
8059 * [A stable regression in `VecDeque::push_back` and other
8060   capacity-altering methods that caused panics for zero-sized types
8061   was fixed][vd].
8062 * [Function pointers implement traits for up to 12 parameters][fp2].
8063
8064 Miscellaneous
8065 -------------
8066
8067 * The compiler [no longer uses the 'morestack' feature to prevent
8068   stack overflow][mm]. Instead it uses guard pages and stack
8069   probes (though stack probes are not yet implemented on any platform
8070   but Windows).
8071 * [The compiler matches traits faster when projections are involved][p].
8072 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8073   `usize`][ffi].
8074 * [Cargo now displays useful information about what its doing during
8075   `cargo update`][cu].
8076
8077 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8078 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8079 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8080 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8081 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8082 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8083 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8084 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8085 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8086 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8087 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8088 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8089 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8090 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8091 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8092 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8093 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8094 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8095 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8096 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8097 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8098 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8099 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8100 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8101 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8102 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8103 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8104 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8105 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8106 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8107 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8108 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8109 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8110 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8111 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8112 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8113 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8114 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8115 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8116 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8117 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8118 [bh2]: https://github.com/rust-lang/rust/pull/28156
8119 [binfat]: https://github.com/rust-lang/rust/pull/28270
8120 [bm]: https://github.com/rust-lang/rust/pull/28197
8121 [cc]: https://github.com/rust-lang/rust/pull/27531
8122 [crlf]: https://github.com/rust-lang/rust/pull/28034
8123 [cu]: https://github.com/rust-lang/cargo/pull/1931
8124 [d]: https://github.com/rust-lang/rust/pull/27825
8125 [dep]: https://github.com/rust-lang/rust/pull/28339
8126 [es]: https://github.com/rust-lang/rust/pull/27956
8127 [ext]: https://github.com/rust-lang/rust/pull/28094
8128 [faststr]: https://github.com/rust-lang/rust/pull/28338
8129 [ffi]: https://github.com/rust-lang/rust/pull/28779
8130 [fp]: https://github.com/rust-lang/rust/pull/28268
8131 [fp2]: https://github.com/rust-lang/rust/pull/28560
8132 [fp3]: https://github.com/rust-lang/rust/pull/27307
8133 [i]: https://github.com/rust-lang/rust/pull/27451
8134 [into2]: https://github.com/rust-lang/rust/pull/28039
8135 [it]: https://github.com/rust-lang/rust/pull/27652
8136 [mm]: https://github.com/rust-lang/rust/pull/27338
8137 [mutw]: https://github.com/rust-lang/rust/pull/28368
8138 [sound]: https://github.com/rust-lang/rust/pull/27641
8139 [p]: https://github.com/rust-lang/rust/pull/27866
8140 [pec]: https://github.com/rust-lang/rust/pull/28486
8141 [pr]: https://github.com/rust-lang/rust/pull/27896
8142 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8143 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8144 [s]: https://github.com/rust-lang/rust/pull/27474
8145 [stab]: https://github.com/rust-lang/rust/pull/28339
8146 [stat]: https://github.com/rust-lang/rust/pull/28321
8147 [vd]: https://github.com/rust-lang/rust/pull/28494
8148
8149 Version 1.3.0 (2015-09-17)
8150 ==============================
8151
8152 * ~900 changes, numerous bugfixes
8153
8154 Highlights
8155 ----------
8156
8157 * The [new object lifetime defaults][nold] have been [turned
8158   on][nold2] after a cycle of warnings about the change. Now types
8159   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8160   being interpreted as `&'a Box<Trait+'a>` to `&'a
8161   Box<Trait+'static>`.
8162 * [The Rustonomicon][nom] is a new book in the official documentation
8163   that dives into writing unsafe Rust.
8164 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8165   timekeeping is employed by other std APIs, as well as out-of-tree
8166   time crates.
8167
8168 Breaking Changes
8169 ----------------
8170
8171 * The [new object lifetime defaults][nold] have been [turned
8172   on][nold2] after a cycle of warnings about the change.
8173 * There is a known [regression][lr] in how object lifetime elision is
8174   interpreted, the proper solution for which is undetermined.
8175 * The `#[prelude_import]` attribute, an internal implementation
8176   detail, was accidentally stabilized previously. [It has been put
8177   behind the `prelude_import` feature gate][pi]. This change is
8178   believed to break no existing code.
8179 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8180   [more sane for dynamically sized types][dst3]. Code that relied on
8181   the previous behavior is thought to be broken.
8182 * The `dropck` rules, which checks that destructors can't access
8183   destroyed values, [have been updated][dropck] to match the
8184   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8185   cause some previously-compiling code to no longer build.
8186
8187 Language
8188 --------
8189
8190 * The [new object lifetime defaults][nold] have been [turned
8191   on][nold2] after a cycle of warnings about the change.
8192 * Semicolons may [now follow types and paths in
8193   macros](https://github.com/rust-lang/rust/pull/27000).
8194 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8195   [more sane for dynamically sized types][dst3]. Code that relied on
8196   the previous behavior is not known to exist, and suspected to be
8197   broken.
8198 * `'static` variables [may now be recursive][st].
8199 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8200   implementations correctly.
8201 * The `dropck` rules, which checks that destructors can't access
8202   destroyed values, [have been updated][dropck] to match the
8203   [RFC][dropckrfc].
8204
8205 Libraries
8206 ---------
8207
8208 * The [`Duration`] API, [has been stabilized][ds], as well as the
8209   `std::time` module, which presently contains only `Duration`.
8210 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8211 * The owned C string, [`CString`], implements [`Borrow`] and the
8212   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8213   these allow C strings to be borrowed and cloned in generic code.
8214 * [`CStr`] implements [`Debug`].
8215 * [`AtomicPtr`] implements [`Debug`].
8216 * [`Error`] trait objects [can be downcast to their concrete types][e]
8217   in many common configurations, using the [`is`], [`downcast`],
8218   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8219   [`Any`] trait.
8220 * Searching for substrings now [employs the two-way algorithm][search]
8221   instead of doing a naive search. This gives major speedups to a
8222   number of methods, including [`contains`][sc], [`find`][sf],
8223   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8224   [`ends_with`][sew] are also faster.
8225 * The performance of `PartialEq` for slices is [much faster][ps].
8226 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8227   is overridden and optimized by the implementations for scalars.
8228 * The [`Hasher`] trait now has a number of specialized `write_*`
8229   methods for primitive types, for efficiency.
8230 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8231   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8232   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8233   of [`std::error::Error::cause`][iec] also delegates to the inner
8234   error.
8235 * [`process::Child`][pc] gained the [`id`] method, which returns a
8236   `u32` representing the platform-specific process identifier.
8237 * The [`connect`] method on slices is deprecated, replaced by the new
8238   [`join`] method (note that both of these are on the *unstable*
8239   [`SliceConcatExt`] trait, but through the magic of the prelude are
8240   available to stable code anyway).
8241 * The [`Div`] operator is implemented for [`Wrapping`] types.
8242 * [`DerefMut` is implemented for `String`][dms].
8243 * Performance of SipHash (the default hasher for `HashMap`) is
8244   [better for long data][sh].
8245 * [`AtomicPtr`] implements [`Send`].
8246 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8247   are now [specialized to use uninitialized buffers for increased
8248   performance][rte].
8249 * Lifetime parameters of foreign functions [are now resolved
8250   properly][f].
8251
8252 Misc
8253 ----
8254
8255 * Rust can now, with some coercion, [produce programs that run on
8256   Windows XP][xp], though XP is not considered a supported platform.
8257 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8258   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8259   recommended for use in 1.3, though should be fully-functional
8260   in the [64-bit 1.4 beta][b14].
8261 * On Fedora-based systems installation will [properly configure the
8262   dynamic linker][fl].
8263 * The compiler gained many new extended error descriptions, which can
8264   be accessed with the `--explain` flag.
8265 * The `dropck` pass, which checks that destructors can't access
8266   destroyed values, [has been rewritten][dropck]. This fixes some
8267   soundness holes, and as such will cause some previously-compiling
8268   code to no longer build.
8269 * `rustc` now uses [LLVM to write archive files where possible][ar].
8270   Eventually this will eliminate the compiler's dependency on the ar
8271   utility.
8272 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8273   supported FreeBSD on x86_64).
8274 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8275   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8276   more strict.
8277 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8278   will kill the process instead of leaking][nlp].
8279
8280 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8281 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8282 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8283 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8284 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8285 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8286 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8287 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8288 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8289 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8290 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8291 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8292 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8293 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8294 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8295 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8296 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8297 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8298 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8299 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8300 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8301 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8302 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8303 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8304 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8305 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8306 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8307 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8308 [ar]: https://github.com/rust-lang/rust/pull/26926
8309 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8310 [dms]: https://github.com/rust-lang/rust/pull/26241
8311 [dropck]: https://github.com/rust-lang/rust/pull/27261
8312 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8313 [ds]: https://github.com/rust-lang/rust/pull/26818
8314 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8315 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8316 [dst3]: https://github.com/rust-lang/rust/pull/27351
8317 [e]: https://github.com/rust-lang/rust/pull/24793
8318 [f]: https://github.com/rust-lang/rust/pull/26588
8319 [fb]: https://github.com/rust-lang/rust/pull/26959
8320 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8321 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8322 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8323 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8324 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8325 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8326 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8327 [lic]: https://github.com/rust-lang/rust/pull/26583
8328 [lnu]: https://github.com/rust-lang/rust/pull/27026
8329 [lr]: https://github.com/rust-lang/rust/issues/27248
8330 [lum]: https://github.com/rust-lang/rust/pull/26378
8331 [lur]: https://github.com/rust-lang/rust/pull/26783
8332 [nlp]: https://github.com/rust-lang/rust/pull/27176
8333 [nold2]: https://github.com/rust-lang/rust/pull/27045
8334 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8335 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8336 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8337 [pi]: https://github.com/rust-lang/rust/pull/26699
8338 [ps]: https://github.com/rust-lang/rust/pull/26884
8339 [rte]: https://github.com/rust-lang/rust/pull/26950
8340 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8341 [search]: https://github.com/rust-lang/rust/pull/26327
8342 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8343 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8344 [sh]: https://github.com/rust-lang/rust/pull/27280
8345 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8346 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8347 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8348 [st]: https://github.com/rust-lang/rust/pull/26630
8349 [win1]: https://github.com/rust-lang/rust/pull/26569
8350 [win2]: https://github.com/rust-lang/rust/pull/26741
8351 [win3]: https://github.com/rust-lang/rust/pull/26741
8352 [win4]: https://github.com/rust-lang/rust/pull/27210
8353 [xp]: https://github.com/rust-lang/rust/pull/26569
8354
8355 Version 1.2.0 (2015-08-07)
8356 ==========================
8357
8358 * ~1200 changes, numerous bugfixes
8359
8360 Highlights
8361 ----------
8362
8363 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8364   like `Rc` to contain types without a fixed size, arrays and trait
8365   objects, finally enabling use of `Rc<[T]>` and completing the
8366   implementation of DST.
8367 * [Parallel codegen][parcodegen] is now working again, which can
8368   substantially speed up large builds in debug mode; It also gets
8369   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8370   jobs). It's not enabled by default, but will be "in the near
8371   future". It can be activated with the `-C codegen-units=N` flag to
8372   `rustc`.
8373 * This is the first release with [experimental support for linking
8374   with the MSVC linker and lib C on Windows (instead of using the GNU
8375   variants via MinGW)][win]. It is yet recommended only for the most
8376   intrepid Rustaceans.
8377 * Benchmark compilations are showing a 30% improvement in
8378   bootstrapping over 1.1.
8379
8380 Breaking Changes
8381 ----------------
8382
8383 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8384   unicode case mapping, which is a previously-planned change in
8385   behavior and considered a bugfix.
8386 * [`mem::align_of`] now specifies [the *minimum alignment* for
8387   T][align], which is usually the alignment programs are interested
8388   in, and the same value reported by clang's
8389   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8390   break real code.
8391 * [The `#[packed]` attribute is no longer silently accepted by the
8392   compiler][packed]. This attribute did nothing and code that
8393   mentioned it likely did not work as intended.
8394 * Associated type defaults are [now behind the
8395   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8396   defaults *did not work*, but could be mentioned syntactically. As
8397   such this breakage has minimal impact.
8398
8399 Language
8400 --------
8401
8402 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8403   matching against dereferenceable values.
8404
8405 Libraries
8406 ---------
8407
8408 * The [`Extend`] trait, which grows a collection from an iterator, is
8409   implemented over iterators of references, for `String`, `Vec`,
8410   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8411   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8412 * The [`iter::once`] function returns an iterator that yields a single
8413   element, and [`iter::empty`] returns an iterator that yields no
8414   elements.
8415 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8416   over substring matches.
8417 * [`Cell`] and [`RefCell`] both implement `Eq`.
8418 * A number of methods for wrapping arithmetic are added to the
8419   integral types, [`wrapping_div`], [`wrapping_rem`],
8420   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8421   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8422   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8423   type.. It is illegal for the default arithmetic operations in Rust
8424   to overflow; the desire to wrap must be explicit.
8425 * The `{:#?}` formatting specifier [displays the alternate,
8426   pretty-printed][debugfmt] form of the `Debug` formatter. This
8427   feature was actually introduced prior to 1.0 with little
8428   fanfare.
8429 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8430   for writing data to formatted strings, similar to [`io::Write`].
8431 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8432   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8433   are used by code generators to emit implementations of [`Debug`].
8434 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8435   methods that convert case, following Unicode case mapping.
8436 * It is now easier to handle poisoned locks. The [`PoisonError`]
8437   type, returned by failing lock operations, exposes `into_inner`,
8438   `get_ref`, and `get_mut`, which all give access to the inner lock
8439   guard, and allow the poisoned lock to continue to operate. The
8440   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8441   poisoned lock without attempting to take the lock.
8442 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8443   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8444   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8445   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8446   `ChildStderr`.
8447 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8448   malformed input.
8449
8450 Misc
8451 ----
8452
8453 * `rustc` employs smarter heuristics for guessing at [typos].
8454 * `rustc` emits more efficient code for [no-op conversions between
8455   unsafe pointers][nop].
8456 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8457   resulting in faster compile times and smaller code.
8458
8459 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8460 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8461 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8462 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8463 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8464 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8465 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8466 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8467 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8468 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8469 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8470 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8471 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8472 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8473 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8474 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8475 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8476 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8477 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8478 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8479 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8480 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8481 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8482 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8483 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8484 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8485 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8486 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8487 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8488 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8489 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8490 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8491 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8492 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8493 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8494 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8495 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8496 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8497 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8498 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8499 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8500 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8501 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8502 [align]: https://github.com/rust-lang/rust/pull/25646
8503 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8504 [typos]: https://github.com/rust-lang/rust/pull/26087
8505 [nop]: https://github.com/rust-lang/rust/pull/26336
8506 [fat]: https://github.com/rust-lang/rust/pull/26411
8507 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8508 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8509 [packed]: https://github.com/rust-lang/rust/pull/25541
8510 [ad]: https://github.com/rust-lang/rust/pull/27382
8511 [win]: https://github.com/rust-lang/rust/pull/25350
8512
8513 Version 1.1.0 (2015-06-25)
8514 =========================
8515
8516 * ~850 changes, numerous bugfixes
8517
8518 Highlights
8519 ----------
8520
8521 * The [`std::fs` module has been expanded][fs] to expand the set of
8522   functionality exposed:
8523   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8524     don't incur a syscall on some platforms.
8525   * A `symlink_metadata` function has been added.
8526   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8527     access to all underlying information.
8528 * The compiler now contains extended explanations of many errors. When an error
8529   with an explanation occurs the compiler suggests using the `--explain` flag
8530   to read the explanation. Error explanations are also [available online][err-index].
8531 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8532   well as other work, the time to bootstrap the compiler decreased by
8533   32%.
8534
8535 Libraries
8536 ---------
8537
8538 * The [`str::split_whitespace`] method splits a string on unicode
8539   whitespace boundaries.
8540 * On both Windows and Unix, new extension traits provide conversion of
8541   I/O types to and from the underlying system handles. On Unix, these
8542   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8543   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8544   `TcpListener`, and `UpdSocket`. Further implementations for
8545   `std::process` will be stabilized later.
8546 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8547   Windows, symlinks can be created with
8548   `std::os::windows::symlink_dir` and
8549   `std::os::windows::symlink_file`.
8550 * The `mpsc::Receiver` type can now be converted into an iterator with
8551   `into_iter` on the [`IntoIterator`] trait.
8552 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8553   implementation of the [`From`] trait.
8554 * The `Debug` implementation for `RangeFull` [creates output that is
8555   more consistent with other implementations][rf].
8556 * [`Debug` is implemented for `File`][file].
8557 * The `Default` implementation for `Arc` [no longer requires `Sync +
8558   Send`][arc].
8559 * [The `Iterator` methods `count`, `nth`, and `last` have been
8560   overridden for slices to have O(1) performance instead of O(n)][si].
8561 * Incorrect handling of paths on Windows has been improved in both the
8562   compiler and the standard library.
8563 * [`AtomicPtr` gained a `Default` implementation][ap].
8564 * In accordance with Rust's policy on arithmetic overflow `abs` now
8565   [panics on overflow when debug assertions are enabled][abs].
8566 * The [`Cloned`] iterator, which was accidentally left unstable for
8567   1.0 [has been stabilized][c].
8568 * The [`Incoming`] iterator, which iterates over incoming TCP
8569   connections, and which was accidentally unnamable in 1.0, [is now
8570   properly exported][inc].
8571 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8572   `sift_up` or `sift_down` panic][bh].
8573 * The [`split_off`] method of `LinkedList` [no longer corrupts
8574   the list in certain scenarios][ll].
8575
8576 Misc
8577 ----
8578
8579 * Type checking performance [has improved notably][sk] with
8580   [multiple improvements][pre].
8581 * The compiler [suggests code changes][ch] for more errors.
8582 * rustc and it's build system have experimental support for [building
8583   toolchains against MUSL][m] instead of glibc on Linux.
8584 * The compiler defines the `target_env` cfg value, which is used for
8585   distinguishing toolchains that are otherwise for the same
8586   platform. Presently this is set to `gnu` for common GNU Linux
8587   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8588 * The [`cargo rustc`][crc] command invokes a build with custom flags
8589   to rustc.
8590 * [Android executables are always position independent][pie].
8591 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8592   with `Drop`][drop].
8593
8594 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8595 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8596 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8597 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8598 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8599 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8600 [rf]: https://github.com/rust-lang/rust/pull/24491
8601 [err-index]: https://doc.rust-lang.org/error-index.html
8602 [sk]: https://github.com/rust-lang/rust/pull/24615
8603 [pre]: https://github.com/rust-lang/rust/pull/25323
8604 [file]: https://github.com/rust-lang/rust/pull/24598
8605 [ch]: https://github.com/rust-lang/rust/pull/24683
8606 [arc]: https://github.com/rust-lang/rust/pull/24695
8607 [si]: https://github.com/rust-lang/rust/pull/24701
8608 [ap]: https://github.com/rust-lang/rust/pull/24834
8609 [m]: https://github.com/rust-lang/rust/pull/24777
8610 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8611 [crc]: https://github.com/rust-lang/cargo/pull/1568
8612 [pie]: https://github.com/rust-lang/rust/pull/24953
8613 [abs]: https://github.com/rust-lang/rust/pull/25441
8614 [c]: https://github.com/rust-lang/rust/pull/25496
8615 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8616 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8617 [inc]: https://github.com/rust-lang/rust/pull/25522
8618 [bh]: https://github.com/rust-lang/rust/pull/25856
8619 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8620 [ll]: https://github.com/rust-lang/rust/pull/26022
8621 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8622 [drop]: https://github.com/rust-lang/rust/pull/24935
8623
8624 Version 1.0.0 (2015-05-15)
8625 ========================
8626
8627 * ~1500 changes, numerous bugfixes
8628
8629 Highlights
8630 ----------
8631
8632 * The vast majority of the standard library is now `#[stable]`. It is
8633   no longer possible to use unstable features with a stable build of
8634   the compiler.
8635 * Many popular crates on [crates.io] now work on the stable release
8636   channel.
8637 * Arithmetic on basic integer types now [checks for overflow in debug
8638   builds][overflow].
8639
8640 Language
8641 --------
8642
8643 * Several [restrictions have been added to trait coherence][coh] in
8644   order to make it easier for upstream authors to change traits
8645   without breaking downstream code.
8646 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8647   improve error messages and macro behavior. For example, `0b1234` is
8648   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8649 * Trait bounds [are always invariant][inv], eliminating the need for
8650   the `PhantomFn` and `MarkerTrait` lang items, which have been
8651   removed.
8652 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8653   "foo" as bar` syntax has been replaced with `extern crate foo as
8654   bar`, and Cargo now automatically translates "-" in *package* names
8655   to underscore for the crate name.
8656 * [Lifetime shadowing is an error][lt].
8657 * [`Send` no longer implies `'static`][send-rfc].
8658 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8659   `MyType::default()`.
8660 * Primitive types [now have inherent methods][prim-inherent],
8661   obviating the need for extension traits like `SliceExt`.
8662 * Methods with `Self: Sized` in their `where` clause are [considered
8663   object-safe][self-sized], allowing many extension traits like
8664   `IteratorExt` to be merged into the traits they extended.
8665 * You can now [refer to associated types][assoc-where] whose
8666   corresponding trait bounds appear only in a `where` clause.
8667 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8668   like `Send` and `Sync` are now library-defined.
8669 * A [Reflect trait][reflect] was introduced, which means that
8670   downcasting via the `Any` trait is effectively limited to concrete
8671   types. This helps retain the potentially-important "parametricity"
8672   property: generic code cannot behave differently for different type
8673   arguments except in minor ways.
8674 * The `unsafe_destructor` feature is now deprecated in favor of the
8675   [new `dropck`][dropck]. This change is a major reduction in unsafe
8676   code.
8677
8678 Libraries
8679 ---------
8680
8681 * The `thread_local` module [has been renamed to `std::thread`][th].
8682 * The methods of `IteratorExt` [have been moved to the `Iterator`
8683   trait itself][ie].
8684 * Several traits that implement Rust's conventions for type
8685   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8686   [centralized in the `std::convert` module][con].
8687 * The `FromError` trait [was removed in favor of `From`][fe].
8688 * The basic sleep function [has moved to
8689   `std::thread::sleep_ms`][slp].
8690 * The `splitn` function now takes an `n` parameter that represents the
8691   number of items yielded by the returned iterator [instead of the
8692   number of 'splits'][spl].
8693 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8694 * [Derived implementations of `PartialOrd` now order enums according
8695   to their explicitly-assigned discriminants][po].
8696 * [Methods for searching strings are generic over `Pattern`s][pat],
8697   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8698   some others.
8699 * [In method resolution, object methods are resolved before inherent
8700   methods][meth].
8701 * [`String::from_str` has been deprecated in favor of the `From` impl,
8702   `String::from`][sf].
8703 * [`io::Error` implements `Sync`][ios].
8704 * [The `words` method on `&str` has been replaced with
8705   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8706   a word?'
8707 * The new path and IO modules are complete and `#[stable]`. This
8708   was the major library focus for this cycle.
8709 * The path API was [revised][path-normalize] to normalize `.`,
8710   adjusting the tradeoffs in favor of the most common usage.
8711 * A large number of remaining APIs in `std` were also stabilized
8712   during this cycle; about 75% of the non-deprecated API surface
8713   is now stable.
8714 * The new [string pattern API][string-pattern] landed, which makes
8715   the string slice API much more internally consistent and flexible.
8716 * A new set of [generic conversion traits][conversion] replaced
8717   many existing ad hoc traits.
8718 * Generic numeric traits were [completely removed][num-traits]. This
8719   was made possible thanks to inherent methods for primitive types,
8720   and the removal gives maximal flexibility for designing a numeric
8721   hierarchy in the future.
8722 * The `Fn` traits are now related via [inheritance][fn-inherit]
8723   and provide ergonomic [blanket implementations][fn-blanket].
8724 * The `Index` and `IndexMut` traits were changed to
8725   [take the index by value][index-value], enabling code like
8726   `hash_map["string"]` to work.
8727 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8728   `Copy` data is known to be `Clone` as well.
8729
8730 Misc
8731 ----
8732
8733 * Many errors now have extended explanations that can be accessed with
8734   the `--explain` flag to `rustc`.
8735 * Many new examples have been added to the standard library
8736   documentation.
8737 * rustdoc has received a number of improvements focused on completion
8738   and polish.
8739 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8740 * Much headway was made on ecosystem-wide CI, making it possible
8741   to [compare builds for breakage][ci-compare].
8742
8743
8744 [crates.io]: http://crates.io
8745 [clo]: https://github.com/rust-lang/rust/pull/24034
8746 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8747 [con]: https://github.com/rust-lang/rust/pull/23875
8748 [cr]: https://github.com/rust-lang/rust/pull/23419
8749 [fe]: https://github.com/rust-lang/rust/pull/23879
8750 [ie]: https://github.com/rust-lang/rust/pull/23300
8751 [inv]: https://github.com/rust-lang/rust/pull/23938
8752 [ios]: https://github.com/rust-lang/rust/pull/24133
8753 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8754 [lt]: https://github.com/rust-lang/rust/pull/24057
8755 [meth]: https://github.com/rust-lang/rust/pull/24056
8756 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8757 [po]: https://github.com/rust-lang/rust/pull/24270
8758 [sf]: https://github.com/rust-lang/rust/pull/24517
8759 [slp]: https://github.com/rust-lang/rust/pull/23949
8760 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8761 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8762 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8763 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8764 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8765 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8766 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8767 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8768 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8769 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8770 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8771 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8772 [reflect]: https://github.com/rust-lang/rust/pull/23712
8773 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8774 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8775 [index-value]: https://github.com/rust-lang/rust/pull/23601
8776 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8777 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8778 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8779 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8780 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8781 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8782
8783
8784 Version 1.0.0-alpha.2 (2015-02-20)
8785 =====================================
8786
8787 * ~1300 changes, numerous bugfixes
8788
8789 * Highlights
8790
8791     * The various I/O modules were [overhauled][io-rfc] to reduce
8792       unnecessary abstractions and provide better interoperation with
8793       the underlying platform. The old `io` module remains temporarily
8794       at `std::old_io`.
8795     * The standard library now [participates in feature gating][feat],
8796       so use of unstable libraries now requires a `#![feature(...)]`
8797       attribute. The impact of this change is [described on the
8798       forum][feat-forum]. [RFC][feat-rfc].
8799
8800 * Language
8801
8802     * `for` loops [now operate on the `IntoIterator` trait][into],
8803       which eliminates the need to call `.iter()`, etc. to iterate
8804       over collections. There are some new subtleties to remember
8805       though regarding what sort of iterators various types yield, in
8806       particular that `for foo in bar { }` yields values from a move
8807       iterator, destroying the original collection. [RFC][into-rfc].
8808     * Objects now have [default lifetime bounds][obj], so you don't
8809       have to write `Box<Trait+'static>` when you don't care about
8810       storing references. [RFC][obj-rfc].
8811     * In types that implement `Drop`, [lifetimes must outlive the
8812       value][drop]. This will soon make it possible to safely
8813       implement `Drop` for types where `#[unsafe_destructor]` is now
8814       required. Read the [gorgeous RFC][drop-rfc] for details.
8815     * The fully qualified <T as Trait>::X syntax lets you set the Self
8816       type for a trait method or associated type. [RFC][ufcs-rfc].
8817     * References to types that implement `Deref<U>` now [automatically
8818       coerce to references][deref] to the dereferenced type `U`,
8819       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8820       should eliminate many unsightly uses of `&*`, as when converting
8821       from references to vectors into references to
8822       slices. [RFC][deref-rfc].
8823     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8824       `|:|`) is obsolete and closure kind is inferred from context.
8825     * [`Self` is a keyword][Self].
8826
8827 * Libraries
8828
8829     * The `Show` and `String` formatting traits [have been
8830       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8831       their related purposes. Automatically getting a string
8832       conversion to use with `format!("{:?}", something_to_debug)` is
8833       now written `#[derive(Debug)]`.
8834     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8835       OsStr}`, provide strings in platform-specific encodings for easier
8836       interop with system APIs. [RFC][osstr-rfc].
8837     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8838       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8839       creating raw pointers.
8840
8841 * Tooling
8842
8843     * Certain long error messages of the form 'expected foo found bar'
8844       are now [split neatly across multiple
8845       lines][multiline]. Examples in the PR.
8846     * On Unix Rust can be [uninstalled][un] by running
8847       `/usr/local/lib/rustlib/uninstall.sh`.
8848     * The `#[rustc_on_unimplemented]` attribute, requiring the
8849       'on_unimplemented' feature, lets rustc [display custom error
8850       messages when a trait is expected to be implemented for a type
8851       but is not][onun].
8852
8853 * Misc
8854
8855     * Rust is tested against a [LALR grammar][lalr], which parses
8856       almost all the Rust files that rustc does.
8857
8858 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8859 [close]: https://github.com/rust-lang/rust/pull/21843
8860 [deref]: https://github.com/rust-lang/rust/pull/21351
8861 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8862 [drop]: https://github.com/rust-lang/rust/pull/21972
8863 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8864 [feat]: https://github.com/rust-lang/rust/pull/21248
8865 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8866 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8867 [fmt]: https://github.com/rust-lang/rust/pull/21457
8868 [into]: https://github.com/rust-lang/rust/pull/20790
8869 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8870 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8871 [lalr]: https://github.com/rust-lang/rust/pull/21452
8872 [multiline]: https://github.com/rust-lang/rust/pull/19870
8873 [obj]: https://github.com/rust-lang/rust/pull/22230
8874 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8875 [onun]: https://github.com/rust-lang/rust/pull/20889
8876 [osstr]: https://github.com/rust-lang/rust/pull/21488
8877 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8878 [Self]: https://github.com/rust-lang/rust/pull/22158
8879 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8880 [un]: https://github.com/rust-lang/rust/pull/22256
8881
8882
8883 Version 1.0.0-alpha (2015-01-09)
8884 ==================================
8885
8886   * ~2400 changes, numerous bugfixes
8887
8888   * Highlights
8889
8890     * The language itself is considered feature complete for 1.0,
8891       though there will be many usability improvements and bugfixes
8892       before the final release.
8893     * Nearly 50% of the public API surface of the standard library has
8894       been declared 'stable'. Those interfaces are unlikely to change
8895       before 1.0.
8896     * The long-running debate over integer types has been
8897       [settled][ints]: Rust will ship with types named `isize` and
8898       `usize`, rather than `int` and `uint`, for pointer-sized
8899       integers. Guidelines will be rolled out during the alpha cycle.
8900     * Most crates that are not `std` have been moved out of the Rust
8901       distribution into the Cargo ecosystem so they can evolve
8902       separately and don't need to be stabilized as quickly, including
8903       'time', 'getopts', 'num', 'regex', and 'term'.
8904     * Documentation continues to be expanded with more API coverage, more
8905       examples, and more in-depth explanations. The guides have been
8906       consolidated into [The Rust Programming Language][trpl].
8907     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8908     * All official Rust binary installers now come with [Cargo], the
8909       Rust package manager.
8910
8911 * Language
8912
8913     * Closures have been [completely redesigned][unboxed] to be
8914       implemented in terms of traits, can now be used as generic type
8915       bounds and thus monomorphized and inlined, or via an opaque
8916       pointer (boxed) as in the old system. The new system is often
8917       referred to as 'unboxed' closures.
8918     * Traits now support [associated types][assoc], allowing families
8919       of related types to be defined together and used generically in
8920       powerful ways.
8921     * Enum variants are [namespaced by their type names][enum].
8922     * [`where` clauses][where] provide a more versatile and attractive
8923       syntax for specifying generic bounds, though the previous syntax
8924       remains valid.
8925     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8926       numeric types.
8927     * Rust [no longer has a runtime][rt] of any description, and only
8928       supports OS threads, not green threads.
8929     * At long last, Rust has been overhauled for 'dynamically-sized
8930       types' ([DST]), which integrates 'fat pointers' (object types,
8931       arrays, and `str`) more deeply into the type system, making it
8932       more consistent.
8933     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8934       `..j` that produce range types and which, when combined with the
8935       `Index` operator and multidispatch, leads to a convenient slice
8936       notation, `[i..j]`.
8937     * The new range syntax revealed an ambiguity in the fixed-length
8938       array syntax, so now fixed length arrays [are written `[T;
8939       N]`][arrays].
8940     * The `Copy` trait is no longer implemented automatically. Unsafe
8941       pointers no longer implement `Sync` and `Send` so types
8942       containing them don't automatically either. `Sync` and `Send`
8943       are now 'unsafe traits' so one can "forcibly" implement them via
8944       `unsafe impl` if a type confirms to the requirements for them
8945       even though the internals do not (e.g. structs containing unsafe
8946       pointers like `Arc`). These changes are intended to prevent some
8947       footguns and are collectively known as [opt-in built-in
8948       traits][oibit] (though `Sync` and `Send` will soon become pure
8949       library types unknown to the compiler).
8950     * Operator traits now take their operands [by value][ops], and
8951       comparison traits can use multidispatch to compare one type
8952       against multiple other types, allowing e.g. `String` to be
8953       compared with `&str`.
8954     * `if let` and `while let` are no longer feature-gated.
8955     * Rust has adopted a more [uniform syntax for escaping unicode
8956       characters][unicode].
8957     * `macro_rules!` [has been declared stable][mac]. Though it is a
8958       flawed system it is sufficiently popular that it must be usable
8959       for 1.0. Effort has gone into [future-proofing][mac-future] it
8960       in ways that will allow other macro systems to be developed in
8961       parallel, and won't otherwise impact the evolution of the
8962       language.
8963     * The prelude has been [pared back significantly][prelude] such
8964       that it is the minimum necessary to support the most pervasive
8965       code patterns, and through [generalized where clauses][where]
8966       many of the prelude extension traits have been consolidated.
8967     * Rust's rudimentary reflection [has been removed][refl], as it
8968       incurred too much code generation for little benefit.
8969     * [Struct variants][structvars] are no longer feature-gated.
8970     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8971       known as 'higher-ranked trait bounds', this crucially allows
8972       unboxed closures to work.
8973     * Macros invocations surrounded by parens or square brackets and
8974       not terminated by a semicolon are [parsed as
8975       expressions][macros], which makes expressions like `vec![1i32,
8976       2, 3].len()` work as expected.
8977     * Trait objects now implement their traits automatically, and
8978       traits that can be coerced to objects now must be [object
8979       safe][objsafe].
8980     * Automatically deriving traits is now done with `#[derive(...)]`
8981       not `#[deriving(...)]` for [consistency with other naming
8982       conventions][derive].
8983     * Importing the containing module or enum at the same time as
8984       items or variants they contain is [now done with `self` instead
8985       of `mod`][self], as in use `foo::{self, bar}`
8986     * Glob imports are no longer feature-gated.
8987     * The `box` operator and `box` patterns have been feature-gated
8988       pending a redesign. For now unique boxes should be allocated
8989       like other containers, with `Box::new`.
8990
8991 * Libraries
8992
8993     * A [series][coll1] of [efforts][coll2] to establish
8994       [conventions][coll3] for collections types has resulted in API
8995       improvements throughout the standard library.
8996     * New [APIs for error handling][err] provide ergonomic interop
8997       between error types, and [new conventions][err-conv] describe
8998       more clearly the recommended error handling strategies in Rust.
8999     * The `fail!` macro has been renamed to [`panic!`][panic] so that
9000       it is easier to discuss failure in the context of error handling
9001       without making clarifications as to whether you are referring to
9002       the 'fail' macro or failure more generally.
9003     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9004       syscall when available.
9005     * The 'serialize' crate has been renamed 'rustc-serialize' and
9006       moved out of the distribution to Cargo. Although it is widely
9007       used now, it is expected to be superseded in the near future.
9008     * The `Show` formatter, typically implemented with
9009       `#[derive(Show)]` is [now requested with the `{:?}`
9010       specifier][show] and is intended for use by all types, for uses
9011       such as `println!` debugging. The new `String` formatter must be
9012       implemented by hand, uses the `{}` specifier, and is intended
9013       for full-fidelity conversions of things that can logically be
9014       represented as strings.
9015
9016 * Tooling
9017
9018     * [Flexible target specification][flex] allows rustc's code
9019       generation to be configured to support otherwise-unsupported
9020       platforms.
9021     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9022       respective debuggers with Rust-appropriate pretty-printing.
9023     * The Windows installation of Rust is distributed with the
9024       MinGW components currently required to link binaries on that
9025       platform.
9026
9027 * Misc
9028
9029     * Nullable enum optimizations have been extended to more types so
9030       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9031       space than the inner types themselves.
9032     * Work has begun on supporting AArch64.
9033
9034 [Cargo]: https://crates.io
9035 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9036 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9037 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9038 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9039 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9040 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9041 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9042 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9043 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9044 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9045 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9046 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9047 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9048 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9049 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9050 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9051 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9052 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9053 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9054 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9055 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9056 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9057 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9058 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9059 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9060 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9061 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9062 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9063 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9064 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9065 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9066 [trpl]: https://doc.rust-lang.org/book/index.html
9067 [rbe]: http://rustbyexample.com/
9068
9069
9070 Version 0.12.0 (2014-10-09)
9071 =============================
9072
9073   * ~1900 changes, numerous bugfixes
9074
9075   * Highlights
9076
9077     * The introductory documentation (now called The Rust Guide) has
9078       been completely rewritten, as have a number of supplementary
9079       guides.
9080     * Rust's package manager, Cargo, continues to improve and is
9081       sometimes considered to be quite awesome.
9082     * Many API's in `std` have been reviewed and updated for
9083       consistency with the in-development Rust coding
9084       guidelines. The standard library documentation tracks
9085       stabilization progress.
9086     * Minor libraries have been moved out-of-tree to the rust-lang org
9087       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9088       be installed with Cargo.
9089     * Lifetime elision allows lifetime annotations to be left off of
9090       function declarations in many common scenarios.
9091     * Rust now works on 64-bit Windows.
9092
9093   * Language
9094     * Indexing can be overloaded with the `Index` and `IndexMut`
9095       traits.
9096     * The `if let` construct takes a branch only if the `let` pattern
9097       matches, currently behind the 'if_let' feature gate.
9098     * 'where clauses', a more flexible syntax for specifying trait
9099       bounds that is more aesthetic, have been added for traits and
9100       free functions. Where clauses will in the future make it
9101       possible to constrain associated types, which would be
9102       impossible with the existing syntax.
9103     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9104       the 'slicing_syntax' feature gate, and can be overloaded with
9105       the `Slice` or `SliceMut` traits.
9106     * The syntax for matching of sub-slices has been changed to use a
9107       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9108       consistency with other uses of `..` and to future-proof
9109       potential additional uses of the syntax.
9110     * The syntax for matching inclusive ranges in patterns has changed
9111       from `0..3` to `0...4` to be consistent with the exclusive range
9112       syntax for slicing.
9113     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9114       c]`) has been put behind the 'advanced_slice_patterns' feature
9115       gate and may be removed in the future.
9116     * Components of tuples and tuple structs can be extracted using
9117       the `value.0` syntax, currently behind the `tuple_indexing`
9118       feature gate.
9119     * The `#[crate_id]` attribute is no longer supported; versioning
9120       is handled by the package manager.
9121     * Renaming crate imports are now written `extern crate foo as bar`
9122       instead of `extern crate bar = foo`.
9123     * Renaming use statements are now written `use foo as bar` instead
9124       of `use bar = foo`.
9125     * `let` and `match` bindings and argument names in macros are now
9126       hygienic.
9127     * The new, more efficient, closure types ('unboxed closures') have
9128       been added under a feature gate, 'unboxed_closures'. These will
9129       soon replace the existing closure types, once higher-ranked
9130       trait lifetimes are added to the language.
9131     * `move` has been added as a keyword, for indicating closures
9132       that capture by value.
9133     * Mutation and assignment is no longer allowed in pattern guards.
9134     * Generic structs and enums can now have trait bounds.
9135     * The `Share` trait is now called `Sync` to free up the term
9136       'shared' to refer to 'shared reference' (the default reference
9137       type.
9138     * Dynamically-sized types have been mostly implemented,
9139       unifying the behavior of fat-pointer types with the rest of the
9140       type system.
9141     * As part of dynamically-sized types, the `Sized` trait has been
9142       introduced, which qualifying types implement by default, and
9143       which type parameters expect by default. To specify that a type
9144       parameter does not need to be sized, write `<Sized? T>`. Most
9145       types are `Sized`, notable exceptions being unsized arrays
9146       (`[T]`) and trait types.
9147     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9148     * Lifetime bounds can now be applied to type parameters and object
9149       types.
9150     * The old, reference counted GC type, `Gc<T>` which was once
9151       denoted by the `@` sigil, has finally been removed. GC will be
9152       revisited in the future.
9153
9154   * Libraries
9155     * Library documentation has been improved for a number of modules.
9156     * Bit-vectors, collections::bitv has been modernized.
9157     * The url crate is deprecated in favor of
9158       http://github.com/servo/rust-url, which can be installed with
9159       Cargo.
9160     * Most I/O stream types can be cloned and subsequently closed from
9161       a different thread.
9162     * A `std::time::Duration` type has been added for use in I/O
9163       methods that rely on timers, as well as in the 'time' crate's
9164       `Timespec` arithmetic.
9165     * The runtime I/O abstraction layer that enabled the green thread
9166       scheduler to do non-thread-blocking I/O has been removed, along
9167       with the libuv-based implementation employed by the green thread
9168       scheduler. This will greatly simplify the future I/O work.
9169     * `collections::btree` has been rewritten to have a more
9170       idiomatic and efficient design.
9171
9172   * Tooling
9173     * rustdoc output now indicates the stability levels of API's.
9174     * The `--crate-name` flag can specify the name of the crate
9175       being compiled, like `#[crate_name]`.
9176     * The `-C metadata` specifies additional metadata to hash into
9177       symbol names, and `-C extra-filename` specifies additional
9178       information to put into the output filename, for use by the
9179       package manager for versioning.
9180     * debug info generation has continued to improve and should be
9181       more reliable under both gdb and lldb.
9182     * rustc has experimental support for compiling in parallel
9183       using the `-C codegen-units` flag.
9184     * rustc no longer encodes rpath information into binaries by
9185       default.
9186
9187   * Misc
9188     * Stack usage has been optimized with LLVM lifetime annotations.
9189     * Official Rust binaries on Linux are more compatible with older
9190       kernels and distributions, built on CentOS 5.10.
9191
9192
9193 Version 0.11.0 (2014-07-02)
9194 ==========================
9195
9196   * ~1700 changes, numerous bugfixes
9197
9198   * Language
9199     * ~[T] has been removed from the language. This type is superseded by
9200       the Vec<T> type.
9201     * ~str has been removed from the language. This type is superseded by
9202       the String type.
9203     * ~T has been removed from the language. This type is superseded by the
9204       Box<T> type.
9205     * @T has been removed from the language. This type is superseded by the
9206       standard library's std::gc::Gc<T> type.
9207     * Struct fields are now all private by default.
9208     * Vector indices and shift amounts are both required to be a `uint`
9209       instead of any integral type.
9210     * Byte character, byte string, and raw byte string literals are now all
9211       supported by prefixing the normal literal with a `b`.
9212     * Multiple ABIs are no longer allowed in an ABI string
9213     * The syntax for lifetimes on closures/procedures has been tweaked
9214       slightly: `<'a>|A, B|: 'b + K -> T`
9215     * Floating point modulus has been removed from the language; however it
9216       is still provided by a library implementation.
9217     * Private enum variants are now disallowed.
9218     * The `priv` keyword has been removed from the language.
9219     * A closure can no longer be invoked through a &-pointer.
9220     * The `use foo, bar, baz;` syntax has been removed from the language.
9221     * The transmute intrinsic no longer works on type parameters.
9222     * Statics now allow blocks/items in their definition.
9223     * Trait bounds are separated from objects with + instead of : now.
9224     * Objects can no longer be read while they are mutably borrowed.
9225     * The address of a static is now marked as insignificant unless the
9226       #[inline(never)] attribute is placed it.
9227     * The #[unsafe_destructor] attribute is now behind a feature gate.
9228     * Struct literals are no longer allowed in ambiguous positions such as
9229       if, while, match, and for..in.
9230     * Declaration of lang items and intrinsics are now feature-gated by
9231       default.
9232     * Integral literals no longer default to `int`, and floating point
9233       literals no longer default to `f64`. Literals must be suffixed with an
9234       appropriate type if inference cannot determine the type of the
9235       literal.
9236     * The Box<T> type is no longer implicitly borrowed to &mut T.
9237     * Procedures are now required to not capture borrowed references.
9238
9239   * Libraries
9240     * The standard library is now a "facade" over a number of underlying
9241       libraries. This means that development on the standard library should
9242       be speedier due to smaller crates, as well as a clearer line between
9243       all dependencies.
9244     * A new library, libcore, lives under the standard library's facade
9245       which is Rust's "0-assumption" library, suitable for embedded and
9246       kernel development for example.
9247     * A regex crate has been added to the standard distribution. This crate
9248       includes statically compiled regular expressions.
9249     * The unwrap/unwrap_err methods on Result require a Show bound for
9250       better error messages.
9251     * The return types of the std::comm primitives have been centralized
9252       around the Result type.
9253     * A number of I/O primitives have gained the ability to time out their
9254       operations.
9255     * A number of I/O primitives have gained the ability to close their
9256       reading/writing halves to cancel pending operations.
9257     * Reverse iterator methods have been removed in favor of `rev()` on
9258       their forward-iteration counterparts.
9259     * A bitflags! macro has been added to enable easy interop with C and
9260       management of bit flags.
9261     * A debug_assert! macro is now provided which is disabled when
9262       `--cfg ndebug` is passed to the compiler.
9263     * A graphviz crate has been added for creating .dot files.
9264     * The std::cast module has been migrated into std::mem.
9265     * The std::local_data api has been migrated from freestanding functions
9266       to being based on methods.
9267     * The Pod trait has been renamed to Copy.
9268     * jemalloc has been added as the default allocator for types.
9269     * The API for allocating memory has been changed to use proper alignment
9270       and sized deallocation
9271     * Connecting a TcpStream or binding a TcpListener is now based on a
9272       string address and a u16 port. This allows connecting to a hostname as
9273       opposed to an IP.
9274     * The Reader trait now contains a core method, read_at_least(), which
9275       correctly handles many repeated 0-length reads.
9276     * The process-spawning API is now centered around a builder-style
9277       Command struct.
9278     * The :? printing qualifier has been moved from the standard library to
9279       an external libdebug crate.
9280     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9281       have been renamed to Eq/Ord.
9282     * The select/plural methods have been removed from format!. The escapes
9283       for { and } have also changed from \{ and \} to {{ and }},
9284       respectively.
9285     * The TaskBuilder API has been re-worked to be a true builder, and
9286       extension traits for spawning native/green tasks have been added.
9287
9288   * Tooling
9289     * All breaking changes to the language or libraries now have their
9290       commit message annotated with `[breaking-change]` to allow for easy
9291       discovery of breaking changes.
9292     * The compiler will now try to suggest how to annotate lifetimes if a
9293       lifetime-related error occurs.
9294     * Debug info continues to be improved greatly with general bug fixes and
9295       better support for situations like link time optimization (LTO).
9296     * Usage of syntax extensions when cross-compiling has been fixed.
9297     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9298       -fdata-sections and --gc-sections has been enabled by default
9299     * The compiler is now stricter about where it will load module files
9300       from when a module is declared via `mod foo;`.
9301     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9302       Syntax extensions are now discovered via a "plugin registrar" type
9303       which will be extended in the future to other various plugins.
9304     * Lints have been restructured to allow for dynamically loadable lints.
9305     * A number of rustdoc improvements:
9306       * The HTML output has been visually redesigned.
9307       * Markdown is now powered by hoedown instead of sundown.
9308       * Searching heuristics have been greatly improved.
9309       * The search index has been reduced in size by a great amount.
9310       * Cross-crate documentation via `pub use` has been greatly improved.
9311       * Primitive types are now hyperlinked and documented.
9312     * Documentation has been moved from static.rust-lang.org/doc to
9313       doc.rust-lang.org
9314     * A new sandbox, play.rust-lang.org, is available for running and
9315       sharing rust code examples on-line.
9316     * Unused attributes are now more robustly warned about.
9317     * The dead_code lint now warns about unused struct fields.
9318     * Cross-compiling to iOS is now supported.
9319     * Cross-compiling to mipsel is now supported.
9320     * Stability attributes are now inherited by default and no longer apply
9321       to intra-crate usage, only inter-crate usage.
9322     * Error message related to non-exhaustive match expressions have been
9323       greatly improved.
9324
9325
9326 Version 0.10 (2014-04-03)
9327 =========================
9328
9329   * ~1500 changes, numerous bugfixes
9330
9331   * Language
9332     * A new RFC process is now in place for modifying the language.
9333     * Patterns with `@`-pointers have been removed from the language.
9334     * Patterns with unique vectors (`~[T]`) have been removed from the
9335       language.
9336     * Patterns with unique strings (`~str`) have been removed from the
9337       language.
9338     * `@str` has been removed from the language.
9339     * `@[T]` has been removed from the language.
9340     * `@self` has been removed from the language.
9341     * `@Trait` has been removed from the language.
9342     * Headers on `~` allocations which contain `@` boxes inside the type for
9343       reference counting have been removed.
9344     * The semantics around the lifetimes of temporary expressions have changed,
9345       see #3511 and #11585 for more information.
9346     * Cross-crate syntax extensions are now possible, but feature gated. See
9347       #11151 for more information. This includes both `macro_rules!` macros as
9348       well as syntax extensions such as `format!`.
9349     * New lint modes have been added, and older ones have been turned on to be
9350       warn-by-default.
9351       * Unnecessary parentheses
9352       * Uppercase statics
9353       * Camel Case types
9354       * Uppercase variables
9355       * Publicly visible private types
9356       * `#[deriving]` with raw pointers
9357     * Unsafe functions can no longer be coerced to closures.
9358     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9359     * The `#[simd]` attribute is now behind a feature gate.
9360     * Visibility is no longer allowed on `extern crate` statements, and
9361       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9362     * Trailing commas are now allowed in argument lists and tuple patterns.
9363     * The `do` keyword has been removed, it is now a reserved keyword.
9364     * Default type parameters have been implemented, but are feature gated.
9365     * Borrowed variables through captures in closures are now considered soundly.
9366     * `extern mod` is now `extern crate`
9367     * The `Freeze` trait has been removed.
9368     * The `Share` trait has been added for types that can be shared among
9369       threads.
9370     * Labels in macros are now hygienic.
9371     * Expression/statement macro invocations can be delimited with `{}` now.
9372     * Treatment of types allowed in `static mut` locations has been tweaked.
9373     * The `*` and `.` operators are now overloadable through the `Deref` and
9374       `DerefMut` traits.
9375     * `~Trait` and `proc` no longer have `Send` bounds by default.
9376     * Partial type hints are now supported with the `_` type marker.
9377     * An `Unsafe` type was introduced for interior mutability. It is now
9378       considered undefined to transmute from `&T` to `&mut T` without using the
9379       `Unsafe` type.
9380     * The #[linkage] attribute was implemented for extern statics/functions.
9381     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9382     * `Pod` was renamed to `Copy`.
9383
9384   * Libraries
9385     * The `libextra` library has been removed. It has now been decomposed into
9386       component libraries with smaller and more focused nuggets of
9387       functionality. The full list of libraries can be found on the
9388       documentation index page.
9389     * std: `std::condition` has been removed. All I/O errors are now propagated
9390       through the `Result` type. In order to assist with error handling, a
9391       `try!` macro for unwrapping errors with an early return and a lint for
9392       unused results has been added. See #12039 for more information.
9393     * std: The `vec` module has been renamed to `slice`.
9394     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9395       This will become the only growable vector in the future.
9396     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9397       are now found at `std::io::BufferedReader` instead of
9398       `std::io::buffered::BufferedReader`.
9399     * std: `print` and `println` are no longer in the prelude, the `print!` and
9400       `println!` macros are intended to be used instead.
9401     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9402       attempts to statically prevent cycles.
9403     * std: The standard distribution is adopting the policy of pushing failure
9404       to the user rather than failing in libraries. Many functions (such as
9405       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9406     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9407       deriving mode: `#[deriving(Show)]`.
9408     * std: `ToStr` is now implemented for all types implementing `Show`.
9409     * std: The formatting trait methods now take `&self` instead of `&T`
9410     * std: The `invert()` method on iterators has been renamed to `rev()`
9411     * std: `std::num` has seen a reduction in the genericity of its traits,
9412       consolidating functionality into a few core traits.
9413     * std: Backtraces are now printed on task failure if the environment
9414       variable `RUST_BACKTRACE` is present.
9415     * std: Naming conventions for iterators have been standardized. More details
9416       can be found on the wiki's style guide.
9417     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9418       still implement the function.
9419     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9420     * std: `assert_approx_eq!` has been removed
9421     * std: The `e` and `E` formatting specifiers for floats have been added to
9422       print them in exponential notation.
9423     * std: The `Times` trait has been removed
9424     * std: Indications of variance and opting out of builtin bounds is done
9425       through marker types in `std::kinds::marker` now
9426     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9427       `#[deriving(Hash)]` is now possible.
9428     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9429     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9430     * std: `Chan::new` is now `channel()`.
9431     * std: A new synchronous channel type has been implemented.
9432     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9433     * std: `hashmap` and `trie` have been moved to `libcollections`
9434     * std: `run` has been rolled into `io::process`
9435     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9436     * std: The equality and comparison traits have seen some reorganization.
9437     * std: `rand` has moved to `librand`.
9438     * std: `to_{lower,upper}case` has been implemented for `char`.
9439     * std: Logging has been moved to `liblog`.
9440     * collections: `HashMap` has been rewritten for higher performance and less
9441       memory usage.
9442     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9443       it can be booted manually. The runtime guide has more information and
9444       examples.
9445     * native: All I/O functionality except signals has been implemented.
9446     * green: Task spawning with `libgreen` has been optimized with stack caching
9447       and various trimming of code.
9448     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9449     * sync: The `extra::sync` module has been updated to modern rust (and moved
9450       to the `sync` library), tweaking and improving various interfaces while
9451       dropping redundant functionality.
9452     * sync: A new `Barrier` type has been added to the `sync` library.
9453     * sync: An efficient mutex for native and green tasks has been implemented.
9454     * serialize: The `base64` module has seen some improvement. It treats
9455       newlines better, has non-string error values, and has seen general
9456       cleanup.
9457     * fourcc: A `fourcc!` macro was introduced
9458     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9459       hexadecimal literal.
9460
9461   * Tooling
9462     * `rustpkg` has been deprecated and removed from the main repository. Its
9463       replacement, `cargo`, is under development.
9464     * Nightly builds of rust are now available
9465     * The memory usage of rustc has been improved many times throughout this
9466       release cycle.
9467     * The build process supports disabling rpath support for the rustc binary
9468       itself.
9469     * Code generation has improved in some cases, giving more information to the
9470       LLVM optimization passes to enable more extensive optimizations.
9471     * Debuginfo compatibility with lldb on OSX has been restored.
9472     * The master branch is now gated on an android bot, making building for
9473       android much more reliable.
9474     * Output flags have been centralized into one `--emit` flag.
9475     * Crate type flags have been centralized into one `--crate-type` flag.
9476     * Codegen flags have been consolidated behind a `-C` flag.
9477     * Linking against outdated crates now has improved error messages.
9478     * Error messages with lifetimes will often suggest how to annotate the
9479       function to fix the error.
9480     * Many more types are documented in the standard library, and new guides
9481       were written.
9482     * Many `rustdoc` improvements:
9483       * code blocks are syntax highlighted.
9484       * render standalone markdown files.
9485       * the --test flag tests all code blocks by default.
9486       * exported macros are displayed.
9487       * re-exported types have their documentation inlined at the location of the
9488         first re-export.
9489       * search works across crates that have been rendered to the same output
9490         directory.
9491
9492
9493 Version 0.9 (2014-01-09)
9494 ==========================
9495
9496    * ~1800 changes, numerous bugfixes
9497
9498    * Language
9499       * The `float` type has been removed. Use `f32` or `f64` instead.
9500       * A new facility for enabling experimental features (feature gating) has
9501         been added, using the crate-level `#[feature(foo)]` attribute.
9502       * Managed boxes (@) are now behind a feature gate
9503         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9504         standard library's `Gc` or `Rc` types instead.
9505       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9506       * Jumping back to the top of a loop is now done with `continue` instead of
9507         `loop`.
9508       * Strings can no longer be mutated through index assignment.
9509       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9510         hash delimiters, as in `r###"foo"###`.
9511       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9512         called once.
9513       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9514       * `@fn`s have been removed.
9515       * `do` only works with procs in order to make it obvious what the cost
9516         of `do` is.
9517       * Single-element tuple-like structs can no longer be dereferenced to
9518         obtain the inner value. A more comprehensive solution for overloading
9519         the dereference operator will be provided in the future.
9520       * The `#[link(...)]` attribute has been replaced with
9521         `#[crate_id = "name#vers"]`.
9522       * Empty `impl`s must be terminated with empty braces and may not be
9523         terminated with a semicolon.
9524       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9525         no longer has any special meaning.
9526       * The old `fmt!` string formatting macro has been removed.
9527       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9528         `print!` and `println!`.
9529       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9530       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9531         `extern mod foo = "bar"` instead.
9532       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9533       * Macros can have attributes.
9534       * Macros can expand to items with attributes.
9535       * Macros can expand to multiple items.
9536       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9537       * Comments may be nested.
9538       * Values automatically coerce to trait objects they implement, without
9539         an explicit `as`.
9540       * Enum discriminants are no longer an entire word but as small as needed to
9541         contain all the variants. The `repr` attribute can be used to override
9542         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9543         `#[repr(C)]` to match C enums.
9544       * Non-string literals are not allowed in attributes (they never worked).
9545       * The FFI now supports variadic functions.
9546       * Octal numeric literals, as in `0o7777`.
9547       * The `concat!` syntax extension performs compile-time string concatenation.
9548       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9549         removed as Rust no longer uses segmented stacks.
9550       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9551       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9552         not `*`; ignoring remaining fields of a struct is also done with `..`,
9553         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9554       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9555       * `rustc` supports the "system" calling convention, which defaults to the
9556         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9557         "C" elsewhere.
9558       * The `type_overflow` lint (default: warn) checks literals for overflow.
9559       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9560       * The `attribute_usage` lint (default: warn) warns about unknown
9561         attributes.
9562       * The `unknown_features` lint (default: warn) warns about unknown
9563         feature gates.
9564       * The `dead_code` lint (default: warn) checks for dead code.
9565       * Rust libraries can be linked statically to one another
9566       * `#[link_args]` is behind the `link_args` feature gate.
9567       * Native libraries are now linked with `#[link(name = "foo")]`
9568       * Native libraries can be statically linked to a rust crate
9569         (`#[link(name = "foo", kind = "static")]`).
9570       * Native OS X frameworks are now officially supported
9571         (`#[link(name = "foo", kind = "framework")]`).
9572       * The `#[thread_local]` attribute creates thread-local (not task-local)
9573         variables. Currently behind the `thread_local` feature gate.
9574       * The `return` keyword may be used in closures.
9575       * Types that can be copied via a memcpy implement the `Pod` kind.
9576       * The `cfg` attribute can now be used on struct fields and enum variants.
9577
9578    * Libraries
9579       * std: The `option` and `result` API's have been overhauled to make them
9580         simpler, more consistent, and more composable.
9581       * std: The entire `std::io` module has been replaced with one that is
9582         more comprehensive and that properly interfaces with the underlying
9583         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9584         implemented.
9585       * std: `io::util` contains a number of useful implementations of
9586         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9587         `ZeroReader`, `TeeReader`.
9588       * std: The reference counted pointer type `extra::rc` moved into std.
9589       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9590         just a wrapper around it).
9591       * std: The `Either` type has been removed.
9592       * std: `fmt::Default` can be implemented for any type to provide default
9593         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9594       * std: The `rand` API continues to be tweaked.
9595       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9596         on failure in gdb, is now named `rust_fail`.
9597       * std: The `each_key` and `each_value` methods on `HashMap` have been
9598         replaced by the `keys` and `values` iterators.
9599       * std: Functions dealing with type size and alignment have moved from the
9600         `sys` module to the `mem` module.
9601       * std: The `path` module was written and API changed.
9602       * std: `str::from_utf8` has been changed to cast instead of allocate.
9603       * std: `starts_with` and `ends_with` methods added to vectors via the
9604         `ImmutableEqVector` trait, which is in the prelude.
9605       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9606         if the index is out of bounds.
9607       * std: Task failure no longer propagates between tasks, as the model was
9608         complex, expensive, and incompatible with thread-based tasks.
9609       * std: The `Any` type can be used for dynamic typing.
9610       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9611         `task::try`.
9612       * std: Methods that produce iterators generally do not have an `_iter`
9613         suffix now.
9614       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9615         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9616       * std: `util::ignore` renamed to `prelude::drop`.
9617       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9618         trait.
9619       * std: `vec::raw` has seen a lot of cleanup and API changes.
9620       * std: The standard library no longer includes any C++ code, and very
9621         minimal C, eliminating the dependency on libstdc++.
9622       * std: Runtime scheduling and I/O functionality has been factored out into
9623         extensible interfaces and is now implemented by two different crates:
9624         libnative, for native threading and I/O; and libgreen, for green threading
9625         and I/O. This paves the way for using the standard library in more limited
9626         embedded environments.
9627       * std: The `comm` module has been rewritten to be much faster, have a
9628         simpler, more consistent API, and to work for both native and green
9629         threading.
9630       * std: All libuv dependencies have been moved into the rustuv crate.
9631       * native: New implementations of runtime scheduling on top of OS threads.
9632       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9633         and other I/O.
9634       * green: The green thread scheduler and message passing types are almost
9635         entirely lock-free.
9636       * extra: The `flatpipes` module had bitrotted and was removed.
9637       * extra: All crypto functions have been removed and Rust now has a policy of
9638         not reimplementing crypto in the standard library. In the future crypto
9639         will be provided by external crates with bindings to established libraries.
9640       * extra: `c_vec` has been modernized.
9641       * extra: The `sort` module has been removed. Use the `sort` method on
9642         mutable slices.
9643
9644    * Tooling
9645       * The `rust` and `rusti` commands have been removed, due to lack of
9646         maintenance.
9647       * `rustdoc` was completely rewritten.
9648       * `rustdoc` can test code examples in documentation.
9649       * `rustpkg` can test packages with the argument, 'test'.
9650       * `rustpkg` supports arbitrary dependencies, including C libraries.
9651       * `rustc`'s support for generating debug info is improved again.
9652       * `rustc` has better error reporting for unbalanced delimiters.
9653       * `rustc`'s JIT support was removed due to bitrot.
9654       * Executables and static libraries can be built with LTO (-Z lto)
9655       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9656         build tools.
9657
9658
9659 Version 0.8 (2013-09-26)
9660 ============================
9661
9662    * ~2200 changes, numerous bugfixes
9663
9664    * Language
9665       * The `for` loop syntax has changed to work with the `Iterator` trait.
9666       * At long last, unwinding works on Windows.
9667       * Default methods are ready for use.
9668       * Many trait inheritance bugs fixed.
9669       * Owned and borrowed trait objects work more reliably.
9670       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9671       * rustc can omit emission of code for the `debug!` macro if it is passed
9672         `--cfg ndebug`
9673       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9674         for foo.rs, then foo/mod.rs, and will generate an error when both are
9675         present.
9676       * Strings no longer contain trailing nulls. The new `std::c_str` module
9677         provides new mechanisms for converting to C strings.
9678       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9679       * The FFI has been overhauled such that foreign functions are called directly,
9680         instead of through a stack-switching wrapper.
9681       * Calling a foreign function must be done through a Rust function with the
9682         `#[fixed_stack_segment]` attribute.
9683       * The `externfn!` macro can be used to declare both a foreign function and
9684         a `#[fixed_stack_segment]` wrapper at once.
9685       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9686       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9687       * `priv` is disallowed everywhere except for struct fields and enum variants.
9688       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9689       * `ref` bindings in irrefutable patterns work correctly now.
9690       * `char` is now prevented from containing invalid code points.
9691       * Casting to `bool` is no longer allowed.
9692       * `\0` is now accepted as an escape in chars and strings.
9693       * `yield` is a reserved keyword.
9694       * `typeof` is a reserved keyword.
9695       * Crates may be imported by URL with `extern mod foo = "url";`.
9696       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9697       * Static vectors can be initialized with repeating elements,
9698         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9699       * Static structs can be initialized with functional record update,
9700         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9701       * `cfg!` can be used to conditionally execute code based on the crate
9702         configuration, similarly to `#[cfg(...)]`.
9703       * The `unnecessary_qualification` lint detects unneeded module
9704         prefixes (default: allow).
9705       * Arithmetic operations have been implemented on the SIMD types in
9706         `std::unstable::simd`.
9707       * Exchange allocation headers were removed, reducing memory usage.
9708       * `format!` implements a completely new, extensible, and higher-performance
9709         string formatting system. It will replace `fmt!`.
9710       * `print!` and `println!` write formatted strings (using the `format!`
9711         extension) to stdout.
9712       * `write!` and `writeln!` write formatted strings (using the `format!`
9713         extension) to the new Writers in `std::rt::io`.
9714       * The library section in which a function or static is placed may
9715         be specified with `#[link_section = "..."]`.
9716       * The `proto!` syntax extension for defining bounded message protocols
9717         was removed.
9718       * `macro_rules!` is hygienic for `let` declarations.
9719       * The `#[export_name]` attribute specifies the name of a symbol.
9720       * `unreachable!` can be used to indicate unreachable code, and fails
9721         if executed.
9722
9723    * Libraries
9724       * std: Transitioned to the new runtime, written in Rust.
9725       * std: Added an experimental I/O library, `rt::io`, based on the new
9726         runtime.
9727       * std: A new generic `range` function was added to the prelude, replacing
9728         `uint::range` and friends.
9729       * std: `range_rev` no longer exists. Since range is an iterator it can be
9730         reversed with `range(lo, hi).invert()`.
9731       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9732         renamed to `unwrap_or`.
9733       * std: The `iterator` module was renamed to `iter`.
9734       * std: Integral types now support the `checked_add`, `checked_sub`, and
9735         `checked_mul` operations for detecting overflow.
9736       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9737         consistency.
9738       * std: Methods are standardizing on conventions for casting methods:
9739         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9740         and cheap casts.
9741       * std: The `CString` type in `c_str` provides new ways to convert to and
9742         from C strings.
9743       * std: `DoubleEndedIterator` can yield elements in two directions.
9744       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9745         two splices.
9746       * std: `str::from_bytes` renamed to `str::from_utf8`.
9747       * std: `pop_opt` and `shift_opt` methods added to vectors.
9748       * std: The task-local data interface no longer uses @, and keys are
9749         no longer function pointers.
9750       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9751       * std: Added `SharedPort` to `comm`.
9752       * std: `Eq` has a default method for `ne`; only `eq` is required
9753         in implementations.
9754       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9755         is required in implementations.
9756       * std: `is_utf8` performance is improved, impacting many string functions.
9757       * std: `os::MemoryMap` provides cross-platform mmap.
9758       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9759         are not 'in-bounds' are considered undefined.
9760       * std: Many freestanding functions in `vec` removed in favor of methods.
9761       * std: Many freestanding functions on scalar types removed in favor of
9762         methods.
9763       * std: Many options to task builders were removed since they don't make
9764         sense in the new scheduler design.
9765       * std: More containers implement `FromIterator` so can be created by the
9766         `collect` method.
9767       * std: More complete atomic types in `unstable::atomics`.
9768       * std: `comm::PortSet` removed.
9769       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9770         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9771         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9772         default implementations.
9773       * std: Various `from_str` functions were removed in favor of a generic
9774         `from_str` which is available in the prelude.
9775       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9776       * extra: `dlist`, the doubly-linked list was modernized.
9777       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9778       * extra: Added `glob` module, replacing `std::os::glob`.
9779       * extra: `rope` was removed.
9780       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9781       * extra: `net`, and `timer` were removed. The experimental replacements
9782         are `std::rt::io::net` and `std::rt::io::timer`.
9783       * extra: Iterators implemented for `SmallIntMap`.
9784       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9785       * extra: `SmallIntSet` removed. Use `BitvSet`.
9786       * extra: Performance of JSON parsing greatly improved.
9787       * extra: `semver` updated to SemVer 2.0.0.
9788       * extra: `term` handles more terminals correctly.
9789       * extra: `dbg` module removed.
9790       * extra: `par` module removed.
9791       * extra: `future` was cleaned up, with some method renames.
9792       * extra: Most free functions in `getopts` were converted to methods.
9793
9794    * Other
9795       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9796       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9797         similarly to gcc's `--march` flag.
9798       * rustc's performance compiling small crates is much better.
9799       * rustpkg has received many improvements.
9800       * rustpkg supports git tags as package IDs.
9801       * rustpkg builds into target-specific directories so it can be used for
9802         cross-compiling.
9803       * The number of concurrent test tasks is controlled by the environment
9804         variable RUST_TEST_TASKS.
9805       * The test harness can now report metrics for benchmarks.
9806       * All tools have man pages.
9807       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9808       * The runtime uses jemalloc for allocations.
9809       * Segmented stacks are temporarily disabled as part of the transition to
9810         the new runtime. Stack overflows are possible!
9811       * A new documentation backend, rustdoc_ng, is available for use. It is
9812         still invoked through the normal `rustdoc` command.
9813
9814
9815 Version 0.7 (2013-07-03)
9816 =======================
9817
9818    * ~2000 changes, numerous bugfixes
9819
9820    * Language
9821       * `impl`s no longer accept a visibility qualifier. Put them on methods
9822         instead.
9823       * The borrow checker has been rewritten with flow-sensitivity, fixing
9824         many bugs and inconveniences.
9825       * The `self` parameter no longer implicitly means `&'self self`,
9826         and can be explicitly marked with a lifetime.
9827       * Overloadable compound operators (`+=`, etc.) have been temporarily
9828         removed due to bugs.
9829       * The `for` loop protocol now requires `for`-iterators to return `bool`
9830         so they compose better.
9831       * The `Durable` trait is replaced with the `'static` bounds.
9832       * Trait default methods work more often.
9833       * Structs with the `#[packed]` attribute have byte alignment and
9834         no padding between fields.
9835       * Type parameters bound by `Copy` must now be copied explicitly with
9836         the `copy` keyword.
9837       * It is now illegal to move out of a dereferenced unsafe pointer.
9838       * `Option<~T>` is now represented as a nullable pointer.
9839       * `@mut` does dynamic borrow checks correctly.
9840       * The `main` function is only detected at the topmost level of the crate.
9841         The `#[main]` attribute is still valid anywhere.
9842       * Struct fields may no longer be mutable. Use inherited mutability.
9843       * The `#[no_send]` attribute makes a type that would otherwise be
9844         `Send`, not.
9845       * The `#[no_freeze]` attribute makes a type that would otherwise be
9846         `Freeze`, not.
9847       * Unbounded recursion will abort the process after reaching the limit
9848         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9849       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9850         are never implicitly copyable.
9851       * `#[static_assert]` makes compile-time assertions about static bools.
9852       * At long last, 'argument modes' no longer exist.
9853       * The rarely used `use mod` statement no longer exists.
9854
9855    * Syntax extensions
9856       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9857         argument list.
9858       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9859         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9860         `#[deriving(...)]`.
9861       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9862         and unsuffixed integer literals.
9863
9864    * Libraries
9865       * The `core` crate was renamed to `std`.
9866       * The `std` crate was renamed to `extra`.
9867       * More and improved documentation.
9868       * std: `iterator` module for external iterator objects.
9869       * Many old-style (internal, higher-order function) iterators replaced by
9870         implementations of `Iterator`.
9871       * std: Many old internal vector and string iterators,
9872         incl. `any`, `all`. removed.
9873       * std: The `finalize` method of `Drop` renamed to `drop`.
9874       * std: The `drop` method now takes `&mut self` instead of `&self`.
9875       * std: The prelude no longer re-exports any modules, only types and traits.
9876       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9877         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9878       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9879         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9880       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9881         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9882       * std: Many types implement `Clone`.
9883       * std: `path` type renamed to `Path`.
9884       * std: `mut` module and `Mut` type removed.
9885       * std: Many standalone functions removed in favor of methods and iterators
9886         in `vec`, `str`. In the future methods will also work as functions.
9887       * std: `reinterpret_cast` removed. Use `transmute`.
9888       * std: ascii string handling in `std::ascii`.
9889       * std: `Rand` is implemented for ~/@.
9890       * std: `run` module for spawning processes overhauled.
9891       * std: Various atomic types added to `unstable::atomic`.
9892       * std: Various types implement `Zero`.
9893       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9894       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9895       * std: Added `os::mkdir_recursive`.
9896       * std: Added `os::glob` function performs filesystems globs.
9897       * std: `FuzzyEq` renamed to `ApproxEq`.
9898       * std: `Map` now defines `pop` and `swap` methods.
9899       * std: `Cell` constructors converted to static methods.
9900       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9901       * extra: `flate` module moved from `std` to `extra`.
9902       * extra: `fileinput` module for iterating over a series of files.
9903       * extra: `Complex` number type and `complex` module.
9904       * extra: `Rational` number type and `rational` module.
9905       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9906       * extra: `term` uses terminfo now, is more correct.
9907       * extra: `arc` functions converted to methods.
9908       * extra: Implementation of fixed output size variations of SHA-2.
9909
9910    * Tooling
9911       * `unused_variables` lint mode for unused variables (default: warn).
9912       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9913         (default: warn).
9914       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9915         (default: warn).
9916       * `dead_assignment` lint mode for unread variables (default: warn).
9917       * `unnecessary_allocation` lint mode detects some heap allocations that are
9918         immediately borrowed so could be written without allocating (default: warn).
9919       * `missing_doc` lint mode (default: allow).
9920       * `unreachable_code` lint mode (default: warn).
9921       * The `rusti` command has been rewritten and a number of bugs addressed.
9922       * rustc outputs in color on more terminals.
9923       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9924       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9925       * Compiling with `-g` will make the binary record information about
9926         dynamic borrowcheck failures for debugging.
9927       * rustdoc has a nicer stylesheet.
9928       * Various improvements to rustdoc.
9929       * Improvements to rustpkg (see the detailed release notes).
9930
9931
9932 Version 0.6 (2013-04-03)
9933 ========================
9934
9935    * ~2100 changes, numerous bugfixes
9936
9937    * Syntax changes
9938       * The self type parameter in traits is now spelled `Self`
9939       * The `self` parameter in trait and impl methods must now be explicitly
9940         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9941       * Static methods no longer require the `static` keyword and instead
9942         are distinguished by the lack of a `self` parameter
9943       * Replaced the `Durable` trait with the `'static` lifetime
9944       * The old closure type syntax with the trailing sigil has been
9945         removed in favor of the more consistent leading sigil
9946       * `super` is a keyword, and may be prefixed to paths
9947       * Trait bounds are separated with `+` instead of whitespace
9948       * Traits are implemented with `impl Trait for Type`
9949         instead of `impl Type: Trait`
9950       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9951       * The `export` keyword has finally been removed
9952       * The `move` keyword has been removed (see "Semantic changes")
9953       * The interior mutability qualifier on vectors, `[mut T]`, has been
9954         removed. Use `&mut [T]`, etc.
9955       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9956       * `fail` is no longer a keyword. Use `fail!()`
9957       * `assert` is no longer a keyword. Use `assert!()`
9958       * `log` is no longer a keyword. use `debug!`, etc.
9959       * 1-tuples may be represented as `(T,)`
9960       * Struct fields may no longer be `mut`. Use inherited mutability,
9961         `@mut T`, `core::mut` or `core::cell`
9962       * `extern mod { ... }` is no longer valid syntax for foreign
9963         function modules. Use extern blocks: `extern { ... }`
9964       * Newtype enums removed. Use tuple-structs.
9965       * Trait implementations no longer support visibility modifiers
9966       * Pattern matching over vectors improved and expanded
9967       * `const` renamed to `static` to correspond to lifetime name,
9968         and make room for future `static mut` unsafe mutable globals.
9969       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9970       * `Clone` implementations can be automatically generated with
9971         `#[deriving(Clone)]`
9972       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9973         instead of `foo as Bar`.
9974       * Fixed length vector types are now written as `[int, .. 3]`
9975         instead of `[int * 3]`.
9976       * Fixed length vector types can express the length as a constant
9977         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9978
9979    * Semantic changes
9980       * Types with owned pointers or custom destructors move by default,
9981         eliminating the `move` keyword
9982       * All foreign functions are considered unsafe
9983       * &mut is now unaliasable
9984       * Writes to borrowed @mut pointers are prevented dynamically
9985       * () has size 0
9986       * The name of the main function can be customized using #[main]
9987       * The default type of an inferred closure is &fn instead of @fn
9988       * `use` statements may no longer be "chained" - they cannot import
9989         identifiers imported by previous `use` statements
9990       * `use` statements are crate relative, importing from the "top"
9991         of the crate by default. Paths may be prefixed with `super::`
9992         or `self::` to change the search behavior.
9993       * Method visibility is inherited from the implementation declaration
9994       * Structural records have been removed
9995       * Many more types can be used in static items, including enums
9996         'static-lifetime pointers and vectors
9997       * Pattern matching over vectors improved and expanded
9998       * Typechecking of closure types has been overhauled to
9999         improve inference and eliminate unsoundness
10000       * Macros leave scope at the end of modules, unless that module is
10001         tagged with #[macro_escape]
10002
10003    * Libraries
10004       * Added big integers to `std::bigint`
10005       * Removed `core::oldcomm` module
10006       * Added pipe-based `core::comm` module
10007       * Numeric traits have been reorganized under `core::num`
10008       * `vec::slice` finally returns a slice
10009       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10010       * Containers reorganized around traits in `core::container`
10011       * `core::dvec` removed, `~[T]` is a drop-in replacement
10012       * `core::send_map` renamed to `core::hashmap`
10013       * `std::map` removed; replaced with `core::hashmap`
10014       * `std::treemap` reimplemented as an owned balanced tree
10015       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10016       * `core::trie` added as a fast ordered map for integer keys
10017       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10018       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10019         overload the comparison operators, whereas `TotalOrd` is used
10020         by certain container types
10021
10022    * Other
10023       * Replaced the 'cargo' package manager with 'rustpkg'
10024       * Added all-purpose 'rust' tool
10025       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10026       * rustc now *attempts* to offer spelling suggestions
10027       * Improved support for ARM and Android
10028       * Preliminary MIPS backend
10029       * Improved foreign function ABI implementation for x86, x86_64
10030       * Various memory usage improvements
10031       * Rust code may be embedded in foreign code under limited circumstances
10032       * Inline assembler supported by new asm!() syntax extension.
10033
10034
10035 Version 0.5 (2012-12-21)
10036 ===========================
10037
10038    * ~900 changes, numerous bugfixes
10039
10040    * Syntax changes
10041       * Removed `<-` move operator
10042       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10043       * Removed old fixed length vector syntax - `[T]/N`
10044       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10045       * Macros may now expand to items and statements
10046       * `a.b()` is always parsed as a method call, never as a field projection
10047       * `Eq` and `IterBytes` implementations can be automatically generated
10048         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10049       * Removed the special crate language for `.rc` files
10050       * Function arguments may consist of any irrefutable pattern
10051
10052    * Semantic changes
10053       * `&` and `~` pointers may point to objects
10054       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10055       * Enum variants may be structs
10056       * Destructors can be added to all nominal types with the Drop trait
10057       * Structs and nullary enum variants may be constants
10058       * Values that cannot be implicitly copied are now automatically moved
10059         without writing `move` explicitly
10060       * `&T` may now be coerced to `*T`
10061       * Coercions happen in `let` statements as well as function calls
10062       * `use` statements now take crate-relative paths
10063       * The module and type namespaces have been merged so that static
10064         method names can be resolved under the trait in which they are
10065         declared
10066
10067    * Improved support for language features
10068       * Trait inheritance works in many scenarios
10069       * More support for explicit self arguments in methods - `self`, `&self`
10070         `@self`, and `~self` all generally work as expected
10071       * Static methods work in more situations
10072       * Experimental: Traits may declare default methods for the implementations
10073         to use
10074
10075    * Libraries
10076       * New condition handling system in `core::condition`
10077       * Timsort added to `std::sort`
10078       * New priority queue, `std::priority_queue`
10079       * Pipes for serializable types, `std::flatpipes'
10080       * Serialization overhauled to be trait-based
10081       * Expanded `getopts` definitions
10082       * Moved futures to `std`
10083       * More functions are pure now
10084       * `core::comm` renamed to `oldcomm`. Still deprecated
10085       * `rustdoc` and `cargo` are libraries now
10086
10087    * Misc
10088       * Added a preliminary REPL, `rusti`
10089       * License changed from MIT to dual MIT/APL2
10090
10091
10092 Version 0.4 (2012-10-15)
10093 ==========================
10094
10095    * ~2000 changes, numerous bugfixes
10096
10097    * Syntax
10098       * All keywords are now strict and may not be used as identifiers anywhere
10099       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10100         'of', 'with', 'to', 'class'.
10101       * Classes are replaced with simpler structs
10102       * Explicit method self types
10103       * `ret` became `return` and `alt` became `match`
10104       * `import` is now `use`; `use is now `extern mod`
10105       * `extern mod { ... }` is now `extern { ... }`
10106       * `use mod` is the recommended way to import modules
10107       * `pub` and `priv` replace deprecated export lists
10108       * The syntax of `match` pattern arms now uses fat arrow (=>)
10109       * `main` no longer accepts an args vector; use `os::args` instead
10110
10111    * Semantics
10112       * Trait implementations are now coherent, ala Haskell typeclasses
10113       * Trait methods may be static
10114       * Argument modes are deprecated
10115       * Borrowed pointers are much more mature and recommended for use
10116       * Strings and vectors in the static region are stored in constant memory
10117       * Typestate was removed
10118       * Resolution rewritten to be more reliable
10119       * Support for 'dual-mode' data structures (freezing and thawing)
10120
10121    * Libraries
10122       * Most binary operators can now be overloaded via the traits in
10123         `core::ops'
10124       * `std::net::url` for representing URLs
10125       * Sendable hash maps in `core::send_map`
10126       * `core::task' gained a (currently unsafe) task-local storage API
10127
10128    * Concurrency
10129       * An efficient new intertask communication primitive called the pipe,
10130         along with a number of higher-level channel types, in `core::pipes`
10131       * `std::arc`, an atomically reference counted, immutable, shared memory
10132         type
10133       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10134       * Futures are now based on pipes and sendable
10135       * More robust linked task failure
10136       * Improved task builder API
10137
10138    * Other
10139       * Improved error reporting
10140       * Preliminary JIT support
10141       * Preliminary work on precise GC
10142       * Extensive architectural improvements to rustc
10143       * Begun a transition away from buggy C++-based reflection (shape) code to
10144         Rust-based (visitor) code
10145       * All hash functions and tables converted to secure, randomized SipHash
10146
10147
10148 Version 0.3  (2012-07-12)
10149 ========================
10150
10151    * ~1900 changes, numerous bugfixes
10152
10153    * New coding conveniences
10154       * Integer-literal suffix inference
10155       * Per-item control over warnings, errors
10156       * #[cfg(windows)] and #[cfg(unix)] attributes
10157       * Documentation comments
10158       * More compact closure syntax
10159       * 'do' expressions for treating higher-order functions as
10160         control structures
10161       * *-patterns (wildcard extended to all constructor fields)
10162
10163    * Semantic cleanup
10164       * Name resolution pass and exhaustiveness checker rewritten
10165       * Region pointers and borrow checking supersede alias
10166         analysis
10167       * Init-ness checking is now provided by a region-based liveness
10168         pass instead of the typestate pass; same for last-use analysis
10169       * Extensive work on region pointers
10170
10171    * Experimental new language features
10172       * Slices and fixed-size, interior-allocated vectors
10173       * #!-comments for lang versioning, shell execution
10174       * Destructors and iface implementation for classes;
10175         type-parameterized classes and class methods
10176       * 'const' type kind for types that can be used to implement
10177         shared-memory concurrency patterns
10178
10179    * Type reflection
10180
10181    * Removal of various obsolete features
10182       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10183                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10184
10185       * Constructs: do-while loops ('do' repurposed), fn binding,
10186                     resources (replaced by destructors)
10187
10188    * Compiler reorganization
10189       * Syntax-layer of compiler split into separate crate
10190       * Clang (from LLVM project) integrated into build
10191       * Typechecker split into sub-modules
10192
10193    * New library code
10194       * New time functions
10195       * Extension methods for many built-in types
10196       * Arc: atomic-refcount read-only / exclusive-use shared cells
10197       * Par: parallel map and search routines
10198       * Extensive work on libuv interface
10199       * Much vector code moved to libraries
10200       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10201         #include, #include_str, #include_bin
10202
10203    * Tool improvements
10204       * Cargo automatically resolves dependencies
10205
10206
10207 Version 0.2  (2012-03-29)
10208 =========================
10209
10210    * >1500 changes, numerous bugfixes
10211
10212    * New docs and doc tooling
10213
10214    * New port: FreeBSD x86_64
10215
10216    * Compilation model enhancements
10217       * Generics now specialized, multiply instantiated
10218       * Functions now inlined across separate crates
10219
10220    * Scheduling, stack and threading fixes
10221       * Noticeably improved message-passing performance
10222       * Explicit schedulers
10223       * Callbacks from C
10224       * Helgrind clean
10225
10226    * Experimental new language features
10227       * Operator overloading
10228       * Region pointers
10229       * Classes
10230
10231    * Various language extensions
10232       * C-callback function types: 'crust fn ...'
10233       * Infinite-loop construct: 'loop { ... }'
10234       * Shorten 'mutable' to 'mut'
10235       * Required mutable-local qualifier: 'let mut ...'
10236       * Basic glob-exporting: 'export foo::*;'
10237       * Alt now exhaustive, 'alt check' for runtime-checked
10238       * Block-function form of 'for' loop, with 'break' and 'ret'.
10239
10240    * New library code
10241       * AST quasi-quote syntax extension
10242       * Revived libuv interface
10243       * New modules: core::{future, iter}, std::arena
10244       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10245       * Extensive cleanup, regularization in libstd, libcore
10246
10247
10248 Version 0.1  (2012-01-20)
10249 ===============================
10250
10251    * Most language features work, including:
10252       * Unique pointers, unique closures, move semantics
10253       * Interface-constrained generics
10254       * Static interface dispatch
10255       * Stack growth
10256       * Multithread task scheduling
10257       * Typestate predicates
10258       * Failure unwinding, destructors
10259       * Pattern matching and destructuring assignment
10260       * Lightweight block-lambda syntax
10261       * Preliminary macro-by-example
10262
10263    * Compiler works with the following configurations:
10264       * Linux: x86 and x86_64 hosts and targets
10265       * macOS: x86 and x86_64 hosts and targets
10266       * Windows: x86 hosts and targets
10267
10268    * Cross compilation / multi-target configuration supported.
10269
10270    * Preliminary API-documentation and package-management tools included.
10271
10272 Known issues:
10273
10274    * Documentation is incomplete.
10275
10276    * Performance is below intended target.
10277
10278    * Standard library APIs are subject to extensive change, reorganization.
10279
10280    * Language-level versioning is not yet operational - future code will
10281      break unexpectedly.