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
 117 Internal Only
 118 -------------
 119 These changes provide no direct user facing benefits, but represent significant
 120 improvements to the internals and overall performance of rustc and
 121 related tools.
 122
 123 - [Rework the `std::sys::windows::alloc` implementation.][83065]
 124 - [rustdoc: Don't enter an infer_ctxt in get_blanket_impls for impls that aren't blanket impls.][82864]
 125 - [rustdoc: Only look at blanket impls in `get_blanket_impls`][83681]
 126 - [Rework rustdoc const type][82873]
 127
 128 [85667]: https://github.com/rust-lang/rust/pull/85667
 129 [83386]: https://github.com/rust-lang/rust/pull/83386
 130 [82771]: https://github.com/rust-lang/rust/pull/82771
 131 [84147]: https://github.com/rust-lang/rust/pull/84147
 132 [84082]: https://github.com/rust-lang/rust/pull/84082
 133 [83799]: https://github.com/rust-lang/rust/pull/83799
 134 [83681]: https://github.com/rust-lang/rust/pull/83681
 135 [83652]: https://github.com/rust-lang/rust/pull/83652
 136 [83387]: https://github.com/rust-lang/rust/pull/83387
 137 [82873]: https://github.com/rust-lang/rust/pull/82873
 138 [82864]: https://github.com/rust-lang/rust/pull/82864
 139 [82608]: https://github.com/rust-lang/rust/pull/82608
 140 [82565]: https://github.com/rust-lang/rust/pull/82565
 141 [80525]: https://github.com/rust-lang/rust/pull/80525
 142 [79278]: https://github.com/rust-lang/rust/pull/79278
 143 [78618]: https://github.com/rust-lang/rust/pull/78618
 144 [77704]: https://github.com/rust-lang/rust/pull/77704
 145 [83941]: https://github.com/rust-lang/rust/pull/83941
 146 [83065]: https://github.com/rust-lang/rust/pull/83065
 147 [81764]: https://github.com/rust-lang/rust/pull/81764
 148 [81469]: https://github.com/rust-lang/rust/pull/81469
 149 [cargo/9298]: https://github.com/rust-lang/cargo/pull/9298
 150 [cargo/9282]: https://github.com/rust-lang/cargo/pull/9282
 151 [cargo/9392]: https://github.com/rust-lang/cargo/pull/9392
 152 [`AtomicBool::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicBool.html#method.fetch_update
 153 [`AtomicPtr::fetch_update`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicPtr.html#method.fetch_update
 154 [`BTreeMap::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.retain
 155 [`BTreeSet::retain`]: https://doc.rust-lang.org/std/collections/struct.BTreeSet.html#method.retain
 156 [`BufReader::seek_relative`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.seek_relative
 157 [`DebugStruct::non_exhaustive`]: https://doc.rust-lang.org/std/fmt/struct.DebugStruct.html#method.finish_non_exhaustive
 158 [`Duration::MAX`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 159 [`Duration::ZERO`]: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.ZERO
 160 [`Duration::is_zero`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.is_zero
 161 [`Duration::saturating_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_add
 162 [`Duration::saturating_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_mul
 163 [`Duration::saturating_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.saturating_sub
 164 [`ErrorKind::Unsupported`]: https://doc.rust-lang.org/std/io/enum.ErrorKind.html#variant.Unsupported
 165 [`Option::insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.insert
 166 [`Ordering::is_eq`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_eq
 167 [`Ordering::is_ge`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ge
 168 [`Ordering::is_gt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_gt
 169 [`Ordering::is_le`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_le
 170 [`Ordering::is_lt`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_lt
 171 [`Ordering::is_ne`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.is_ne
 172 [`OsStr::eq_ignore_ascii_case`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.eq_ignore_ascii_case
 173 [`OsStr::is_ascii`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.is_ascii
 174 [`OsStr::make_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_lowercase
 175 [`OsStr::make_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.make_ascii_uppercase
 176 [`OsStr::to_ascii_lowercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_lowercase
 177 [`OsStr::to_ascii_uppercase`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.to_ascii_uppercase
 178 [`Peekable::peek_mut`]: https://doc.rust-lang.org/std/iter/struct.Peekable.html#method.peek_mut
 179 [`Rc::decrement_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 180 [`Rc::increment_strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.increment_strong_count
 181 [`Vec::extend_from_within`]: https://doc.rust-lang.org/beta/std/vec/struct.Vec.html#method.extend_from_within
 182 [`array::from_mut`]: https://doc.rust-lang.org/beta/std/array/fn.from_mut.html
 183 [`array::from_ref`]: https://doc.rust-lang.org/beta/std/array/fn.from_ref.html
 184 [`cmp::max_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by_key.html
 185 [`cmp::max_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.max_by.html
 186 [`cmp::min_by_key`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by_key.html
 187 [`cmp::min_by`]: https://doc.rust-lang.org/beta/std/cmp/fn.min_by.html
 188 [`f32::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 189 [`f64::is_subnormal`]: https://doc.rust-lang.org/std/primitive.f64.html#method.is_subnormal
 190 [ietf6943]: https://datatracker.ietf.org/doc/html/rfc6943#section-3.1.1
 191
 192
 193 Version 1.52.1 (2021-05-10)
 194 ============================
 195
 196 This release disables incremental compilation, unless the user has explicitly
 197 opted in via the newly added RUSTC_FORCE_INCREMENTAL=1 environment variable.
 198
 199 This is due to the widespread, and frequently occuring, breakage encountered by
 200 Rust users due to newly enabled incremental verification in 1.52.0. Notably,
 201 Rust users **should** upgrade to 1.52.0 or 1.52.1: the bugs that are detected by
 202 newly added incremental verification are still present in past stable versions,
 203 and are not yet fixed on any channel. These bugs can lead to miscompilation of
 204 Rust binaries.
 205
 206 These problems only affect incremental builds, so release builds with Cargo
 207 should not be affected unless the user has explicitly opted into incremental.
 208 Debug and check builds are affected.
 209
 210 See [84970] for more details.
 211
 212 [84970]: https://github.com/rust-lang/rust/issues/84970
 213
 214 Version 1.52.0 (2021-05-06)
 215 ============================
 216
 217 Language
 218 --------
 219 - [Added the `unsafe_op_in_unsafe_fn` lint, which checks whether the unsafe code
 220   in an `unsafe fn` is wrapped in a `unsafe` block.][79208] This lint
 221   is allowed by default, and may become a warning or hard error in a
 222   future edition.
 223 - [You can now cast mutable references to arrays to a pointer of the same type as
 224   the element.][81479]
 225
 226 Compiler
 227 --------
 228 - [Upgraded the default LLVM to LLVM 12.][81451]
 229
 230 Added tier 3\* support for the following targets.
 231
 232 - [`s390x-unknown-linux-musl`][82166]
 233 - [`riscv32gc-unknown-linux-musl` & `riscv64gc-unknown-linux-musl`][82202]
 234 - [`powerpc-unknown-openbsd`][82733]
 235
 236 \* Refer to Rust's [platform support page][platform-support-doc] for more
 237 information on Rust's tiered platform support.
 238
 239 Libraries
 240 ---------
 241 - [`OsString` now implements `Extend` and `FromIterator`.][82121]
 242 - [`cmp::Reverse` now has `#[repr(transparent)]` representation.][81879]
 243 - [`Arc<impl Error>` now implements `error::Error`.][80553]
 244 - [All integer division and remainder operations are now `const`.][80962]
 245
 246 Stabilised APIs
 247 -------------
 248 - [`Arguments::as_str`]
 249 - [`char::MAX`]
 250 - [`char::REPLACEMENT_CHARACTER`]
 251 - [`char::UNICODE_VERSION`]
 252 - [`char::decode_utf16`]
 253 - [`char::from_digit`]
 254 - [`char::from_u32_unchecked`]
 255 - [`char::from_u32`]
 256 - [`slice::partition_point`]
 257 - [`str::rsplit_once`]
 258 - [`str::split_once`]
 259
 260 The following previously stable APIs are now `const`.
 261
 262 - [`char::len_utf8`]
 263 - [`char::len_utf16`]
 264 - [`char::to_ascii_uppercase`]
 265 - [`char::to_ascii_lowercase`]
 266 - [`char::eq_ignore_ascii_case`]
 267 - [`u8::to_ascii_uppercase`]
 268 - [`u8::to_ascii_lowercase`]
 269 - [`u8::eq_ignore_ascii_case`]
 270
 271 Rustdoc
 272 -------
 273 - [Rustdoc lints are now treated as a tool lint, meaning that
 274   lints are now prefixed with `rustdoc::` (e.g. `#[warn(rustdoc::broken_intra_doc_links)]`).][80527]
 275   Using the old style is still allowed, and will become a warning in
 276   a future release.
 277 - [Rustdoc now supports argument files.][82261]
 278 - [Rustdoc now generates smart punctuation for documentation.][79423]
 279 - [You can now use "task lists" in Rustdoc Markdown.][81766] E.g.
 280   ```markdown
 281   - [x] Complete
 282   - [ ] Todo
 283   ```
 284
 285 Misc
 286 ----
 287 - [You can now pass multiple filters to tests.][81356] E.g.
 288   `cargo test -- foo bar` will run all tests that match `foo` and `bar`.
 289 - [Rustup now distributes PDB symbols for the `std` library on Windows,
 290   allowing you to see `std` symbols when debugging.][82218]
 291
 292 Internal Only
 293 -------------
 294 These changes provide no direct user facing benefits, but represent significant
 295 improvements to the internals and overall performance of rustc and
 296 related tools.
 297
 298 - [Check the result cache before the DepGraph when ensuring queries][81855]
 299 - [Try fast_reject::simplify_type in coherence before doing full check][81744]
 300 - [Only store a LocalDefId in some HIR nodes][81611]
 301 - [Store HIR attributes in a side table][79519]
 302
 303 Compatibility Notes
 304 -------------------
 305 - [Cargo build scripts are now forbidden from setting `RUSTC_BOOTSTRAP`.][cargo/9181]
 306 - [Removed support for the `x86_64-rumprun-netbsd` target.][82594]
 307 - [Deprecated the `x86_64-sun-solaris` target in favor of `x86_64-pc-solaris`.][82216]
 308 - [Rustdoc now only accepts `,`, ` `, and `\t` as delimiters for specifying
 309   languages in code blocks.][78429]
 310 - [Rustc now catches more cases of `pub_use_of_private_extern_crate`][80763]
 311 - [Changes in how proc macros handle whitespace may lead to panics when used
 312   with older `proc-macro-hack` versions. A `cargo update` should be sufficient to fix this in all cases.][84136]
 313 - [Turn `#[derive]` into a regular macro attribute][79078]
 314
 315 [84136]: https://github.com/rust-lang/rust/issues/84136
 316 [80763]: https://github.com/rust-lang/rust/pull/80763
 317 [82166]: https://github.com/rust-lang/rust/pull/82166
 318 [82121]: https://github.com/rust-lang/rust/pull/82121
 319 [81879]: https://github.com/rust-lang/rust/pull/81879
 320 [82261]: https://github.com/rust-lang/rust/pull/82261
 321 [82218]: https://github.com/rust-lang/rust/pull/82218
 322 [82216]: https://github.com/rust-lang/rust/pull/82216
 323 [82202]: https://github.com/rust-lang/rust/pull/82202
 324 [81855]: https://github.com/rust-lang/rust/pull/81855
 325 [81766]: https://github.com/rust-lang/rust/pull/81766
 326 [81744]: https://github.com/rust-lang/rust/pull/81744
 327 [81611]: https://github.com/rust-lang/rust/pull/81611
 328 [81479]: https://github.com/rust-lang/rust/pull/81479
 329 [81451]: https://github.com/rust-lang/rust/pull/81451
 330 [81356]: https://github.com/rust-lang/rust/pull/81356
 331 [80962]: https://github.com/rust-lang/rust/pull/80962
 332 [80553]: https://github.com/rust-lang/rust/pull/80553
 333 [80527]: https://github.com/rust-lang/rust/pull/80527
 334 [79519]: https://github.com/rust-lang/rust/pull/79519
 335 [79423]: https://github.com/rust-lang/rust/pull/79423
 336 [79208]: https://github.com/rust-lang/rust/pull/79208
 337 [78429]: https://github.com/rust-lang/rust/pull/78429
 338 [82733]: https://github.com/rust-lang/rust/pull/82733
 339 [82594]: https://github.com/rust-lang/rust/pull/82594
 340 [79078]: https://github.com/rust-lang/rust/pull/79078
 341 [cargo/9181]: https://github.com/rust-lang/cargo/pull/9181
 342 [`char::MAX`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.MAX
 343 [`char::REPLACEMENT_CHARACTER`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.REPLACEMENT_CHARACTER
 344 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/std/primitive.char.html#associatedconstant.UNICODE_VERSION
 345 [`char::decode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.decode_utf16
 346 [`char::from_u32`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32
 347 [`char::from_u32_unchecked`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_u32_unchecked
 348 [`char::from_digit`]: https://doc.rust-lang.org/std/primitive.char.html#method.from_digit
 349 [`Peekable::next_if`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if
 350 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/stable/std/iter/struct.Peekable.html#method.next_if_eq
 351 [`Arguments::as_str`]: https://doc.rust-lang.org/stable/std/fmt/struct.Arguments.html#method.as_str
 352 [`str::split_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.split_once
 353 [`str::rsplit_once`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.rsplit_once
 354 [`slice::partition_point`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.partition_point
 355 [`char::len_utf8`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf8
 356 [`char::len_utf16`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.len_utf16
 357 [`char::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_uppercase
 358 [`char::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.to_ascii_lowercase
 359 [`char::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.char.html#method.eq_ignore_ascii_case
 360 [`u8::to_ascii_uppercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_uppercase
 361 [`u8::to_ascii_lowercase`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ascii_lowercase
 362 [`u8::eq_ignore_ascii_case`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.eq_ignore_ascii_case
 363
 364 Version 1.51.0 (2021-03-25)
 365 ============================
 366
 367 Language
 368 --------
 369 - [You can now parameterize items such as functions, traits, and `struct`s by constant
 370   values in addition to by types and lifetimes.][79135] Also known as "const generics"
 371   E.g. you can now write the following. Note: Only values of primitive integers,
 372   `bool`, or `char` types are currently permitted.
 373   ```rust
 374   struct GenericArray<T, const LENGTH: usize> {
 375       inner: [T; LENGTH]
 376   }
 377
 378   impl<T, const LENGTH: usize> GenericArray<T, LENGTH> {
 379       const fn last(&self) -> Option<&T> {
 380           if LENGTH == 0 {
 381               None
 382           } else {
 383               Some(&self.inner[LENGTH - 1])
 384           }
 385       }
 386   }
 387   ```
 388
 389
 390 Compiler
 391 --------
 392
 393 - [Added the `-Csplit-debuginfo` codegen option for macOS platforms.][79570]
 394   This option controls whether debug information is split across multiple files
 395   or packed into a single file. **Note** This option is unstable on other platforms.
 396 - [Added tier 3\* support for `aarch64_be-unknown-linux-gnu`,
 397   `aarch64-unknown-linux-gnu_ilp32`, and `aarch64_be-unknown-linux-gnu_ilp32` targets.][81455]
 398 - [Added tier 3 support for `i386-unknown-linux-gnu` and `i486-unknown-linux-gnu` targets.][80662]
 399 - [The `target-cpu=native` option will now detect individual features of CPUs.][80749]
 400
 401 \* Refer to Rust's [platform support page][platform-support-doc] for more
 402 information on Rust's tiered platform support.
 403
 404 Libraries
 405 ---------
 406
 407 - [`Box::downcast` is now also implemented for any `dyn Any + Send + Sync` object.][80945]
 408 - [`str` now implements `AsMut<str>`.][80279]
 409 - [`u64` and `u128` now implement `From<char>`.][79502]
 410 - [`Error` is now implemented for `&T` where `T` implements `Error`.][75180]
 411 - [`Poll::{map_ok, map_err}` are now implemented for `Poll<Option<Result<T, E>>>`.][80968]
 412 - [`unsigned_abs` is now implemented for all signed integer types.][80959]
 413 - [`io::Empty` now implements `io::Seek`.][78044]
 414 - [`rc::Weak<T>` and `sync::Weak<T>`'s methods such as `as_ptr` are now implemented for
 415   `T: ?Sized` types.][80764]
 416 - [`Div` and `Rem` by their `NonZero` variant is now implemented for all unsigned integers.][79134]
 417
 418
 419 Stabilized APIs
 420 ---------------
 421
 422 - [`Arc::decrement_strong_count`]
 423 - [`Arc::increment_strong_count`]
 424 - [`Once::call_once_force`]
 425 - [`Peekable::next_if_eq`]
 426 - [`Peekable::next_if`]
 427 - [`Seek::stream_position`]
 428 - [`array::IntoIter`]
 429 - [`panic::panic_any`]
 430 - [`ptr::addr_of!`]
 431 - [`ptr::addr_of_mut!`]
 432 - [`slice::fill_with`]
 433 - [`slice::split_inclusive_mut`]
 434 - [`slice::split_inclusive`]
 435 - [`slice::strip_prefix`]
 436 - [`slice::strip_suffix`]
 437 - [`str::split_inclusive`]
 438 - [`sync::OnceState`]
 439 - [`task::Wake`]
 440 - [`VecDeque::range`]
 441 - [`VecDeque::range_mut`]
 442
 443 Cargo
 444 -----
 445 - [Added the `split-debuginfo` profile option to control the -Csplit-debuginfo
 446   codegen option.][cargo/9112]
 447 - [Added the `resolver` field to `Cargo.toml` to enable the new feature resolver
 448   and CLI option behavior.][cargo/8997] Version 2 of the feature resolver will try
 449   to avoid unifying features of dependencies where that unification could be unwanted.
 450   Such as using the same dependency with a `std` feature in a build scripts and
 451   proc-macros, while using the `no-std` feature in the final binary. See the
 452   [Cargo book documentation][feature-resolver@2.0] for more information on the feature.
 453
 454 Rustdoc
 455 -------
 456
 457 - [Rustdoc will now include documentation for methods available from _nested_ `Deref` traits.][80653]
 458 - [You can now provide a `--default-theme` flag which sets the default theme to use for
 459   documentation.][79642]
 460
 461 Various improvements to intra-doc links:
 462
 463 - [You can link to non-path primitives such as `slice`.][80181]
 464 - [You can link to associated items.][74489]
 465 - [You can now include generic parameters when linking to items, like `Vec<T>`.][76934]
 466
 467 Misc
 468 ----
 469 - [You can now pass `--include-ignored` to tests (e.g. with
 470   `cargo test -- --include-ignored`) to include testing tests marked `#[ignore]`.][80053]
 471
 472 Compatibility Notes
 473 -------------------
 474
 475 - [WASI platforms no longer use the `wasm-bindgen` ABI, and instead use the wasm32 ABI.][79998]
 476 - [`rustc` no longer promotes division, modulo and indexing operations to `const` that
 477   could fail.][80579]
 478 - [The minimum version of glibc for the following platforms has been bumped to version 2.31
 479   for the distributed artifacts.][81521]
 480     - `armv5te-unknown-linux-gnueabi`
 481     - `sparc64-unknown-linux-gnu`
 482     - `thumbv7neon-unknown-linux-gnueabihf`
 483     - `armv7-unknown-linux-gnueabi`
 484     - `x86_64-unknown-linux-gnux32`
 485 - [`atomic::spin_loop_hint` has been deprecated.][80966] It's recommended to use `hint::spin_loop` instead.
 486
 487 Internal Only
 488 -------------
 489
 490 - [Consistently avoid constructing optimized MIR when not doing codegen][80718]
 491
 492 [79135]: https://github.com/rust-lang/rust/pull/79135
 493 [74489]: https://github.com/rust-lang/rust/pull/74489
 494 [76934]: https://github.com/rust-lang/rust/pull/76934
 495 [79570]: https://github.com/rust-lang/rust/pull/79570
 496 [80181]: https://github.com/rust-lang/rust/pull/80181
 497 [79642]: https://github.com/rust-lang/rust/pull/79642
 498 [80945]: https://github.com/rust-lang/rust/pull/80945
 499 [80279]: https://github.com/rust-lang/rust/pull/80279
 500 [80053]: https://github.com/rust-lang/rust/pull/80053
 501 [79502]: https://github.com/rust-lang/rust/pull/79502
 502 [75180]: https://github.com/rust-lang/rust/pull/75180
 503 [79135]: https://github.com/rust-lang/rust/pull/79135
 504 [81521]: https://github.com/rust-lang/rust/pull/81521
 505 [80968]: https://github.com/rust-lang/rust/pull/80968
 506 [80959]: https://github.com/rust-lang/rust/pull/80959
 507 [80718]: https://github.com/rust-lang/rust/pull/80718
 508 [80653]: https://github.com/rust-lang/rust/pull/80653
 509 [80579]: https://github.com/rust-lang/rust/pull/80579
 510 [79998]: https://github.com/rust-lang/rust/pull/79998
 511 [78044]: https://github.com/rust-lang/rust/pull/78044
 512 [81455]: https://github.com/rust-lang/rust/pull/81455
 513 [80764]: https://github.com/rust-lang/rust/pull/80764
 514 [80749]: https://github.com/rust-lang/rust/pull/80749
 515 [80662]: https://github.com/rust-lang/rust/pull/80662
 516 [79134]: https://github.com/rust-lang/rust/pull/79134
 517 [80966]: https://github.com/rust-lang/rust/pull/80966
 518 [cargo/8997]: https://github.com/rust-lang/cargo/pull/8997
 519 [cargo/9112]: https://github.com/rust-lang/cargo/pull/9112
 520 [feature-resolver@2.0]: https://doc.rust-lang.org/nightly/cargo/reference/features.html#feature-resolver-version-2
 521 [`Once::call_once_force`]: https://doc.rust-lang.org/stable/std/sync/struct.Once.html#method.call_once_force
 522 [`sync::OnceState`]: https://doc.rust-lang.org/stable/std/sync/struct.OnceState.html
 523 [`panic::panic_any`]: https://doc.rust-lang.org/stable/std/panic/fn.panic_any.html
 524 [`slice::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 525 [`slice::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.strip_prefix
 526 [`Arc::increment_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.increment_strong_count
 527 [`Arc::decrement_strong_count`]: https://doc.rust-lang.org/nightly/std/sync/struct.Arc.html#method.decrement_strong_count
 528 [`slice::fill_with`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.fill_with
 529 [`ptr::addr_of!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of.html
 530 [`ptr::addr_of_mut!`]: https://doc.rust-lang.org/nightly/std/ptr/macro.addr_of_mut.html
 531 [`array::IntoIter`]: https://doc.rust-lang.org/nightly/std/array/struct.IntoIter.html
 532 [`slice::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive
 533 [`slice::split_inclusive_mut`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_inclusive_mut
 534 [`str::split_inclusive`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_inclusive
 535 [`task::Wake`]: https://doc.rust-lang.org/nightly/std/task/trait.Wake.html
 536 [`Seek::stream_position`]: https://doc.rust-lang.org/nightly/std/io/trait.Seek.html#method.stream_position
 537 [`Peekable::next_if`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if
 538 [`Peekable::next_if_eq`]: https://doc.rust-lang.org/nightly/std/iter/struct.Peekable.html#method.next_if_eq
 539 [`VecDeque::range`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range
 540 [`VecDeque::range_mut`]: https://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.range_mut
 541
 542 Version 1.50.0 (2021-02-11)
 543 ============================
 544
 545 Language
 546 -----------------------
 547 - [You can now use `const` values for `x` in `[x; N]` array expressions.][79270]
 548   This has been technically possible since 1.38.0, as it was unintentionally stabilized.
 549 - [Assignments to `ManuallyDrop<T>` union fields are now considered safe.][78068]
 550
 551 Compiler
 552 -----------------------
 553 - [Added tier 3\* support for the `armv5te-unknown-linux-uclibceabi` target.][78142]
 554 - [Added tier 3 support for the `aarch64-apple-ios-macabi` target.][77484]
 555 - [The `x86_64-unknown-freebsd` is now built with the full toolset.][79484]
 556 - [Dropped support for all cloudabi targets.][78439]
 557
 558 \* Refer to Rust's [platform support page][platform-support-doc] for more
 559 information on Rust's tiered platform support.
 560
 561 Libraries
 562 -----------------------
 563
 564 - [`proc_macro::Punct` now implements `PartialEq<char>`.][78636]
 565 - [`ops::{Index, IndexMut}` are now implemented for fixed sized arrays of any length.][74989]
 566 - [On Unix platforms, the `std::fs::File` type now has a "niche" of `-1`.][74699]
 567   This value cannot be a valid file descriptor, and now means `Option<File>` takes
 568   up the same amount of space as `File`.
 569
 570 Stabilized APIs
 571 ---------------
 572
 573 - [`bool::then`]
 574 - [`btree_map::Entry::or_insert_with_key`]
 575 - [`f32::clamp`]
 576 - [`f64::clamp`]
 577 - [`hash_map::Entry::or_insert_with_key`]
 578 - [`Ord::clamp`]
 579 - [`RefCell::take`]
 580 - [`slice::fill`]
 581 - [`UnsafeCell::get_mut`]
 582
 583 The following previously stable methods are now `const`.
 584
 585 - [`IpAddr::is_ipv4`]
 586 - [`IpAddr::is_ipv6`]
 587 - [`IpAddr::is_unspecified`]
 588 - [`IpAddr::is_loopback`]
 589 - [`IpAddr::is_multicast`]
 590 - [`Ipv4Addr::octets`]
 591 - [`Ipv4Addr::is_loopback`]
 592 - [`Ipv4Addr::is_private`]
 593 - [`Ipv4Addr::is_link_local`]
 594 - [`Ipv4Addr::is_multicast`]
 595 - [`Ipv4Addr::is_broadcast`]
 596 - [`Ipv4Addr::is_documentation`]
 597 - [`Ipv4Addr::to_ipv6_compatible`]
 598 - [`Ipv4Addr::to_ipv6_mapped`]
 599 - [`Ipv6Addr::segments`]
 600 - [`Ipv6Addr::is_unspecified`]
 601 - [`Ipv6Addr::is_loopback`]
 602 - [`Ipv6Addr::is_multicast`]
 603 - [`Ipv6Addr::to_ipv4`]
 604 - [`Layout::size`]
 605 - [`Layout::align`]
 606 - [`Layout::from_size_align`]
 607 - `pow` for all integer types.
 608 - `checked_pow` for all integer types.
 609 - `saturating_pow` for all integer types.
 610 - `wrapping_pow` for all integer types.
 611 - `next_power_of_two` for all unsigned integer types.
 612 - `checked_next_power_of_two` for all unsigned integer types.
 613
 614 Cargo
 615 -----------------------
 616
 617 - [Added the `[build.rustc-workspace-wrapper]` option.][cargo/8976]
 618   This option sets a wrapper to execute instead of `rustc`, for workspace members only.
 619 - [`cargo:rerun-if-changed` will now, if provided a directory, scan the entire
 620   contents of that directory for changes.][cargo/8973]
 621 - [Added the `--workspace` flag to the `cargo update` command.][cargo/8725]
 622
 623 Misc
 624 ----
 625
 626 - [The search results tab and the help button are focusable with keyboard in rustdoc.][79896]
 627 - [Running tests will now print the total time taken to execute.][75752]
 628
 629 Compatibility Notes
 630 -------------------
 631
 632 - [The `compare_and_swap` method on atomics has been deprecated.][79261] It's
 633   recommended to use the `compare_exchange` and `compare_exchange_weak` methods instead.
 634 - [Changes in how `TokenStream`s are checked have fixed some cases where you could write
 635   unhygenic `macro_rules!` macros.][79472]
 636 - [`#![test]` as an inner attribute is now considered unstable like other inner macro
 637   attributes, and reports an error by default through the `soft_unstable` lint.][79003]
 638 - [Overriding a `forbid` lint at the same level that it was set is now a hard error.][78864]
 639 - [You can no longer intercept `panic!` calls by supplying your own macro.][78343] It's
 640   recommended to use the `#[panic_handler]` attribute to provide your own implementation.
 641 - [Semi-colons after item statements (e.g. `struct Foo {};`) now produce a warning.][78296]
 642
 643 [74989]: https://github.com/rust-lang/rust/pull/74989
 644 [79261]: https://github.com/rust-lang/rust/pull/79261
 645 [79896]: https://github.com/rust-lang/rust/pull/79896
 646 [79484]: https://github.com/rust-lang/rust/pull/79484
 647 [79472]: https://github.com/rust-lang/rust/pull/79472
 648 [79270]: https://github.com/rust-lang/rust/pull/79270
 649 [79003]: https://github.com/rust-lang/rust/pull/79003
 650 [78864]: https://github.com/rust-lang/rust/pull/78864
 651 [78636]: https://github.com/rust-lang/rust/pull/78636
 652 [78439]: https://github.com/rust-lang/rust/pull/78439
 653 [78343]: https://github.com/rust-lang/rust/pull/78343
 654 [78296]: https://github.com/rust-lang/rust/pull/78296
 655 [78068]: https://github.com/rust-lang/rust/pull/78068
 656 [75752]: https://github.com/rust-lang/rust/pull/75752
 657 [74699]: https://github.com/rust-lang/rust/pull/74699
 658 [78142]: https://github.com/rust-lang/rust/pull/78142
 659 [77484]: https://github.com/rust-lang/rust/pull/77484
 660 [cargo/8976]: https://github.com/rust-lang/cargo/pull/8976
 661 [cargo/8973]: https://github.com/rust-lang/cargo/pull/8973
 662 [cargo/8725]: https://github.com/rust-lang/cargo/pull/8725
 663 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv4
 664 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_ipv6
 665 [`IpAddr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_unspecified
 666 [`IpAddr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_loopback
 667 [`IpAddr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/enum.IpAddr.html#method.is_multicast
 668 [`Ipv4Addr::octets`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.octets
 669 [`Ipv4Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_loopback
 670 [`Ipv4Addr::is_private`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_private
 671 [`Ipv4Addr::is_link_local`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_link_local
 672 [`Ipv4Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_multicast
 673 [`Ipv4Addr::is_broadcast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_broadcast
 674 [`Ipv4Addr::is_documentation`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.is_documentation
 675 [`Ipv4Addr::to_ipv6_compatible`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_compatible
 676 [`Ipv4Addr::to_ipv6_mapped`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv4Addr.html#method.to_ipv6_mapped
 677 [`Ipv6Addr::segments`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.segments
 678 [`Ipv6Addr::is_unspecified`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_unspecified
 679 [`Ipv6Addr::is_loopback`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_loopback
 680 [`Ipv6Addr::is_multicast`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.is_multicast
 681 [`Ipv6Addr::to_ipv4`]: https://doc.rust-lang.org/stable/std/net/struct.Ipv6Addr.html#method.to_ipv4
 682 [`Layout::align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.align
 683 [`Layout::from_size_align`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.from_size_align
 684 [`Layout::size`]: https://doc.rust-lang.org/stable/std/alloc/struct.Layout.html#method.size
 685 [`Ord::clamp`]: https://doc.rust-lang.org/stable/std/cmp/trait.Ord.html#method.clamp
 686 [`RefCell::take`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.take
 687 [`UnsafeCell::get_mut`]: https://doc.rust-lang.org/stable/std/cell/struct.UnsafeCell.html#method.get_mut
 688 [`bool::then`]: https://doc.rust-lang.org/stable/std/primitive.bool.html#method.then
 689 [`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
 690 [`f32::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.clamp
 691 [`f64::clamp`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.clamp
 692 [`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
 693 [`slice::fill`]: https://doc.rust-lang.org/stable/std/primitive.slice.html#method.fill
 694
 695
 696 Version 1.49.0 (2020-12-31)
 697 ============================
 698
 699 Language
 700 -----------------------
 701
 702 - [Unions can now implement `Drop`, and you can now have a field in a union
 703   with `ManuallyDrop<T>`.][77547]
 704 - [You can now cast uninhabited enums to integers.][76199]
 705 - [You can now bind by reference and by move in patterns.][76119] This
 706   allows you to selectively borrow individual components of a type. E.g.
 707   ```rust
 708   #[derive(Debug)]
 709   struct Person {
 710       name: String,
 711       age: u8,
 712   }
 713
 714   let person = Person {
 715       name: String::from("Alice"),
 716       age: 20,
 717   };
 718
 719   // `name` is moved out of person, but `age` is referenced.
 720   let Person { name, ref age } = person;
 721   println!("{} {}", name, age);
 722   ```
 723
 724 Compiler
 725 -----------------------
 726
 727 - [Added tier 1\* support for `aarch64-unknown-linux-gnu`.][78228]
 728 - [Added tier 2 support for `aarch64-apple-darwin`.][75991]
 729 - [Added tier 2 support for `aarch64-pc-windows-msvc`.][75914]
 730 - [Added tier 3 support for `mipsel-unknown-none`.][78676]
 731 - [Raised the minimum supported LLVM version to LLVM 9.][78848]
 732 - [Output from threads spawned in tests is now captured.][78227]
 733 - [Change os and vendor values to "none" and "unknown" for some targets][78951]
 734
 735 \* Refer to Rust's [platform support page][platform-support-doc] for more
 736 information on Rust's tiered platform support.
 737
 738 Libraries
 739 -----------------------
 740
 741 - [`RangeInclusive` now checks for exhaustion when calling `contains` and indexing.][78109]
 742 - [`ToString::to_string` now no longer shrinks the internal buffer in the default implementation.][77997]
 743
 744 Stabilized APIs
 745 ---------------
 746
 747 - [`slice::select_nth_unstable`]
 748 - [`slice::select_nth_unstable_by`]
 749 - [`slice::select_nth_unstable_by_key`]
 750
 751 The following previously stable methods are now `const`.
 752
 753 - [`Poll::is_ready`]
 754 - [`Poll::is_pending`]
 755
 756 Cargo
 757 -----------------------
 758 - [Building a crate with `cargo-package` should now be independently reproducible.][cargo/8864]
 759 - [`cargo-tree` now marks proc-macro crates.][cargo/8765]
 760 - [Added `CARGO_PRIMARY_PACKAGE` build-time environment variable.][cargo/8758] This
 761   variable will be set if the crate being built is one the user selected to build, either
 762   with `-p` or through defaults.
 763 - [You can now use glob patterns when specifying packages & targets.][cargo/8752]
 764
 765
 766 Compatibility Notes
 767 -------------------
 768
 769 - [Demoted `i686-unknown-freebsd` from host tier 2 to target tier 2 support.][78746]
 770 - [Macros that end with a semi-colon are now treated as statements even if they expand to nothing.][78376]
 771 - [Rustc will now check for the validity of some built-in attributes on enum variants.][77015]
 772   Previously such invalid or unused attributes could be ignored.
 773 - Leading whitespace is stripped more uniformly in documentation comments, which may change behavior. You
 774   read [this post about the changes][rustdoc-ws-post] for more details.
 775 - [Trait bounds are no longer inferred for associated types.][79904]
 776
 777 Internal Only
 778 -------------
 779 These changes provide no direct user facing benefits, but represent significant
 780 improvements to the internals and overall performance of rustc and
 781 related tools.
 782
 783 - [rustc's internal crates are now compiled using the `initial-exec` Thread
 784   Local Storage model.][78201]
 785 - [Calculate visibilities once in resolve.][78077]
 786 - [Added `system` to the `llvm-libunwind` bootstrap config option.][77703]
 787 - [Added `--color` for configuring terminal color support to bootstrap.][79004]
 788
 789
 790 [75991]: https://github.com/rust-lang/rust/pull/75991
 791 [78951]: https://github.com/rust-lang/rust/pull/78951
 792 [78848]: https://github.com/rust-lang/rust/pull/78848
 793 [78746]: https://github.com/rust-lang/rust/pull/78746
 794 [78376]: https://github.com/rust-lang/rust/pull/78376
 795 [78228]: https://github.com/rust-lang/rust/pull/78228
 796 [78227]: https://github.com/rust-lang/rust/pull/78227
 797 [78201]: https://github.com/rust-lang/rust/pull/78201
 798 [78109]: https://github.com/rust-lang/rust/pull/78109
 799 [78077]: https://github.com/rust-lang/rust/pull/78077
 800 [77997]: https://github.com/rust-lang/rust/pull/77997
 801 [77703]: https://github.com/rust-lang/rust/pull/77703
 802 [77547]: https://github.com/rust-lang/rust/pull/77547
 803 [77015]: https://github.com/rust-lang/rust/pull/77015
 804 [76199]: https://github.com/rust-lang/rust/pull/76199
 805 [76119]: https://github.com/rust-lang/rust/pull/76119
 806 [75914]: https://github.com/rust-lang/rust/pull/75914
 807 [79004]: https://github.com/rust-lang/rust/pull/79004
 808 [78676]: https://github.com/rust-lang/rust/pull/78676
 809 [79904]: https://github.com/rust-lang/rust/issues/79904
 810 [cargo/8864]: https://github.com/rust-lang/cargo/pull/8864
 811 [cargo/8765]: https://github.com/rust-lang/cargo/pull/8765
 812 [cargo/8758]: https://github.com/rust-lang/cargo/pull/8758
 813 [cargo/8752]: https://github.com/rust-lang/cargo/pull/8752
 814 [`slice::select_nth_unstable`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable
 815 [`slice::select_nth_unstable_by`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by
 816 [`slice::select_nth_unstable_by_key`]: https://doc.rust-lang.org/nightly/std/primitive.slice.html#method.select_nth_unstable_by_key
 817 [`hint::spin_loop`]: https://doc.rust-lang.org/stable/std/hint/fn.spin_loop.html
 818 [`Poll::is_ready`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_ready
 819 [`Poll::is_pending`]: https://doc.rust-lang.org/stable/std/task/enum.Poll.html#method.is_pending
 820 [rustdoc-ws-post]: https://blog.guillaume-gomez.fr/articles/2020-11-11+New+doc+comment+handling+in+rustdoc
 821
 822 Version 1.48.0 (2020-11-19)
 823 ==========================
 824
 825 Language
 826 --------
 827
 828 - [The `unsafe` keyword is now syntactically permitted on modules.][75857] This
 829   is still rejected *semantically*, but can now be parsed by procedural macros.
 830
 831 Compiler
 832 --------
 833 - [Stabilised the `-C link-self-contained=<yes|no>` compiler flag.][76158] This tells
 834   `rustc` whether to link its own C runtime and libraries or to rely on a external
 835   linker to find them. (Supported only on `windows-gnu`, `linux-musl`, and `wasi` platforms.)
 836 - [You can now use `-C target-feature=+crt-static` on `linux-gnu` targets.][77386]
 837   Note: If you're using cargo you must explicitly pass the `--target` flag.
 838 - [Added tier 2\* support for `aarch64-unknown-linux-musl`.][76420]
 839
 840 \* Refer to Rust's [platform support page][platform-support-doc] for more
 841 information on Rust's tiered platform support.
 842
 843 Libraries
 844 ---------
 845 - [`io::Write` is now implemented for `&ChildStdin` `&Sink`, `&Stdout`,
 846   and `&Stderr`.][76275]
 847 - [All arrays of any length now implement `TryFrom<Vec<T>>`.][76310]
 848 - [The `matches!` macro now supports having a trailing comma.][74880]
 849 - [`Vec<A>` now implements `PartialEq<[B]>` where `A: PartialEq<B>`.][74194]
 850 - [The `RefCell::{replace, replace_with, clone}` methods now all use `#[track_caller]`.][77055]
 851
 852 Stabilized APIs
 853 ---------------
 854 - [`slice::as_ptr_range`]
 855 - [`slice::as_mut_ptr_range`]
 856 - [`VecDeque::make_contiguous`]
 857 - [`future::pending`]
 858 - [`future::ready`]
 859
 860 The following previously stable methods are now `const fn`'s:
 861
 862 - [`Option::is_some`]
 863 - [`Option::is_none`]
 864 - [`Option::as_ref`]
 865 - [`Result::is_ok`]
 866 - [`Result::is_err`]
 867 - [`Result::as_ref`]
 868 - [`Ordering::reverse`]
 869 - [`Ordering::then`]
 870
 871 Cargo
 872 -----
 873
 874 Rustdoc
 875 -------
 876 - [You can now link to items in `rustdoc` using the intra-doc link
 877   syntax.][74430] E.g. ``/// Uses [`std::future`]`` will automatically generate
 878   a link to `std::future`'s documentation. See ["Linking to items by
 879   name"][intradoc-links] for more information.
 880 - [You can now specify `#[doc(alias = "<alias>")]` on items to add search aliases
 881   when searching through `rustdoc`'s UI.][75740]
 882
 883 Compatibility Notes
 884 -------------------
 885 - [Promotion of references to `'static` lifetime inside `const fn` now follows the
 886   same rules as inside a `fn` body.][75502] In particular, `&foo()` will not be
 887   promoted to `'static` lifetime any more inside `const fn`s.
 888 - [Associated type bindings on trait objects are now verified to meet the bounds
 889   declared on the trait when checking that they implement the trait.][27675]
 890 - [When trait bounds on associated types or opaque types are ambiguous, the
 891   compiler no longer makes an arbitrary choice on which bound to use.][54121]
 892 - [Fixed recursive nonterminals not being expanded in macros during
 893   pretty-print/reparse check.][77153] This may cause errors if your macro wasn't
 894   correctly handling recursive nonterminal tokens.
 895 - [`&mut` references to non zero-sized types are no longer promoted.][75585]
 896 - [`rustc` will now warn if you use attributes like `#[link_name]` or `#[cold]`
 897   in places where they have no effect.][73461]
 898 - [Updated `_mm256_extract_epi8` and `_mm256_extract_epi16` signatures in
 899   `arch::{x86, x86_64}` to return `i32` to match the vendor signatures.][73166]
 900 - [`mem::uninitialized` will now panic if any inner types inside a struct or enum
 901   disallow zero-initialization.][71274]
 902 - [`#[target_feature]` will now error if used in a place where it has no effect.][78143]
 903 - [Foreign exceptions are now caught by `catch_unwind` and will cause an abort.][70212]
 904   Note: This behaviour is not guaranteed and is still considered undefined behaviour,
 905   see the [`catch_unwind`] documentation for further information.
 906
 907
 908
 909 Internal Only
 910 -------------
 911 These changes provide no direct user facing benefits, but represent significant
 912 improvements to the internals and overall performance of rustc and
 913 related tools.
 914
 915 - [Building `rustc` from source now uses `ninja` by default over `make`.][74922]
 916   You can continue building with `make` by setting `ninja=false` in
 917   your `config.toml`.
 918 - [cg_llvm: `fewer_names` in `uncached_llvm_type`][76030]
 919 - [Made `ensure_sufficient_stack()` non-generic][76680]
 920
 921 [78143]: https://github.com/rust-lang/rust/issues/78143
 922 [76680]: https://github.com/rust-lang/rust/pull/76680/
 923 [76030]: https://github.com/rust-lang/rust/pull/76030/
 924 [70212]: https://github.com/rust-lang/rust/pull/70212/
 925 [27675]: https://github.com/rust-lang/rust/issues/27675/
 926 [54121]: https://github.com/rust-lang/rust/issues/54121/
 927 [71274]: https://github.com/rust-lang/rust/pull/71274/
 928 [77386]: https://github.com/rust-lang/rust/pull/77386/
 929 [77153]: https://github.com/rust-lang/rust/pull/77153/
 930 [77055]: https://github.com/rust-lang/rust/pull/77055/
 931 [76275]: https://github.com/rust-lang/rust/pull/76275/
 932 [76310]: https://github.com/rust-lang/rust/pull/76310/
 933 [76420]: https://github.com/rust-lang/rust/pull/76420/
 934 [76158]: https://github.com/rust-lang/rust/pull/76158/
 935 [75857]: https://github.com/rust-lang/rust/pull/75857/
 936 [75585]: https://github.com/rust-lang/rust/pull/75585/
 937 [75740]: https://github.com/rust-lang/rust/pull/75740/
 938 [75502]: https://github.com/rust-lang/rust/pull/75502/
 939 [74880]: https://github.com/rust-lang/rust/pull/74880/
 940 [74922]: https://github.com/rust-lang/rust/pull/74922/
 941 [74430]: https://github.com/rust-lang/rust/pull/74430/
 942 [74194]: https://github.com/rust-lang/rust/pull/74194/
 943 [73461]: https://github.com/rust-lang/rust/pull/73461/
 944 [73166]: https://github.com/rust-lang/rust/pull/73166/
 945 [intradoc-links]: https://doc.rust-lang.org/rustdoc/linking-to-items-by-name.html
 946 [`catch_unwind`]: https://doc.rust-lang.org/std/panic/fn.catch_unwind.html
 947 [`Option::is_some`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_some
 948 [`Option::is_none`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.is_none
 949 [`Option::as_ref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_ref
 950 [`Result::is_ok`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_ok
 951 [`Result::is_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.is_err
 952 [`Result::as_ref`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.as_ref
 953 [`Ordering::reverse`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.reverse
 954 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
 955 [`slice::as_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr_range
 956 [`slice::as_mut_ptr_range`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_mut_ptr_range
 957 [`VecDeque::make_contiguous`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.make_contiguous
 958 [`future::pending`]: https://doc.rust-lang.org/std/future/fn.pending.html
 959 [`future::ready`]: https://doc.rust-lang.org/std/future/fn.ready.html
 960
 961
 962 Version 1.47.0 (2020-10-08)
 963 ==========================
 964
 965 Language
 966 --------
 967 - [Closures will now warn when not used.][74869]
 968
 969 Compiler
 970 --------
 971 - [Stabilized the `-C control-flow-guard` codegen option][73893], which enables
 972   [Control Flow Guard][1.47.0-cfg] for Windows platforms, and is ignored on other
 973   platforms.
 974 - [Upgraded to LLVM 11.][73526]
 975 - [Added tier 3\* support for the `thumbv4t-none-eabi` target.][74419]
 976 - [Upgrade the FreeBSD toolchain to version 11.4][75204]
 977 - [`RUST_BACKTRACE`'s output is now more compact.][75048]
 978
 979 \* Refer to Rust's [platform support page][platform-support-doc] for more
 980 information on Rust's tiered platform support.
 981
 982 Libraries
 983 ---------
 984 - [`CStr` now implements `Index<RangeFrom<usize>>`.][74021]
 985 - [Traits in `std`/`core` are now implemented for arrays of any length, not just
 986   those of length less than 33.][74060]
 987 - [`ops::RangeFull` and `ops::Range` now implement Default.][73197]
 988 - [`panic::Location` now implements `Copy`, `Clone`, `Eq`, `Hash`, `Ord`,
 989   `PartialEq`, and `PartialOrd`.][73583]
 990
 991 Stabilized APIs
 992 ---------------
 993 - [`Ident::new_raw`]
 994 - [`Range::is_empty`]
 995 - [`RangeInclusive::is_empty`]
 996 - [`Result::as_deref`]
 997 - [`Result::as_deref_mut`]
 998 - [`Vec::leak`]
 999 - [`pointer::offset_from`]
1000 - [`f32::TAU`]
1001 - [`f64::TAU`]
1002
1003 The following previously stable APIs have now been made const.
1004
1005 - [The `new` method for all `NonZero` integers.][73858]
1006 - [The `checked_add`,`checked_sub`,`checked_mul`,`checked_neg`, `checked_shl`,
1007   `checked_shr`, `saturating_add`, `saturating_sub`, and `saturating_mul`
1008   methods for all integers.][73858]
1009 - [The `checked_abs`, `saturating_abs`, `saturating_neg`, and `signum`  for all
1010   signed integers.][73858]
1011 - [The `is_ascii_alphabetic`, `is_ascii_uppercase`, `is_ascii_lowercase`,
1012   `is_ascii_alphanumeric`, `is_ascii_digit`, `is_ascii_hexdigit`,
1013   `is_ascii_punctuation`, `is_ascii_graphic`, `is_ascii_whitespace`, and
1014   `is_ascii_control` methods for `char` and `u8`.][73858]
1015
1016 Cargo
1017 -----
1018 - [`build-dependencies` are now built with opt-level 0 by default.][cargo/8500]
1019   You can override this by setting the following in your `Cargo.toml`.
1020   ```toml
1021   [profile.release.build-override]
1022   opt-level = 3
1023   ```
1024 - [`cargo-help` will now display man pages for commands rather just the
1025   `--help` text.][cargo/8456]
1026 - [`cargo-metadata` now emits a `test` field indicating if a target has
1027   tests enabled.][cargo/8478]
1028 - [`workspace.default-members` now respects `workspace.exclude`.][cargo/8485]
1029 - [`cargo-publish` will now use an alternative registry by default if it's the
1030   only registry specified in `package.publish`.][cargo/8571]
1031
1032 Misc
1033 ----
1034 - [Added a help button beside Rustdoc's searchbar that explains rustdoc's
1035   type based search.][75366]
1036 - [Added the Ayu theme to rustdoc.][71237]
1037
1038 Compatibility Notes
1039 -------------------
1040 - [Bumped the minimum supported Emscripten version to 1.39.20.][75716]
1041 - [Fixed a regression parsing `{} && false` in tail expressions.][74650]
1042 - [Added changes to how proc-macros are expanded in `macro_rules!` that should
1043   help to preserve more span information.][73084] These changes may cause
1044   compiliation errors if your macro was unhygenic or didn't correctly handle
1045   `Delimiter::None`.
1046 - [Moved support for the CloudABI target to tier 3.][75568]
1047 - [`linux-gnu` targets now require minimum kernel 2.6.32 and glibc 2.11.][74163]
1048 - [Added the `rustc-docs` component.][75560] This allows you to install
1049   and read the documentation for the compiler internal APIs. (Currently only
1050   available for `x86_64-unknown-linux-gnu`.)
1051
1052 Internal Only
1053 --------
1054
1055 - [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.
1056
1057 [1.47.0-cfg]: https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard
1058 [75048]: https://github.com/rust-lang/rust/pull/75048/
1059 [74163]: https://github.com/rust-lang/rust/pull/74163/
1060 [71237]: https://github.com/rust-lang/rust/pull/71237/
1061 [74869]: https://github.com/rust-lang/rust/pull/74869/
1062 [73858]: https://github.com/rust-lang/rust/pull/73858/
1063 [75716]: https://github.com/rust-lang/rust/pull/75716/
1064 [75908]: https://github.com/rust-lang/rust/pull/75908/
1065 [75516]: https://github.com/rust-lang/rust/pull/75516/
1066 [75560]: https://github.com/rust-lang/rust/pull/75560/
1067 [75568]: https://github.com/rust-lang/rust/pull/75568/
1068 [75366]: https://github.com/rust-lang/rust/pull/75366/
1069 [75204]: https://github.com/rust-lang/rust/pull/75204/
1070 [74650]: https://github.com/rust-lang/rust/pull/74650/
1071 [74419]: https://github.com/rust-lang/rust/pull/74419/
1072 [73964]: https://github.com/rust-lang/rust/pull/73964/
1073 [74021]: https://github.com/rust-lang/rust/pull/74021/
1074 [74060]: https://github.com/rust-lang/rust/pull/74060/
1075 [73893]: https://github.com/rust-lang/rust/pull/73893/
1076 [73526]: https://github.com/rust-lang/rust/pull/73526/
1077 [73583]: https://github.com/rust-lang/rust/pull/73583/
1078 [73084]: https://github.com/rust-lang/rust/pull/73084/
1079 [73197]: https://github.com/rust-lang/rust/pull/73197/
1080 [72488]: https://github.com/rust-lang/rust/pull/72488/
1081 [cargo/8456]: https://github.com/rust-lang/cargo/pull/8456/
1082 [cargo/8478]: https://github.com/rust-lang/cargo/pull/8478/
1083 [cargo/8485]: https://github.com/rust-lang/cargo/pull/8485/
1084 [cargo/8500]: https://github.com/rust-lang/cargo/pull/8500/
1085 [cargo/8571]: https://github.com/rust-lang/cargo/pull/8571/
1086 [`Ident::new_raw`]:  https://doc.rust-lang.org/nightly/proc_macro/struct.Ident.html#method.new_raw
1087 [`Range::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.Range.html#method.is_empty
1088 [`RangeInclusive::is_empty`]: https://doc.rust-lang.org/nightly/std/ops/struct.RangeInclusive.html#method.is_empty
1089 [`Result::as_deref_mut`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref_mut
1090 [`Result::as_deref`]: https://doc.rust-lang.org/nightly/std/result/enum.Result.html#method.as_deref
1091 [`TypeId::of`]: https://doc.rust-lang.org/nightly/std/any/struct.TypeId.html#method.of
1092 [`Vec::leak`]: https://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.leak
1093 [`f32::TAU`]: https://doc.rust-lang.org/nightly/std/f32/consts/constant.TAU.html
1094 [`f64::TAU`]: https://doc.rust-lang.org/nightly/std/f64/consts/constant.TAU.html
1095 [`pointer::offset_from`]: https://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.offset_from
1096
1097
1098 Version 1.46.0 (2020-08-27)
1099 ==========================
1100
1101 Language
1102 --------
1103 - [`if`, `match`, and `loop` expressions can now be used in const functions.][72437]
1104 - [Additionally you are now also able to coerce and cast to slices (`&[T]`) in
1105   const functions.][73862]
1106 - [The `#[track_caller]` attribute can now be added to functions to use the
1107   function's caller's location information for panic messages.][72445]
1108 - [Recursively indexing into tuples no longer needs parentheses.][71322] E.g.
1109   `x.0.0` over `(x.0).0`.
1110 - [`mem::transmute` can now be used in statics and constants.][72920] **Note**
1111   You currently can't use `mem::transmute` in constant functions.
1112
1113 Compiler
1114 --------
1115 - [You can now use the `cdylib` target on Apple iOS and tvOS platforms.][73516]
1116 - [Enabled static "Position Independent Executables" by default
1117   for `x86_64-unknown-linux-musl`.][70740]
1118
1119 Libraries
1120 ---------
1121 - [`mem::forget` is now a `const fn`.][73887]
1122 - [`String` now implements `From<char>`.][73466]
1123 - [The `leading_ones`, and `trailing_ones` methods have been stabilised for all
1124   integer types.][73032]
1125 - [`vec::IntoIter<T>` now implements `AsRef<[T]>`.][72583]
1126 - [All non-zero integer types (`NonZeroU8`) now implement `TryFrom` for their
1127   zero-able equivalent (e.g. `TryFrom<u8>`).][72717]
1128 - [`&[T]` and `&mut [T]` now implement `PartialEq<Vec<T>>`.][71660]
1129 - [`(String, u16)` now implements `ToSocketAddrs`.][73007]
1130 - [`vec::Drain<'_, T>` now implements `AsRef<[T]>`.][72584]
1131
1132 Stabilized APIs
1133 ---------------
1134 - [`Option::zip`]
1135 - [`vec::Drain::as_slice`]
1136
1137 Cargo
1138 -----
1139 Added a number of new environment variables that are now available when
1140 compiling your crate.
1141
1142 - [`CARGO_BIN_NAME` and `CARGO_CRATE_NAME`][cargo/8270] Providing the name of
1143   the specific binary being compiled and the name of the crate.
1144 - [`CARGO_PKG_LICENSE`][cargo/8325] The license from the manifest of the package.
1145 - [`CARGO_PKG_LICENSE_FILE`][cargo/8387] The path to the license file.
1146
1147 Compatibility Notes
1148 -------------------
1149 - [The target configuration option `abi_blacklist` has been renamed
1150   to `unsupported_abis`.][74150] The old name will still continue to work.
1151 - [Rustc will now warn if you cast a C-like enum that implements `Drop`.][72331]
1152   This was previously accepted but will become a hard error in a future release.
1153 - [Rustc will fail to compile if you have a struct with
1154   `#[repr(i128)]` or `#[repr(u128)]`.][74109] This representation is currently only
1155   allowed on `enum`s.
1156 - [Tokens passed to `macro_rules!` are now always captured.][73293] This helps
1157   ensure that spans have the correct information, and may cause breakage if you
1158   were relying on receiving spans with dummy information.
1159 - [The InnoSetup installer for Windows is no longer available.][72569] This was
1160   a legacy installer that was replaced by a MSI installer a few years ago but
1161   was still being built.
1162 - [`{f32, f64}::asinh` now returns the correct values for negative numbers.][72486]
1163 - [Rustc will no longer accept overlapping trait implementations that only
1164   differ in how the lifetime was bound.][72493]
1165 - [Rustc now correctly relates the lifetime of an existential associated
1166   type.][71896] This fixes some edge cases where `rustc` would erroneously allow
1167   you to pass a shorter lifetime than expected.
1168 - [Rustc now dynamically links to `libz` (also called `zlib`) on Linux.][74420]
1169   The library will need to be installed for `rustc` to work, even though we
1170   expect it to be already available on most systems.
1171 - [Tests annotated with `#[should_panic]` are broken on ARMv7 while running
1172   under QEMU.][74820]
1173 - [Pretty printing of some tokens in procedural macros changed.][75453] The
1174   exact output returned by rustc's pretty printing is an unstable
1175   implementation detail: we recommend any macro relying on it to switch to a
1176   more robust parsing system.
1177
1178 [75453]: https://github.com/rust-lang/rust/issues/75453/
1179 [74820]: https://github.com/rust-lang/rust/issues/74820/
1180 [74420]: https://github.com/rust-lang/rust/issues/74420/
1181 [74109]: https://github.com/rust-lang/rust/pull/74109/
1182 [74150]: https://github.com/rust-lang/rust/pull/74150/
1183 [73862]: https://github.com/rust-lang/rust/pull/73862/
1184 [73887]: https://github.com/rust-lang/rust/pull/73887/
1185 [73466]: https://github.com/rust-lang/rust/pull/73466/
1186 [73516]: https://github.com/rust-lang/rust/pull/73516/
1187 [73293]: https://github.com/rust-lang/rust/pull/73293/
1188 [73007]: https://github.com/rust-lang/rust/pull/73007/
1189 [73032]: https://github.com/rust-lang/rust/pull/73032/
1190 [72920]: https://github.com/rust-lang/rust/pull/72920/
1191 [72569]: https://github.com/rust-lang/rust/pull/72569/
1192 [72583]: https://github.com/rust-lang/rust/pull/72583/
1193 [72584]: https://github.com/rust-lang/rust/pull/72584/
1194 [72717]: https://github.com/rust-lang/rust/pull/72717/
1195 [72437]: https://github.com/rust-lang/rust/pull/72437/
1196 [72445]: https://github.com/rust-lang/rust/pull/72445/
1197 [72486]: https://github.com/rust-lang/rust/pull/72486/
1198 [72493]: https://github.com/rust-lang/rust/pull/72493/
1199 [72331]: https://github.com/rust-lang/rust/pull/72331/
1200 [71896]: https://github.com/rust-lang/rust/pull/71896/
1201 [71660]: https://github.com/rust-lang/rust/pull/71660/
1202 [71322]: https://github.com/rust-lang/rust/pull/71322/
1203 [70740]: https://github.com/rust-lang/rust/pull/70740/
1204 [cargo/8270]: https://github.com/rust-lang/cargo/pull/8270/
1205 [cargo/8325]: https://github.com/rust-lang/cargo/pull/8325/
1206 [cargo/8387]: https://github.com/rust-lang/cargo/pull/8387/
1207 [`Option::zip`]: https://doc.rust-lang.org/stable/std/option/enum.Option.html#method.zip
1208 [`vec::Drain::as_slice`]: https://doc.rust-lang.org/stable/std/vec/struct.Drain.html#method.as_slice
1209
1210
1211 Version 1.45.2 (2020-08-03)
1212 ==========================
1213
1214 * [Fix bindings in tuple struct patterns][74954]
1215 * [Fix track_caller integration with trait objects][74784]
1216
1217 [74954]: https://github.com/rust-lang/rust/issues/74954
1218 [74784]: https://github.com/rust-lang/rust/issues/74784
1219
1220
1221 Version 1.45.1 (2020-07-30)
1222 ==========================
1223
1224 * [Fix const propagation with references.][73613]
1225 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1226 * [Avoid spurious implicit region bound.][74509]
1227 * [Install clippy on x.py install][74457]
1228
1229 [73613]: https://github.com/rust-lang/rust/pull/73613
1230 [73078]: https://github.com/rust-lang/rust/issues/73078
1231 [74509]: https://github.com/rust-lang/rust/pull/74509
1232 [74457]: https://github.com/rust-lang/rust/pull/74457
1233
1234
1235 Version 1.45.0 (2020-07-16)
1236 ==========================
1237
1238 Language
1239 --------
1240 - [Out of range float to int conversions using `as` has been defined as a saturating
1241   conversion.][71269] This was previously undefined behaviour, but you can use the
1242    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
1243    may be desirable in rare performance sensitive situations.
1244 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
1245   using `u64`.][70705]
1246 - [Function like procedural macros can now be used in expression, pattern, and  statement
1247   positions.][68717] This means you can now use a function-like procedural macro
1248   anywhere you can use a declarative (`macro_rules!`) macro.
1249
1250 Compiler
1251 --------
1252 - [You can now override individual target features through the `target-feature`
1253   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
1254   equivalent to `-C target-feature=+avx2,+fma`.
1255 - [Added the `force-unwind-tables` flag.][69984] This option allows
1256   rustc to always generate unwind tables regardless of panic strategy.
1257 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
1258   to include LLVM bitcode into generated `rlib`s (this is on by default).
1259 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
1260 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
1261 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
1262 - [Upgraded to LLVM 10.][67759]
1263
1264 \* Refer to Rust's [platform support page][platform-support-doc] for more
1265 information on Rust's tiered platform support.
1266
1267
1268 Libraries
1269 ---------
1270 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
1271   and `Ord`.][72239]
1272 - [`proc_macro::TokenStream` now implements `Default`.][72234]
1273 - [You can now use `char` with
1274   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
1275   a range of codepoints.][72413] E.g.
1276   you can now write the following;
1277   ```rust
1278   for ch in 'a'..='z' {
1279       print!("{}", ch);
1280   }
1281   println!();
1282   // Prints "abcdefghijklmnopqrstuvwxyz"
1283   ```
1284 - [`OsString` now implements `FromStr`.][71662]
1285 - [The `saturating_neg` method has been added to all signed integer primitive
1286   types, and the `saturating_abs` method has been added for all integer
1287   primitive types.][71886]
1288 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
1289   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
1290   or `Path`.][71447]
1291 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
1292 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
1293   integer types.][69813]
1294 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
1295   integer types.][72324]
1296 - [The `fetch_update` method has been added to all atomic integer types.][71843]
1297
1298 Stabilized APIs
1299 ---------------
1300 - [`Arc::as_ptr`]
1301 - [`BTreeMap::remove_entry`]
1302 - [`Rc::as_ptr`]
1303 - [`rc::Weak::as_ptr`]
1304 - [`rc::Weak::from_raw`]
1305 - [`rc::Weak::into_raw`]
1306 - [`str::strip_prefix`]
1307 - [`str::strip_suffix`]
1308 - [`sync::Weak::as_ptr`]
1309 - [`sync::Weak::from_raw`]
1310 - [`sync::Weak::into_raw`]
1311 - [`char::UNICODE_VERSION`]
1312 - [`Span::resolved_at`]
1313 - [`Span::located_at`]
1314 - [`Span::mixed_site`]
1315 - [`unix::process::CommandExt::arg0`]
1316
1317 Cargo
1318 -----
1319
1320 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
1321   time.][cargo/8066]
1322
1323 Misc
1324 ----
1325 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
1326   `~~outdated information~~` becomes "~~outdated information~~".
1327 - [Added an emoji to Rustdoc's deprecated API message.][72014]
1328
1329 Compatibility Notes
1330 -------------------
1331 - [Trying to self initialize a static value (that is creating a value using
1332   itself) is unsound and now causes a compile error.][71140]
1333 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
1334   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
1335 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
1336   previously undocumented and not intended for public use. Rustdoc still provides
1337   a non-zero exit code on errors.
1338 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
1339   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
1340   flags while cargo is adding `embed-bitcode` itself. The recommended way to
1341   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
1342   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
1343
1344 Internals Only
1345 --------------
1346 - [Make clippy a git subtree instead of a git submodule][70655]
1347 - [Unify the undo log of all snapshot types][69464]
1348
1349 [71848]: https://github.com/rust-lang/rust/issues/71848/
1350 [73420]: https://github.com/rust-lang/rust/issues/73420/
1351 [72324]: https://github.com/rust-lang/rust/pull/72324/
1352 [71843]: https://github.com/rust-lang/rust/pull/71843/
1353 [71886]: https://github.com/rust-lang/rust/pull/71886/
1354 [72234]: https://github.com/rust-lang/rust/pull/72234/
1355 [72239]: https://github.com/rust-lang/rust/pull/72239/
1356 [72397]: https://github.com/rust-lang/rust/pull/72397/
1357 [72413]: https://github.com/rust-lang/rust/pull/72413/
1358 [72014]: https://github.com/rust-lang/rust/pull/72014/
1359 [72062]: https://github.com/rust-lang/rust/pull/72062/
1360 [72094]: https://github.com/rust-lang/rust/pull/72094/
1361 [72133]: https://github.com/rust-lang/rust/pull/72133/
1362 [67759]: https://github.com/rust-lang/rust/pull/67759/
1363 [71900]: https://github.com/rust-lang/rust/pull/71900/
1364 [71928]: https://github.com/rust-lang/rust/pull/71928/
1365 [71662]: https://github.com/rust-lang/rust/pull/71662/
1366 [71716]: https://github.com/rust-lang/rust/pull/71716/
1367 [71447]: https://github.com/rust-lang/rust/pull/71447/
1368 [71269]: https://github.com/rust-lang/rust/pull/71269/
1369 [71095]: https://github.com/rust-lang/rust/pull/71095/
1370 [71140]: https://github.com/rust-lang/rust/pull/71140/
1371 [70655]: https://github.com/rust-lang/rust/pull/70655/
1372 [70705]: https://github.com/rust-lang/rust/pull/70705/
1373 [69984]: https://github.com/rust-lang/rust/pull/69984/
1374 [69813]: https://github.com/rust-lang/rust/pull/69813/
1375 [69464]: https://github.com/rust-lang/rust/pull/69464/
1376 [68717]: https://github.com/rust-lang/rust/pull/68717/
1377 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
1378 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
1379 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
1380 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
1381 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
1382 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
1383 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
1384 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
1385 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
1386 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
1387 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
1388 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
1389 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
1390 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
1391 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
1392 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
1393 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
1394
1395
1396 Version 1.44.1 (2020-06-18)
1397 ===========================
1398
1399 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
1400 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
1401 * [Fix crashes when finding backtrace on macOS.][71397]
1402 * [Clippy applies lint levels into different files.][clippy/5356]
1403
1404 [71397]: https://github.com/rust-lang/rust/issues/71397
1405 [73078]: https://github.com/rust-lang/rust/issues/73078
1406 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
1407 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
1408
1409
1410 Version 1.44.0 (2020-06-04)
1411 ==========================
1412
1413 Language
1414 --------
1415 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
1416 - [Added the `unused_braces` lint.][70081]
1417
1418 **Syntax-only changes**
1419
1420 - [Expansion-driven outline module parsing][69838]
1421 ```rust
1422 #[cfg(FALSE)]
1423 mod foo {
1424     mod bar {
1425         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
1426     }
1427 }
1428 ```
1429
1430 These are still rejected semantically, so you will likely receive an error but
1431 these changes can be seen and parsed by macros and conditional compilation.
1432
1433 Compiler
1434 --------
1435 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
1436   Additionally when in incremental mode rustc defaults to 256 codegen units.
1437 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
1438   a panic is thrown.][67502]
1439 - [Added tier 3\* support for the `aarch64-unknown-none` and
1440   `aarch64-unknown-none-softfloat` targets.][68334]
1441 - [Added tier 3 support for `arm64-apple-tvos` and
1442   `x86_64-apple-tvos` targets.][68191]
1443
1444
1445 Libraries
1446 ---------
1447 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
1448   `vec![]` to be able to be used in `const` contexts.
1449 - [`convert::Infallible` now implements `Hash`.][70281]
1450 - [`OsString` now implements `DerefMut` and `IndexMut` returning
1451   a `&mut OsStr`.][70048]
1452 - [Unicode 13 is now supported.][69929]
1453 - [`String` now implements `From<&mut str>`.][69661]
1454 - [`IoSlice` now implements `Copy`.][69403]
1455 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
1456 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
1457 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
1458   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
1459   integer types.][69373]
1460
1461 Stabilized APIs
1462 ---------------
1463 - [`PathBuf::with_capacity`]
1464 - [`PathBuf::capacity`]
1465 - [`PathBuf::clear`]
1466 - [`PathBuf::reserve`]
1467 - [`PathBuf::reserve_exact`]
1468 - [`PathBuf::shrink_to_fit`]
1469 - [`f32::to_int_unchecked`]
1470 - [`f64::to_int_unchecked`]
1471 - [`Layout::align_to`]
1472 - [`Layout::pad_to_align`]
1473 - [`Layout::array`]
1474 - [`Layout::extend`]
1475
1476 Cargo
1477 -----
1478 - [Added the `cargo tree` command which will print a tree graph of
1479   your dependencies.][cargo/8062] E.g.
1480   ```
1481     mdbook v0.3.2 (/Users/src/rust/mdbook)
1482   ├── ammonia v3.0.0
1483   │   ├── html5ever v0.24.0
1484   │   │   ├── log v0.4.8
1485   │   │   │   └── cfg-if v0.1.9
1486   │   │   ├── mac v0.1.1
1487   │   │   └── markup5ever v0.9.0
1488   │   │       ├── log v0.4.8 (*)
1489   │   │       ├── phf v0.7.24
1490   │   │       │   └── phf_shared v0.7.24
1491   │   │       │       ├── siphasher v0.2.3
1492   │   │       │       └── unicase v1.4.2
1493   │   │       │           [build-dependencies]
1494   │   │       │           └── version_check v0.1.5
1495   ...
1496   ```
1497   You can also display dependencies on multiple versions of the same crate with
1498   `cargo tree -d` (short for `cargo tree --duplicates`).
1499
1500 Misc
1501 ----
1502 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
1503   the version in the sidebar.][69494]
1504
1505 Compatibility Notes
1506 -------------------
1507 - [Rustc now correctly generates static libraries on Windows GNU targets with
1508   the `.a` extension, rather than the previous `.lib`.][70937]
1509 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
1510 - [The `file_name` property in JSON output of macro errors now points the actual
1511   source file rather than the previous format of `<NAME macros>`.][70969]
1512   **Note:** this may not point to a file that actually exists on the user's system.
1513 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
1514 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
1515   not allow zero initialization such as `NonZeroU8`.][66059] This was
1516   previously a warning.
1517 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
1518   operator has been defined as a saturating operation.][71269] This was previously
1519   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
1520   continue using the current behaviour, which may be desirable in rare performance
1521   sensitive situations.
1522
1523 Internal Only
1524 -------------
1525 These changes provide no direct user facing benefits, but represent significant
1526 improvements to the internals and overall performance of rustc and
1527 related tools.
1528
1529 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
1530 - [Replace big JS dict with JSON parsing.][71250]
1531
1532 [69373]: https://github.com/rust-lang/rust/pull/69373/
1533 [66059]: https://github.com/rust-lang/rust/pull/66059/
1534 [68191]: https://github.com/rust-lang/rust/pull/68191/
1535 [68899]: https://github.com/rust-lang/rust/pull/68899/
1536 [71147]: https://github.com/rust-lang/rust/pull/71147/
1537 [71250]: https://github.com/rust-lang/rust/pull/71250/
1538 [70937]: https://github.com/rust-lang/rust/pull/70937/
1539 [70969]: https://github.com/rust-lang/rust/pull/70969/
1540 [70632]: https://github.com/rust-lang/rust/pull/70632/
1541 [70281]: https://github.com/rust-lang/rust/pull/70281/
1542 [70345]: https://github.com/rust-lang/rust/pull/70345/
1543 [70048]: https://github.com/rust-lang/rust/pull/70048/
1544 [70081]: https://github.com/rust-lang/rust/pull/70081/
1545 [70156]: https://github.com/rust-lang/rust/pull/70156/
1546 [71269]: https://github.com/rust-lang/rust/pull/71269/
1547 [69838]: https://github.com/rust-lang/rust/pull/69838/
1548 [69929]: https://github.com/rust-lang/rust/pull/69929/
1549 [69661]: https://github.com/rust-lang/rust/pull/69661/
1550 [69778]: https://github.com/rust-lang/rust/pull/69778/
1551 [69494]: https://github.com/rust-lang/rust/pull/69494/
1552 [69403]: https://github.com/rust-lang/rust/pull/69403/
1553 [69033]: https://github.com/rust-lang/rust/pull/69033/
1554 [68692]: https://github.com/rust-lang/rust/pull/68692/
1555 [68334]: https://github.com/rust-lang/rust/pull/68334/
1556 [67502]: https://github.com/rust-lang/rust/pull/67502/
1557 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
1558 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
1559 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
1560 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
1561 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
1562 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
1563 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
1564 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
1565 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
1566 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
1567 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
1568 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
1569 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
1570
1571
1572 Version 1.43.1 (2020-05-07)
1573 ===========================
1574
1575 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
1576 * [Fixed the stabilization of AVX-512 features.][71473]
1577 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
1578
1579 [71430]: https://github.com/rust-lang/rust/pull/71430
1580 [71473]: https://github.com/rust-lang/rust/issues/71473
1581 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
1582
1583
1584 Version 1.43.0 (2020-04-23)
1585 ==========================
1586
1587 Language
1588 --------
1589 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
1590   the type inferred correctly.][68129]
1591 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
1592
1593 **Syntax only changes**
1594 - [Allow `type Foo: Ord` syntactically.][69361]
1595 - [Fuse associated and extern items up to defaultness.][69194]
1596 - [Syntactically allow `self` in all `fn` contexts.][68764]
1597 - [Merge `fn` syntax + cleanup item parsing.][68728]
1598 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
1599   For example, you may now write:
1600   ```rust
1601   macro_rules! mac_trait {
1602       ($i:item) => {
1603           trait T { $i }
1604       }
1605   }
1606   mac_trait! {
1607       fn foo() {}
1608   }
1609   ```
1610
1611 These are still rejected *semantically*, so you will likely receive an error but
1612 these changes can be seen and parsed by macros and
1613 conditional compilation.
1614
1615
1616 Compiler
1617 --------
1618 - [You can now pass multiple lint flags to rustc to override the previous
1619   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
1620   everything in the `unused` lint group except `unused-variables` which
1621   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
1622   everything in the `unused` lint group **including** `unused-variables` since
1623   the allow flag is specified before the deny flag (and therefore overridden).
1624 - [rustc will now prefer your system MinGW libraries over its bundled libraries
1625   if they are available on `windows-gnu`.][67429]
1626 - [rustc now buffers errors/warnings printed in JSON.][69227]
1627
1628 Libraries
1629 ---------
1630 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
1631   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
1632   respectively.][69538] **Note** These conversions are only available when `N`
1633   is `0..=32`.
1634 - [You can now use associated constants on floats and integers directly, rather
1635   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
1636   `f32::NAN` with no imports.
1637 - [`u8::is_ascii` is now `const`.][68984]
1638 - [`String` now implements `AsMut<str>`.][68742]
1639 - [Added the `primitive` module to `std` and `core`.][67637] This module
1640   reexports Rust's primitive types. This is mainly useful in macros
1641   where you want avoid these types being shadowed.
1642 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
1643 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
1644
1645 Stabilized APIs
1646 ---------------
1647 - [`Once::is_completed`]
1648 - [`f32::LOG10_2`]
1649 - [`f32::LOG2_10`]
1650 - [`f64::LOG10_2`]
1651 - [`f64::LOG2_10`]
1652 - [`iter::once_with`]
1653
1654 Cargo
1655 -----
1656 - [You can now set config `[profile]`s in your `.cargo/config`, or through
1657   your environment.][cargo/7823]
1658 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
1659   executable path when running integration tests or benchmarks.][cargo/7697]
1660   `<name>` is the name of your binary as-is e.g. If you wanted the executable
1661   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
1662
1663 Misc
1664 ----
1665 - [Certain checks in the `const_err` lint were deemed unrelated to const
1666   evaluation][69185], and have been moved to the `unconditional_panic` and
1667   `arithmetic_overflow` lints.
1668
1669 Compatibility Notes
1670 -------------------
1671
1672 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
1673   has been a warning since 1.36.0.
1674 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
1675   led to some instances being accepted, and now correctly emits a hard error.
1676
1677 [69340]: https://github.com/rust-lang/rust/pull/69340
1678
1679 Internal Only
1680 -------------
1681 These changes provide no direct user facing benefits, but represent significant
1682 improvements to the internals and overall performance of `rustc` and
1683 related tools.
1684
1685 - [All components are now built with `opt-level=3` instead of `2`.][67878]
1686 - [Improved how rustc generates drop code.][67332]
1687 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
1688 - [traits: preallocate 2 Vecs of known initial size][69022]
1689 - [Avoid exponential behaviour when relating types][68772]
1690 - [Skip `Drop` terminators for enum variants without drop glue][68943]
1691 - [Improve performance of coherence checks][68966]
1692 - [Deduplicate types in the generator witness][68672]
1693 - [Invert control in struct_lint_level.][68725]
1694
1695 [67332]: https://github.com/rust-lang/rust/pull/67332/
1696 [67429]: https://github.com/rust-lang/rust/pull/67429/
1697 [67637]: https://github.com/rust-lang/rust/pull/67637/
1698 [67642]: https://github.com/rust-lang/rust/pull/67642/
1699 [67878]: https://github.com/rust-lang/rust/pull/67878/
1700 [67885]: https://github.com/rust-lang/rust/pull/67885/
1701 [68129]: https://github.com/rust-lang/rust/pull/68129/
1702 [68672]: https://github.com/rust-lang/rust/pull/68672/
1703 [68725]: https://github.com/rust-lang/rust/pull/68725/
1704 [68728]: https://github.com/rust-lang/rust/pull/68728/
1705 [68738]: https://github.com/rust-lang/rust/pull/68738/
1706 [68742]: https://github.com/rust-lang/rust/pull/68742/
1707 [68764]: https://github.com/rust-lang/rust/pull/68764/
1708 [68772]: https://github.com/rust-lang/rust/pull/68772/
1709 [68943]: https://github.com/rust-lang/rust/pull/68943/
1710 [68952]: https://github.com/rust-lang/rust/pull/68952/
1711 [68966]: https://github.com/rust-lang/rust/pull/68966/
1712 [68984]: https://github.com/rust-lang/rust/pull/68984/
1713 [69022]: https://github.com/rust-lang/rust/pull/69022/
1714 [69185]: https://github.com/rust-lang/rust/pull/69185/
1715 [69194]: https://github.com/rust-lang/rust/pull/69194/
1716 [69201]: https://github.com/rust-lang/rust/pull/69201/
1717 [69227]: https://github.com/rust-lang/rust/pull/69227/
1718 [69548]: https://github.com/rust-lang/rust/pull/69548/
1719 [69256]: https://github.com/rust-lang/rust/pull/69256/
1720 [69361]: https://github.com/rust-lang/rust/pull/69361/
1721 [69366]: https://github.com/rust-lang/rust/pull/69366/
1722 [69538]: https://github.com/rust-lang/rust/pull/69538/
1723 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
1724 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
1725 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
1726 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
1727 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
1728 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
1729 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
1730 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
1731
1732
1733 Version 1.42.0 (2020-03-12)
1734 ==========================
1735
1736 Language
1737 --------
1738 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
1739   ```rust
1740   fn foo(words: &[&str]) {
1741       match words {
1742           ["Hello", "World", "!", ..] => println!("Hello World!"),
1743           ["Foo", "Bar", ..] => println!("Baz"),
1744           rest => println!("{:?}", rest),
1745       }
1746   }
1747   ```
1748 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
1749   that you can create an enum that has the exact layout and ABI of the type
1750   it contains.
1751 - [There are some *syntax-only* changes:][67131]
1752    - `default` is syntactically allowed before items in `trait` definitions.
1753    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
1754      leave out their bodies in favor of `;`.
1755    - Bounds on associated types in `impl`s are now syntactically allowed
1756      (e.g. `type Foo: Ord;`).
1757    - `...` (the C-variadic type) may occur syntactically directly as the type of
1758       any function parameter.
1759
1760   These are still rejected *semantically*, so you will likely receive an error
1761   but these changes can be seen and parsed by procedural macros and
1762   conditional compilation.
1763
1764 Compiler
1765 --------
1766 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
1767 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
1768 - [`Option::{expect,unwrap}` and
1769    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
1770    pointing to the location where they were called, rather than
1771    `core`'s internals. ][67887]
1772
1773 \* Refer to Rust's [platform support page][platform-support-doc] for more
1774 information on Rust's tiered platform support.
1775
1776 Libraries
1777 ---------
1778 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
1779 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
1780    to implement `Sized`.][67935]
1781 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
1782 - [`Layout::new` is now `const`.][66254]
1783 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
1784
1785
1786 Stabilized APIs
1787 ---------------
1788 - [`CondVar::wait_while`]
1789 - [`CondVar::wait_timeout_while`]
1790 - [`DebugMap::key`]
1791 - [`DebugMap::value`]
1792 - [`ManuallyDrop::take`]
1793 - [`matches!`]
1794 - [`ptr::slice_from_raw_parts_mut`]
1795 - [`ptr::slice_from_raw_parts`]
1796
1797 Cargo
1798 -----
1799 - [You no longer need to include `extern crate proc_macro;` to be able to
1800   `use proc_macro;` in the `2018` edition.][cargo/7700]
1801
1802 Compatibility Notes
1803 -------------------
1804 - [`Error::description` has been deprecated, and its use will now produce a
1805   warning.][66919] It's recommended to use `Display`/`to_string` instead.
1806
1807 [68253]: https://github.com/rust-lang/rust/pull/68253/
1808 [68348]: https://github.com/rust-lang/rust/pull/68348/
1809 [67935]: https://github.com/rust-lang/rust/pull/67935/
1810 [68339]: https://github.com/rust-lang/rust/pull/68339/
1811 [68122]: https://github.com/rust-lang/rust/pull/68122/
1812 [67712]: https://github.com/rust-lang/rust/pull/67712/
1813 [67887]: https://github.com/rust-lang/rust/pull/67887/
1814 [67131]: https://github.com/rust-lang/rust/pull/67131/
1815 [67233]: https://github.com/rust-lang/rust/pull/67233/
1816 [66899]: https://github.com/rust-lang/rust/pull/66899/
1817 [66919]: https://github.com/rust-lang/rust/pull/66919/
1818 [66254]: https://github.com/rust-lang/rust/pull/66254/
1819 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
1820 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
1821 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
1822 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
1823 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
1824 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
1825 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
1826 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
1827 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
1828
1829
1830 Version 1.41.1 (2020-02-27)
1831 ===========================
1832
1833 * [Always check types of static items][69145]
1834 * [Always check lifetime bounds of `Copy` impls][69145]
1835 * [Fix miscompilation in callers of `Layout::repeat`][69225]
1836
1837 [69225]: https://github.com/rust-lang/rust/issues/69225
1838 [69145]: https://github.com/rust-lang/rust/pull/69145
1839
1840
1841 Version 1.41.0 (2020-01-30)
1842 ===========================
1843
1844 Language
1845 --------
1846
1847 - [You can now pass type parameters to foreign items when implementing
1848   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
1849 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
1850   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
1851   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
1852 - [You can now use any valid identifier in a `format_args` macro.][66847]
1853   Previously identifiers starting with an underscore were not allowed.
1854 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
1855   enum variants.][66183] These are still rejected semantically, but
1856   can be seen and parsed by procedural macros and conditional compilation.
1857
1858 Compiler
1859 --------
1860
1861 - [Rustc will now warn if you have unused loop `'label`s.][66325]
1862 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
1863 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
1864 - [You can now pass an arguments file passing the `@path` syntax
1865   to rustc.][66172] Note that the format differs somewhat from what is
1866   found in other tooling; please see [the documentation][argfile-docs] for
1867   more information.
1868 - [You can now provide `--extern` flag without a path, indicating that it is
1869   available from the search path or specified with an `-L` flag.][64882]
1870
1871 \* Refer to Rust's [platform support page][platform-support-doc] for more
1872 information on Rust's tiered platform support.
1873
1874 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
1875
1876 Libraries
1877 ---------
1878
1879 - [The `core::panic` module is now stable.][66771] It was already stable
1880   through `std`.
1881 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
1882   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
1883 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
1884
1885 Stabilized APIs
1886 ---------------
1887
1888 - [`Result::map_or`]
1889 - [`Result::map_or_else`]
1890 - [`std::rc::Weak::weak_count`]
1891 - [`std::rc::Weak::strong_count`]
1892 - [`std::sync::Weak::weak_count`]
1893 - [`std::sync::Weak::strong_count`]
1894
1895 Cargo
1896 -----
1897
1898 - [Cargo will now document all the private items for binary crates
1899   by default.][cargo/7593]
1900 - [`cargo-install` will now reinstall the package if it detects that it is out
1901   of date.][cargo/7560]
1902 - [Cargo.lock now uses a more git friendly format that should help to reduce
1903   merge conflicts.][cargo/7579]
1904 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
1905   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
1906   optimisation level to `2` for debug builds. You can also use
1907   `[profile.<profile>.build-override]` to override build scripts and
1908   their dependencies.
1909
1910 Misc
1911 ----
1912
1913 - [You can now specify `edition` in documentation code blocks to compile the block
1914   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
1915   should be compiled the 2018 edition of Rust.
1916 - [You can now provide custom themes to rustdoc with `--theme`, and check the
1917   current theme with `--check-theme`.][54733]
1918 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
1919
1920 Compatibility Notes
1921 -------------------
1922
1923 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
1924   Apple targets.][apple-32bit-drop] This means that the source code is still
1925   available to build, but the targets are no longer being tested and release
1926   binaries for those platforms will no longer be distributed by the Rust project.
1927   Please refer to the linked blog post for more information.
1928
1929 [54733]: https://github.com/rust-lang/rust/pull/54733/
1930 [61351]: https://github.com/rust-lang/rust/pull/61351/
1931 [67255]: https://github.com/rust-lang/rust/pull/67255/
1932 [66661]: https://github.com/rust-lang/rust/pull/66661/
1933 [66771]: https://github.com/rust-lang/rust/pull/66771/
1934 [66847]: https://github.com/rust-lang/rust/pull/66847/
1935 [66238]: https://github.com/rust-lang/rust/pull/66238/
1936 [66277]: https://github.com/rust-lang/rust/pull/66277/
1937 [66325]: https://github.com/rust-lang/rust/pull/66325/
1938 [66172]: https://github.com/rust-lang/rust/pull/66172/
1939 [66183]: https://github.com/rust-lang/rust/pull/66183/
1940 [65879]: https://github.com/rust-lang/rust/pull/65879/
1941 [65013]: https://github.com/rust-lang/rust/pull/65013/
1942 [64882]: https://github.com/rust-lang/rust/pull/64882/
1943 [64325]: https://github.com/rust-lang/rust/pull/64325/
1944 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
1945 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
1946 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
1947 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
1948 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
1949 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
1950 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
1951 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
1952 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
1953 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
1954 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
1955
1956 Version 1.40.0 (2019-12-19)
1957 ===========================
1958
1959 Language
1960 --------
1961 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
1962   `const` contexts.][65188] e.g.
1963
1964   ```rust
1965   pub struct Point(i32, i32);
1966
1967   const ORIGIN: Point = {
1968       let constructor = Point;
1969
1970       constructor(0, 0)
1971   };
1972   ```
1973
1974 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
1975   indicate that there may be variants or fields added in the future.][64639]
1976   For example this requires adding a wild-card branch (`_ => {}`) to any match
1977   statements on a non-exhaustive `enum`. [(RFC 2008)]
1978 - [You can now use function-like procedural macros in `extern` blocks and in
1979   type positions.][63931] e.g. `type Generated = macro!();`
1980 - [Function-like and attribute procedural macros can now emit
1981   `macro_rules!` items, so you can now have your macros generate macros.][64035]
1982 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
1983   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
1984   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
1985
1986 Compiler
1987 --------
1988 - [Added tier 3 support\* for the
1989   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
1990 - [Added tier 3 support for the
1991   `aarch64-unknown-none-softfloat` target.][64589]
1992 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
1993   `mips64el-unknown-linux-muslabi64` targets.][65843]
1994
1995 \* Refer to Rust's [platform support page][platform-support-doc] for more
1996   information on Rust's tiered platform support.
1997
1998 Libraries
1999 ---------
2000 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
2001
2002 Stabilized APIs
2003 ---------------
2004 - [`BTreeMap::get_key_value`]
2005 - [`HashMap::get_key_value`]
2006 - [`Option::as_deref_mut`]
2007 - [`Option::as_deref`]
2008 - [`Option::flatten`]
2009 - [`UdpSocket::peer_addr`]
2010 - [`f32::to_be_bytes`]
2011 - [`f32::to_le_bytes`]
2012 - [`f32::to_ne_bytes`]
2013 - [`f64::to_be_bytes`]
2014 - [`f64::to_le_bytes`]
2015 - [`f64::to_ne_bytes`]
2016 - [`f32::from_be_bytes`]
2017 - [`f32::from_le_bytes`]
2018 - [`f32::from_ne_bytes`]
2019 - [`f64::from_be_bytes`]
2020 - [`f64::from_le_bytes`]
2021 - [`f64::from_ne_bytes`]
2022 - [`mem::take`]
2023 - [`slice::repeat`]
2024 - [`todo!`]
2025
2026 Cargo
2027 -----
2028 - [Cargo will now always display warnings, rather than only on
2029   fresh builds.][cargo/7450]
2030 - [Feature flags (except `--all-features`) passed to a virtual workspace will
2031   now produce an error.][cargo/7507] Previously these flags were ignored.
2032 - [You can now publish `dev-dependencies` without including
2033   a `version`.][cargo/7333]
2034
2035 Misc
2036 ----
2037 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
2038   when running documentation tests with `rustdoc`.][63803]
2039
2040 Compatibility Notes
2041 -------------------
2042 - [As previously announced, any previous NLL warnings in the 2015 edition are
2043   now hard errors.][64221]
2044 - [The `include!` macro will now warn if it failed to include the
2045   entire file.][64284] The `include!` macro unintentionally only includes the
2046   first _expression_ in a file, and this can be unintuitive. This will become
2047   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
2048 - [Using `#[inline]` on function prototypes and consts now emits a warning under
2049   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
2050   or `extern` blocks now correctly emits a hard error.
2051
2052 [65294]: https://github.com/rust-lang/rust/pull/65294/
2053 [66103]: https://github.com/rust-lang/rust/pull/66103/
2054 [65843]: https://github.com/rust-lang/rust/pull/65843/
2055 [65188]: https://github.com/rust-lang/rust/pull/65188/
2056 [65092]: https://github.com/rust-lang/rust/pull/65092/
2057 [64589]: https://github.com/rust-lang/rust/pull/64589/
2058 [64639]: https://github.com/rust-lang/rust/pull/64639/
2059 [64221]: https://github.com/rust-lang/rust/pull/64221/
2060 [64284]: https://github.com/rust-lang/rust/pull/64284/
2061 [63931]: https://github.com/rust-lang/rust/pull/63931/
2062 [64035]: https://github.com/rust-lang/rust/pull/64035/
2063 [63674]: https://github.com/rust-lang/rust/pull/63674/
2064 [63803]: https://github.com/rust-lang/rust/pull/63803/
2065 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
2066 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
2067 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
2068 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
2069 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
2070 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
2071 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
2072 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
2073 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
2074 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
2075 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
2076 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
2077 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
2078 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
2079 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
2080 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
2081 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
2082 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
2083 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
2084 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
2085 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
2086 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
2087 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
2088 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
2089 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
2090 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
2091
2092
2093 Version 1.39.0 (2019-11-07)
2094 ===========================
2095
2096 Language
2097 --------
2098 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
2099   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
2100 - [You can now use certain attributes on function, closure, and function pointer
2101   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
2102   `deny`, `forbid` as well as inert helper attributes used by procedural macro
2103   attributes applied to items. e.g.
2104   ```rust
2105   fn len(
2106       #[cfg(windows)] slice: &[u16],
2107       #[cfg(not(windows))] slice: &[u8],
2108   ) -> usize {
2109       slice.len()
2110   }
2111   ```
2112 - [You can now take shared references to bind-by-move patterns in the `if` guards
2113   of `match` arms.][63118] e.g.
2114   ```rust
2115   fn main() {
2116       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
2117
2118       match array {
2119           nums
2120   //      ---- `nums` is bound by move.
2121               if nums.iter().sum::<u8>() == 10
2122   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
2123           => {
2124               drop(nums);
2125   //          ----------- Legal as `nums` was bound by move and so we have ownership.
2126           }
2127           _ => unreachable!(),
2128       }
2129   }
2130   ```
2131
2132
2133
2134 Compiler
2135 --------
2136 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
2137 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
2138 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
2139   **Note** Cargo currently doesn't use this feature. Refer to
2140   [cargo#7315][cargo/7315] to track this feature's progress.
2141 - [You can now pass `--show-output` argument to test binaries to print the
2142   output of successful tests.][62600]
2143
2144
2145 \* Refer to Rust's [platform support page][platform-support-doc] for more
2146 information on Rust's tiered platform support.
2147
2148 Libraries
2149 ---------
2150 - [`Vec::new` and `String::new` are now `const` functions.][64028]
2151 - [`LinkedList::new` is now a `const` function.][63684]
2152 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
2153 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
2154   now `const`.][63786]
2155
2156 Stabilized APIs
2157 ---------------
2158 - [`Pin::into_inner`]
2159 - [`Instant::checked_duration_since`]
2160 - [`Instant::saturating_duration_since`]
2161
2162 Cargo
2163 -----
2164 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
2165 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
2166   `--all` is now deprecated.
2167
2168 Misc
2169 ----
2170 - [You can now pass `-Clinker` to rustdoc to control the linker used
2171   for compiling doctests.][63834]
2172
2173 Compatibility Notes
2174 -------------------
2175 - [Code that was previously accepted by the old borrow checker, but rejected by
2176   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
2177   previously a warning, and will also become a hard error in the Rust 2015
2178   edition in the 1.40.0 release.
2179 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
2180   run tests.][63827] This should improve performance when running a large
2181   amount of doctests.
2182 - [The `try!` macro will now issue a deprecation warning.][62672] It is
2183   recommended to use the `?` operator instead.
2184 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
2185   returned `0.0`.
2186
2187 [62600]: https://github.com/rust-lang/rust/pull/62600/
2188 [62672]: https://github.com/rust-lang/rust/pull/62672/
2189 [63118]: https://github.com/rust-lang/rust/pull/63118/
2190 [63209]: https://github.com/rust-lang/rust/pull/63209/
2191 [63402]: https://github.com/rust-lang/rust/pull/63402/
2192 [63565]: https://github.com/rust-lang/rust/pull/63565/
2193 [63595]: https://github.com/rust-lang/rust/pull/63595/
2194 [63684]: https://github.com/rust-lang/rust/pull/63684/
2195 [63698]: https://github.com/rust-lang/rust/pull/63698/
2196 [63770]: https://github.com/rust-lang/rust/pull/63770/
2197 [63786]: https://github.com/rust-lang/rust/pull/63786/
2198 [63827]: https://github.com/rust-lang/rust/pull/63827/
2199 [63834]: https://github.com/rust-lang/rust/pull/63834/
2200 [63927]: https://github.com/rust-lang/rust/pull/63927/
2201 [63933]: https://github.com/rust-lang/rust/pull/63933/
2202 [63934]: https://github.com/rust-lang/rust/pull/63934/
2203 [63938]: https://github.com/rust-lang/rust/pull/63938/
2204 [63940]: https://github.com/rust-lang/rust/pull/63940/
2205 [63941]: https://github.com/rust-lang/rust/pull/63941/
2206 [63945]: https://github.com/rust-lang/rust/pull/63945/
2207 [64010]: https://github.com/rust-lang/rust/pull/64010/
2208 [64028]: https://github.com/rust-lang/rust/pull/64028/
2209 [64334]: https://github.com/rust-lang/rust/pull/64334/
2210 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
2211 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
2212 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
2213 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
2214 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
2215 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
2216
2217 Version 1.38.0 (2019-09-26)
2218 ==========================
2219
2220 Language
2221 --------
2222 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
2223 - [The `#[deprecated]` attribute can now be used on macros.][62042]
2224
2225 Compiler
2226 --------
2227 - [Added pipelined compilation support to `rustc`.][62766] This will
2228   improve compilation times in some cases. For further information please refer
2229   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
2230 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
2231   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
2232   `x86_64-uwp-windows-msvc` targets.][60260]
2233 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
2234   `armv7-unknown-linux-musleabi` targets.][63107]
2235 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
2236 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
2237 - [Upgraded to LLVM 9.][62592]
2238
2239 \* Refer to Rust's [platform support page][platform-support-doc] for more
2240 information on Rust's tiered platform support.
2241
2242 Libraries
2243 ---------
2244 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
2245 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
2246   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
2247   is available at `std::clone::Clone`). This also makes all built-in macros
2248   available in `std`/`core` root. e.g. `std::include_bytes!`.
2249 - [`str::Chars` now implements `Debug`.][63000]
2250 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
2251 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
2252 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
2253 - [Added euclidean remainder and division operations (`div_euclid`,
2254   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
2255   `overflowing`, and `wrapping` versions are available for all
2256   integer primitives.
2257 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
2258   `PartialEq`.][61491]
2259 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
2260
2261 Stabilized APIs
2262 ---------------
2263 - [`<*const T>::cast`]
2264 - [`<*mut T>::cast`]
2265 - [`Duration::as_secs_f32`]
2266 - [`Duration::as_secs_f64`]
2267 - [`Duration::div_f32`]
2268 - [`Duration::div_f64`]
2269 - [`Duration::from_secs_f32`]
2270 - [`Duration::from_secs_f64`]
2271 - [`Duration::mul_f32`]
2272 - [`Duration::mul_f64`]
2273 - [`any::type_name`]
2274
2275 Cargo
2276 -----
2277 - [Added pipelined compilation support to `cargo`.][cargo/7143]
2278 - [You can now pass the `--features` option multiple times to enable
2279   multiple features.][cargo/7084]
2280
2281 Rustdoc
2282 -------
2283
2284 - [Documentation on `pub use` statements is prepended to the documentation of the re-exported item][63048]
2285
2286 Misc
2287 ----
2288 - [`rustc` will now warn about some incorrect uses of
2289   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
2290
2291 Compatibility Notes
2292 -------------------
2293 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
2294   1.38.0.
2295 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
2296   issues][62896] with certain crates such as libc.
2297
2298 [60260]: https://github.com/rust-lang/rust/pull/60260/
2299 [61457]: https://github.com/rust-lang/rust/pull/61457/
2300 [61491]: https://github.com/rust-lang/rust/pull/61491/
2301 [61884]: https://github.com/rust-lang/rust/pull/61884/
2302 [61953]: https://github.com/rust-lang/rust/pull/61953/
2303 [62042]: https://github.com/rust-lang/rust/pull/62042/
2304 [62528]: https://github.com/rust-lang/rust/pull/62528/
2305 [62583]: https://github.com/rust-lang/rust/pull/62583/
2306 [62735]: https://github.com/rust-lang/rust/pull/62735/
2307 [62766]: https://github.com/rust-lang/rust/pull/62766/
2308 [62784]: https://github.com/rust-lang/rust/pull/62784/
2309 [62592]: https://github.com/rust-lang/rust/pull/62592/
2310 [62785]: https://github.com/rust-lang/rust/issues/62785/
2311 [62814]: https://github.com/rust-lang/rust/pull/62814/
2312 [62896]: https://github.com/rust-lang/rust/issues/62896/
2313 [63000]: https://github.com/rust-lang/rust/pull/63000/
2314 [63056]: https://github.com/rust-lang/rust/pull/63056/
2315 [63107]: https://github.com/rust-lang/rust/pull/63107/
2316 [63346]: https://github.com/rust-lang/rust/pull/63346/
2317 [63421]: https://github.com/rust-lang/rust/pull/63421/
2318 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
2319 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
2320 [63048]: https://github.com/rust-lang/rust/pull/63048
2321 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2322 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
2323 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
2324 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
2325 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
2326 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
2327 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
2328 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
2329 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
2330 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
2331 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
2332 [platform-support-doc]: https://doc.rust-lang.org/nightly/rustc/platform-support.html
2333 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
2334
2335 Version 1.37.0 (2019-08-15)
2336 ==========================
2337
2338 Language
2339 --------
2340 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
2341   [`Box`][62228], or an [array][62235] and unused.
2342 - [You can now use the `cfg` and `cfg_attr` attributes on
2343   generic parameters.][61547]
2344 - [You can now use enum variants through type alias.][61682] e.g. You can
2345   write the following:
2346   ```rust
2347   type MyOption = Option<u8>;
2348
2349   fn increment_or_zero(x: MyOption) -> u8 {
2350       match x {
2351           MyOption::Some(y) => y + 1,
2352           MyOption::None => 0,
2353       }
2354   }
2355   ```
2356 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
2357   `const _: u32 = 5;`.
2358 - [You can now use `#[repr(align(X)]` on enums.][61229]
2359 - [The  `?` Kleene macro operator is now available in the
2360   2015 edition.][60932]
2361
2362 Compiler
2363 --------
2364 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
2365   and `-C profile-use` flags.][61268] For more information on how to use profile
2366   guided optimization, please refer to the [rustc book][rustc-book-pgo].
2367 - [The `rust-lldb` wrapper script should now work again.][61827]
2368
2369 Libraries
2370 ---------
2371 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
2372
2373 Stabilized APIs
2374 ---------------
2375 - [`BufReader::buffer`]
2376 - [`BufWriter::buffer`]
2377 - [`Cell::from_mut`]
2378 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
2379 - [`DoubleEndedIterator::nth_back`]
2380 - [`Option::xor`]
2381 - [`Wrapping::reverse_bits`]
2382 - [`i128::reverse_bits`]
2383 - [`i16::reverse_bits`]
2384 - [`i32::reverse_bits`]
2385 - [`i64::reverse_bits`]
2386 - [`i8::reverse_bits`]
2387 - [`isize::reverse_bits`]
2388 - [`slice::copy_within`]
2389 - [`u128::reverse_bits`]
2390 - [`u16::reverse_bits`]
2391 - [`u32::reverse_bits`]
2392 - [`u64::reverse_bits`]
2393 - [`u8::reverse_bits`]
2394 - [`usize::reverse_bits`]
2395
2396 Cargo
2397 -----
2398 - [`Cargo.lock` files are now included by default when publishing executable crates
2399   with executables.][cargo/7026]
2400 - [You can now specify `default-run="foo"` in `[package]` to specify the
2401   default executable to use for `cargo run`.][cargo/7056]
2402
2403 Misc
2404 ----
2405
2406 Compatibility Notes
2407 -------------------
2408 - [Using `...` for inclusive range patterns will now warn by default.][61342]
2409   Please transition your code to using the `..=` syntax for inclusive
2410   ranges instead.
2411 - [Using a trait object without the `dyn` will now warn by default.][61203]
2412   Please transition your code to use `dyn Trait` for trait objects instead.
2413
2414 [62228]: https://github.com/rust-lang/rust/pull/62228/
2415 [62235]: https://github.com/rust-lang/rust/pull/62235/
2416 [61802]: https://github.com/rust-lang/rust/pull/61802/
2417 [61827]: https://github.com/rust-lang/rust/pull/61827/
2418 [61547]: https://github.com/rust-lang/rust/pull/61547/
2419 [61682]: https://github.com/rust-lang/rust/pull/61682/
2420 [61268]: https://github.com/rust-lang/rust/pull/61268/
2421 [61342]: https://github.com/rust-lang/rust/pull/61342/
2422 [61347]: https://github.com/rust-lang/rust/pull/61347/
2423 [61100]: https://github.com/rust-lang/rust/pull/61100/
2424 [61203]: https://github.com/rust-lang/rust/pull/61203/
2425 [61229]: https://github.com/rust-lang/rust/pull/61229/
2426 [60932]: https://github.com/rust-lang/rust/pull/60932/
2427 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
2428 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
2429 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
2430 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
2431 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
2432 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
2433 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
2434 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
2435 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
2436 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
2437 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
2438 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
2439 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
2440 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
2441 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
2442 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
2443 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
2444 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
2445 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
2446 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
2447 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
2448 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
2449 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
2450 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
2451
2452
2453 Version 1.36.0 (2019-07-04)
2454 ==========================
2455
2456 Language
2457 --------
2458 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
2459 - [The order of traits in trait objects no longer affects the semantics of that
2460   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
2461   `dyn fmt::Debug + Send`, where this was previously not the case.
2462
2463 Libraries
2464 ---------
2465 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
2466 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
2467 - [`mem::needs_drop` is now available as a const fn.][60364]
2468 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
2469 - [`String` now implements `BorrowMut<str>`.][60404]
2470 - [`io::Cursor` now implements `Default`.][60234]
2471 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
2472 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
2473   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
2474   environment has access to heap memory allocation.
2475 - [`String` now implements `From<&String>`.][59825]
2476 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
2477   return a tuple of each argument when there is multiple arguments.
2478 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
2479   not used.][59648]
2480
2481 Stabilized APIs
2482 ---------------
2483 - [`VecDeque::rotate_left`]
2484 - [`VecDeque::rotate_right`]
2485 - [`Iterator::copied`]
2486 - [`io::IoSlice`]
2487 - [`io::IoSliceMut`]
2488 - [`Read::read_vectored`]
2489 - [`Write::write_vectored`]
2490 - [`str::as_mut_ptr`]
2491 - [`mem::MaybeUninit`]
2492 - [`pointer::align_offset`]
2493 - [`future::Future`]
2494 - [`task::Context`]
2495 - [`task::RawWaker`]
2496 - [`task::RawWakerVTable`]
2497 - [`task::Waker`]
2498 - [`task::Poll`]
2499
2500 Cargo
2501 -----
2502 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
2503 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
2504
2505 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
2506
2507 Clippy
2508 ------
2509 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
2510
2511 Misc
2512 ----
2513
2514 Compatibility Notes
2515 -------------------
2516 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
2517   longer recommended, and will be deprecated in 1.39.0.
2518
2519 [60318]: https://github.com/rust-lang/rust/pull/60318/
2520 [60364]: https://github.com/rust-lang/rust/pull/60364/
2521 [60370]: https://github.com/rust-lang/rust/pull/60370/
2522 [60404]: https://github.com/rust-lang/rust/pull/60404/
2523 [60234]: https://github.com/rust-lang/rust/pull/60234/
2524 [60244]: https://github.com/rust-lang/rust/pull/60244/
2525 [58623]: https://github.com/rust-lang/rust/pull/58623/
2526 [59648]: https://github.com/rust-lang/rust/pull/59648/
2527 [59675]: https://github.com/rust-lang/rust/pull/59675/
2528 [59825]: https://github.com/rust-lang/rust/pull/59825/
2529 [59826]: https://github.com/rust-lang/rust/pull/59826/
2530 [59445]: https://github.com/rust-lang/rust/pull/59445/
2531 [59114]: https://github.com/rust-lang/rust/pull/59114/
2532 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
2533 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
2534 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
2535 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
2536 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
2537 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
2538 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
2539 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
2540 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
2541 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
2542 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
2543 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
2544 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
2545 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
2546 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
2547 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
2548 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
2549 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
2550 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
2551 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
2552
2553
2554 Version 1.35.0 (2019-05-23)
2555 ==========================
2556
2557 Language
2558 --------
2559 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
2560   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
2561 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
2562   ```rust
2563   unsafe fn call_unsafe(func: unsafe fn()) {
2564       func()
2565   }
2566
2567   pub fn main() {
2568       unsafe { call_unsafe(|| {}); }
2569   }
2570   ```
2571
2572
2573 Compiler
2574 --------
2575 - [Added the `armv6-unknown-freebsd-gnueabihf` and
2576   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
2577 - [Added the `wasm32-unknown-wasi` target.][59464]
2578
2579
2580 Libraries
2581 ---------
2582 - [`Thread` will now show its ID in `Debug` output.][59460]
2583 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
2584 - [`alloc::System` now implements `Default`.][59451]
2585 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
2586   last field.][59076]
2587 - [`char::{ToLowercase, ToUppercase}` now
2588   implement `ExactSizeIterator`.][58778]
2589 - [All `NonZero` numeric types now implement `FromStr`.][58717]
2590 - [Removed the `Read` trait bounds
2591   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
2592 - [You can now call the `dbg!` macro without any parameters to print the file
2593   and line where it is called.][57847]
2594 - [In place ASCII case conversions are now up to 4× faster.][59283]
2595   e.g. `str::make_ascii_lowercase`
2596 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
2597   and `Send`.][58369]
2598
2599 Stabilized APIs
2600 ---------------
2601 - [`f32::copysign`]
2602 - [`f64::copysign`]
2603 - [`RefCell::replace_with`]
2604 - [`RefCell::map_split`]
2605 - [`ptr::hash`]
2606 - [`Range::contains`]
2607 - [`RangeFrom::contains`]
2608 - [`RangeTo::contains`]
2609 - [`RangeInclusive::contains`]
2610 - [`RangeToInclusive::contains`]
2611 - [`Option::copied`]
2612
2613 Cargo
2614 -----
2615 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
2616   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
2617   platform specific.
2618
2619 Misc
2620 ----
2621 - [The Rust toolchain is now available natively for musl based distros.][58575]
2622
2623 [59460]: https://github.com/rust-lang/rust/pull/59460/
2624 [59464]: https://github.com/rust-lang/rust/pull/59464/
2625 [59500]: https://github.com/rust-lang/rust/pull/59500/
2626 [59512]: https://github.com/rust-lang/rust/pull/59512/
2627 [59580]: https://github.com/rust-lang/rust/pull/59580/
2628 [59283]: https://github.com/rust-lang/rust/pull/59283/
2629 [59451]: https://github.com/rust-lang/rust/pull/59451/
2630 [59076]: https://github.com/rust-lang/rust/pull/59076/
2631 [58778]: https://github.com/rust-lang/rust/pull/58778/
2632 [58717]: https://github.com/rust-lang/rust/pull/58717/
2633 [58369]: https://github.com/rust-lang/rust/pull/58369/
2634 [58423]: https://github.com/rust-lang/rust/pull/58423/
2635 [58080]: https://github.com/rust-lang/rust/pull/58080/
2636 [57847]: https://github.com/rust-lang/rust/pull/57847/
2637 [58575]: https://github.com/rust-lang/rust/pull/58575
2638 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
2639 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
2640 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
2641 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
2642 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
2643 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
2644 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
2645 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
2646 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
2647 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
2648 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
2649 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
2650
2651 Version 1.34.2 (2019-05-14)
2652 ===========================
2653
2654 * [Destabilize the `Error::type_id` function due to a security
2655    vulnerability][60785] ([CVE-2019-12083])
2656
2657 [60785]: https://github.com/rust-lang/rust/pull/60785
2658 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
2659
2660 Version 1.34.1 (2019-04-25)
2661 ===========================
2662
2663 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
2664 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
2665 * [Fix Clippy panic when checking some macros][clippy/3805]
2666
2667 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
2668 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
2669 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
2670
2671 Version 1.34.0 (2019-04-11)
2672 ==========================
2673
2674 Language
2675 --------
2676 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
2677   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
2678   but had no effect.
2679 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
2680   `#[attr{}]` procedural macros.][57367]
2681 - [You can now write `extern crate self as foo;`][57407] to import your
2682   crate's root into the extern prelude.
2683
2684
2685 Compiler
2686 --------
2687 - [You can now target `riscv64imac-unknown-none-elf` and
2688   `riscv64gc-unknown-none-elf`.][58406]
2689 - [You can now enable linker plugin LTO optimisations with
2690   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
2691   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
2692   boundaries.
2693 - [You can now target `powerpc64-unknown-freebsd`.][57809]
2694
2695
2696 Libraries
2697 ---------
2698 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
2699   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
2700   the `Hash` trait to create an iterator.
2701 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
2702   methods.][58421] Most notably you no longer require the `Ord` trait to create
2703   an iterator.
2704 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
2705   for all numeric types.][58044]
2706 - [Indexing a `str` is now generic over all types that
2707   implement `SliceIndex<str>`.][57604]
2708 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
2709   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
2710   produce a warning if their returning type is unused.
2711 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
2712   `overflowing_pow` are now available for all numeric types.][57873] These are
2713   equivalent to methods such as `wrapping_add` for the `pow` operation.
2714
2715
2716 Stabilized APIs
2717 ---------------
2718
2719 #### std & core
2720 * [`Any::type_id`]
2721 * [`Error::type_id`]
2722 * [`atomic::AtomicI16`]
2723 * [`atomic::AtomicI32`]
2724 * [`atomic::AtomicI64`]
2725 * [`atomic::AtomicI8`]
2726 * [`atomic::AtomicU16`]
2727 * [`atomic::AtomicU32`]
2728 * [`atomic::AtomicU64`]
2729 * [`atomic::AtomicU8`]
2730 * [`convert::Infallible`]
2731 * [`convert::TryFrom`]
2732 * [`convert::TryInto`]
2733 * [`iter::from_fn`]
2734 * [`iter::successors`]
2735 * [`num::NonZeroI128`]
2736 * [`num::NonZeroI16`]
2737 * [`num::NonZeroI32`]
2738 * [`num::NonZeroI64`]
2739 * [`num::NonZeroI8`]
2740 * [`num::NonZeroIsize`]
2741 * [`slice::sort_by_cached_key`]
2742 * [`str::escape_debug`]
2743 * [`str::escape_default`]
2744 * [`str::escape_unicode`]
2745 * [`str::split_ascii_whitespace`]
2746
2747 #### std
2748 * [`Instant::checked_add`]
2749 * [`Instant::checked_sub`]
2750 * [`SystemTime::checked_add`]
2751 * [`SystemTime::checked_sub`]
2752
2753 Cargo
2754 -----
2755 - [You can now use alternative registries to crates.io.][cargo/6654]
2756
2757 Misc
2758 ----
2759 - [You can now use the `?` operator in your documentation tests without manually
2760   adding `fn main() -> Result<(), _> {}`.][56470]
2761
2762 Compatibility Notes
2763 -------------------
2764 - [`Command::before_exec` is being replaced by the unsafe method
2765   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
2766 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
2767   can now use `const` functions in `static` variables.
2768
2769 [58370]: https://github.com/rust-lang/rust/pull/58370/
2770 [58406]: https://github.com/rust-lang/rust/pull/58406/
2771 [58421]: https://github.com/rust-lang/rust/pull/58421/
2772 [58166]: https://github.com/rust-lang/rust/pull/58166/
2773 [58044]: https://github.com/rust-lang/rust/pull/58044/
2774 [58057]: https://github.com/rust-lang/rust/pull/58057/
2775 [58059]: https://github.com/rust-lang/rust/pull/58059/
2776 [57809]: https://github.com/rust-lang/rust/pull/57809/
2777 [57873]: https://github.com/rust-lang/rust/pull/57873/
2778 [57604]: https://github.com/rust-lang/rust/pull/57604/
2779 [57367]: https://github.com/rust-lang/rust/pull/57367/
2780 [57407]: https://github.com/rust-lang/rust/pull/57407/
2781 [57425]: https://github.com/rust-lang/rust/pull/57425/
2782 [57106]: https://github.com/rust-lang/rust/pull/57106/
2783 [56470]: https://github.com/rust-lang/rust/pull/56470/
2784 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
2785 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
2786 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
2787 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
2788 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
2789 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
2790 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
2791 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
2792 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
2793 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
2794 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
2795 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
2796 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
2797 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
2798 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
2799 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
2800 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
2801 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
2802 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
2803 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
2804 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
2805 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
2806 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
2807 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
2808 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
2809 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
2810 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
2811 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
2812 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
2813 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
2814 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
2815
2816
2817 Version 1.33.0 (2019-02-28)
2818 ==========================
2819
2820 Language
2821 --------
2822 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
2823   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
2824 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
2825   E.g. You can have match statement on a `u8` that covers `0..=255` and
2826   you would no longer be required to have a `_ => unreachable!()` case.
2827 - [You can now have multiple patterns in `if let` and `while let`
2828   expressions.][57532] You can do this with the same syntax as a `match`
2829   expression. E.g.
2830   ```rust
2831   enum Creature {
2832       Crab(String),
2833       Lobster(String),
2834       Person(String),
2835   }
2836
2837   fn main() {
2838       let state = Creature::Crab("Ferris");
2839
2840       if let Creature::Crab(name) | Creature::Person(name) = state {
2841           println!("This creature's name is: {}", name);
2842       }
2843   }
2844   ```
2845 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
2846   this feature will by default produce a warning as this behaviour can be
2847   unintuitive. E.g. `if let _ = 5 {}`
2848 - [You can now use `let` bindings, assignments, expression statements,
2849   and irrefutable pattern destructuring in const functions.][57175]
2850 - [You can now call unsafe const functions.][57067] E.g.
2851   ```rust
2852   const unsafe fn foo() -> i32 { 5 }
2853   const fn bar() -> i32 {
2854       unsafe { foo() }
2855   }
2856   ```
2857 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
2858   E.g. `#[cfg_attr(all(), must_use, optimize)]`
2859 - [You can now specify a specific alignment with the `#[repr(packed)]`
2860   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
2861   with an alignment of 2 bytes and a size of 6 bytes.
2862 - [You can now import an item from a module as an `_`.][56303] This allows you to
2863   import a trait's impls, and not have the name in the namespace. E.g.
2864   ```rust
2865   use std::io::Read as _;
2866
2867   // Allowed as there is only one `Read` in the module.
2868   pub trait Read {}
2869   ```
2870 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
2871
2872 Compiler
2873 --------
2874 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
2875   command line argument.][56351]
2876 - [The minimum required LLVM version has been bumped to 6.0.][56642]
2877 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
2878 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
2879   tier 2 support.][57130] Visit the [platform support][platform-support] page for
2880   information on Rust's platform support.
2881 - [Added support for the `thumbv7neon-linux-androideabi` and
2882   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
2883 - [Added support for the `x86_64-unknown-uefi` target.][56769]
2884
2885 Libraries
2886 ---------
2887 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
2888   functions for all numeric types.][57566]
2889 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
2890   are now `const` functions for all numeric types.][57105]
2891 - [The methods `is_positive` and `is_negative` are now `const` functions for
2892   all signed numeric types.][57105]
2893 - [The `get` method for all `NonZero` types is now `const`.][57167]
2894 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
2895   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
2896   numeric types.][57234]
2897 - [`Ipv4Addr::new` is now a `const` function][57234]
2898
2899 Stabilized APIs
2900 ---------------
2901 - [`unix::FileExt::read_exact_at`]
2902 - [`unix::FileExt::write_all_at`]
2903 - [`Option::transpose`]
2904 - [`Result::transpose`]
2905 - [`convert::identity`]
2906 - [`pin::Pin`]
2907 - [`marker::Unpin`]
2908 - [`marker::PhantomPinned`]
2909 - [`Vec::resize_with`]
2910 - [`VecDeque::resize_with`]
2911 - [`Duration::as_millis`]
2912 - [`Duration::as_micros`]
2913 - [`Duration::as_nanos`]
2914
2915
2916 Cargo
2917 -----
2918 - [You can now publish crates that require a feature flag to compile with
2919   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
2920 - [Cargo should now rebuild a crate if a file was modified during the initial
2921   build.][cargo/6484]
2922
2923 Compatibility Notes
2924 -------------------
2925 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
2926   are now deprecated in the standard library, and their usage will now produce a warning.
2927   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
2928   methods instead.
2929 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
2930   downcasting.
2931 - [Libtest no longer creates a new thread for each test when
2932   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
2933
2934 [55982]: https://github.com/rust-lang/rust/pull/55982/
2935 [56243]: https://github.com/rust-lang/rust/pull/56243
2936 [56303]: https://github.com/rust-lang/rust/pull/56303/
2937 [56351]: https://github.com/rust-lang/rust/pull/56351/
2938 [56362]: https://github.com/rust-lang/rust/pull/56362
2939 [56642]: https://github.com/rust-lang/rust/pull/56642/
2940 [56769]: https://github.com/rust-lang/rust/pull/56769/
2941 [56805]: https://github.com/rust-lang/rust/pull/56805
2942 [56947]: https://github.com/rust-lang/rust/pull/56947/
2943 [57049]: https://github.com/rust-lang/rust/pull/57049/
2944 [57067]: https://github.com/rust-lang/rust/pull/57067/
2945 [57105]: https://github.com/rust-lang/rust/pull/57105
2946 [57130]: https://github.com/rust-lang/rust/pull/57130/
2947 [57167]: https://github.com/rust-lang/rust/pull/57167/
2948 [57175]: https://github.com/rust-lang/rust/pull/57175/
2949 [57234]: https://github.com/rust-lang/rust/pull/57234/
2950 [57332]: https://github.com/rust-lang/rust/pull/57332/
2951 [57465]: https://github.com/rust-lang/rust/pull/57465/
2952 [57532]: https://github.com/rust-lang/rust/pull/57532/
2953 [57535]: https://github.com/rust-lang/rust/pull/57535/
2954 [57566]: https://github.com/rust-lang/rust/pull/57566/
2955 [57615]: https://github.com/rust-lang/rust/pull/57615/
2956 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
2957 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
2958 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
2959 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
2960 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
2961 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
2962 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
2963 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
2964 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
2965 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
2966 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
2967 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
2968 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
2969 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
2970 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
2971 [platform-support]: https://forge.rust-lang.org/platform-support.html
2972
2973 Version 1.32.0 (2019-01-17)
2974 ==========================
2975
2976 Language
2977 --------
2978 #### 2018 edition
2979 - [You can now use the `?` operator in macro definitions.][56245] The `?`
2980   operator allows you to specify zero or one repetitions similar to the `*` and
2981   `+` operators.
2982 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
2983   now always resolve to the item (`enum`, `struct`, etc.) available in the
2984   module if present, before resolving to a external crate or an item the prelude.][56759]
2985   E.g.
2986   ```rust
2987   enum Color { Red, Green, Blue }
2988
2989   use Color::*;
2990   ```
2991
2992 #### All editions
2993 - [You can now match against `PhantomData<T>` types.][55837]
2994 - [You can now match against literals in macros with the `literal`
2995   specifier.][56072] This will match against a literal of any type.
2996   E.g. `1`, `'A'`, `"Hello World"`
2997 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
2998   ```rust
2999   struct Point(i32, i32);
3000
3001   impl Point {
3002       pub fn new(x: i32, y: i32) -> Self {
3003           Self(x, y)
3004       }
3005
3006       pub fn is_origin(&self) -> bool {
3007           match self {
3008               Self(0, 0) => true,
3009               _ => false,
3010           }
3011       }
3012   }
3013   ```
3014 - [Self can also now be used in type definitions.][56366] E.g.
3015   ```rust
3016   enum List<T>
3017   where
3018       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
3019   {
3020       Nil,
3021       Cons(T, Box<Self>) // likewise here
3022   }
3023   ```
3024 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
3025   a `impl Trait` or `dyn Trait` is returned and unused in the program.
3026
3027 Compiler
3028 --------
3029 - [The default allocator has changed from jemalloc to the default allocator on
3030   your system.][55238] The compiler itself on Linux & macOS will still use
3031   jemalloc, but programs compiled with it will use the system allocator.
3032 - [Added the `aarch64-pc-windows-msvc` target.][55702]
3033
3034 Libraries
3035 ---------
3036 - [`PathBuf` now implements `FromStr`.][55148]
3037 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
3038 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
3039   easily debug expressions in your rust program. E.g.
3040   ```rust
3041   let a = 2;
3042   let b = dbg!(a * 2) + 1;
3043   //      ^-- prints: [src/main.rs:4] a * 2 = 4
3044   assert_eq!(b, 5);
3045   ```
3046
3047 The following APIs are now `const` functions and can be used in a
3048 `const` context.
3049
3050 - [`Cell::as_ptr`]
3051 - [`UnsafeCell::get`]
3052 - [`char::is_ascii`]
3053 - [`iter::empty`]
3054 - [`ManuallyDrop::new`]
3055 - [`ManuallyDrop::into_inner`]
3056 - [`RangeInclusive::start`]
3057 - [`RangeInclusive::end`]
3058 - [`NonNull::as_ptr`]
3059 - [`slice::as_ptr`]
3060 - [`str::as_ptr`]
3061 - [`Duration::as_secs`]
3062 - [`Duration::subsec_millis`]
3063 - [`Duration::subsec_micros`]
3064 - [`Duration::subsec_nanos`]
3065 - [`CStr::as_ptr`]
3066 - [`Ipv4Addr::is_unspecified`]
3067 - [`Ipv6Addr::new`]
3068 - [`Ipv6Addr::octets`]
3069
3070 Stabilized APIs
3071 ---------------
3072 - [`i8::to_be_bytes`]
3073 - [`i8::to_le_bytes`]
3074 - [`i8::to_ne_bytes`]
3075 - [`i8::from_be_bytes`]
3076 - [`i8::from_le_bytes`]
3077 - [`i8::from_ne_bytes`]
3078 - [`i16::to_be_bytes`]
3079 - [`i16::to_le_bytes`]
3080 - [`i16::to_ne_bytes`]
3081 - [`i16::from_be_bytes`]
3082 - [`i16::from_le_bytes`]
3083 - [`i16::from_ne_bytes`]
3084 - [`i32::to_be_bytes`]
3085 - [`i32::to_le_bytes`]
3086 - [`i32::to_ne_bytes`]
3087 - [`i32::from_be_bytes`]
3088 - [`i32::from_le_bytes`]
3089 - [`i32::from_ne_bytes`]
3090 - [`i64::to_be_bytes`]
3091 - [`i64::to_le_bytes`]
3092 - [`i64::to_ne_bytes`]
3093 - [`i64::from_be_bytes`]
3094 - [`i64::from_le_bytes`]
3095 - [`i64::from_ne_bytes`]
3096 - [`i128::to_be_bytes`]
3097 - [`i128::to_le_bytes`]
3098 - [`i128::to_ne_bytes`]
3099 - [`i128::from_be_bytes`]
3100 - [`i128::from_le_bytes`]
3101 - [`i128::from_ne_bytes`]
3102 - [`isize::to_be_bytes`]
3103 - [`isize::to_le_bytes`]
3104 - [`isize::to_ne_bytes`]
3105 - [`isize::from_be_bytes`]
3106 - [`isize::from_le_bytes`]
3107 - [`isize::from_ne_bytes`]
3108 - [`u8::to_be_bytes`]
3109 - [`u8::to_le_bytes`]
3110 - [`u8::to_ne_bytes`]
3111 - [`u8::from_be_bytes`]
3112 - [`u8::from_le_bytes`]
3113 - [`u8::from_ne_bytes`]
3114 - [`u16::to_be_bytes`]
3115 - [`u16::to_le_bytes`]
3116 - [`u16::to_ne_bytes`]
3117 - [`u16::from_be_bytes`]
3118 - [`u16::from_le_bytes`]
3119 - [`u16::from_ne_bytes`]
3120 - [`u32::to_be_bytes`]
3121 - [`u32::to_le_bytes`]
3122 - [`u32::to_ne_bytes`]
3123 - [`u32::from_be_bytes`]
3124 - [`u32::from_le_bytes`]
3125 - [`u32::from_ne_bytes`]
3126 - [`u64::to_be_bytes`]
3127 - [`u64::to_le_bytes`]
3128 - [`u64::to_ne_bytes`]
3129 - [`u64::from_be_bytes`]
3130 - [`u64::from_le_bytes`]
3131 - [`u64::from_ne_bytes`]
3132 - [`u128::to_be_bytes`]
3133 - [`u128::to_le_bytes`]
3134 - [`u128::to_ne_bytes`]
3135 - [`u128::from_be_bytes`]
3136 - [`u128::from_le_bytes`]
3137 - [`u128::from_ne_bytes`]
3138 - [`usize::to_be_bytes`]
3139 - [`usize::to_le_bytes`]
3140 - [`usize::to_ne_bytes`]
3141 - [`usize::from_be_bytes`]
3142 - [`usize::from_le_bytes`]
3143 - [`usize::from_ne_bytes`]
3144
3145 Cargo
3146 -----
3147 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
3148 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
3149
3150 Misc
3151 ----
3152 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
3153
3154 Compatibility Notes
3155 -------------------
3156 - [The argument types for AVX's
3157   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
3158   been changed from `*const` to `*mut` as the previous implementation
3159   was unsound.
3160
3161
3162 [55148]: https://github.com/rust-lang/rust/pull/55148/
3163 [55238]: https://github.com/rust-lang/rust/pull/55238/
3164 [55280]: https://github.com/rust-lang/rust/pull/55280/
3165 [55610]: https://github.com/rust-lang/rust/pull/55610/
3166 [55663]: https://github.com/rust-lang/rust/pull/55663/
3167 [55702]: https://github.com/rust-lang/rust/pull/55702/
3168 [55837]: https://github.com/rust-lang/rust/pull/55837/
3169 [55843]: https://github.com/rust-lang/rust/pull/55843/
3170 [56072]: https://github.com/rust-lang/rust/pull/56072/
3171 [56245]: https://github.com/rust-lang/rust/pull/56245/
3172 [56365]: https://github.com/rust-lang/rust/pull/56365/
3173 [56366]: https://github.com/rust-lang/rust/pull/56366/
3174 [56395]: https://github.com/rust-lang/rust/pull/56395/
3175 [56759]: https://github.com/rust-lang/rust/pull/56759/
3176 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
3177 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
3178 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
3179 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
3180 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
3181 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3182 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3183 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
3184 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
3185 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
3186 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
3187 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
3188 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
3189 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
3190 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
3191 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
3192 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
3193 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
3194 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
3195 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
3196 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
3197 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
3198 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
3199 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
3200 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
3201 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
3202 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
3203 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
3204 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
3205 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
3206 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
3207 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
3208 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
3209 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
3210 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
3211 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
3212 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
3213 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
3214 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
3215 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
3216 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
3217 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
3218 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
3219 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
3220 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
3221 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
3222 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
3223 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
3224 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
3225 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
3226 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
3227 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
3228 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
3229 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
3230 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
3231 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
3232 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
3233 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
3234 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
3235 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
3236 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
3237 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
3238 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
3239 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
3240 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
3241 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
3242 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
3243 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
3244 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
3245 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
3246 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
3247 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
3248 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
3249 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
3250 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
3251 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
3252 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
3253 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
3254 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
3255 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
3256 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
3257 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
3258 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
3259 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
3260 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
3261 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
3262 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
3263 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
3264 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
3265 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
3266 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
3267 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
3268 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
3269
3270
3271 Version 1.31.1 (2018-12-20)
3272 ===========================
3273
3274 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
3275 - [Fix broken go-to-definition in RLS][rls/1171]
3276 - [Fix infinite loop on hover in RLS][rls/1170]
3277
3278 [56562]: https://github.com/rust-lang/rust/pull/56562
3279 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
3280 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
3281
3282 Version 1.31.0 (2018-12-06)
3283 ==========================
3284
3285 Language
3286 --------
3287 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
3288 - [New lifetime elision rules now allow for eliding lifetimes in functions and
3289   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
3290   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
3291   in structs.
3292 - [You can now define and use `const` functions.][54835] These are currently
3293   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
3294   [language reference][const-reference] for what exactly is available.
3295 - [You can now use tool lints, which allow you to scope lints from external
3296   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
3297 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
3298   a crate, not just in exported functions.][54451]
3299 - [You can now use parentheses in pattern matches.][54497]
3300
3301 Compiler
3302 --------
3303 - [Updated musl to 1.1.20][54430]
3304
3305 Libraries
3306 ---------
3307 - [You can now convert `num::NonZero*` types to their raw equivalents using the
3308   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
3309 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
3310   into `Option<&mut T>` using the `From` trait.][53218]
3311 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
3312
3313
3314 Stabilized APIs
3315 ---------------
3316 - [`slice::align_to`]
3317 - [`slice::align_to_mut`]
3318 - [`slice::chunks_exact`]
3319 - [`slice::chunks_exact_mut`]
3320 - [`slice::rchunks`]
3321 - [`slice::rchunks_mut`]
3322 - [`slice::rchunks_exact`]
3323 - [`slice::rchunks_exact_mut`]
3324 - [`Option::replace`]
3325
3326 Cargo
3327 -----
3328 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
3329 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
3330   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
3331
3332 [52813]: https://github.com/rust-lang/rust/pull/52813/
3333 [53218]: https://github.com/rust-lang/rust/pull/53218/
3334 [53555]: https://github.com/rust-lang/rust/issues/53555/
3335 [54057]: https://github.com/rust-lang/rust/pull/54057/
3336 [54240]: https://github.com/rust-lang/rust/pull/54240/
3337 [54430]: https://github.com/rust-lang/rust/pull/54430/
3338 [54451]: https://github.com/rust-lang/rust/pull/54451/
3339 [54497]: https://github.com/rust-lang/rust/pull/54497/
3340 [54778]: https://github.com/rust-lang/rust/pull/54778/
3341 [54835]: https://github.com/rust-lang/rust/pull/54835/
3342 [54870]: https://github.com/rust-lang/rust/pull/54870/
3343 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
3344 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
3345 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
3346 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
3347 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
3348 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
3349 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3350 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
3351 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
3352 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
3353 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
3354 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
3355 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
3356 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
3357
3358 Version 1.30.1 (2018-11-08)
3359 ===========================
3360
3361 - [Fixed overflow ICE in rustdoc][54199]
3362 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
3363
3364 [54199]: https://github.com/rust-lang/rust/pull/54199
3365 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
3366
3367 Version 1.30.0 (2018-10-25)
3368 ==========================
3369
3370 Language
3371 --------
3372 - [Procedural macros are now available.][52081] These kinds of macros allow for
3373   more powerful code generation. There is a [new chapter available][proc-macros]
3374   in the Rust Programming Language book that goes further in depth.
3375 - [You can now use keywords as identifiers using the raw identifiers
3376   syntax (`r#`),][53236] e.g. `let r#for = true;`
3377 - [Using anonymous parameters in traits is now deprecated with a warning and
3378   will be a hard error in the 2018 edition.][53272]
3379 - [You can now use `crate` in paths.][54404] This allows you to refer to the
3380   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
3381 - [Using a external crate no longer requires being prefixed with `::`.][54404]
3382   Previously, using a external crate in a module without a use statement
3383   required `let json = ::serde_json::from_str(foo);` but can now be written
3384   as `let json = serde_json::from_str(foo);`.
3385 - [You can now apply the `#[used]` attribute to static items to prevent the
3386   compiler from optimising them away, even if they appear to be unused,][51363]
3387   e.g. `#[used] static FOO: u32 = 1;`
3388 - [You can now import and reexport macros from other crates with the `use`
3389   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
3390   the root module of the crate. If your macro relies on calling other local
3391   macros, it is recommended to export with the
3392   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
3393   those macros.
3394 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
3395   using the `vis` specifier.][53370]
3396 - [Non-macro attributes now allow all forms of literals, not just
3397   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
3398   write `#[attr(true)]`.
3399 - [You can now specify a function to handle a panic in the Rust runtime with the
3400   `#[panic_handler]` attribute.][51366]
3401
3402 Compiler
3403 --------
3404 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
3405 - [Added the `aarch64-unknown-netbsd` target][53165]
3406 - [Upgraded to LLVM 8.][53611]
3407
3408 Libraries
3409 ---------
3410 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
3411
3412 Stabilized APIs
3413 ---------------
3414 - [`Ipv4Addr::BROADCAST`]
3415 - [`Ipv4Addr::LOCALHOST`]
3416 - [`Ipv4Addr::UNSPECIFIED`]
3417 - [`Ipv6Addr::LOCALHOST`]
3418 - [`Ipv6Addr::UNSPECIFIED`]
3419 - [`Iterator::find_map`]
3420
3421   The following methods are replacement methods for `trim_left`, `trim_right`,
3422   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
3423   in 1.33.0:
3424 - [`str::trim_end_matches`]
3425 - [`str::trim_end`]
3426 - [`str::trim_start_matches`]
3427 - [`str::trim_start`]
3428
3429 Cargo
3430 ----
3431 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
3432 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
3433   equivalent to calling `rustdoc --error-format=json`.
3434 - [Cargo will now provide a progress bar for builds.][cargo/5995]
3435
3436 Misc
3437 ----
3438 - [`rustdoc` allows you to specify what edition to treat your code as with the
3439   `--edition` option.][54057]
3440 - [`rustdoc` now has the `--color` (specify whether to output color) and
3441   `--error-format` (specify error format, e.g. `json`) options.][53003]
3442 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
3443   debug symbols.][53774]
3444 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
3445   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
3446
3447 [50911]: https://github.com/rust-lang/rust/pull/50911/
3448 [51363]: https://github.com/rust-lang/rust/pull/51363/
3449 [51366]: https://github.com/rust-lang/rust/pull/51366/
3450 [52081]: https://github.com/rust-lang/rust/pull/52081/
3451 [53003]: https://github.com/rust-lang/rust/pull/53003/
3452 [53033]: https://github.com/rust-lang/rust/pull/53033/
3453 [53044]: https://github.com/rust-lang/rust/pull/53044/
3454 [53165]: https://github.com/rust-lang/rust/pull/53165/
3455 [53611]: https://github.com/rust-lang/rust/pull/53611/
3456 [53213]: https://github.com/rust-lang/rust/pull/53213/
3457 [53236]: https://github.com/rust-lang/rust/pull/53236/
3458 [53272]: https://github.com/rust-lang/rust/pull/53272/
3459 [53370]: https://github.com/rust-lang/rust/pull/53370/
3460 [53459]: https://github.com/rust-lang/rust/pull/53459/
3461 [53774]: https://github.com/rust-lang/rust/pull/53774/
3462 [53822]: https://github.com/rust-lang/rust/pull/53822/
3463 [54057]: https://github.com/rust-lang/rust/pull/54057/
3464 [54146]: https://github.com/rust-lang/rust/pull/54146/
3465 [54404]: https://github.com/rust-lang/rust/pull/54404/
3466 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
3467 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
3468 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
3469 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
3470
3471 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
3472 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
3473 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
3474 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
3475 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
3476 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
3477 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
3478 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
3479 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
3480 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
3481
3482
3483 Version 1.29.2 (2018-10-11)
3484 ===========================
3485
3486 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
3487 - The `rls-preview` component on the windows-gnu targets has been restored.
3488
3489 [54639]: https://github.com/rust-lang/rust/pull/54639
3490
3491
3492 Version 1.29.1 (2018-09-25)
3493 ===========================
3494
3495 Security Notes
3496 --------------
3497
3498 - The standard library's `str::repeat` function contained an out of bounds write
3499   caused by an integer overflow. This has been fixed by deterministically
3500   panicking when an overflow happens.
3501
3502   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
3503   us.
3504
3505
3506 Version 1.29.0 (2018-09-13)
3507 ==========================
3508
3509 Compiler
3510 --------
3511 - [Bumped minimum LLVM version to 5.0.][51899]
3512 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
3513 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
3514 - [Upgraded to LLVM 7.][51966]
3515
3516 Libraries
3517 ---------
3518 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
3519 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
3520 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
3521 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
3522   for `&str`.][51178]
3523 - [`Cell<T>` now allows `T` to be unsized.][50494]
3524 - [`SocketAddr` is now stable on Redox.][52656]
3525
3526 Stabilized APIs
3527 ---------------
3528 - [`Arc::downcast`]
3529 - [`Iterator::flatten`]
3530 - [`Rc::downcast`]
3531
3532 Cargo
3533 -----
3534 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
3535   `--locked` to disable this behavior.
3536 - [`cargo-install` will now allow you to cross compile an install
3537   using `--target`.][cargo/5614]
3538 - [Added the `cargo-fix` subcommand to automatically move project code from
3539   2015 edition to 2018.][cargo/5723]
3540 - [`cargo doc` can now optionally document private types using the
3541   `--document-private-items` flag.][cargo/5543]
3542
3543 Misc
3544 ----
3545 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
3546   the specified level to that level.][52354] For example `--cap-lints warn`
3547   will demote `deny` and `forbid` lints to `warn`.
3548 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
3549   fails and `101` if there is a panic.][52197]
3550 - [A preview of clippy has been made available through rustup.][51122]
3551   You can install the preview with `rustup component add clippy-preview`.
3552
3553 Compatibility Notes
3554 -------------------
3555 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
3556   Use `str::get_unchecked(begin..end)` instead.
3557 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
3558   Consider using the `home_dir` function from
3559   https://crates.io/crates/dirs instead.
3560 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
3561 - [`cfg` attributes and `--cfg` command line flags are now more
3562   strictly validated.][53893]
3563
3564 [53893]: https://github.com/rust-lang/rust/pull/53893/
3565 [52861]: https://github.com/rust-lang/rust/pull/52861/
3566 [51966]: https://github.com/rust-lang/rust/pull/51966/
3567 [52656]: https://github.com/rust-lang/rust/pull/52656/
3568 [52239]: https://github.com/rust-lang/rust/pull/52239/
3569 [52330]: https://github.com/rust-lang/rust/pull/52330/
3570 [52354]: https://github.com/rust-lang/rust/pull/52354/
3571 [52402]: https://github.com/rust-lang/rust/pull/52402/
3572 [52103]: https://github.com/rust-lang/rust/pull/52103/
3573 [52197]: https://github.com/rust-lang/rust/pull/52197/
3574 [51807]: https://github.com/rust-lang/rust/pull/51807/
3575 [51899]: https://github.com/rust-lang/rust/pull/51899/
3576 [51912]: https://github.com/rust-lang/rust/pull/51912/
3577 [51511]: https://github.com/rust-lang/rust/pull/51511/
3578 [51619]: https://github.com/rust-lang/rust/pull/51619/
3579 [51656]: https://github.com/rust-lang/rust/pull/51656/
3580 [51178]: https://github.com/rust-lang/rust/pull/51178/
3581 [51122]: https://github.com/rust-lang/rust/pull/51122
3582 [50494]: https://github.com/rust-lang/rust/pull/50494/
3583 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
3584 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
3585 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
3586 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
3587 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
3588 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
3589 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
3590
3591
3592 Version 1.28.0 (2018-08-02)
3593 ===========================
3594
3595 Language
3596 --------
3597 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
3598   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
3599   the inner type across Foreign Function Interface (FFI) boundaries.
3600 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
3601   and can now be used as identifiers.][51196]
3602 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
3603   stable.][51241] This will allow users to specify a global allocator for
3604   their program.
3605 - [Unit test functions marked with the `#[test]` attribute can now return
3606   `Result<(), E: Debug>` in addition to `()`.][51298]
3607 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
3608   allows macros to easily target lifetimes.
3609
3610 Compiler
3611 --------
3612 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
3613   prioritise making smaller binary sizes. `z` is the same as `s` with the
3614   exception that it does not vectorise loops, which typically results in an even
3615   smaller binary.
3616 - [The short error format is now stable.][49546] Specified with
3617   `--error-format=short` this option will provide a more compressed output of
3618   rust error messages.
3619 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
3620 - [Reduced the number of allocations in the macro parser.][50855] This can
3621   improve compile times of macro heavy crates on average by 5%.
3622
3623 Libraries
3624 ---------
3625 - [Implemented `Default` for `&mut str`.][51306]
3626 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
3627 - [Implemented `Extend` for `()`.][50234]
3628 - [The `Debug` implementation of `time::Duration` should now be more easily
3629   human readable.][50364] Previously a `Duration` of one second would printed as
3630   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
3631 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
3632   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
3633   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
3634   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
3635   for `PathBuf`.][50170]
3636 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
3637   and `Wrapping<i128>`.][50465]
3638 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
3639   possible.][51050] This can provide up to a 40% speed increase.
3640 - [Improved error messages when using `format!`.][50610]
3641
3642 Stabilized APIs
3643 ---------------
3644 - [`Iterator::step_by`]
3645 - [`Path::ancestors`]
3646 - [`SystemTime::UNIX_EPOCH`]
3647 - [`alloc::GlobalAlloc`]
3648 - [`alloc::Layout`]
3649 - [`alloc::LayoutErr`]
3650 - [`alloc::System`]
3651 - [`alloc::alloc`]
3652 - [`alloc::alloc_zeroed`]
3653 - [`alloc::dealloc`]
3654 - [`alloc::realloc`]
3655 - [`alloc::handle_alloc_error`]
3656 - [`btree_map::Entry::or_default`]
3657 - [`fmt::Alignment`]
3658 - [`hash_map::Entry::or_default`]
3659 - [`iter::repeat_with`]
3660 - [`num::NonZeroUsize`]
3661 - [`num::NonZeroU128`]
3662 - [`num::NonZeroU16`]
3663 - [`num::NonZeroU32`]
3664 - [`num::NonZeroU64`]
3665 - [`num::NonZeroU8`]
3666 - [`ops::RangeBounds`]
3667 - [`slice::SliceIndex`]
3668 - [`slice::from_mut`]
3669 - [`slice::from_ref`]
3670 - [`{Any + Send + Sync}::downcast_mut`]
3671 - [`{Any + Send + Sync}::downcast_ref`]
3672 - [`{Any + Send + Sync}::is`]
3673
3674 Cargo
3675 -----
3676 - [Cargo will now no longer allow you to publish crates with build scripts that
3677   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
3678   considered to be immutable.
3679
3680 Misc
3681 ----
3682 - [The `suggestion_applicability` field in `rustc`'s json output is now
3683   stable.][50486] This will allow dev tools to check whether a code suggestion
3684   would apply to them.
3685
3686 Compatibility Notes
3687 -------------------
3688 - [Rust will consider trait objects with duplicated constraints to be the same
3689   type as without the duplicated constraint.][51276] For example the below code will
3690   now fail to compile.
3691   ```rust
3692   trait Trait {}
3693
3694   impl Trait + Send {
3695       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
3696   }
3697
3698   impl Trait + Send + Send {
3699       fn test(&self) { println!("two"); }
3700   }
3701   ```
3702
3703 [49546]: https://github.com/rust-lang/rust/pull/49546/
3704 [50143]: https://github.com/rust-lang/rust/pull/50143/
3705 [50170]: https://github.com/rust-lang/rust/pull/50170/
3706 [50234]: https://github.com/rust-lang/rust/pull/50234/
3707 [50265]: https://github.com/rust-lang/rust/pull/50265/
3708 [50364]: https://github.com/rust-lang/rust/pull/50364/
3709 [50385]: https://github.com/rust-lang/rust/pull/50385/
3710 [50465]: https://github.com/rust-lang/rust/pull/50465/
3711 [50486]: https://github.com/rust-lang/rust/pull/50486/
3712 [50554]: https://github.com/rust-lang/rust/pull/50554/
3713 [50610]: https://github.com/rust-lang/rust/pull/50610/
3714 [50855]: https://github.com/rust-lang/rust/pull/50855/
3715 [51050]: https://github.com/rust-lang/rust/pull/51050/
3716 [51196]: https://github.com/rust-lang/rust/pull/51196/
3717 [51200]: https://github.com/rust-lang/rust/pull/51200/
3718 [51241]: https://github.com/rust-lang/rust/pull/51241/
3719 [51276]: https://github.com/rust-lang/rust/pull/51276/
3720 [51298]: https://github.com/rust-lang/rust/pull/51298/
3721 [51306]: https://github.com/rust-lang/rust/pull/51306/
3722 [51562]: https://github.com/rust-lang/rust/pull/51562/
3723 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
3724 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
3725 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
3726 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
3727 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
3728 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
3729 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
3730 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
3731 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
3732 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
3733 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
3734 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
3735 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
3736 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
3737 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
3738 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
3739 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
3740 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
3741 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
3742 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
3743 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
3744 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
3745 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
3746 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
3747 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
3748 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
3749 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
3750 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
3751 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
3752 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
3753
3754 Version 1.27.2 (2018-07-20)
3755 ===========================
3756
3757 Compatibility Notes
3758 -------------------
3759
3760 - The borrow checker was fixed to avoid potential unsoundness when using
3761   match ergonomics: [#52213][52213].
3762
3763 [52213]: https://github.com/rust-lang/rust/issues/52213
3764
3765 Version 1.27.1 (2018-07-10)
3766 ===========================
3767
3768 Security Notes
3769 --------------
3770
3771 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
3772   when running, which enabled executing code as some other user on a
3773   given machine. This release fixes that vulnerability; you can read
3774   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
3775
3776   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
3777
3778 Compatibility Notes
3779 -------------------
3780
3781 - The borrow checker was fixed to avoid an additional potential unsoundness when using
3782   match ergonomics: [#51415][51415], [#49534][49534].
3783
3784 [51415]: https://github.com/rust-lang/rust/issues/51415
3785 [49534]: https://github.com/rust-lang/rust/issues/49534
3786 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
3787 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
3788
3789 Version 1.27.0 (2018-06-21)
3790 ==========================
3791
3792 Language
3793 --------
3794 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
3795   be used as an identifier.
3796 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
3797   bare `Trait` syntax, and should make it clearer when being used in tandem with
3798   `impl Trait` because it is equivalent to the following syntax:
3799   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
3800   `Box<Trait> == Box<dyn Trait>`.
3801 - [Attributes on generic parameters such as types and lifetimes are
3802   now stable.][48851] e.g.
3803   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
3804 - [The `#[must_use]` attribute can now also be used on functions as well as
3805   types.][48925] It provides a lint that by default warns users when the
3806   value returned by a function has not been used.
3807
3808 Compiler
3809 --------
3810 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
3811
3812 Libraries
3813 ---------
3814 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
3815   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
3816   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
3817   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
3818   the `cfg` attribute.
3819 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
3820   std are now available in core.][49896]
3821 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
3822   to `Self`.][49630]
3823 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
3824   that the operation isn't done in place.
3825 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
3826   the `#[must_use]` attribute][49533] to warn about unused potentially
3827   expensive allocations.
3828
3829 Stabilized APIs
3830 ---------------
3831 - [`DoubleEndedIterator::rfind`]
3832 - [`DoubleEndedIterator::rfold`]
3833 - [`DoubleEndedIterator::try_rfold`]
3834 - [`Duration::from_micros`]
3835 - [`Duration::from_nanos`]
3836 - [`Duration::subsec_micros`]
3837 - [`Duration::subsec_millis`]
3838 - [`HashMap::remove_entry`]
3839 - [`Iterator::try_fold`]
3840 - [`Iterator::try_for_each`]
3841 - [`NonNull::cast`]
3842 - [`Option::filter`]
3843 - [`String::replace_range`]
3844 - [`Take::set_limit`]
3845 - [`hint::unreachable_unchecked`]
3846 - [`os::unix::process::parent_id`]
3847 - [`ptr::swap_nonoverlapping`]
3848 - [`slice::rsplit_mut`]
3849 - [`slice::rsplit`]
3850 - [`slice::swap_with_slice`]
3851
3852 Cargo
3853 -----
3854 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
3855   `readme`, and `repository` fields.][cargo/5386]
3856 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
3857 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
3858   a different directory than `target` for placing compilation artifacts.
3859 - [Cargo will be adding automatic target inference for binaries, benchmarks,
3860   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
3861   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
3862   where cargo would infer a binary, Cargo will produce a warning. You can
3863   disable this feature ahead of time by setting any of the following to false:
3864   `autobins`, `autobenches`, `autoexamples`, `autotests`.
3865 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
3866   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
3867
3868 Misc
3869 ----
3870 - [Added “The Rustc book” into the official documentation.][49707]
3871   [“The Rustc book”] documents and teaches how to use the rustc compiler.
3872 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
3873
3874 Compatibility Notes
3875 -------------------
3876 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
3877   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
3878   compile, `"".is_empty()` will still compile.
3879 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
3880   will only print the inner type.][48553] E.g.
3881   `print!("{:?}", AtomicBool::new(true))` will print `true`,
3882   not `AtomicBool(true)`.
3883 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
3884   could enter higher numbers but they were not supported by LLVM. Up to 512MB
3885   alignment should cover all use cases.
3886 - The `.description()` method on the `std::error::Error` trait
3887   [has been soft-deprecated][50163]. It is no longer required to implement it.
3888
3889 [48553]: https://github.com/rust-lang/rust/pull/48553/
3890 [48851]: https://github.com/rust-lang/rust/pull/48851/
3891 [48925]: https://github.com/rust-lang/rust/pull/48925/
3892 [49533]: https://github.com/rust-lang/rust/pull/49533/
3893 [49623]: https://github.com/rust-lang/rust/pull/49623/
3894 [49630]: https://github.com/rust-lang/rust/pull/49630/
3895 [49664]: https://github.com/rust-lang/rust/pull/49664/
3896 [49699]: https://github.com/rust-lang/rust/pull/49699/
3897 [49707]: https://github.com/rust-lang/rust/pull/49707/
3898 [49719]: https://github.com/rust-lang/rust/pull/49719/
3899 [49896]: https://github.com/rust-lang/rust/pull/49896/
3900 [49968]: https://github.com/rust-lang/rust/pull/49968/
3901 [50163]: https://github.com/rust-lang/rust/pull/50163
3902 [50177]: https://github.com/rust-lang/rust/pull/50177/
3903 [50378]: https://github.com/rust-lang/rust/pull/50378/
3904 [50398]: https://github.com/rust-lang/rust/pull/50398/
3905 [50423]: https://github.com/rust-lang/rust/pull/50423/
3906 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
3907 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
3908 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
3909 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
3910 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
3911 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
3912 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
3913 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
3914 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
3915 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
3916 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
3917 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
3918 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
3919 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
3920 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
3921 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
3922 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
3923 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
3924 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
3925 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
3926 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
3927 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
3928 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
3929 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
3930 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
3931 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
3932 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
3933 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
3934 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
3935 [“The Rustc book”]: https://doc.rust-lang.org/rustc
3936
3937
3938 Version 1.26.2 (2018-06-05)
3939 ==========================
3940
3941 Compatibility Notes
3942 -------------------
3943
3944 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
3945
3946 [51117]: https://github.com/rust-lang/rust/issues/51117
3947
3948
3949 Version 1.26.1 (2018-05-29)
3950 ==========================
3951
3952 Tools
3953 -----
3954
3955 - [RLS now works on Windows.][50646]
3956 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
3957
3958
3959 Compatibility Notes
3960 --------
3961
3962 - [`fn main() -> impl Trait` no longer works for non-Termination
3963   trait.][50656]
3964   This reverts an accidental stabilization.
3965 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
3966 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
3967
3968 [50646]: https://github.com/rust-lang/rust/issues/50646
3969 [50656]: https://github.com/rust-lang/rust/pull/50656
3970 [50812]: https://github.com/rust-lang/rust/pull/50812
3971 [50950]: https://github.com/rust-lang/rust/issues/50950
3972 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
3973
3974 Version 1.26.0 (2018-05-10)
3975 ==========================
3976
3977 Language
3978 --------
3979 - [Closures now implement `Copy` and/or `Clone` if all captured variables
3980   implement either or both traits.][49299]
3981 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
3982 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
3983   lifetime can be elided.][49458]
3984 - [`impl Trait` is now stable allowing you to have abstract types in returns
3985    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
3986   `fn open(path: impl AsRef<Path>)`.
3987 - [Pattern matching will now automatically apply dereferences.][49394]
3988 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
3989 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
3990 - [A lot of operations are now available in a const context.][46882] E.g. You
3991   can now index into constant arrays, reference and dereference into constants,
3992   and use tuple struct constructors.
3993 - [Fixed entry slice patterns are now stable.][48516] E.g.
3994   ```rust
3995   let points = [1, 2, 3, 4];
3996   match points {
3997       [1, 2, 3, 4] => println!("All points were sequential."),
3998       _ => println!("Not all points were sequential."),
3999   }
4000   ```
4001
4002
4003 Compiler
4004 --------
4005 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
4006 - [Fixed exponential projection complexity on nested types.][48296]
4007   This can provide up to a ~12% reduction in compile times for certain crates.
4008 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
4009   to remap path prefixes outputted by the compiler.
4010 - [Added `powerpc-unknown-netbsd` target.][48281]
4011
4012 Libraries
4013 ---------
4014 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
4015 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
4016   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
4017 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
4018 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
4019 - [`ascii::escape_default` is now available in libcore.][48735]
4020 - [Trailing commas are now supported in std and core macros.][48056]
4021 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
4022 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
4023
4024 Stabilized APIs
4025 ---------------
4026 - [`*const T::add`]
4027 - [`*const T::copy_to_nonoverlapping`]
4028 - [`*const T::copy_to`]
4029 - [`*const T::read_unaligned`]
4030 - [`*const T::read_volatile`]
4031 - [`*const T::read`]
4032 - [`*const T::sub`]
4033 - [`*const T::wrapping_add`]
4034 - [`*const T::wrapping_sub`]
4035 - [`*mut T::add`]
4036 - [`*mut T::copy_to_nonoverlapping`]
4037 - [`*mut T::copy_to`]
4038 - [`*mut T::read_unaligned`]
4039 - [`*mut T::read_volatile`]
4040 - [`*mut T::read`]
4041 - [`*mut T::replace`]
4042 - [`*mut T::sub`]
4043 - [`*mut T::swap`]
4044 - [`*mut T::wrapping_add`]
4045 - [`*mut T::wrapping_sub`]
4046 - [`*mut T::write_bytes`]
4047 - [`*mut T::write_unaligned`]
4048 - [`*mut T::write_volatile`]
4049 - [`*mut T::write`]
4050 - [`Box::leak`]
4051 - [`FromUtf8Error::as_bytes`]
4052 - [`LocalKey::try_with`]
4053 - [`Option::cloned`]
4054 - [`btree_map::Entry::and_modify`]
4055 - [`fs::read_to_string`]
4056 - [`fs::read`]
4057 - [`fs::write`]
4058 - [`hash_map::Entry::and_modify`]
4059 - [`iter::FusedIterator`]
4060 - [`ops::RangeInclusive`]
4061 - [`ops::RangeToInclusive`]
4062 - [`process::id`]
4063 - [`slice::rotate_left`]
4064 - [`slice::rotate_right`]
4065 - [`String::retain`]
4066
4067
4068 Cargo
4069 -----
4070 - [Cargo will now output path to custom commands when `-v` is
4071   passed with `--list`][cargo/5041]
4072 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
4073
4074 Misc
4075 ----
4076 - [The second edition of "The Rust Programming Language" book is now recommended
4077   over the first.][48404]
4078
4079 Compatibility Notes
4080 -------------------
4081
4082 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
4083   syntax is now invalid.
4084   ```
4085   use std::ops::Fn as dyn;
4086   fn g(_: Box<dyn(std::fmt::Debug)>) {}
4087   ```
4088 - [The result of dereferences are no longer promoted to `'static`.][47408]
4089   e.g.
4090   ```rust
4091   fn main() {
4092       const PAIR: &(i32, i32) = &(0, 1);
4093       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
4094   }
4095   ```
4096 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
4097 - [`".e0"` will now no longer parse as `0.0` and will instead cause
4098   an error.][48235]
4099 - [Removed hoedown from rustdoc.][48274]
4100 - [Bounds on higher-kinded lifetimes a hard error.][48326]
4101
4102 [46882]: https://github.com/rust-lang/rust/pull/46882
4103 [47379]: https://github.com/rust-lang/rust/pull/47379
4104 [47408]: https://github.com/rust-lang/rust/pull/47408
4105 [47813]: https://github.com/rust-lang/rust/pull/47813
4106 [48056]: https://github.com/rust-lang/rust/pull/48056
4107 [48125]: https://github.com/rust-lang/rust/pull/48125
4108 [48166]: https://github.com/rust-lang/rust/pull/48166
4109 [48235]: https://github.com/rust-lang/rust/pull/48235
4110 [48274]: https://github.com/rust-lang/rust/pull/48274
4111 [48281]: https://github.com/rust-lang/rust/pull/48281
4112 [48296]: https://github.com/rust-lang/rust/pull/48296
4113 [48326]: https://github.com/rust-lang/rust/pull/48326
4114 [48359]: https://github.com/rust-lang/rust/pull/48359
4115 [48404]: https://github.com/rust-lang/rust/pull/48404
4116 [48481]: https://github.com/rust-lang/rust/pull/48481
4117 [48516]: https://github.com/rust-lang/rust/pull/48516
4118 [48628]: https://github.com/rust-lang/rust/pull/48628
4119 [48629]: https://github.com/rust-lang/rust/pull/48629
4120 [48657]: https://github.com/rust-lang/rust/pull/48657
4121 [48735]: https://github.com/rust-lang/rust/pull/48735
4122 [48978]: https://github.com/rust-lang/rust/pull/48978
4123 [49101]: https://github.com/rust-lang/rust/pull/49101
4124 [49109]: https://github.com/rust-lang/rust/pull/49109
4125 [49121]: https://github.com/rust-lang/rust/pull/49121
4126 [49162]: https://github.com/rust-lang/rust/pull/49162
4127 [49184]: https://github.com/rust-lang/rust/pull/49184
4128 [49234]: https://github.com/rust-lang/rust/pull/49234
4129 [49255]: https://github.com/rust-lang/rust/pull/49255
4130 [49299]: https://github.com/rust-lang/rust/pull/49299
4131 [49305]: https://github.com/rust-lang/rust/pull/49305
4132 [49394]: https://github.com/rust-lang/rust/pull/49394
4133 [49458]: https://github.com/rust-lang/rust/pull/49458
4134 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
4135 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
4136 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
4137 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
4138 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
4139 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
4140 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
4141 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
4142 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
4143 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
4144 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
4145 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
4146 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
4147 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
4148 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
4149 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
4150 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
4151 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
4152 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
4153 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
4154 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
4155 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
4156 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
4157 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
4158 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
4159 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
4160 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
4161 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
4162 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
4163 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
4164 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
4165 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
4166 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
4167 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
4168 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
4169 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
4170 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
4171 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
4172 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
4173 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
4174 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
4175 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
4176
4177
4178 Version 1.25.0 (2018-03-29)
4179 ==========================
4180
4181 Language
4182 --------
4183 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
4184 - [You can now use nested groups of imports.][47948]
4185   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
4186 - [You can now have `|` at the start of a match arm.][47947] e.g.
4187 ```rust
4188 enum Foo { A, B, C }
4189
4190 fn main() {
4191     let x = Foo::A;
4192     match x {
4193         | Foo::A
4194         | Foo::B => println!("AB"),
4195         | Foo::C => println!("C"),
4196     }
4197 }
4198 ```
4199
4200 Compiler
4201 --------
4202 - [Upgraded to LLVM 6.][47828]
4203 - [Added `-C lto=val` option.][47521]
4204 - [Added `i586-unknown-linux-musl` target][47282]
4205
4206 Libraries
4207 ---------
4208 - [Impl Send for `process::Command` on Unix.][47760]
4209 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
4210 - [`UnsafeCell::into_inner` is now safe.][47204]
4211 - [Implement libstd for CloudABI.][47268]
4212 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
4213 - [Implement `AsRef<Path>` for Component][46985]
4214 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
4215 - [Moved `Duration` to libcore.][46666]
4216
4217 Stabilized APIs
4218 ---------------
4219 - [`Location::column`]
4220 - [`ptr::NonNull`]
4221
4222 The following functions can now be used in a constant expression.
4223 eg. `static MINUTE: Duration = Duration::from_secs(60);`
4224 - [`Duration::new`][47300]
4225 - [`Duration::from_secs`][47300]
4226 - [`Duration::from_millis`][47300]
4227
4228 Cargo
4229 -----
4230 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
4231 - [`cargo new` now defaults to creating a binary crate, instead of a
4232   library crate.][cargo/5029]
4233
4234 Misc
4235 ----
4236 - [Rust by example is now shipped with new releases][46196]
4237
4238 Compatibility Notes
4239 -------------------
4240 - [Deprecated `net::lookup_host`.][47510]
4241 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
4242 - The borrow checker was sometimes incorrectly permitting overlapping borrows
4243   around indexing operations (see [#47349][47349]). This has been fixed (which also
4244   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
4245 - [Removed deprecated unstable attribute `#[simd]`.][47251]
4246
4247 [33903]: https://github.com/rust-lang/rust/pull/33903
4248 [47947]: https://github.com/rust-lang/rust/pull/47947
4249 [47948]: https://github.com/rust-lang/rust/pull/47948
4250 [47760]: https://github.com/rust-lang/rust/pull/47760
4251 [47790]: https://github.com/rust-lang/rust/pull/47790
4252 [47828]: https://github.com/rust-lang/rust/pull/47828
4253 [47398]: https://github.com/rust-lang/rust/pull/47398
4254 [47510]: https://github.com/rust-lang/rust/pull/47510
4255 [47521]: https://github.com/rust-lang/rust/pull/47521
4256 [47204]: https://github.com/rust-lang/rust/pull/47204
4257 [47251]: https://github.com/rust-lang/rust/pull/47251
4258 [47268]: https://github.com/rust-lang/rust/pull/47268
4259 [47282]: https://github.com/rust-lang/rust/pull/47282
4260 [47300]: https://github.com/rust-lang/rust/pull/47300
4261 [47349]: https://github.com/rust-lang/rust/pull/47349
4262 [46931]: https://github.com/rust-lang/rust/pull/46931
4263 [46985]: https://github.com/rust-lang/rust/pull/46985
4264 [47006]: https://github.com/rust-lang/rust/pull/47006
4265 [46830]: https://github.com/rust-lang/rust/pull/46830
4266 [46095]: https://github.com/rust-lang/rust/pull/46095
4267 [46666]: https://github.com/rust-lang/rust/pull/46666
4268 [46196]: https://github.com/rust-lang/rust/pull/46196
4269 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
4270 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
4271 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
4272 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
4273 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
4274
4275
4276 Version 1.24.1 (2018-03-01)
4277 ==========================
4278
4279  - [Do not abort when unwinding through FFI][48251]
4280  - [Emit UTF-16 files for linker arguments on Windows][48318]
4281  - [Make the error index generator work again][48308]
4282  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
4283
4284 [48251]: https://github.com/rust-lang/rust/issues/48251
4285 [48308]: https://github.com/rust-lang/rust/issues/48308
4286 [48318]: https://github.com/rust-lang/rust/issues/48318
4287 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
4288
4289
4290 Version 1.24.0 (2018-02-15)
4291 ==========================
4292
4293 Language
4294 --------
4295 - [External `sysv64` ffi is now available.][46528]
4296   eg. `extern "sysv64" fn foo () {}`
4297
4298 Compiler
4299 --------
4300 - [rustc now uses 16 codegen units by default for release builds.][46910]
4301   For the fastest builds, utilize `codegen-units=1`.
4302 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
4303 - [Add `aarch64-unknown-openbsd` support][46760]
4304
4305 Libraries
4306 ---------
4307 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
4308   improvement in performance in the majority of cases.
4309 - [`OsStr`'s `Debug` implementation is now lossless and consistent
4310   with Windows.][46798]
4311 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
4312 - [impl `From<bool>` for `AtomicBool`][46293]
4313 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
4314 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
4315 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
4316 - [float::from_bits now just uses transmute.][46012] This provides
4317   some optimisations from LLVM.
4318 - [Copied `AsciiExt` methods onto `char`][46077]
4319 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
4320 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
4321 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
4322 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
4323
4324 Stabilized APIs
4325 ---------------
4326 - [`RefCell::replace`]
4327 - [`RefCell::swap`]
4328 - [`atomic::spin_loop_hint`]
4329
4330 The following functions can now be used in a constant expression.
4331 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
4332
4333 - [`AtomicBool::new`][46287]
4334 - [`AtomicUsize::new`][46287]
4335 - [`AtomicIsize::new`][46287]
4336 - [`AtomicPtr::new`][46287]
4337 - [`Cell::new`][46287]
4338 - [`{integer}::min_value`][46287]
4339 - [`{integer}::max_value`][46287]
4340 - [`mem::size_of`][46287]
4341 - [`mem::align_of`][46287]
4342 - [`ptr::null`][46287]
4343 - [`ptr::null_mut`][46287]
4344 - [`RefCell::new`][46287]
4345 - [`UnsafeCell::new`][46287]
4346
4347 Cargo
4348 -----
4349 - [Added a `workspace.default-members` config that
4350   overrides implied `--all` in virtual workspaces.][cargo/4743]
4351 - [Enable incremental by default on development builds.][cargo/4817] Also added
4352   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
4353   per-project or global basis respectively.
4354
4355 Misc
4356 ----
4357
4358 Compatibility Notes
4359 -------------------
4360 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
4361 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
4362   in accordance with IETF RFC 4291 §2.2.
4363 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
4364 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
4365   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
4366 - [Leading zeros in tuple struct members is now an error][47084]
4367 - [`column!()` macro is one-based instead of zero-based][46977]
4368 - [`fmt::Arguments` can no longer be shared across threads][45198]
4369 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
4370 - [Cargo sets a different working directory for the compiler][cargo/4788]
4371
4372 [44884]: https://github.com/rust-lang/rust/pull/44884
4373 [45198]: https://github.com/rust-lang/rust/pull/45198
4374 [45506]: https://github.com/rust-lang/rust/pull/45506
4375 [45904]: https://github.com/rust-lang/rust/pull/45904
4376 [45990]: https://github.com/rust-lang/rust/pull/45990
4377 [46012]: https://github.com/rust-lang/rust/pull/46012
4378 [46077]: https://github.com/rust-lang/rust/pull/46077
4379 [46094]: https://github.com/rust-lang/rust/pull/46094
4380 [46284]: https://github.com/rust-lang/rust/pull/46284
4381 [46287]: https://github.com/rust-lang/rust/pull/46287
4382 [46293]: https://github.com/rust-lang/rust/pull/46293
4383 [46528]: https://github.com/rust-lang/rust/pull/46528
4384 [46671]: https://github.com/rust-lang/rust/pull/46671
4385 [46713]: https://github.com/rust-lang/rust/pull/46713
4386 [46735]: https://github.com/rust-lang/rust/pull/46735
4387 [46749]: https://github.com/rust-lang/rust/pull/46749
4388 [46760]: https://github.com/rust-lang/rust/pull/46760
4389 [46798]: https://github.com/rust-lang/rust/pull/46798
4390 [46828]: https://github.com/rust-lang/rust/pull/46828
4391 [46831]: https://github.com/rust-lang/rust/pull/46831
4392 [46833]: https://github.com/rust-lang/rust/pull/46833
4393 [46910]: https://github.com/rust-lang/rust/pull/46910
4394 [46977]: https://github.com/rust-lang/rust/pull/46977
4395 [47018]: https://github.com/rust-lang/rust/pull/47018
4396 [47080]: https://github.com/rust-lang/rust/pull/47080
4397 [47084]: https://github.com/rust-lang/rust/pull/47084
4398 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
4399 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
4400 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
4401 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
4402 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
4403 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
4404
4405
4406 Version 1.23.0 (2018-01-04)
4407 ==========================
4408
4409 Language
4410 --------
4411 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
4412 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
4413   Which should fix some confusing errors in some operations.
4414
4415 Compiler
4416 --------
4417 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
4418   undefined behavior.][45920]
4419 - [rustc now suggests renaming import if names clash.][45660]
4420 - [Display errors/warnings correctly when there are zero-width or
4421   wide characters.][45711]
4422 - [rustc now avoids unnecessary copies of arguments that are
4423   simple bindings][45380] This should improve memory usage on average by 5-10%.
4424 - [Updated musl used to build musl rustc to 1.1.17][45393]
4425
4426 Libraries
4427 ---------
4428 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
4429 - [Implement Hash for raw pointers to unsized types][45483]
4430 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
4431 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
4432 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
4433 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
4434   and `<*mut T>::as_mut`][44932]
4435 - [Optimized `Thread::{park, unpark}` implementation][45524]
4436 - [Improved `SliceExt::binary_search` performance.][45333]
4437 - [impl `FromIterator<()>` for `()`][45379]
4438 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
4439   is now deprecated.
4440
4441 Stabilized APIs
4442 ---------------
4443
4444 Cargo
4445 -----
4446 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
4447   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
4448 - [Added unit test checking to `cargo check`][cargo/4592]
4449 - [Cargo now lets you install a specific version
4450   using `cargo install --version`][cargo/4637]
4451
4452 Misc
4453 ----
4454 - [Releases now ship with the Cargo book documentation.][45692]
4455 - [rustdoc now prints rendering warnings on every run.][45324]
4456
4457 Compatibility Notes
4458 -------------------
4459 - [Changes have been made to type equality to make it more correct,
4460   in rare cases this could break some code.][45853] [Tracking issue for
4461   further information][45852]
4462 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
4463 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
4464   Android 9, the minimum supported version is Android 14.
4465 - [Bumped the minimum LLVM to 3.9][45326]
4466
4467 [44042]: https://github.com/rust-lang/rust/pull/44042
4468 [44932]: https://github.com/rust-lang/rust/pull/44932
4469 [45267]: https://github.com/rust-lang/rust/pull/45267
4470 [45324]: https://github.com/rust-lang/rust/pull/45324
4471 [45326]: https://github.com/rust-lang/rust/pull/45326
4472 [45333]: https://github.com/rust-lang/rust/pull/45333
4473 [45379]: https://github.com/rust-lang/rust/pull/45379
4474 [45380]: https://github.com/rust-lang/rust/pull/45380
4475 [45393]: https://github.com/rust-lang/rust/pull/45393
4476 [45435]: https://github.com/rust-lang/rust/pull/45435
4477 [45483]: https://github.com/rust-lang/rust/pull/45483
4478 [45524]: https://github.com/rust-lang/rust/pull/45524
4479 [45571]: https://github.com/rust-lang/rust/pull/45571
4480 [45580]: https://github.com/rust-lang/rust/pull/45580
4481 [45610]: https://github.com/rust-lang/rust/pull/45610
4482 [45660]: https://github.com/rust-lang/rust/pull/45660
4483 [45692]: https://github.com/rust-lang/rust/pull/45692
4484 [45711]: https://github.com/rust-lang/rust/pull/45711
4485 [45772]: https://github.com/rust-lang/rust/pull/45772
4486 [45852]: https://github.com/rust-lang/rust/issues/45852
4487 [45853]: https://github.com/rust-lang/rust/pull/45853
4488 [45887]: https://github.com/rust-lang/rust/pull/45887
4489 [45920]: https://github.com/rust-lang/rust/pull/45920
4490 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
4491 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
4492 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
4493
4494
4495 Version 1.22.1 (2017-11-22)
4496 ==========================
4497
4498 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
4499
4500 [46183]: https://github.com/rust-lang/rust/pull/46183
4501
4502 Version 1.22.0 (2017-11-22)
4503 ==========================
4504
4505 Language
4506 --------
4507 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
4508 - [Now accepts underscores in unicode escapes][43716]
4509 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
4510 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
4511
4512 Compiler
4513 --------
4514 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
4515 - [rustc will no longer inline in codegen units when compiling for debug][45075]
4516   This should decrease compile times for debug builds.
4517 - [strict memory alignment now enabled on ARMv6][45094]
4518 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
4519
4520 Libraries
4521 ---------
4522 - [Allow atomic operations up to 32 bits
4523   on `armv5te_unknown_linux_gnueabi`][44978]
4524 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
4525 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
4526 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
4527 - [Properly detect overflow in `Instant += Duration`.][44220]
4528 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
4529 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
4530 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
4531
4532 Stabilized APIs
4533 ---------------
4534
4535 Cargo
4536 -----
4537 - [Cargo will now build multi file examples in subdirectories of the `examples`
4538   folder that have a `main.rs` file.][cargo/4496]
4539 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
4540   the old format will continue to work and can be updated with `cargo update`.
4541 - [Now supports vendoring git repositories][cargo/3992]
4542
4543 Misc
4544 ----
4545 - [`libbacktrace` is now available on Apple platforms.][44251]
4546 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
4547   This now lets you specify that a given code example will fail to compile.
4548
4549 Compatibility Notes
4550 -------------------
4551 - [The minimum Android version that rustc can build for has been bumped
4552   to `4.0` from `2.3`][45656]
4553 - [Allowing `T op= &T` for numeric types has broken some type
4554   inference cases][45480]
4555
4556
4557 [42526]: https://github.com/rust-lang/rust/pull/42526
4558 [43017]: https://github.com/rust-lang/rust/pull/43017
4559 [43716]: https://github.com/rust-lang/rust/pull/43716
4560 [43949]: https://github.com/rust-lang/rust/pull/43949
4561 [44015]: https://github.com/rust-lang/rust/pull/44015
4562 [44220]: https://github.com/rust-lang/rust/pull/44220
4563 [44251]: https://github.com/rust-lang/rust/pull/44251
4564 [44287]: https://github.com/rust-lang/rust/pull/44287
4565 [44303]: https://github.com/rust-lang/rust/pull/44303
4566 [44456]: https://github.com/rust-lang/rust/pull/44456
4567 [44466]: https://github.com/rust-lang/rust/pull/44466
4568 [44895]: https://github.com/rust-lang/rust/pull/44895
4569 [44966]: https://github.com/rust-lang/rust/pull/44966
4570 [44978]: https://github.com/rust-lang/rust/pull/44978
4571 [45041]: https://github.com/rust-lang/rust/pull/45041
4572 [45064]: https://github.com/rust-lang/rust/pull/45064
4573 [45075]: https://github.com/rust-lang/rust/pull/45075
4574 [45094]: https://github.com/rust-lang/rust/pull/45094
4575 [45095]: https://github.com/rust-lang/rust/pull/45095
4576 [45480]: https://github.com/rust-lang/rust/issues/45480
4577 [45656]: https://github.com/rust-lang/rust/pull/45656
4578 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
4579 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
4580 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
4581
4582
4583
4584
4585
4586
4587 Version 1.21.0 (2017-10-12)
4588 ==========================
4589
4590 Language
4591 --------
4592 - [You can now use static references for literals.][43838]
4593   Example:
4594   ```rust
4595   fn main() {
4596       let x: &'static u32 = &0;
4597   }
4598   ```
4599 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
4600   Example:
4601   ```rust
4602   my_macro!(Vec<i32>::new); // Always worked
4603   my_macro!(Vec::<i32>::new); // Now works
4604   ```
4605
4606 Compiler
4607 --------
4608 - [Upgraded jemalloc to 4.5.0][43911]
4609 - [Enabled unwinding panics on Redox][43917]
4610 - [Now runs LLVM in parallel during translation phase.][43506]
4611   This should reduce peak memory usage.
4612
4613 Libraries
4614 ---------
4615 - [Generate builtin impls for `Clone` for all arrays and tuples that
4616   are `T: Clone`][43690]
4617 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
4618 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
4619   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
4620
4621 Stabilized APIs
4622 ---------------
4623
4624 [`std::mem::discriminant`]
4625
4626 Cargo
4627 -----
4628 - [You can now call `cargo install` with multiple package names][cargo/4216]
4629 - [Cargo commands inside a virtual workspace will now implicitly
4630   pass `--all`][cargo/4335]
4631 - [Added a `[patch]` section to `Cargo.toml` to handle
4632   prepublication dependencies][cargo/4123] [RFC 1969]
4633 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
4634   like patterns][cargo/4270]
4635 - [Added the `--all-targets` option][cargo/4400]
4636 - [Using required dependencies as a feature is now deprecated and emits
4637   a warning][cargo/4364]
4638
4639
4640 Misc
4641 ----
4642 - [Cargo docs are moving][43916]
4643   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
4644 - [The rustdoc book is now available][43863]
4645   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
4646 - [Added a preview of RLS has been made available through rustup][44204]
4647   Install with `rustup component add rls-preview`
4648 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
4649   Previously only showed `std::os::unix`.
4650
4651 Compatibility Notes
4652 -------------------
4653 - [Changes in method matching against higher-ranked types][43880] This may cause
4654   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
4655 - [rustc's JSON error output's byte position start at top of file.][42973]
4656   Was previously relative to the rustc's internal `CodeMap` struct which
4657   required the unstable library `libsyntax` to correctly use.
4658 - [`unused_results` lint no longer ignores booleans][43728]
4659
4660 [42565]: https://github.com/rust-lang/rust/pull/42565
4661 [42973]: https://github.com/rust-lang/rust/pull/42973
4662 [43348]: https://github.com/rust-lang/rust/pull/43348
4663 [43459]: https://github.com/rust-lang/rust/pull/43459
4664 [43506]: https://github.com/rust-lang/rust/pull/43506
4665 [43540]: https://github.com/rust-lang/rust/pull/43540
4666 [43690]: https://github.com/rust-lang/rust/pull/43690
4667 [43728]: https://github.com/rust-lang/rust/pull/43728
4668 [43838]: https://github.com/rust-lang/rust/pull/43838
4669 [43863]: https://github.com/rust-lang/rust/pull/43863
4670 [43880]: https://github.com/rust-lang/rust/pull/43880
4671 [43911]: https://github.com/rust-lang/rust/pull/43911
4672 [43916]: https://github.com/rust-lang/rust/pull/43916
4673 [43917]: https://github.com/rust-lang/rust/pull/43917
4674 [44204]: https://github.com/rust-lang/rust/pull/44204
4675 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
4676 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
4677 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4678 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
4679 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
4680 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
4681 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
4682 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
4683 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
4684
4685 Version 1.20.0 (2017-08-31)
4686 ===========================
4687
4688 Language
4689 --------
4690 - [Associated constants are now stabilised.][42809]
4691 - [A lot of macro bugs are now fixed.][42913]
4692
4693 Compiler
4694 --------
4695
4696 - [Struct fields are now properly coerced to the expected field type.][42807]
4697 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
4698   `wasm32-experimental-emscripten` target.
4699 - [Changed some of the error messages to be more helpful.][42033]
4700 - [Add support for RELRO(RELocation Read-Only) for platforms that support
4701   it.][43170]
4702 - [rustc now reports the total number of errors on compilation failure][43015]
4703   previously this was only the number of errors in the pass that failed.
4704 - [Expansion in rustc has been sped up 29x.][42533]
4705 - [added `msp430-none-elf` target.][43099]
4706 - [rustc will now suggest one-argument enum variant to fix type mismatch when
4707   applicable][43178]
4708 - [Fixes backtraces on Redox][43228]
4709 - [rustc now identifies different versions of same crate when absolute paths of
4710   different types match in an error message.][42826]
4711
4712 Libraries
4713 ---------
4714
4715
4716 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
4717 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
4718   tuples.][43011]
4719 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
4720   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
4721 - [Impl `Clone` for `DefaultHasher`.][42799]
4722 - [Impl `Sync` for `SyncSender`.][42397]
4723 - [Impl `FromStr` for `char`][42271]
4724 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
4725   NaN.][42431]
4726 - [allow messages in the `unimplemented!()` macro.][42155]
4727   ie. `unimplemented!("Waiting for 1.21 to be stable")`
4728 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
4729 - [Upgrade to Unicode 10.0.0][42999]
4730 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
4731 - [Skip the main thread's manual stack guard on Linux][43072]
4732 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
4733 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
4734   previously 2^15.
4735 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
4736
4737 Stabilized APIs
4738 ---------------
4739
4740 - [`CStr::into_c_string`]
4741 - [`CString::as_c_str`]
4742 - [`CString::into_boxed_c_str`]
4743 - [`Chain::get_mut`]
4744 - [`Chain::get_ref`]
4745 - [`Chain::into_inner`]
4746 - [`Option::get_or_insert_with`]
4747 - [`Option::get_or_insert`]
4748 - [`OsStr::into_os_string`]
4749 - [`OsString::into_boxed_os_str`]
4750 - [`Take::get_mut`]
4751 - [`Take::get_ref`]
4752 - [`Utf8Error::error_len`]
4753 - [`char::EscapeDebug`]
4754 - [`char::escape_debug`]
4755 - [`compile_error!`]
4756 - [`f32::from_bits`]
4757 - [`f32::to_bits`]
4758 - [`f64::from_bits`]
4759 - [`f64::to_bits`]
4760 - [`mem::ManuallyDrop`]
4761 - [`slice::sort_unstable_by_key`]
4762 - [`slice::sort_unstable_by`]
4763 - [`slice::sort_unstable`]
4764 - [`str::from_boxed_utf8_unchecked`]
4765 - [`str::as_bytes_mut`]
4766 - [`str::as_bytes_mut`]
4767 - [`str::from_utf8_mut`]
4768 - [`str::from_utf8_unchecked_mut`]
4769 - [`str::get_mut`]
4770 - [`str::get_unchecked_mut`]
4771 - [`str::get_unchecked`]
4772 - [`str::get`]
4773 - [`str::into_boxed_bytes`]
4774
4775
4776 Cargo
4777 -----
4778 - [Cargo API token location moved from `~/.cargo/config` to
4779   `~/.cargo/credentials`.][cargo/3978]
4780 - [Cargo will now build `main.rs` binaries that are in sub-directories of
4781   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
4782   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
4783 - [You can now specify version of a binary when installed through
4784   `cargo install` using `--vers`.][cargo/4229]
4785 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
4786   failure.][cargo/4248]
4787 - [Changed the convention around which file is the crate root.][cargo/4259]
4788 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
4789   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
4790
4791 Compatibility Notes
4792 -------------------
4793
4794 - [Functions with `'static` in their return types will now not be as usable as
4795   if they were using lifetime parameters instead.][42417]
4796 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
4797   takes the sign of NaN into account where previously didn't.][42430]
4798
4799 [42033]: https://github.com/rust-lang/rust/pull/42033
4800 [42155]: https://github.com/rust-lang/rust/pull/42155
4801 [42271]: https://github.com/rust-lang/rust/pull/42271
4802 [42397]: https://github.com/rust-lang/rust/pull/42397
4803 [42417]: https://github.com/rust-lang/rust/pull/42417
4804 [42430]: https://github.com/rust-lang/rust/pull/42430
4805 [42431]: https://github.com/rust-lang/rust/pull/42431
4806 [42533]: https://github.com/rust-lang/rust/pull/42533
4807 [42571]: https://github.com/rust-lang/rust/pull/42571
4808 [42613]: https://github.com/rust-lang/rust/pull/42613
4809 [42799]: https://github.com/rust-lang/rust/pull/42799
4810 [42807]: https://github.com/rust-lang/rust/pull/42807
4811 [42809]: https://github.com/rust-lang/rust/pull/42809
4812 [42822]: https://github.com/rust-lang/rust/pull/42822
4813 [42826]: https://github.com/rust-lang/rust/pull/42826
4814 [42854]: https://github.com/rust-lang/rust/pull/42854
4815 [42913]: https://github.com/rust-lang/rust/pull/42913
4816 [42999]: https://github.com/rust-lang/rust/pull/42999
4817 [43011]: https://github.com/rust-lang/rust/pull/43011
4818 [43015]: https://github.com/rust-lang/rust/pull/43015
4819 [43072]: https://github.com/rust-lang/rust/pull/43072
4820 [43077]: https://github.com/rust-lang/rust/pull/43077
4821 [43097]: https://github.com/rust-lang/rust/pull/43097
4822 [43099]: https://github.com/rust-lang/rust/pull/43099
4823 [43170]: https://github.com/rust-lang/rust/pull/43170
4824 [43178]: https://github.com/rust-lang/rust/pull/43178
4825 [43185]: https://github.com/rust-lang/rust/pull/43185
4826 [43228]: https://github.com/rust-lang/rust/pull/43228
4827 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
4828 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
4829 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
4830 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
4831 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
4832 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
4833 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
4834 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
4835 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
4836 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
4837 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
4838 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
4839 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
4840 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
4841 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
4842 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
4843 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
4844 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
4845 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
4846 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
4847 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
4848 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
4849 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
4850 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
4851 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
4852 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
4853 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
4854 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
4855 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
4856 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
4857 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
4858 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
4859 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
4860 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
4861 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
4862 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
4863 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
4864 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
4865 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
4866
4867
4868 Version 1.19.0 (2017-07-20)
4869 ===========================
4870
4871 Language
4872 --------
4873
4874 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
4875   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
4876 - [Macro recursion limit increased to 1024 from 64.][41676]
4877 - [Added lint for detecting unused macros.][41907]
4878 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
4879   For example: `let x = loop { break 7; };`
4880 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
4881   contain `Copy` types and cannot have a `Drop` implementation.
4882   Example: `union Foo { bar: u8, baz: usize }`
4883 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
4884   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
4885
4886 Compiler
4887 --------
4888
4889 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
4890 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
4891   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
4892   you should use `--target armv7-linux-androideabi`.
4893 - [Fixed ICE when removing a source file between compilation sessions.][41873]
4894 - [Minor optimisation of string operations.][42037]
4895 - [Compiler error message is now `aborting due to previous error(s)` instead of
4896   `aborting due to N previous errors`][42150] This was previously inaccurate and
4897   would only count certain kinds of errors.
4898 - [The compiler now supports Visual Studio 2017][42225]
4899 - [The compiler is now built against LLVM 4.0.1 by default][42948]
4900 - [Added a lot][42264] of [new error codes][42302]
4901 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
4902   libraries with C Run-time Libraries(CRT) to be statically linked.
4903 - [Fixed various ARM codegen bugs][42740]
4904
4905 Libraries
4906 ---------
4907
4908 - [`String` now implements `FromIterator<Cow<'a, str>>` and
4909   `Extend<Cow<'a, str>>`][41449]
4910 - [`Vec` now implements `From<&mut [T]>`][41530]
4911 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
4912 - [`SplitWhitespace` now implements `Clone`][41659]
4913 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
4914   1.5x faster][41764]
4915 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
4916   macros, but for printing to stderr.
4917
4918 Stabilized APIs
4919 ---------------
4920
4921 - [`OsString::shrink_to_fit`]
4922 - [`cmp::Reverse`]
4923 - [`Command::envs`]
4924 - [`thread::ThreadId`]
4925
4926 Cargo
4927 -----
4928
4929 - [Build scripts can now add environment variables to the environment
4930   the crate is being compiled in.
4931   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
4932 - [Subcommands now replace the current process rather than spawning a new
4933   child process][cargo/3970]
4934 - [Workspace members can now accept glob file patterns][cargo/3979]
4935 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
4936   the members in a given workspace.][cargo/3988]
4937 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
4938 - [Target directory path is now in the cargo metadata][cargo/4022]
4939 - [Cargo no longer checks out a local working directory for the
4940   crates.io index][cargo/4026] This should provide smaller file size for the
4941   registry, and improve cloning times, especially on Windows machines.
4942 - [Added an `--exclude` option for excluding certain packages when using the
4943   `--all` option][cargo/4031]
4944 - [Cargo will now automatically retry when receiving a 5xx error
4945   from crates.io][cargo/4032]
4946 - [The `--features` option now accepts multiple comma or space
4947   delimited values.][cargo/4084]
4948 - [Added support for custom target specific runners][cargo/3954]
4949
4950 Misc
4951 ----
4952
4953 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
4954   Windows Debugger.
4955 - [Rust will now release XZ compressed packages][rust-installer/57]
4956 - [rustup will now prefer to download rust packages with
4957   XZ compression][rustup/1100] over GZip packages.
4958 - [Added the ability to escape `#` in rust documentation][41785] By adding
4959   additional `#`'s ie. `##` is now `#`
4960
4961 Compatibility Notes
4962 -------------------
4963
4964 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
4965 - [`-Z` flags are now no longer allowed to be used on the stable
4966   compiler.][41751] This has been a warning for a year previous to this.
4967 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
4968   longer works][42844]. Users should migrate to the built-in `check`
4969   command, which has been available since 1.16.
4970 - [Ending a float literal with `._` is now a hard error.
4971   Example: `42._` .][41946]
4972 - [Any use of a private `extern crate` outside of its module is now a
4973   hard error.][36886] This was previously a warning.
4974 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
4975   relative while the `::` prefix makes a path absolute, but was ignored and the
4976   path was relative regardless.
4977 - [Floating point constants in match patterns is now a hard error][36890]
4978   This was previously a warning.
4979 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
4980   match patterns is now a hard error][36891] This was previously a warning.
4981 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
4982   a warning.
4983 - [From the pound escape, lines consisting of multiple `#`s are
4984   now visible][41785]
4985 - [It is an error to re-export private enum variants][42460]. This is
4986   known to break a number of crates that depend on an older version of
4987   mustache.
4988 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
4989   to use it to find the linker, and the build will fail where it did
4990   not previously][42607]
4991
4992 [36886]: https://github.com/rust-lang/rust/issues/36886
4993 [36888]: https://github.com/rust-lang/rust/issues/36888
4994 [36890]: https://github.com/rust-lang/rust/issues/36890
4995 [36891]: https://github.com/rust-lang/rust/issues/36891
4996 [36892]: https://github.com/rust-lang/rust/issues/36892
4997 [37406]: https://github.com/rust-lang/rust/issues/37406
4998 [39983]: https://github.com/rust-lang/rust/pull/39983
4999 [41145]: https://github.com/rust-lang/rust/pull/41145
5000 [41192]: https://github.com/rust-lang/rust/pull/41192
5001 [41258]: https://github.com/rust-lang/rust/pull/41258
5002 [41370]: https://github.com/rust-lang/rust/pull/41370
5003 [41449]: https://github.com/rust-lang/rust/pull/41449
5004 [41530]: https://github.com/rust-lang/rust/pull/41530
5005 [41624]: https://github.com/rust-lang/rust/pull/41624
5006 [41656]: https://github.com/rust-lang/rust/pull/41656
5007 [41659]: https://github.com/rust-lang/rust/pull/41659
5008 [41676]: https://github.com/rust-lang/rust/pull/41676
5009 [41751]: https://github.com/rust-lang/rust/pull/41751
5010 [41764]: https://github.com/rust-lang/rust/pull/41764
5011 [41785]: https://github.com/rust-lang/rust/pull/41785
5012 [41873]: https://github.com/rust-lang/rust/pull/41873
5013 [41907]: https://github.com/rust-lang/rust/pull/41907
5014 [41946]: https://github.com/rust-lang/rust/pull/41946
5015 [42016]: https://github.com/rust-lang/rust/pull/42016
5016 [42037]: https://github.com/rust-lang/rust/pull/42037
5017 [42068]: https://github.com/rust-lang/rust/pull/42068
5018 [42150]: https://github.com/rust-lang/rust/pull/42150
5019 [42162]: https://github.com/rust-lang/rust/pull/42162
5020 [42225]: https://github.com/rust-lang/rust/pull/42225
5021 [42264]: https://github.com/rust-lang/rust/pull/42264
5022 [42302]: https://github.com/rust-lang/rust/pull/42302
5023 [42460]: https://github.com/rust-lang/rust/issues/42460
5024 [42607]: https://github.com/rust-lang/rust/issues/42607
5025 [42740]: https://github.com/rust-lang/rust/pull/42740
5026 [42844]: https://github.com/rust-lang/rust/issues/42844
5027 [42948]: https://github.com/rust-lang/rust/pull/42948
5028 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
5029 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
5030 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
5031 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
5032 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
5033 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
5034 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
5035 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
5036 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
5037 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
5038 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
5039 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
5040 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
5041 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
5042 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
5043 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
5044 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
5045 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
5046 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
5047 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
5048 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
5049 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
5050
5051
5052 Version 1.18.0 (2017-06-08)
5053 ===========================
5054
5055 Language
5056 --------
5057
5058 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
5059   make the item visible to just that module tree. Also accepts the keyword
5060   `crate` to make something public to the whole crate but not users of the
5061   library. Example: `pub(crate) mod utils;`. [RFC 1422].
5062 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
5063   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
5064 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
5065   types like `Write + Send`, trailing `+` are now supported in trait objects,
5066   and better error reporting for trait objects starting with `?Sized`.
5067 - [0e+10 is now a valid floating point literal][40589]
5068 - [Now warns if you bind a lifetime parameter to 'static][40734]
5069 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
5070   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
5071   representation in some cases.][40377]
5072
5073 Compiler
5074 --------
5075
5076 - [rustc can now emit mir with `--emit mir`][39891]
5077 - [Improved LLVM IR for trivial functions][40367]
5078 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
5079 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
5080   opportunities found through profiling
5081 - [Improved backtrace formatting when panicking][38165]
5082
5083 Libraries
5084 ---------
5085
5086 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
5087   iterator hasn't been advanced the original `Vec` is reassembled with no actual
5088   iteration or reallocation.
5089 - [Simplified HashMap Bucket interface][40561] provides performance
5090   improvements for iterating and cloning.
5091 - [Specialize Vec::from_elem to use calloc][40409]
5092 - [Fixed Race condition in fs::create_dir_all][39799]
5093 - [No longer caching stdio on Windows][40516]
5094 - [Optimized insertion sort in slice][40807] insertion sort in some cases
5095   2.50%~ faster and in one case now 12.50% faster.
5096 - [Optimized `AtomicBool::fetch_nand`][41143]
5097
5098 Stabilized APIs
5099 ---------------
5100
5101 - [`Child::try_wait`]
5102 - [`HashMap::retain`]
5103 - [`HashSet::retain`]
5104 - [`PeekMut::pop`]
5105 - [`TcpStream::peek`]
5106 - [`UdpSocket::peek`]
5107 - [`UdpSocket::peek_from`]
5108
5109 Cargo
5110 -----
5111
5112 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
5113   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
5114 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
5115 - [Added Android build support][cargo/3885]
5116 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
5117   of a certain type, for example `cargo build --bins` will build all
5118   binaries.
5119 - [Added support for haiku][cargo/3952]
5120
5121 Misc
5122 ----
5123
5124 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
5125 - [Added rust-windbg script for better debugging on Windows][39983]
5126 - [Rust now uses the official cross compiler for NetBSD][40612]
5127 - [rustdoc now accepts `#` at the start of files][40828]
5128 - [Fixed jemalloc support for musl][41168]
5129
5130 Compatibility Notes
5131 -------------------
5132
5133 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
5134   always placed after the sign if it exists and before the digits. With the `#`
5135   flag the zeroes are placed after the prefix and before the digits.
5136 - [Due to the struct field optimisation][40377], using `transmute` on structs
5137   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
5138   always been undefined behavior, but is now more likely to break in practice.
5139 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
5140   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
5141   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
5142 - [Overlapping inherent `impl`s are now a hard error][40728]
5143 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
5144 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
5145   `out.asm` and `out.ll` instead of only one of the filetypes.
5146 - [ calling a function that returns `Self` will no longer work][41805] when
5147   the size of `Self` cannot be statically determined.
5148 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
5149   this has caused a few regressions namely:
5150
5151   - Changed the link order of local static/dynamic libraries (respecting the
5152     order on given rather than having the compiler reorder).
5153   - Changed how MinGW is linked, native code linked to dynamic libraries
5154     may require manually linking to the gcc support library (for the native
5155     code itself)
5156
5157 [38165]: https://github.com/rust-lang/rust/pull/38165
5158 [39799]: https://github.com/rust-lang/rust/pull/39799
5159 [39891]: https://github.com/rust-lang/rust/pull/39891
5160 [39983]: https://github.com/rust-lang/rust/pull/39983
5161 [40043]: https://github.com/rust-lang/rust/pull/40043
5162 [40241]: https://github.com/rust-lang/rust/pull/40241
5163 [40338]: https://github.com/rust-lang/rust/pull/40338
5164 [40367]: https://github.com/rust-lang/rust/pull/40367
5165 [40377]: https://github.com/rust-lang/rust/pull/40377
5166 [40409]: https://github.com/rust-lang/rust/pull/40409
5167 [40516]: https://github.com/rust-lang/rust/pull/40516
5168 [40556]: https://github.com/rust-lang/rust/pull/40556
5169 [40561]: https://github.com/rust-lang/rust/pull/40561
5170 [40589]: https://github.com/rust-lang/rust/pull/40589
5171 [40612]: https://github.com/rust-lang/rust/pull/40612
5172 [40723]: https://github.com/rust-lang/rust/pull/40723
5173 [40728]: https://github.com/rust-lang/rust/pull/40728
5174 [40731]: https://github.com/rust-lang/rust/pull/40731
5175 [40734]: https://github.com/rust-lang/rust/pull/40734
5176 [40805]: https://github.com/rust-lang/rust/pull/40805
5177 [40807]: https://github.com/rust-lang/rust/pull/40807
5178 [40828]: https://github.com/rust-lang/rust/pull/40828
5179 [40870]: https://github.com/rust-lang/rust/pull/40870
5180 [41085]: https://github.com/rust-lang/rust/pull/41085
5181 [41143]: https://github.com/rust-lang/rust/pull/41143
5182 [41168]: https://github.com/rust-lang/rust/pull/41168
5183 [41270]: https://github.com/rust-lang/rust/issues/41270
5184 [41469]: https://github.com/rust-lang/rust/pull/41469
5185 [41805]: https://github.com/rust-lang/rust/issues/41805
5186 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
5187 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
5188 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
5189 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
5190 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
5191 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
5192 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
5193 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
5194 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
5195 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
5196 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
5197 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
5198 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
5199 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
5200
5201
5202 Version 1.17.0 (2017-04-27)
5203 ===========================
5204
5205 Language
5206 --------
5207
5208 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
5209 * [Fields of structs may be initialized without duplicating the field/variable
5210   names][39761]. [RFC 1682]
5211 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
5212 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5213   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
5214   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
5215   `'b`. Soundness fix.
5216 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
5217 * [Static variables may contain references to other statics][40027]
5218
5219 Compiler
5220 --------
5221
5222 * [Exit quickly on only `--emit dep-info`][40336]
5223 * [Make `-C relocation-model` more correctly determine whether the linker
5224   creates a position-independent executable][40245]
5225 * [Add `-C overflow-checks` to directly control whether integer overflow
5226   panics][40037]
5227 * [The rustc type checker now checks items on demand instead of in a single
5228   in-order pass][40008]. This is mostly an internal refactoring in support of
5229   future work, including incremental type checking, but also resolves [RFC
5230   1647], allowing `Self` to appear in `impl` `where` clauses.
5231 * [Optimize vtable loads][39995]
5232 * [Turn off vectorization for Emscripten targets][39990]
5233 * [Provide suggestions for unknown macros imported with `use`][39953]
5234 * [Fix ICEs in path resolution][39939]
5235 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
5236 * [Add clearer error message using `&str + &str`][39116]
5237
5238 Stabilized APIs
5239 ---------------
5240
5241 * [`Arc::into_raw`]
5242 * [`Arc::from_raw`]
5243 * [`Arc::ptr_eq`]
5244 * [`Rc::into_raw`]
5245 * [`Rc::from_raw`]
5246 * [`Rc::ptr_eq`]
5247 * [`Ordering::then`]
5248 * [`Ordering::then_with`]
5249 * [`BTreeMap::range`]
5250 * [`BTreeMap::range_mut`]
5251 * [`collections::Bound`]
5252 * [`process::abort`]
5253 * [`ptr::read_unaligned`]
5254 * [`ptr::write_unaligned`]
5255 * [`Result::expect_err`]
5256 * [`Cell::swap`]
5257 * [`Cell::replace`]
5258 * [`Cell::into_inner`]
5259 * [`Cell::take`]
5260
5261 Libraries
5262 ---------
5263
5264 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
5265 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
5266 * [`String` implements `FromIterator<&char>`][40028]
5267 * `Box` [implements][40009] a number of new conversions:
5268   `From<Box<str>> for String`,
5269   `From<Box<[T]>> for Vec<T>`,
5270   `From<Box<CStr>> for CString`,
5271   `From<Box<OsStr>> for OsString`,
5272   `From<Box<Path>> for PathBuf`,
5273   `Into<Box<str>> for String`,
5274   `Into<Box<[T]>> for Vec<T>`,
5275   `Into<Box<CStr>> for CString`,
5276   `Into<Box<OsStr>> for OsString`,
5277   `Into<Box<Path>> for PathBuf`,
5278   `Default for Box<str>`,
5279   `Default for Box<CStr>`,
5280   `Default for Box<OsStr>`,
5281   `From<&CStr> for Box<CStr>`,
5282   `From<&OsStr> for Box<OsStr>`,
5283   `From<&Path> for Box<Path>`
5284 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
5285 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
5286 * [Slightly optimize `slice::sort`][39538]
5287 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
5288 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
5289   `Box<str>` implements `From<&str>`][39438]
5290 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
5291   `From<(I, u16)> where I: Into<IpAddr>`][39372]
5292 * [`format!` estimates the needed capacity before writing a string][39356]
5293 * [Support unprivileged symlink creation in Windows][38921]
5294 * [`PathBuf` implements `Default`][38764]
5295 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
5296 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
5297   and poor hash functions.
5298
5299 Cargo
5300 -----
5301
5302 * [Add `cargo check --all`][cargo/3731]
5303 * [Add an option to ignore SSL revocation checking][cargo/3699]
5304 * [Add `cargo run --package`][cargo/3691]
5305 * [Add `required_features`][cargo/3667]
5306 * [Assume `build.rs` is a build script][cargo/3664]
5307 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
5308
5309 Misc
5310 ----
5311
5312 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
5313   `rustbook`][39633]
5314 * [The "Unstable Book" documents nightly-only features][ubook]
5315 * [Improve the style of the sidebar in rustdoc output][40265]
5316 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
5317 * [Fix MSP430 breakage due to `i128`][40257]
5318 * [Preliminary Solaris/SPARCv9 support][39903]
5319 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
5320   run without installing the MSVC runtime.
5321 * [`rustdoc --test` includes file names in test names][39788]
5322 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
5323   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
5324 * [Initial support for `aarch64-unknown-freebsd`][39491]
5325 * [Initial support for `i686-unknown-netbsd`][39426]
5326 * [This release no longer includes the old makefile build system][39431]. Rust
5327   is built with a custom build system, written in Rust, and with Cargo.
5328 * [Add Debug implementations for libcollection structs][39002]
5329 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
5330 * [`--test-threads=0` produces an error][38945]
5331 * [`rustup` installs documentation by default][40526]
5332 * [The Rust source includes NatVis visualizations][39843]. These can be used by
5333   WinDbg and Visual Studio to improve the debugging experience.
5334
5335 Compatibility Notes
5336 -------------------
5337
5338 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
5339   workaround, either use MSVC 2015 or run vcvars.bat.
5340 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
5341   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
5342   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
5343   fix.
5344 * [`format!` and `Display::to_string` panic if an underlying formatting
5345   implementation returns an error][40117]. Previously the error was silently
5346   ignored. It is incorrect for `write_fmt` to return an error when writing
5347   to a string.
5348 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
5349   crates were marked stable and could be accessed from the stable toolchain.
5350 * [Rust git source no longer includes vendored crates][39728]. Those that need
5351   to build with vendored crates should build from release tarballs.
5352 * [Fix inert attributes from `proc_macro_derives`][39572]
5353 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
5354   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
5355   build system.
5356 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
5357   existing code generally ignores the type of dead-code unless a type-hint is
5358   provided; this can cause surprising inference interactions particularly around
5359   defaulting. The new code uniformly ignores the result type of dead-code.
5360 * [Tuple-struct constructors with private fields are no longer visible][38932]
5361 * [Lifetime parameters that do not appear in the arguments are now considered
5362   early-bound][38897], resolving a soundness bug (#[32330]). The
5363   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
5364   April of 2016.
5365 * [rustdoc: fix doctests with non-feature crate attributes][38161]
5366 * [Make transmuting from fn item types to pointer-sized types a hard
5367   error][34198]
5368
5369 [27787]: https://github.com/rust-lang/rust/issues/27787
5370 [32330]: https://github.com/rust-lang/rust/issues/32330
5371 [34198]: https://github.com/rust-lang/rust/pull/34198
5372 [38161]: https://github.com/rust-lang/rust/pull/38161
5373 [38368]: https://github.com/rust-lang/rust/pull/38368
5374 [38584]: https://github.com/rust-lang/rust/issues/38584
5375 [38661]: https://github.com/rust-lang/rust/pull/38661
5376 [38764]: https://github.com/rust-lang/rust/pull/38764
5377 [38864]: https://github.com/rust-lang/rust/issues/38864
5378 [38897]: https://github.com/rust-lang/rust/pull/38897
5379 [38921]: https://github.com/rust-lang/rust/pull/38921
5380 [38932]: https://github.com/rust-lang/rust/pull/38932
5381 [38945]: https://github.com/rust-lang/rust/pull/38945
5382 [38981]: https://github.com/rust-lang/rust/pull/38981
5383 [39002]: https://github.com/rust-lang/rust/pull/39002
5384 [39116]: https://github.com/rust-lang/rust/pull/39116
5385 [39193]: https://github.com/rust-lang/rust/pull/39193
5386 [39265]: https://github.com/rust-lang/rust/pull/39265
5387 [39356]: https://github.com/rust-lang/rust/pull/39356
5388 [39372]: https://github.com/rust-lang/rust/pull/39372
5389 [39426]: https://github.com/rust-lang/rust/pull/39426
5390 [39431]: https://github.com/rust-lang/rust/pull/39431
5391 [39438]: https://github.com/rust-lang/rust/pull/39438
5392 [39440]: https://github.com/rust-lang/rust/pull/39440
5393 [39485]: https://github.com/rust-lang/rust/pull/39485
5394 [39491]: https://github.com/rust-lang/rust/pull/39491
5395 [39518]: https://github.com/rust-lang/rust/pull/39518
5396 [39538]: https://github.com/rust-lang/rust/pull/39538
5397 [39572]: https://github.com/rust-lang/rust/pull/39572
5398 [39633]: https://github.com/rust-lang/rust/pull/39633
5399 [39642]: https://github.com/rust-lang/rust/pull/39642
5400 [39728]: https://github.com/rust-lang/rust/pull/39728
5401 [39761]: https://github.com/rust-lang/rust/pull/39761
5402 [39788]: https://github.com/rust-lang/rust/pull/39788
5403 [39793]: https://github.com/rust-lang/rust/pull/39793
5404 [39837]: https://github.com/rust-lang/rust/pull/39837
5405 [39843]: https://github.com/rust-lang/rust/pull/39843
5406 [39851]: https://github.com/rust-lang/rust/pull/39851
5407 [39903]: https://github.com/rust-lang/rust/pull/39903
5408 [39939]: https://github.com/rust-lang/rust/pull/39939
5409 [39953]: https://github.com/rust-lang/rust/pull/39953
5410 [39960]: https://github.com/rust-lang/rust/pull/39960
5411 [39990]: https://github.com/rust-lang/rust/pull/39990
5412 [39995]: https://github.com/rust-lang/rust/pull/39995
5413 [40008]: https://github.com/rust-lang/rust/pull/40008
5414 [40009]: https://github.com/rust-lang/rust/pull/40009
5415 [40027]: https://github.com/rust-lang/rust/pull/40027
5416 [40028]: https://github.com/rust-lang/rust/pull/40028
5417 [40037]: https://github.com/rust-lang/rust/pull/40037
5418 [40117]: https://github.com/rust-lang/rust/pull/40117
5419 [40166]: https://github.com/rust-lang/rust/pull/40166
5420 [40245]: https://github.com/rust-lang/rust/pull/40245
5421 [40257]: https://github.com/rust-lang/rust/pull/40257
5422 [40261]: https://github.com/rust-lang/rust/pull/40261
5423 [40265]: https://github.com/rust-lang/rust/pull/40265
5424 [40319]: https://github.com/rust-lang/rust/pull/40319
5425 [40336]: https://github.com/rust-lang/rust/pull/40336
5426 [40526]: https://github.com/rust-lang/rust/pull/40526
5427 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5428 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
5429 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
5430 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
5431 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
5432 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
5433 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
5434 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
5435 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
5436 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
5437 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
5438 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
5439 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
5440 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
5441 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
5442 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
5443 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
5444 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
5445 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
5446 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
5447 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
5448 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
5449 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
5450 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
5451 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
5452 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
5453 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
5454 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
5455 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
5456 [mdbook]: https://crates.io/crates/mdbook
5457 [ubook]: https://doc.rust-lang.org/unstable-book/
5458
5459
5460 Version 1.16.0 (2017-03-16)
5461 ===========================
5462
5463 Language
5464 --------
5465
5466 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5467 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5468   match patterns][38069]
5469 * [Clean up semantics of `self` in an import list][38313]
5470 * [`Self` may appear in `impl` headers][38920]
5471 * [`Self` may appear in struct expressions][39282]
5472
5473 Compiler
5474 --------
5475
5476 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
5477   a `.rmeta` file containing only crate metadata][38571]. This can be
5478   used by tools like the Rust Language Service to perform
5479   metadata-only builds.
5480 * [Levenshtein based typo suggestions now work in most places, while
5481   previously they worked only for fields and sometimes for local
5482   variables][38927]. Together with the overhaul of "no
5483   resolution"/"unexpected resolution" errors (#[38154]) they result in
5484   large and systematic improvement in resolution diagnostics.
5485 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
5486   `U`][38670]
5487 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
5488 * [`rustc` no longer attempts to provide "consider using an explicit
5489   lifetime" suggestions][37057]. They were inaccurate.
5490
5491 Stabilized APIs
5492 ---------------
5493
5494 * [`VecDeque::truncate`]
5495 * [`VecDeque::resize`]
5496 * [`String::insert_str`]
5497 * [`Duration::checked_add`]
5498 * [`Duration::checked_sub`]
5499 * [`Duration::checked_div`]
5500 * [`Duration::checked_mul`]
5501 * [`str::replacen`]
5502 * [`str::repeat`]
5503 * [`SocketAddr::is_ipv4`]
5504 * [`SocketAddr::is_ipv6`]
5505 * [`IpAddr::is_ipv4`]
5506 * [`IpAddr::is_ipv6`]
5507 * [`Vec::dedup_by`]
5508 * [`Vec::dedup_by_key`]
5509 * [`Result::unwrap_or_default`]
5510 * [`<*const T>::wrapping_offset`]
5511 * [`<*mut T>::wrapping_offset`]
5512 * `CommandExt::creation_flags`
5513 * [`File::set_permissions`]
5514 * [`String::split_off`]
5515
5516 Libraries
5517 ---------
5518
5519 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
5520   their argument by `Borrow` parameter][37761]
5521 * [All public types in std implement `Debug`][38006]
5522 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
5523 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
5524 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5525   Windows][38274]
5526 * [std: Fix partial writes in `LineWriter`][38062]
5527 * [std: Clamp max read/write sizes on Unix][38062]
5528 * [Use more specific panic message for `&str` slicing errors][38066]
5529 * [`TcpListener::set_only_v6` is deprecated][38304]. This
5530   functionality cannot be achieved in std currently.
5531 * [`writeln!`, like `println!`, now accepts a form with no string
5532   or formatting arguments, to just print a newline][38469]
5533 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
5534 * [Reduce the size of static data in `std_unicode::tables`][38781]
5535 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
5536   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
5537   `Display`][38909]
5538 * [`Duration` implements `Sum`][38712]
5539 * [`String` implements `ToSocketAddrs`][39048]
5540
5541 Cargo
5542 -----
5543
5544 * [The `cargo check` command does a type check of a project without
5545   building it][cargo/3296]
5546 * [crates.io will display CI badges from Travis and AppVeyor, if
5547   specified in Cargo.toml][cargo/3546]
5548 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
5549 * [Compilation profiles accept integer values for `debug`, in addition
5550   to `true` and `false`. These are passed to `rustc` as the value to
5551   `-C debuginfo`][cargo/3534]
5552 * [Implement `cargo --version --verbose`][cargo/3604]
5553 * [All builds now output 'dep-info' build dependencies compatible with
5554   make and ninja][cargo/3557]
5555 * [Build all workspace members with `build --all`][cargo/3511]
5556 * [Document all workspace members with `doc --all`][cargo/3515]
5557 * [Path deps outside workspace are not members][cargo/3443]
5558
5559 Misc
5560 ----
5561
5562 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
5563   the path to the Rust implementation][38589]
5564 * [The `armv7-linux-androideabi` target no longer enables NEON
5565   extensions, per Google's ABI guide][38413]
5566 * [The stock standard library can be compiled for Redox OS][38401]
5567 * [Rust has initial SPARC support][38726]. Tier 3. No builds
5568   available.
5569 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
5570   builds available.
5571 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
5572
5573 Compatibility Notes
5574 -------------------
5575
5576 * [Uninhabitable enums (those without any variants) no longer permit wildcard
5577   match patterns][38069]
5578 * In this release, references to uninhabited types can not be
5579   pattern-matched. This was accidentally allowed in 1.15.
5580 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
5581 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
5582   Windows][38274]
5583 * [Clean up semantics of `self` in an import list][38313]
5584 * Reimplemented lifetime elision. This change was almost entirely compatible
5585   with existing code, but it did close a number of small bugs and loopholes,
5586   as well as being more accepting in some other [cases][41105].
5587
5588 [37057]: https://github.com/rust-lang/rust/pull/37057
5589 [37761]: https://github.com/rust-lang/rust/pull/37761
5590 [38006]: https://github.com/rust-lang/rust/pull/38006
5591 [38051]: https://github.com/rust-lang/rust/pull/38051
5592 [38062]: https://github.com/rust-lang/rust/pull/38062
5593 [38062]: https://github.com/rust-lang/rust/pull/38622
5594 [38066]: https://github.com/rust-lang/rust/pull/38066
5595 [38069]: https://github.com/rust-lang/rust/pull/38069
5596 [38131]: https://github.com/rust-lang/rust/pull/38131
5597 [38154]: https://github.com/rust-lang/rust/pull/38154
5598 [38274]: https://github.com/rust-lang/rust/pull/38274
5599 [38304]: https://github.com/rust-lang/rust/pull/38304
5600 [38313]: https://github.com/rust-lang/rust/pull/38313
5601 [38314]: https://github.com/rust-lang/rust/pull/38314
5602 [38327]: https://github.com/rust-lang/rust/pull/38327
5603 [38401]: https://github.com/rust-lang/rust/pull/38401
5604 [38413]: https://github.com/rust-lang/rust/pull/38413
5605 [38469]: https://github.com/rust-lang/rust/pull/38469
5606 [38559]: https://github.com/rust-lang/rust/pull/38559
5607 [38571]: https://github.com/rust-lang/rust/pull/38571
5608 [38580]: https://github.com/rust-lang/rust/pull/38580
5609 [38589]: https://github.com/rust-lang/rust/pull/38589
5610 [38670]: https://github.com/rust-lang/rust/pull/38670
5611 [38712]: https://github.com/rust-lang/rust/pull/38712
5612 [38726]: https://github.com/rust-lang/rust/pull/38726
5613 [38781]: https://github.com/rust-lang/rust/pull/38781
5614 [38798]: https://github.com/rust-lang/rust/pull/38798
5615 [38909]: https://github.com/rust-lang/rust/pull/38909
5616 [38920]: https://github.com/rust-lang/rust/pull/38920
5617 [38927]: https://github.com/rust-lang/rust/pull/38927
5618 [39048]: https://github.com/rust-lang/rust/pull/39048
5619 [39282]: https://github.com/rust-lang/rust/pull/39282
5620 [39379]: https://github.com/rust-lang/rust/pull/39379
5621 [41105]: https://github.com/rust-lang/rust/issues/41105
5622 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5623 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
5624 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
5625 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
5626 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
5627 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
5628 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
5629 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
5630 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
5631 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
5632 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
5633 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
5634 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
5635 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
5636 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
5637 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
5638 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
5639 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
5640 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
5641 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
5642 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
5643 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
5644 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
5645 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
5646 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
5647 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
5648 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
5649 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
5650 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
5651 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
5652
5653
5654 Version 1.15.1 (2017-02-09)
5655 ===========================
5656
5657 * [Fix IntoIter::as_mut_slice's signature][39466]
5658 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
5659
5660 [39466]: https://github.com/rust-lang/rust/pull/39466
5661 [39523]: https://github.com/rust-lang/rust/pull/39523
5662
5663
5664 Version 1.15.0 (2017-02-02)
5665 ===========================
5666
5667 Language
5668 --------
5669
5670 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
5671   stable. This allows popular code-generating crates like Serde and Diesel to
5672   work ergonomically. [RFC 1681].
5673 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
5674   with curly braces][36868]. Part of [RFC 1506].
5675 * [A number of minor changes to name resolution have been activated][37127].
5676   They add up to more consistent semantics, allowing for future evolution of
5677   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5678   details of what is different. The breaking changes here have been transitioned
5679   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5680 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
5681   bounds][38279]
5682 * [`?Sized` can be used in `where` clauses][37791]
5683 * [There is now a limit on the size of monomorphized types and it can be
5684   modified with the `#![type_size_limit]` crate attribute, similarly to
5685   the `#![recursion_limit]` attribute][37789]
5686
5687 Compiler
5688 --------
5689
5690 * [On Windows, the compiler will apply dllimport attributes when linking to
5691   extern functions][37973]. Additional attributes and flags can control which
5692   library kind is linked and its name. [RFC 1717].
5693 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5694 * [The `--test` flag works with procedural macro crates][38107]
5695 * [Fix `extern "aapcs" fn` ABI][37814]
5696 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
5697 * [The `format!` expander recognizes incorrect `printf` and shell-style
5698   formatting directives and suggests the correct format][37613].
5699 * [Only report one error for all unused imports in an import list][37456]
5700
5701 Compiler Performance
5702 --------------------
5703
5704 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
5705 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
5706 * [Don't clone in `UnificationTable::probe`][37848]
5707 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
5708 * [Use small vectors in type walker][37760]
5709 * [Macro expansion performance was improved][37701]
5710 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
5711 * [Replace FNV with a faster hash function][37229]
5712
5713 Stabilized APIs
5714 ---------------
5715
5716 * [`std::iter::Iterator::min_by`]
5717 * [`std::iter::Iterator::max_by`]
5718 * [`std::os::*::fs::FileExt`]
5719 * [`std::sync::atomic::Atomic*::get_mut`]
5720 * [`std::sync::atomic::Atomic*::into_inner`]
5721 * [`std::vec::IntoIter::as_slice`]
5722 * [`std::vec::IntoIter::as_mut_slice`]
5723 * [`std::sync::mpsc::Receiver::try_iter`]
5724 * [`std::os::unix::process::CommandExt::before_exec`]
5725 * [`std::rc::Rc::strong_count`]
5726 * [`std::rc::Rc::weak_count`]
5727 * [`std::sync::Arc::strong_count`]
5728 * [`std::sync::Arc::weak_count`]
5729 * [`std::char::encode_utf8`]
5730 * [`std::char::encode_utf16`]
5731 * [`std::cell::Ref::clone`]
5732 * [`std::io::Take::into_inner`]
5733
5734 Libraries
5735 ---------
5736
5737 * [The standard sorting algorithm has been rewritten for dramatic performance
5738   improvements][38192]. It is a hybrid merge sort, drawing influences from
5739   Timsort. Previously it was a naive merge sort.
5740 * [`Iterator::nth` no longer has a `Sized` bound][38134]
5741 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
5742   performance.
5743 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
5744   and `char_indices().last()`][37882]
5745 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
5746 * [Chinese characters display correctly in `fmt::Debug`][37855]
5747 * [Derive `Default` for `Duration`][37699]
5748 * [Support creation of anonymous pipes on WinXP/2k][37677]
5749 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
5750 * [Don't pass overlapped handles to processes][38835]
5751
5752 Cargo
5753 -----
5754
5755 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5756   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5757   should instead check the variable at runtime with `std::env`. That the value
5758   was set at build time was a bug, and incorrect when cross-compiling. This
5759   change is known to cause breakage.
5760 * [Add `--all` flag to `cargo test`][cargo/3221]
5761 * [Compile statically against the MSVC CRT][cargo/3363]
5762 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
5763 * [Link OpenSSL statically on OSX][cargo/3311]
5764 * [Apply new fingerprinting to build dir outputs][cargo/3310]
5765 * [Test for bad path overrides with summaries][cargo/3336]
5766 * [Require `cargo install --vers` to take a semver version][cargo/3338]
5767 * [Fix retrying crate downloads for network errors][cargo/3348]
5768 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
5769 * [Emit more info on --message-format=json][cargo/3319]
5770 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
5771 * [Don't ignore errors in workspace manifest][cargo/3409]
5772 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
5773
5774 Tooling
5775 -------
5776
5777 * [Test runners (binaries built with `--test`) now support a `--list` argument
5778   that lists the tests it contains][38185]
5779 * [Test runners now support a `--exact` argument that makes the test filter
5780   match exactly, instead of matching only a substring of the test name][38181]
5781 * [rustdoc supports a `--playground-url` flag][37763]
5782 * [rustdoc provides more details about `#[should_panic]` errors][37749]
5783
5784 Misc
5785 ----
5786
5787 * [The Rust build system is now written in Rust][37817]. The Makefiles may
5788   continue to be used in this release by passing `--disable-rustbuild` to the
5789   configure script, but they will be deleted soon. Note that the new build
5790   system uses a different on-disk layout that will likely affect any scripts
5791   building Rust.
5792 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
5793   releases.
5794 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
5795 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
5796   releases.
5797
5798 Compatibility Notes
5799 -------------------
5800
5801 * [A number of minor changes to name resolution have been activated][37127].
5802   They add up to more consistent semantics, allowing for future evolution of
5803   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
5804   details of what is different. The breaking changes here have been transitioned
5805   through the [`legacy_imports`] lint since 1.14, with no known regressions.
5806 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
5807   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
5808   should instead check the variable at runtime with `std::env`. That the value
5809   was set at build time was a bug, and incorrect when cross-compiling. This
5810   change is known to cause breakage.
5811 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
5812   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
5813   1.10 and is now an error by default. It will become a hard error in the near
5814   future.
5815 * [The semantics relating modules to file system directories are changing in
5816   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
5817   lint, which is a warning in this release, and will become a hard error in the
5818   future.
5819 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
5820 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
5821   the underlying iterator][37834]
5822
5823 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
5824 [33685]: https://github.com/rust-lang/rust/issues/33685
5825 [36868]: https://github.com/rust-lang/rust/pull/36868
5826 [37127]: https://github.com/rust-lang/rust/pull/37127
5827 [37229]: https://github.com/rust-lang/rust/pull/37229
5828 [37456]: https://github.com/rust-lang/rust/pull/37456
5829 [37527]: https://github.com/rust-lang/rust/pull/37527
5830 [37602]: https://github.com/rust-lang/rust/pull/37602
5831 [37613]: https://github.com/rust-lang/rust/pull/37613
5832 [37615]: https://github.com/rust-lang/rust/pull/37615
5833 [37636]: https://github.com/rust-lang/rust/pull/37636
5834 [37627]: https://github.com/rust-lang/rust/pull/37627
5835 [37642]: https://github.com/rust-lang/rust/pull/37642
5836 [37677]: https://github.com/rust-lang/rust/pull/37677
5837 [37699]: https://github.com/rust-lang/rust/pull/37699
5838 [37701]: https://github.com/rust-lang/rust/pull/37701
5839 [37705]: https://github.com/rust-lang/rust/pull/37705
5840 [37749]: https://github.com/rust-lang/rust/pull/37749
5841 [37760]: https://github.com/rust-lang/rust/pull/37760
5842 [37763]: https://github.com/rust-lang/rust/pull/37763
5843 [37764]: https://github.com/rust-lang/rust/pull/37764
5844 [37789]: https://github.com/rust-lang/rust/pull/37789
5845 [37791]: https://github.com/rust-lang/rust/pull/37791
5846 [37814]: https://github.com/rust-lang/rust/pull/37814
5847 [37817]: https://github.com/rust-lang/rust/pull/37817
5848 [37834]: https://github.com/rust-lang/rust/pull/37834
5849 [37848]: https://github.com/rust-lang/rust/pull/37848
5850 [37855]: https://github.com/rust-lang/rust/pull/37855
5851 [37882]: https://github.com/rust-lang/rust/pull/37882
5852 [37888]: https://github.com/rust-lang/rust/pull/37888
5853 [37973]: https://github.com/rust-lang/rust/pull/37973
5854 [37979]: https://github.com/rust-lang/rust/pull/37979
5855 [38086]: https://github.com/rust-lang/rust/pull/38086
5856 [38107]: https://github.com/rust-lang/rust/pull/38107
5857 [38117]: https://github.com/rust-lang/rust/pull/38117
5858 [38134]: https://github.com/rust-lang/rust/pull/38134
5859 [38146]: https://github.com/rust-lang/rust/pull/38146
5860 [38181]: https://github.com/rust-lang/rust/pull/38181
5861 [38182]: https://github.com/rust-lang/rust/pull/38182
5862 [38185]: https://github.com/rust-lang/rust/pull/38185
5863 [38192]: https://github.com/rust-lang/rust/pull/38192
5864 [38279]: https://github.com/rust-lang/rust/pull/38279
5865 [38835]: https://github.com/rust-lang/rust/pull/38835
5866 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
5867 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5868 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
5869 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
5870 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
5871 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
5872 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
5873 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
5874 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
5875 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
5876 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
5877 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
5878 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
5879 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
5880 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
5881 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
5882 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
5883 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
5884 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
5885 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
5886 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
5887 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
5888 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
5889 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
5890 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
5891 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
5892 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
5893 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
5894 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
5895 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
5896 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
5897 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
5898 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
5899 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
5900 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
5901 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
5902 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
5903 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
5904
5905
5906 Version 1.14.0 (2016-12-22)
5907 ===========================
5908
5909 Language
5910 --------
5911
5912 * [`..` matches multiple tuple fields in enum variants, structs
5913   and tuples][36843]. [RFC 1492].
5914 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
5915 * [`use *` and `use ::*` both glob-import from the crate root][37367]
5916 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
5917   dereferencing][36822]
5918
5919 Compiler
5920 --------
5921
5922 * [Mark enums with non-zero discriminant as non-zero][37224]
5923 * [Lower-case `static mut` names are linted like other
5924   statics and consts][37162]
5925 * [Fix ICE on some macros in const integer positions
5926    (e.g. `[u8; m!()]`)][36819]
5927 * [Improve error message and snippet for "did you mean `x`"][36798]
5928 * [Add a panic-strategy field to the target specification][36794]
5929 * [Include LLVM version in `--version --verbose`][37200]
5930
5931 Compile-time Optimizations
5932 --------------------------
5933
5934 * [Improve macro expansion performance][37569]
5935 * [Shrink `Expr_::ExprInlineAsm`][37445]
5936 * [Replace all uses of SHA-256 with BLAKE2b][37439]
5937 * [Reduce the number of bytes hashed by `IchHasher`][37427]
5938 * [Avoid more allocations when compiling html5ever][37373]
5939 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
5940 * [Avoid some allocations in the macro parser][37318]
5941 * [Use a faster deflate setting][37298]
5942 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
5943   during interning of slices][37270]
5944 * [Optimize `write_metadata`][37267]
5945 * [Don't process obligation forest cycles when stalled][37231]
5946 * [Avoid many `CrateConfig` clones][37161]
5947 * [Optimize `Substs::super_fold_with`][37108]
5948 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
5949 * [Speed up `plug_leaks`][36917]
5950
5951 Libraries
5952 ---------
5953
5954 * [`println!()`, with no arguments, prints newline][36825].
5955   Previously, an empty string was required to achieve the same.
5956 * [`Wrapping` impls standard binary and unary operators, as well as
5957    the `Sum` and `Product` iterators][37356]
5958 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
5959   Vec<T>`][37326]
5960 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
5961   `VecDeque` iterators][37315]
5962 * [Improve `SipHasher` performance on small values][37312]
5963 * [Add Iterator trait TrustedLen to enable better FromIterator /
5964   Extend][37306]
5965 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
5966 * [`ReadDir` implements `Debug`][37221]
5967 * [Implement `RefUnwindSafe` for atomic types][37178]
5968 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
5969 * [Avoid allocations in `Decoder::read_str`][37064]
5970 * [`io::Error` implements `From<io::ErrorKind>`][37037]
5971 * [Impl `Debug` for raw pointers to unsized data][36880]
5972 * [Don't reuse `HashMap` random seeds][37470]
5973 * [The internal memory layout of `HashMap` is more cache-friendly, for
5974   significant improvements in some operations][36692]
5975 * [`HashMap` uses less memory on 32-bit architectures][36595]
5976 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
5977
5978 Cargo
5979 -----
5980
5981 * [Expose rustc cfg values to build scripts][cargo/3243]
5982 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
5983 * [Fix passing --features when testing multiple packages][cargo/3280]
5984 * [Use a single profile set per workspace][cargo/3249]
5985 * [Load `replace` sections from lock files][cargo/3220]
5986 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
5987
5988 Tooling
5989 -------
5990
5991 * [rustup is the recommended Rust installation method][1.14rustup]
5992 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
5993   S390x. These are [tier 2] platforms and may have major defects. Follow the
5994   instructions on the website to install, or add the targets to an existing
5995   installation with `rustup target add`. The new target triples are:
5996   - `mips-unknown-linux-gnu`
5997   - `mipsel-unknown-linux-gnu`
5998   - `mips64-unknown-linux-gnuabi64`
5999   - `mips64el-unknown-linux-gnuabi64 `
6000   - `powerpc-unknown-linux-gnu`
6001   - `powerpc64-unknown-linux-gnu`
6002   - `powerpc64le-unknown-linux-gnu`
6003   - `s390x-unknown-linux-gnu `
6004 * This release includes target (std) builds for ARM Linux running MUSL
6005   libc. These are [tier 2] platforms and may have major defects. Add the
6006   following triples to an existing rustup installation with `rustup target add`:
6007   - `arm-unknown-linux-musleabi`
6008   - `arm-unknown-linux-musleabihf`
6009   - `armv7-unknown-linux-musleabihf`
6010 * This release includes [experimental support for WebAssembly][1.14wasm], via
6011   the `wasm32-unknown-emscripten` target. This target is known to have major
6012   defects. Please test, report, and fix.
6013 * rustup no longer installs documentation by default. Run `rustup
6014   component add rust-docs` to install.
6015 * [Fix line stepping in debugger][37310]
6016 * [Enable line number debuginfo in releases][37280]
6017
6018 Misc
6019 ----
6020
6021 * [Disable jemalloc on aarch64/powerpc/mips][37392]
6022 * [Add support for Fuchsia OS][37313]
6023 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
6024
6025 Compatibility Notes
6026 -------------------
6027
6028 * [A number of forward-compatibility lints used by the compiler
6029   to gradually introduce language changes have been converted
6030   to deny by default][36894]:
6031   - ["use of inaccessible extern crate erroneously allowed"][36886]
6032   - ["type parameter default erroneously allowed in invalid location"][36887]
6033   - ["detects super or self keywords at the beginning of global path"][36888]
6034   - ["two overlapping inherent impls define an item with the same name
6035     were erroneously allowed"][36889]
6036   - ["floating-point constants cannot be used in patterns"][36890]
6037   - ["constants of struct or enum type can only be used in a pattern if
6038      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
6039   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
6040 * [Prohibit patterns in trait methods without bodies][37378]
6041 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
6042 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
6043 * [The `$crate` macro variable is accepted in fewer locations][37213]
6044 * [Impls specifying extra region requirements beyond the trait
6045   they implement are rejected][37167]
6046 * [Enums may not be unsized][37111]. Unsized enums are intended to
6047   work but never have. For now they are forbidden.
6048 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
6049
6050 [tier 2]: https://forge.rust-lang.org/platform-support.html
6051 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
6052 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
6053 [36430]: https://github.com/rust-lang/rust/pull/36430
6054 [36595]: https://github.com/rust-lang/rust/pull/36595
6055 [36595]: https://github.com/rust-lang/rust/pull/36595
6056 [36692]: https://github.com/rust-lang/rust/pull/36692
6057 [36767]: https://github.com/rust-lang/rust/pull/36767
6058 [36794]: https://github.com/rust-lang/rust/pull/36794
6059 [36798]: https://github.com/rust-lang/rust/pull/36798
6060 [36819]: https://github.com/rust-lang/rust/pull/36819
6061 [36822]: https://github.com/rust-lang/rust/pull/36822
6062 [36825]: https://github.com/rust-lang/rust/pull/36825
6063 [36843]: https://github.com/rust-lang/rust/pull/36843
6064 [36880]: https://github.com/rust-lang/rust/pull/36880
6065 [36886]: https://github.com/rust-lang/rust/issues/36886
6066 [36887]: https://github.com/rust-lang/rust/issues/36887
6067 [36888]: https://github.com/rust-lang/rust/issues/36888
6068 [36889]: https://github.com/rust-lang/rust/issues/36889
6069 [36890]: https://github.com/rust-lang/rust/issues/36890
6070 [36891]: https://github.com/rust-lang/rust/issues/36891
6071 [36892]: https://github.com/rust-lang/rust/issues/36892
6072 [36894]: https://github.com/rust-lang/rust/pull/36894
6073 [36917]: https://github.com/rust-lang/rust/pull/36917
6074 [36993]: https://github.com/rust-lang/rust/pull/36993
6075 [37037]: https://github.com/rust-lang/rust/pull/37037
6076 [37064]: https://github.com/rust-lang/rust/pull/37064
6077 [37094]: https://github.com/rust-lang/rust/pull/37094
6078 [37108]: https://github.com/rust-lang/rust/pull/37108
6079 [37111]: https://github.com/rust-lang/rust/pull/37111
6080 [37161]: https://github.com/rust-lang/rust/pull/37161
6081 [37162]: https://github.com/rust-lang/rust/pull/37162
6082 [37167]: https://github.com/rust-lang/rust/pull/37167
6083 [37178]: https://github.com/rust-lang/rust/pull/37178
6084 [37200]: https://github.com/rust-lang/rust/pull/37200
6085 [37213]: https://github.com/rust-lang/rust/pull/37213
6086 [37221]: https://github.com/rust-lang/rust/pull/37221
6087 [37224]: https://github.com/rust-lang/rust/pull/37224
6088 [37230]: https://github.com/rust-lang/rust/pull/37230
6089 [37231]: https://github.com/rust-lang/rust/pull/37231
6090 [37247]: https://github.com/rust-lang/rust/pull/37247
6091 [37267]: https://github.com/rust-lang/rust/pull/37267
6092 [37270]: https://github.com/rust-lang/rust/pull/37270
6093 [37273]: https://github.com/rust-lang/rust/pull/37273
6094 [37280]: https://github.com/rust-lang/rust/pull/37280
6095 [37298]: https://github.com/rust-lang/rust/pull/37298
6096 [37306]: https://github.com/rust-lang/rust/pull/37306
6097 [37310]: https://github.com/rust-lang/rust/pull/37310
6098 [37312]: https://github.com/rust-lang/rust/pull/37312
6099 [37313]: https://github.com/rust-lang/rust/pull/37313
6100 [37315]: https://github.com/rust-lang/rust/pull/37315
6101 [37318]: https://github.com/rust-lang/rust/pull/37318
6102 [37322]: https://github.com/rust-lang/rust/pull/37322
6103 [37326]: https://github.com/rust-lang/rust/pull/37326
6104 [37351]: https://github.com/rust-lang/rust/pull/37351
6105 [37356]: https://github.com/rust-lang/rust/pull/37356
6106 [37367]: https://github.com/rust-lang/rust/pull/37367
6107 [37373]: https://github.com/rust-lang/rust/pull/37373
6108 [37378]: https://github.com/rust-lang/rust/pull/37378
6109 [37389]: https://github.com/rust-lang/rust/pull/37389
6110 [37392]: https://github.com/rust-lang/rust/pull/37392
6111 [37427]: https://github.com/rust-lang/rust/pull/37427
6112 [37439]: https://github.com/rust-lang/rust/pull/37439
6113 [37445]: https://github.com/rust-lang/rust/pull/37445
6114 [37470]: https://github.com/rust-lang/rust/pull/37470
6115 [37569]: https://github.com/rust-lang/rust/pull/37569
6116 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
6117 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
6118 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
6119 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
6120 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
6121 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
6122 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
6123
6124
6125 Version 1.13.0 (2016-11-10)
6126 ===========================
6127
6128 Language
6129 --------
6130
6131 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
6132   errors, like the `try!` macro, described in [RFC 0243].
6133 * [Stabilize macros in type position][36014]. Described in [RFC 873].
6134 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
6135 * [Fix `#[derive]` for empty tuple structs/variants][35728]
6136 * [Fix lifetime rules for 'if' conditions][36029]
6137 * [Avoid loading and parsing unconfigured non-inline modules][36482]
6138
6139 Compiler
6140 --------
6141
6142 * [Add the `-C link-arg` argument][36574]
6143 * [Remove the old AST-based backend from rustc_trans][35764]
6144 * [Don't enable NEON by default on armv7 Linux][35814]
6145 * [Fix debug line number info for macro expansions][35238]
6146 * [Do not emit "class method" debuginfo for types that are not
6147   DICompositeType][36008]
6148 * [Warn about multiple conflicting #[repr] hints][34623]
6149 * [When sizing DST, don't double-count nested struct prefixes][36351]
6150 * [Default RUST_MIN_STACK to 16MiB for now][36505]
6151 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
6152 * [Reject macros with empty repetitions to avoid infinite loop][36721]
6153 * [Expand macros without recursing to avoid stack overflows][36214]
6154
6155 Diagnostics
6156 -----------
6157
6158 * [Replace macro backtraces with labeled local uses][35702]
6159 * [Improve error message for misplaced doc comments][33922]
6160 * [Buffer unix and lock windows to prevent message interleaving][35975]
6161 * [Update lifetime errors to specifically note temporaries][36171]
6162 * [Special case a few colors for Windows][36178]
6163 * [Suggest `use self` when such an import resolves][36289]
6164 * [Be more specific when type parameter shadows primitive type][36338]
6165 * Many minor improvements
6166
6167 Compile-time Optimizations
6168 --------------------------
6169
6170 * [Compute and cache HIR hashes at beginning][35854]
6171 * [Don't hash types in loan paths][36004]
6172 * [Cache projections in trans][35761]
6173 * [Optimize the parser's last token handling][36527]
6174 * [Only instantiate #[inline] functions in codegen units referencing
6175   them][36524]. This leads to big improvements in cases where crates export
6176   define many inline functions without using them directly.
6177 * [Lazily allocate TypedArena's first chunk][36592]
6178 * [Don't allocate during default HashSet creation][36734]
6179
6180 Stabilized APIs
6181 ---------------
6182
6183 * [`checked_abs`]
6184 * [`wrapping_abs`]
6185 * [`overflowing_abs`]
6186 * [`RefCell::try_borrow`]
6187 * [`RefCell::try_borrow_mut`]
6188
6189 Libraries
6190 ---------
6191
6192 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
6193 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
6194   covariant][35354]
6195 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
6196 * [Implement `Debug` for `std::vec::IntoIter`][35707]
6197 * [`CString`: avoid excessive growth just to 0-terminate][35871]
6198 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
6199 * [Use arc4rand on FreeBSD][35884]
6200 * [memrchr: Correct aligned offset computation][35969]
6201 * [Improve Demangling of Rust Symbols][36059]
6202 * [Use monotonic time in condition variables][35048]
6203 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
6204 * [Implement conversion traits for `char`][35755]
6205 * [Fix illegal instruction caused by overflow in channel cloning][36104]
6206 * [Zero first byte of CString on drop][36264]
6207 * [Inherit overflow checks for sum and product][36372]
6208 * [Add missing Eq implementations][36423]
6209 * [Implement `Debug` for `DirEntry`][36631]
6210 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
6211   `errno`][36754]
6212 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6213 * [Implement more traits for `std::io::ErrorKind`][35911]
6214 * [Optimize BinaryHeap bounds checking][36072]
6215 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
6216   `extend_with_element`][36355]
6217 * [Fix overflow checking in unsigned pow()][34942]
6218
6219 Cargo
6220 -----
6221
6222 * This release includes security fixes to both curl and OpenSSL.
6223 * [Fix transitive doctests when panic=abort][cargo/3021]
6224 * [Add --all-features flag to cargo][cargo/3038]
6225 * [Reject path-based dependencies in `cargo package`][cargo/3060]
6226 * [Don't parse the home directory more than once][cargo/3078]
6227 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
6228 * [Update OpenSSL to 1.0.2j][cargo/3121]
6229 * [Add license and license_file to cargo metadata output][cargo/3110]
6230 * [Make crates-io registry URL optional in config; ignore all changes to
6231   source.crates-io][cargo/3089]
6232 * [Don't download dependencies from other platforms][cargo/3123]
6233 * [Build transitive dev-dependencies when needed][cargo/3125]
6234 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
6235 * [Avoid updating registry when adding existing deps][cargo/3144]
6236 * [Warn about path overrides that won't work][cargo/3136]
6237 * [Use workspaces during `cargo install`][cargo/3146]
6238 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
6239 * [Add --message-format flag][cargo/3000]
6240 * [Pass target environment for rustdoc][cargo/3205]
6241 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
6242 * [Update curl and curl-sys][cargo/3241]
6243 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
6244
6245 Tooling
6246 -------
6247
6248 * [rustdoc: Add the `--sysroot` argument][36586]
6249 * [rustdoc: Fix a couple of issues with the search results][35655]
6250 * [rustdoc: remove the `!` from macro URLs and titles][35234]
6251 * [gdb: Fix pretty-printing special-cased Rust types][35585]
6252 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
6253
6254 Misc
6255 ----
6256
6257 * [Remove unmaintained style guide][35124]
6258 * [Add s390x support][36369]
6259 * [Initial work at Haiku OS support][36727]
6260 * [Add mips-uclibc targets][35734]
6261 * [Crate-ify compiler-rt into compiler-builtins][35021]
6262 * [Add rustc version info (git hash + date) to dist tarball][36213]
6263 * Many documentation improvements
6264
6265 Compatibility Notes
6266 -------------------
6267
6268 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
6269 * [Deny (by default) transmuting from fn item types to pointer-sized
6270   types][34923]. Continuing the long transition to zero-sized fn items,
6271   per [RFC 401].
6272 * [Fix `#[derive]` for empty tuple structs/variants][35728].
6273   Part of [RFC 1506].
6274 * [Issue deprecation warnings for safe accesses to extern statics][36173]
6275 * [Fix lifetime rules for 'if' conditions][36029].
6276 * [Inherit overflow checks for sum and product][36372].
6277 * [Forbid user-defined macros named "macro_rules"][36730].
6278
6279 [33922]: https://github.com/rust-lang/rust/pull/33922
6280 [34623]: https://github.com/rust-lang/rust/pull/34623
6281 [34923]: https://github.com/rust-lang/rust/pull/34923
6282 [34942]: https://github.com/rust-lang/rust/pull/34942
6283 [34982]: https://github.com/rust-lang/rust/pull/34982
6284 [35021]: https://github.com/rust-lang/rust/pull/35021
6285 [35048]: https://github.com/rust-lang/rust/pull/35048
6286 [35074]: https://github.com/rust-lang/rust/pull/35074
6287 [35124]: https://github.com/rust-lang/rust/pull/35124
6288 [35234]: https://github.com/rust-lang/rust/pull/35234
6289 [35238]: https://github.com/rust-lang/rust/pull/35238
6290 [35354]: https://github.com/rust-lang/rust/pull/35354
6291 [35559]: https://github.com/rust-lang/rust/pull/35559
6292 [35585]: https://github.com/rust-lang/rust/pull/35585
6293 [35627]: https://github.com/rust-lang/rust/pull/35627
6294 [35655]: https://github.com/rust-lang/rust/pull/35655
6295 [35702]: https://github.com/rust-lang/rust/pull/35702
6296 [35707]: https://github.com/rust-lang/rust/pull/35707
6297 [35728]: https://github.com/rust-lang/rust/pull/35728
6298 [35734]: https://github.com/rust-lang/rust/pull/35734
6299 [35755]: https://github.com/rust-lang/rust/pull/35755
6300 [35761]: https://github.com/rust-lang/rust/pull/35761
6301 [35764]: https://github.com/rust-lang/rust/pull/35764
6302 [35814]: https://github.com/rust-lang/rust/pull/35814
6303 [35854]: https://github.com/rust-lang/rust/pull/35854
6304 [35871]: https://github.com/rust-lang/rust/pull/35871
6305 [35884]: https://github.com/rust-lang/rust/pull/35884
6306 [35911]: https://github.com/rust-lang/rust/pull/35911
6307 [35969]: https://github.com/rust-lang/rust/pull/35969
6308 [35975]: https://github.com/rust-lang/rust/pull/35975
6309 [36004]: https://github.com/rust-lang/rust/pull/36004
6310 [36008]: https://github.com/rust-lang/rust/pull/36008
6311 [36014]: https://github.com/rust-lang/rust/pull/36014
6312 [36029]: https://github.com/rust-lang/rust/pull/36029
6313 [36059]: https://github.com/rust-lang/rust/pull/36059
6314 [36072]: https://github.com/rust-lang/rust/pull/36072
6315 [36101]: https://github.com/rust-lang/rust/pull/36101
6316 [36104]: https://github.com/rust-lang/rust/pull/36104
6317 [36171]: https://github.com/rust-lang/rust/pull/36171
6318 [36173]: https://github.com/rust-lang/rust/pull/36173
6319 [36178]: https://github.com/rust-lang/rust/pull/36178
6320 [36213]: https://github.com/rust-lang/rust/pull/36213
6321 [36214]: https://github.com/rust-lang/rust/pull/36214
6322 [36264]: https://github.com/rust-lang/rust/pull/36264
6323 [36266]: https://github.com/rust-lang/rust/pull/36266
6324 [36289]: https://github.com/rust-lang/rust/pull/36289
6325 [36338]: https://github.com/rust-lang/rust/pull/36338
6326 [36351]: https://github.com/rust-lang/rust/pull/36351
6327 [36355]: https://github.com/rust-lang/rust/pull/36355
6328 [36369]: https://github.com/rust-lang/rust/pull/36369
6329 [36372]: https://github.com/rust-lang/rust/pull/36372
6330 [36423]: https://github.com/rust-lang/rust/pull/36423
6331 [36482]: https://github.com/rust-lang/rust/pull/36482
6332 [36505]: https://github.com/rust-lang/rust/pull/36505
6333 [36524]: https://github.com/rust-lang/rust/pull/36524
6334 [36527]: https://github.com/rust-lang/rust/pull/36527
6335 [36551]: https://github.com/rust-lang/rust/pull/36551
6336 [36574]: https://github.com/rust-lang/rust/pull/36574
6337 [36586]: https://github.com/rust-lang/rust/pull/36586
6338 [36592]: https://github.com/rust-lang/rust/pull/36592
6339 [36631]: https://github.com/rust-lang/rust/pull/36631
6340 [36639]: https://github.com/rust-lang/rust/pull/36639
6341 [36721]: https://github.com/rust-lang/rust/pull/36721
6342 [36727]: https://github.com/rust-lang/rust/pull/36727
6343 [36730]: https://github.com/rust-lang/rust/pull/36730
6344 [36734]: https://github.com/rust-lang/rust/pull/36734
6345 [36754]: https://github.com/rust-lang/rust/pull/36754
6346 [36995]: https://github.com/rust-lang/rust/pull/36995
6347 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
6348 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
6349 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
6350 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
6351 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
6352 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
6353 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
6354 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
6355 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
6356 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
6357 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
6358 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
6359 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
6360 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
6361 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
6362 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
6363 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
6364 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
6365 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
6366 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
6367 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
6368 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
6369 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
6370 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
6371 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
6372 [rustup]: https://www.rustup.rs
6373 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
6374 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
6375 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
6376 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
6377 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
6378 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
6379 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
6380
6381
6382 Version 1.12.1 (2016-10-20)
6383 ===========================
6384
6385 Regression Fixes
6386 ----------------
6387
6388 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
6389 * [Confusion with double negation and booleans][36856]
6390 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
6391 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
6392 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
6393 * [Corrupted memory after updated to 1.12][36936]
6394 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
6395 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
6396 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
6397
6398 [36381]: https://github.com/rust-lang/rust/issues/36381
6399 [36856]: https://github.com/rust-lang/rust/issues/36856
6400 [36875]: https://github.com/rust-lang/rust/issues/36875
6401 [36924]: https://github.com/rust-lang/rust/issues/36924
6402 [36926]: https://github.com/rust-lang/rust/issues/36926
6403 [36936]: https://github.com/rust-lang/rust/issues/36936
6404 [37026]: https://github.com/rust-lang/rust/issues/37026
6405 [37112]: https://github.com/rust-lang/rust/issues/37112
6406 [37153]: https://github.com/rust-lang/rust/issues/37153
6407
6408
6409 Version 1.12.0 (2016-09-29)
6410 ===========================
6411
6412 Highlights
6413 ----------
6414
6415 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6416   This translation pass is far simpler than the previous AST->LLVM pass, and
6417   creates opportunities to perform new optimizations directly on the MIR. It
6418   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6419 * [`rustc` presents a new, more readable error format, along with
6420   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6421   Most common editors supporting Rust have been updated to work with it. It was
6422   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6423
6424 Compiler
6425 --------
6426
6427 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
6428   This translation pass is far simpler than the previous AST->LLVM pass, and
6429   creates opportunities to perform new optimizations directly on the MIR. It
6430   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
6431 * [Print the Rust target name, not the LLVM target name, with
6432   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
6433 * [The computation of `TypeId` is correct in some cases where it was previously
6434   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
6435 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
6436 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
6437   `--print relocation-models`, and `--print code-models` print the available
6438   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
6439   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
6440 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
6441   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
6442   These targets produce statically-linked binaries. There are no binary release
6443   builds yet though.
6444
6445 Diagnostics
6446 -----------
6447
6448 * [`rustc` presents a new, more readable error format, along with
6449   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
6450   Most common editors supporting Rust have been updated to work with it. It was
6451   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
6452 * [In error descriptions, references are now described in plain English,
6453   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
6454 * [In error type descriptions, unknown numeric types are named `{integer}` or
6455   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
6456 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
6457
6458 Language
6459 --------
6460
6461 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
6462 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
6463 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
6464   useful](https://github.com/rust-lang/rust/pull/34908)
6465 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
6466   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
6467 * [Semicolons are properly required as statement delimiters inside
6468   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
6469 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
6470
6471 Stabilized APIs
6472 ---------------
6473
6474 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
6475 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
6476 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
6477 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
6478 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
6479 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
6480 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
6481 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
6482 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
6483 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
6484   Both on Unix and Windows.
6485 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
6486 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
6487 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
6488 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
6489 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
6490 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
6491 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
6492 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
6493
6494 Libraries
6495 ---------
6496
6497 * [The `format!` macro and friends now allow a single argument to be formatted
6498   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
6499 * [The lifetime bounds on `[T]::binary_search_by` and
6500   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
6501 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
6502 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
6503 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
6504 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
6505 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
6506 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
6507 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
6508 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
6509   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
6510 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
6511   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
6512 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
6513 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
6514   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
6515 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
6516 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
6517 * [`mpsc::sync_channel` `Receiver`s return any available message before
6518   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
6519 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
6520 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
6521
6522 Cargo
6523 -----
6524
6525 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
6526 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
6527 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
6528 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
6529 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
6530 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
6531 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
6532 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
6533 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
6534 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
6535 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
6536 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
6537 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
6538 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
6539 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
6540 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
6541
6542 Performance
6543 -----------
6544
6545 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
6546 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
6547
6548 Tooling
6549 -------
6550
6551 * [Test binaries now support a `--test-threads` argument to specify the number
6552   of threads used to run tests, and which acts the same as the
6553   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
6554 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
6555 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
6556 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6557 * [Rust releases now come with source packages that can be installed by rustup
6558   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
6559   The resulting source code can be used by tools and IDES, located in the
6560   sysroot under `lib/rustlib/src`.
6561
6562 Misc
6563 ----
6564
6565 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
6566 * Many minor improvements to the documentation.
6567 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
6568
6569 Compatibility Notes
6570 -------------------
6571
6572 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
6573   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
6574 * [When formatting strings, if "precision" is specified, the "fill",
6575   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
6576 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
6577
6578
6579 Version 1.11.0 (2016-08-18)
6580 ===========================
6581
6582 Language
6583 --------
6584
6585 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
6586 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
6587 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
6588 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
6589
6590 Stabilized APIs
6591 ---------------
6592
6593 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
6594 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
6595 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
6596 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
6597 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
6598 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
6599   (in libcore - previously stabilized in libstd)
6600 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
6601   (in libcore - previously stabilized in libstd)
6602 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
6603   (in libcore - previously stabilized in libstd)
6604 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
6605   (in libcore - previously stabilized in libstd)
6606 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6607 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
6608 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
6609 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
6610
6611 Libraries
6612 ---------
6613
6614 * [The `thread_local!` macro supports multiple definitions in a single
6615    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
6616 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
6617 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
6618   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
6619 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
6620 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
6621 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
6622 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
6623
6624 Cargo
6625 -----
6626
6627 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
6628 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
6629 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
6630 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
6631 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
6632   and `-vv` prints warnings for all crates.
6633 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
6634 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
6635   This provides room for expansion by arbitrary tools.
6636 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
6637 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
6638 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
6639 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
6640 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
6641 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
6642 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
6643
6644 Performance
6645 -----------
6646
6647 * [Caching projections speeds up type check dramatically for some
6648   workloads](https://github.com/rust-lang/rust/pull/33816)
6649 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
6650   This hasher is faster, but is believed to provide sufficient
6651   protection from collision attacks.
6652 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
6653
6654 Rustdoc
6655 -------
6656
6657 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
6658 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
6659 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
6660 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
6661 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
6662
6663 Tooling
6664 -------
6665
6666 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
6667 * [When emitting debug info, rustc emits frame pointers for closures,
6668   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
6669 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
6670 * Many more errors have been given error codes and extended
6671   explanations
6672 * API documentation continues to be improved, with many new examples
6673
6674 Misc
6675 ----
6676
6677 * [rustc no longer hangs when dependencies recursively re-export
6678   submodules](https://github.com/rust-lang/rust/pull/34542)
6679 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
6680 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
6681   rewritten](https://github.com/rust-lang/rust/pull/33895)
6682 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
6683   No targets use this yet, but it works toward AVR support.
6684
6685 Compatibility Notes
6686 -------------------
6687
6688 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
6689 * [The new follow-set rules that place restrictions on `macro_rules!`
6690   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
6691   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
6692   and has been a warning since 1.10.
6693 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
6694   This causes breakage in some corner cases.
6695
6696
6697 Version 1.10.0 (2016-07-07)
6698 ===========================
6699
6700 Language
6701 --------
6702
6703 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
6704   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
6705 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
6706 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
6707 * [`panic!` can be converted to a runtime abort with the
6708   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
6709   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6710 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
6711   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
6712   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
6713   Note that Cargo does not yet directly support cdylibs.
6714
6715 Stabilized APIs
6716 ---------------
6717
6718 * `os::windows::fs::OpenOptionsExt::access_mode`
6719 * `os::windows::fs::OpenOptionsExt::share_mode`
6720 * `os::windows::fs::OpenOptionsExt::custom_flags`
6721 * `os::windows::fs::OpenOptionsExt::attributes`
6722 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
6723 * `os::unix::fs::OpenOptionsExt::custom_flags`
6724 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
6725 * `Default for sync::Weak`
6726 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
6727 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
6728 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
6729 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
6730 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
6731 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
6732 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
6733 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
6734 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
6735 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
6736 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
6737 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
6738 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
6739 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
6740 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
6741 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
6742 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
6743 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
6744 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
6745 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
6746 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
6747 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
6748 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
6749 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
6750 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
6751 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6752 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6753 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
6754 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
6755 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
6756 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
6757 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
6758 * Read/Write/RawFd impls for `UnixStream`
6759 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
6760 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
6761 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
6762 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
6763 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
6764 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
6765 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
6766 * RawFd impls for `UnixListener`
6767 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
6768 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
6769 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
6770 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
6771 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
6772 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
6773 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
6774 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
6775 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
6776 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
6777 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
6778 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
6779 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
6780 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
6781 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
6782 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
6783 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
6784 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
6785 * RawFd impls for `UnixDatagram`
6786 * `{BTree,Hash}Map::values_mut`
6787 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
6788
6789 Libraries
6790 ---------
6791
6792 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
6793   The semantics of this minor method are subtle and probably not what
6794   most people want.
6795 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
6796 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
6797   will fall back to `/dev/urandom` temporarily to avoid blocking
6798   during early boot](https://github.com/rust-lang/rust/pull/33086).
6799 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
6800 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
6801 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
6802 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
6803 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
6804 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
6805   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
6806
6807 Cargo
6808 -----
6809 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
6810   This controls the runtime behavior of the `panic!` macro
6811   and can be either "unwind" (the default), or "abort".
6812   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
6813 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
6814 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
6815 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
6816   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
6817 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
6818 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
6819 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
6820   By default they are retried twice, which can be customized with the
6821   `net.retry` value in `.cargo/config`.
6822 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
6823 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
6824 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
6825 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
6826   Makes it possible to install multiple crates in parallel.
6827 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
6828 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
6829 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
6830 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
6831 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
6832 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
6833
6834 Performance
6835 -----------
6836
6837 * [rustc memory usage was reduced by refactoring the context used for
6838   type checking](https://github.com/rust-lang/rust/pull/33425).
6839 * [Speed up creation of `HashMap`s by caching the random keys used
6840   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
6841 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
6842 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
6843 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
6844   10x faster than the previous lookup tables.
6845 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
6846
6847 Usability
6848 ---------
6849
6850 * Many incremental improvements to documentation and rustdoc.
6851 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
6852 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
6853 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
6854 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
6855 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
6856 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
6857 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
6858
6859 Misc
6860 ----
6861
6862 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
6863 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
6864 * [`std` no longer prints backtraces on platforms where the running
6865   module must be loaded with `env::current_exe`, which can't be relied
6866   on](https://github.com/rust-lang/rust/pull/33554).
6867 * This release includes std binaries for the i586-unknown-linux-gnu,
6868   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
6869   i586 target is for old x86 hardware without SSE2, and the armv7
6870   target is for Android running on modern ARM architectures.
6871 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
6872   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
6873 * [On Unix the runtime aborts by calling `libc::abort` instead of
6874   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
6875 * [Rust is now bootstrapped from the previous release of Rust,
6876   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
6877
6878 Compatibility Notes
6879 -------------------
6880
6881 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
6882 * [`target_env` for Linux ARM targets is just `gnu`, not
6883   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
6884 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
6885 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
6886 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
6887   Affects how macros are parsed.
6888 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
6889 * [Feature-gated attributes on macro-generated macro invocations are
6890   now rejected](https://github.com/rust-lang/rust/pull/32791).
6891 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
6892   This caused some minor changes to type inference.
6893
6894
6895 Version 1.9.0 (2016-05-26)
6896 ==========================
6897
6898 Language
6899 --------
6900
6901 * The `#[deprecated]` attribute when applied to an API will generate
6902   warnings when used. The warnings may be suppressed with
6903   `#[allow(deprecated)]`. [RFC 1270].
6904 * [`fn` item types are zero sized, and each `fn` names a unique
6905   type][1.9fn]. This will break code that transmutes `fn`s, so calling
6906   `transmute` on a `fn` type will generate a warning for a few cycles,
6907   then will be converted to an error.
6908 * [Field and method resolution understand visibility, so private
6909   fields and methods cannot prevent the proper use of public fields
6910   and methods][1.9fv].
6911 * [The parser considers unicode codepoints in the
6912   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
6913
6914 Stabilized APIs
6915 ---------------
6916
6917 * [`std::panic`]
6918 * [`std::panic::catch_unwind`] (renamed from `recover`)
6919 * [`std::panic::resume_unwind`] (renamed from `propagate`)
6920 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
6921 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
6922 * [`str::is_char_boundary`]
6923 * [`<*const T>::as_ref`]
6924 * [`<*mut T>::as_ref`]
6925 * [`<*mut T>::as_mut`]
6926 * [`AsciiExt::make_ascii_uppercase`]
6927 * [`AsciiExt::make_ascii_lowercase`]
6928 * [`char::decode_utf16`]
6929 * [`char::DecodeUtf16`]
6930 * [`char::DecodeUtf16Error`]
6931 * [`char::DecodeUtf16Error::unpaired_surrogate`]
6932 * [`BTreeSet::take`]
6933 * [`BTreeSet::replace`]
6934 * [`BTreeSet::get`]
6935 * [`HashSet::take`]
6936 * [`HashSet::replace`]
6937 * [`HashSet::get`]
6938 * [`OsString::with_capacity`]
6939 * [`OsString::clear`]
6940 * [`OsString::capacity`]
6941 * [`OsString::reserve`]
6942 * [`OsString::reserve_exact`]
6943 * [`OsStr::is_empty`]
6944 * [`OsStr::len`]
6945 * [`std::os::unix::thread`]
6946 * [`RawPthread`]
6947 * [`JoinHandleExt`]
6948 * [`JoinHandleExt::as_pthread_t`]
6949 * [`JoinHandleExt::into_pthread_t`]
6950 * [`HashSet::hasher`]
6951 * [`HashMap::hasher`]
6952 * [`CommandExt::exec`]
6953 * [`File::try_clone`]
6954 * [`SocketAddr::set_ip`]
6955 * [`SocketAddr::set_port`]
6956 * [`SocketAddrV4::set_ip`]
6957 * [`SocketAddrV4::set_port`]
6958 * [`SocketAddrV6::set_ip`]
6959 * [`SocketAddrV6::set_port`]
6960 * [`SocketAddrV6::set_flowinfo`]
6961 * [`SocketAddrV6::set_scope_id`]
6962 * [`slice::copy_from_slice`]
6963 * [`ptr::read_volatile`]
6964 * [`ptr::write_volatile`]
6965 * [`OpenOptions::create_new`]
6966 * [`TcpStream::set_nodelay`]
6967 * [`TcpStream::nodelay`]
6968 * [`TcpStream::set_ttl`]
6969 * [`TcpStream::ttl`]
6970 * [`TcpStream::set_only_v6`]
6971 * [`TcpStream::only_v6`]
6972 * [`TcpStream::take_error`]
6973 * [`TcpStream::set_nonblocking`]
6974 * [`TcpListener::set_ttl`]
6975 * [`TcpListener::ttl`]
6976 * [`TcpListener::set_only_v6`]
6977 * [`TcpListener::only_v6`]
6978 * [`TcpListener::take_error`]
6979 * [`TcpListener::set_nonblocking`]
6980 * [`UdpSocket::set_broadcast`]
6981 * [`UdpSocket::broadcast`]
6982 * [`UdpSocket::set_multicast_loop_v4`]
6983 * [`UdpSocket::multicast_loop_v4`]
6984 * [`UdpSocket::set_multicast_ttl_v4`]
6985 * [`UdpSocket::multicast_ttl_v4`]
6986 * [`UdpSocket::set_multicast_loop_v6`]
6987 * [`UdpSocket::multicast_loop_v6`]
6988 * [`UdpSocket::set_multicast_ttl_v6`]
6989 * [`UdpSocket::multicast_ttl_v6`]
6990 * [`UdpSocket::set_ttl`]
6991 * [`UdpSocket::ttl`]
6992 * [`UdpSocket::set_only_v6`]
6993 * [`UdpSocket::only_v6`]
6994 * [`UdpSocket::join_multicast_v4`]
6995 * [`UdpSocket::join_multicast_v6`]
6996 * [`UdpSocket::leave_multicast_v4`]
6997 * [`UdpSocket::leave_multicast_v6`]
6998 * [`UdpSocket::take_error`]
6999 * [`UdpSocket::connect`]
7000 * [`UdpSocket::send`]
7001 * [`UdpSocket::recv`]
7002 * [`UdpSocket::set_nonblocking`]
7003
7004 Libraries
7005 ---------
7006
7007 * [`std::sync::Once` is poisoned if its initialization function
7008   fails][1.9o].
7009 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
7010 * [Most types implement `fmt::Debug`][1.9db].
7011 * [The default buffer size used by `BufReader` and `BufWriter` was
7012   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
7013   used by other languages.
7014 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
7015   `Duration` additionally implements `*=` and `/=`][1.9ta].
7016 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
7017 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
7018 * [`Chain` implements `BufRead`][1.9ch].
7019 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
7020
7021 Cargo
7022 -----
7023
7024 * [Cargo can now run concurrently][1.9cc].
7025 * [Top-level overrides allow specific revisions of crates to be
7026   overridden through the entire crate graph][1.9ct].  This is intended
7027   to make upgrades easier for large projects, by allowing crates to be
7028   forked temporarily until they've been upgraded and republished.
7029 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
7030 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
7031   on the commandline][1.9cf]. `rustc` arguments can also be specified
7032   in the `build.rustflags` configuration key.
7033
7034 Performance
7035 -----------
7036
7037 * [The time complexity of comparing variables for equivalence during type
7038   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
7039   to major compilation time improvement in some scenarios.
7040 * [`ToString` is specialized for `str`, giving it the same performance
7041   as `to_owned`][1.9ts].
7042 * [Spawning processes with `Command::output` no longer creates extra
7043   threads][1.9sp].
7044 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
7045   for C-like enums][1.9cl].
7046
7047 Misc
7048 ----
7049
7050 * [Passing the `--quiet` flag to a test runner will produce
7051   much-abbreviated output][1.9q].
7052 * The Rust Project now publishes std binaries for the
7053   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
7054   `i586-pc-windows-msvc` targets.
7055
7056 Compatibility Notes
7057 -------------------
7058
7059 * [`std::sync::Once` is poisoned if its initialization function
7060   fails][1.9o].
7061 * [It is illegal to define methods with the same name in overlapping
7062   inherent `impl` blocks][1.9sn].
7063 * [`fn` item types are zero sized, and each `fn` names a unique
7064   type][1.9fn]. This will break code that transmutes `fn`s, so calling
7065   `transmute` on a `fn` type will generate a warning for a few cycles,
7066   then will be converted to an error.
7067 * [Improvements to const evaluation may trigger new errors when integer
7068   literals are out of range][1.9ce].
7069
7070
7071 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
7072 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
7073 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
7074 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
7075 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
7076 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
7077 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
7078 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
7079 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
7080 [1.9db]: https://github.com/rust-lang/rust/pull/32054
7081 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
7082 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
7083 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
7084 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
7085 [1.9o]: https://github.com/rust-lang/rust/pull/32325
7086 [1.9q]: https://github.com/rust-lang/rust/pull/31887
7087 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
7088 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
7089 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
7090 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
7091 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
7092 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
7093 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
7094 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
7095 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7096 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
7097 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
7098 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
7099 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
7100 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
7101 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
7102 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
7103 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
7104 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
7105 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
7106 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
7107 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
7108 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
7109 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
7110 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
7111 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
7112 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
7113 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
7114 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
7115 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
7116 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
7117 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
7118 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
7119 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
7120 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
7121 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
7122 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
7123 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
7124 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
7125 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
7126 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
7127 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
7128 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
7129 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
7130 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
7131 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7132 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7133 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7134 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7135 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7136 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7137 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
7138 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
7139 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
7140 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
7141 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
7142 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
7143 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
7144 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
7145 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
7146 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
7147 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
7148 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
7149 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
7150 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
7151 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
7152 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
7153 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
7154 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
7155 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
7156 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
7157 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
7158 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
7159 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
7160 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
7161 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
7162 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
7163 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
7164 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
7165 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
7166 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
7167 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
7168 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
7169 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
7170 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
7171 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
7172 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
7173 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
7174 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
7175 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
7176 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
7177 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
7178 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
7179 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
7180 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
7181
7182
7183 Version 1.8.0 (2016-04-14)
7184 ==========================
7185
7186 Language
7187 --------
7188
7189 * Rust supports overloading of compound assignment statements like
7190   `+=` by implementing the [`AddAssign`], [`SubAssign`],
7191   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
7192   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
7193   traits. [RFC 953].
7194 * Empty structs can be defined with braces, as in `struct Foo { }`, in
7195   addition to the non-braced form, `struct Foo;`. [RFC 218].
7196
7197 Libraries
7198 ---------
7199
7200 * Stabilized APIs:
7201   * [`str::encode_utf16`] (renamed from `utf16_units`)
7202   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
7203   * [`Ref::map`]
7204   * [`RefMut::map`]
7205   * [`ptr::drop_in_place`]
7206   * [`time::Instant`]
7207   * [`time::SystemTime`]
7208   * [`Instant::now`]
7209   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
7210   * [`Instant::elapsed`]
7211   * [`SystemTime::now`]
7212   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
7213   * [`SystemTime::elapsed`]
7214   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
7215   * [`SystemTimeError`]
7216   * [`SystemTimeError::duration`]
7217   * Various impls for `SystemTimeError`
7218   * [`UNIX_EPOCH`]
7219   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
7220     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
7221     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
7222 * [The `write!` and `writeln!` macros correctly emit errors if any of
7223   their arguments can't be formatted][1.8w].
7224 * [Various I/O functions support large files on 32-bit Linux][1.8l].
7225 * [The Unix-specific `raw` modules, which contain a number of
7226   redefined C types are deprecated][1.8r], including `os::raw::unix`,
7227   `os::raw::macos`, and `os::raw::linux`. These modules defined types
7228   such as `ino_t` and `dev_t`. The inconsistency of these definitions
7229   across platforms was making it difficult to implement `std`
7230   correctly. Those that need these definitions should use the `libc`
7231   crate. [RFC 1415].
7232 * The Unix-specific `MetadataExt` traits, including
7233   `os::unix::fs::MetadataExt`, which expose values such as inode
7234   numbers [no longer return platform-specific types][1.8r], but
7235   instead return widened integers. [RFC 1415].
7236 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
7237 * [Atomic loads and stores are not volatile][1.8a].
7238 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
7239
7240 Performance
7241 -----------
7242
7243 * [Inlining hash functions lead to a 3% compile-time improvement in
7244   some workloads][1.8h].
7245 * When using jemalloc, its symbols are [unprefixed so that it
7246   overrides the libc malloc implementation][1.8h]. This means that for
7247   rustc, LLVM is now using jemalloc, which results in a 6%
7248   compile-time improvement on a specific workload.
7249 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
7250
7251 Misc
7252 ----
7253
7254 * [32-bit MSVC builds finally implement unwinding][1.8ms].
7255   i686-pc-windows-msvc is now considered a tier-1 platform.
7256 * [The `--print targets` flag prints a list of supported targets][1.8t].
7257 * [The `--print cfg` flag prints the `cfg`s defined for the current
7258   target][1.8cf].
7259 * [`rustc` can be built with an new Cargo-based build system, written
7260   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
7261   build system. To enable it configure with `configure --rustbuild`.
7262 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
7263   variants while also indicating the total number of missing variants
7264   if more than 3][1.8m].
7265 * [Executable stacks are disabled on Linux and BSD][1.8nx].
7266 * The Rust Project now publishes binary releases of the standard
7267   library for a number of tier-2 targets:
7268   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
7269   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
7270   `x86_64-rumprun-netbsd`. These can be installed with
7271   tools such as [multirust][1.8mr].
7272
7273 Cargo
7274 -----
7275
7276 * [`cargo init` creates a new Cargo project in the current
7277   directory][1.8ci].  It is otherwise like `cargo new`.
7278 * [Cargo has configuration keys for `-v` and
7279   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
7280   `[term]` section of `.cargo/config`.
7281 * [Configuration keys that evaluate to strings or integers can be set
7282   via environment variables][1.8ce]. For example the `build.jobs` key
7283   can be set via `CARGO_BUILD_JOBS`. Environment variables take
7284   precedence over config files.
7285 * [Target-specific dependencies support Rust `cfg` syntax for
7286   describing targets][1.8cfg] so that dependencies for multiple
7287   targets can be specified together. [RFC 1361].
7288 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
7289   `RUSTDOC` take precedence over the `build.target-dir`,
7290   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
7291 * [The child process tree is killed on Windows when Cargo is
7292   killed][1.8ck].
7293 * [The `build.target` configuration value sets the target platform,
7294   like `--target`][1.8ct].
7295
7296 Compatibility Notes
7297 -------------------
7298
7299 * [Unstable compiler flags have been further restricted][1.8u]. Since
7300   1.0 `-Z` flags have been considered unstable, and other flags that
7301   were considered unstable additionally required passing `-Z
7302   unstable-options` to access. Unlike unstable language and library
7303   features though, these options have been accessible on the stable
7304   release channel. Going forward, *new unstable flags will not be
7305   available on the stable release channel*, and old unstable flags
7306   will warn about their usage. In the future, all unstable flags will
7307   be unavailable on the stable release channel.
7308 * [It is no longer possible to `match` on empty enum variants using
7309   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
7310 * The Unix-specific `MetadataExt` traits, including
7311   `os::unix::fs::MetadataExt`, which expose values such as inode
7312   numbers [no longer return platform-specific types][1.8r], but
7313   instead return widened integers. [RFC 1415].
7314 * [Modules sourced from the filesystem cannot appear within arbitrary
7315   blocks, but only within other modules][1.8mf].
7316 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
7317 * On Unix, [stack overflow triggers a runtime abort instead of a
7318   SIGSEGV][1.8so].
7319 * [`Command::spawn` and its equivalents return an error if any of
7320   its command-line arguments contain interior `NUL`s][1.8n].
7321 * [Tuple and unit enum variants from other crates are in the type
7322   namespace][1.8tn].
7323 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
7324   type instead of `.a` files][1.8st]. Additionally, for the MSVC
7325   toolchain, `rustc` emits import libraries named `foo.dll.lib`
7326   instead of `foo.lib`.
7327
7328
7329 [1.8a]: https://github.com/rust-lang/rust/pull/30962
7330 [1.8b]: https://github.com/rust-lang/rust/pull/31123
7331 [1.8c]: https://github.com/rust-lang/rust/pull/31530
7332 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
7333 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
7334 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
7335 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
7336 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
7337 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
7338 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
7339 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
7340 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
7341 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
7342 [1.8h]: https://github.com/rust-lang/rust/pull/31460
7343 [1.8l]: https://github.com/rust-lang/rust/pull/31668
7344 [1.8m]: https://github.com/rust-lang/rust/pull/31020
7345 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
7346 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
7347 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
7348 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
7349 [1.8n]: https://github.com/rust-lang/rust/pull/31056
7350 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
7351 [1.8r]: https://github.com/rust-lang/rust/pull/31551
7352 [1.8so]: https://github.com/rust-lang/rust/pull/31333
7353 [1.8st]: https://github.com/rust-lang/rust/pull/29520
7354 [1.8t]: https://github.com/rust-lang/rust/pull/31358
7355 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
7356 [1.8u]: https://github.com/rust-lang/rust/pull/31793
7357 [1.8v]: https://github.com/rust-lang/rust/pull/31757
7358 [1.8w]: https://github.com/rust-lang/rust/pull/31904
7359 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
7360 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
7361 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
7362 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
7363 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
7364 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
7365 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
7366 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
7367 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
7368 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
7369 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
7370 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
7371 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
7372 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
7373 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
7374 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
7375 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
7376 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
7377 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
7378 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
7379 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
7380 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
7381 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
7382 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
7383 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
7384 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
7385 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
7386 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
7387 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
7388 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
7389
7390
7391 Version 1.7.0 (2016-03-03)
7392 ==========================
7393
7394 Libraries
7395 ---------
7396
7397 * Stabilized APIs
7398   * `Path`
7399     * [`Path::strip_prefix`] (renamed from relative_from)
7400     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
7401   * `Ipv4Addr`
7402     * [`Ipv4Addr::is_loopback`]
7403     * [`Ipv4Addr::is_private`]
7404     * [`Ipv4Addr::is_link_local`]
7405     * [`Ipv4Addr::is_multicast`]
7406     * [`Ipv4Addr::is_broadcast`]
7407     * [`Ipv4Addr::is_documentation`]
7408   * `Ipv6Addr`
7409     * [`Ipv6Addr::is_unspecified`]
7410     * [`Ipv6Addr::is_loopback`]
7411     * [`Ipv6Addr::is_multicast`]
7412   * `Vec`
7413     * [`Vec::as_slice`]
7414     * [`Vec::as_mut_slice`]
7415   * `String`
7416     * [`String::as_str`]
7417     * [`String::as_mut_str`]
7418   * Slices
7419     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
7420     be the same length
7421     * `<[T]>::`[`sort_by_key`]
7422   * checked, saturated, and overflowing operations
7423     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
7424     * [`i32::saturating_mul`]
7425     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
7426     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
7427     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
7428     * [`u32::saturating_mul`]
7429     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
7430     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
7431     * and checked, saturated, and overflowing operations for other primitive types
7432   * FFI
7433     * [`ffi::IntoStringError`]
7434     * [`CString::into_string`]
7435     * [`CString::into_bytes`]
7436     * [`CString::into_bytes_with_nul`]
7437     * `From<CString> for Vec<u8>`
7438   * `IntoStringError`
7439     * [`IntoStringError::into_cstring`]
7440     * [`IntoStringError::utf8_error`]
7441     * `Error for IntoStringError`
7442   * Hashing
7443     * [`std::hash::BuildHasher`]
7444     * [`BuildHasher::Hasher`]
7445     * [`BuildHasher::build_hasher`]
7446     * [`std::hash::BuildHasherDefault`]
7447     * [`HashMap::with_hasher`]
7448     * [`HashMap::with_capacity_and_hasher`]
7449     * [`HashSet::with_hasher`]
7450     * [`HashSet::with_capacity_and_hasher`]
7451     * [`std::collections::hash_map::RandomState`]
7452     * [`RandomState::new`]
7453 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
7454   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
7455   from bytes is faster.
7456 * [The performance of `LineWriter` (and thus `io::stdout`) was
7457   improved by using `memchr` to search for newlines][1.7m].
7458 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
7459   `f64` variants were stabilized previously.
7460 * [`BTreeMap` was rewritten to use less memory and improve the performance
7461   of insertion and iteration, the latter by as much as 5x][1.7bm].
7462 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
7463   covariant over their contained type][1.7bt].
7464 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
7465   over their contained type][1.7ll].
7466 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
7467   searching methods.
7468 * [`Any` is implemented for unsized types][1.7a].
7469 * [`Hash` is implemented for `Duration`][1.7h].
7470
7471 Misc
7472 ----
7473
7474 * [When running tests with `--test`, rustdoc will pass `--cfg`
7475   arguments to the compiler][1.7dt].
7476 * [The compiler is built with RPATH information by default][1.7rpa].
7477   This means that it will be possible to run `rustc` when installed in
7478   unusual configurations without configuring the dynamic linker search
7479   path explicitly.
7480 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
7481   any RPATH entries (emitted with `-C rpath`) *not* take precedence
7482   over `LD_LIBRARY_PATH`.
7483
7484 Cargo
7485 -----
7486
7487 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
7488   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
7489 * [The `rerun-if-changed` build script directive no longer causes the
7490   build script to incorrectly run twice in certain scenarios][1.7rr].
7491
7492 Compatibility Notes
7493 -------------------
7494
7495 * Soundness fixes to the interactions between associated types and
7496   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
7497   code that violates the new rules. This is a significant change that
7498   is known to break existing code, so it has emitted warnings for the
7499   new error cases since 1.4 to give crate authors time to adapt. The
7500   details of what is changing are subtle; read the RFC for more.
7501 * [Several bugs in the compiler's visibility calculations were
7502   fixed][1.7v]. Since this was found to break significant amounts of
7503   code, the new errors will be emitted as warnings for several release
7504   cycles, under the `private_in_public` lint.
7505 * Defaulted type parameters were accidentally accepted in positions
7506   that were not intended. In this release, [defaulted type parameters
7507   appearing outside of type definitions will generate a
7508   warning][1.7d], which will become an error in future releases.
7509 * [Parsing "." as a float results in an error instead of 0][1.7p].
7510   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
7511 * [Borrows of closure parameters may not outlive the closure][1.7bc].
7512
7513 [1.7a]: https://github.com/rust-lang/rust/pull/30928
7514 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
7515 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
7516 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
7517 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
7518 [1.7d]: https://github.com/rust-lang/rust/pull/30724
7519 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
7520 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
7521 [1.7f]: https://github.com/rust-lang/rust/pull/30672
7522 [1.7h]: https://github.com/rust-lang/rust/pull/30818
7523 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
7524 [1.7m]: https://github.com/rust-lang/rust/pull/30381
7525 [1.7p]: https://github.com/rust-lang/rust/pull/30681
7526 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
7527 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
7528 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
7529 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
7530 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
7531 [1.7v]: https://github.com/rust-lang/rust/pull/29973
7532 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7533 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7534 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
7535 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
7536 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
7537 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
7538 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
7539 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
7540 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
7541 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
7542 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
7543 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
7544 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
7545 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
7546 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
7547 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
7548 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
7549 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
7550 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
7551 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
7552 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
7553 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
7554 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
7555 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
7556 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
7557 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
7558 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
7559 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
7560 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
7561 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
7562 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
7563 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
7564 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
7565 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
7566 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
7567 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
7568 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
7569 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
7570 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
7571 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
7572 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
7573 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
7574 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
7575 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
7576 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
7577 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
7578 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
7579 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7580 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
7581 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
7582 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
7583 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
7584 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
7585 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
7586 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
7587 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
7588 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
7589 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
7590 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
7591 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
7592
7593
7594 Version 1.6.0 (2016-01-21)
7595 ==========================
7596
7597 Language
7598 --------
7599
7600 * The `#![no_std]` attribute causes a crate to not be linked to the
7601   standard library, but only the [core library][1.6co], as described
7602   in [RFC 1184]. The core library defines common types and traits but
7603   has no platform dependencies whatsoever, and is the basis for Rust
7604   software in environments that cannot support a full port of the
7605   standard library, such as operating systems. Most of the core
7606   library is now stable.
7607
7608 Libraries
7609 ---------
7610
7611 * Stabilized APIs:
7612   [`Read::read_exact`],
7613   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
7614   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
7615   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
7616   [`os::unix::fs::DirBuilderExt`],
7617   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
7618   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
7619   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
7620   [`collections::hash_map::Drain`],
7621   [`collections::hash_map::HashMap::drain`],
7622   [`collections::hash_set::Drain`],
7623   [`collections::hash_set::HashSet::drain`],
7624   [`collections::binary_heap::Drain`],
7625   [`collections::binary_heap::BinaryHeap::drain`],
7626   [`Vec::extend_from_slice`] (renamed from `push_all`),
7627   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
7628   [`RwLock::into_inner`],
7629   [`Iterator::min_by_key`] (renamed from `min_by`),
7630   [`Iterator::max_by_key`] (renamed from `max_by`).
7631 * The [core library][1.6co] is stable, as are most of its APIs.
7632 * [The `assert_eq!` macro supports arguments that don't implement
7633   `Sized`][1.6ae], such as arrays. In this way it behaves more like
7634   `assert!`.
7635 * Several timer functions that take duration in milliseconds [are
7636   deprecated in favor of those that take `Duration`][1.6ms]. These
7637   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
7638   `thread::park_timeout_ms`.
7639 * The algorithm by which `Vec` reserves additional elements was
7640   [tweaked to not allocate excessive space][1.6a] while still growing
7641   exponentially.
7642 * `From` conversions are [implemented from integers to floats][1.6f]
7643   in cases where the conversion is lossless. Thus they are not
7644   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
7645   or `f64`. They are also not implemented for `isize` and `usize`
7646   because the implementations would be platform-specific. `From` is
7647   also implemented from `f32` to `f64`.
7648 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
7649 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
7650 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
7651 * [`BinaryHeap` was refactored][1.6bh] for modest performance
7652   improvements.
7653 * Sorting slices that are already sorted [is 50% faster in some
7654   cases][1.6s].
7655
7656 Cargo
7657 -----
7658
7659 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
7660 * Cargo build scripts can specify their dependencies by emitting the
7661   [`rerun-if-changed`][1.6rr] key.
7662 * crates.io will reject publication of crates with dependencies that
7663   have a wildcard version constraint. Crates with wildcard
7664   dependencies were seen to cause a variety of problems, as described
7665   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
7666   warning.
7667 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
7668   release folder.  A variety of artifacts that Cargo failed to clean
7669   are now correctly deleted.
7670
7671 Misc
7672 ----
7673
7674 * The `unreachable_code` lint [warns when a function call's argument
7675   diverges][1.6dv].
7676 * The parser indicates [failures that may be caused by
7677   confusingly-similar Unicode characters][1.6uc]
7678 * Certain macro errors [are reported at definition time][1.6m], not
7679   expansion.
7680
7681 Compatibility Notes
7682 -------------------
7683
7684 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
7685   environment variable when locating crates. This was a pre-cargo
7686   feature for integrating with the package manager that was
7687   accidentally never removed.
7688 * [A number of bugs were fixed in the privacy checker][1.6p] that
7689   could cause previously-accepted code to break.
7690 * [Modules and unit/tuple structs may not share the same name][1.6ts].
7691 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
7692   struct pattern syntax (`Foo(..)`) can no longer be used to match
7693   unit structs. This is a warning now, but will become an error in
7694   future releases. Patterns that share the same name as a const are
7695   now an error.
7696 * A bug was fixed that causes [rustc not to apply default type
7697   parameters][1.6xc] when resolving certain method implementations of
7698   traits defined in other crates.
7699
7700 [1.6a]: https://github.com/rust-lang/rust/pull/29454
7701 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
7702 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
7703 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
7704 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
7705 [1.6co]: http://doc.rust-lang.org/core/index.html
7706 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
7707 [1.6f]: https://github.com/rust-lang/rust/pull/29129
7708 [1.6m]: https://github.com/rust-lang/rust/pull/29828
7709 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
7710 [1.6p]: https://github.com/rust-lang/rust/pull/29726
7711 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
7712 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
7713 [1.6s]: https://github.com/rust-lang/rust/pull/29675
7714 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
7715 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
7716 [1.6us]: https://github.com/rust-lang/rust/pull/29383
7717 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
7718 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
7719 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7720 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
7721 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
7722 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
7723 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
7724 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
7725 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
7726 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
7727 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
7728 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
7729 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
7730 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
7731 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
7732 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
7733 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
7734 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
7735 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
7736 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
7737 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
7738 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
7739 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
7740 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
7741 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
7742 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
7743 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
7744 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
7745 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
7746 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
7747
7748
7749 Version 1.5.0 (2015-12-10)
7750 ==========================
7751
7752 * ~700 changes, numerous bugfixes
7753
7754 Highlights
7755 ----------
7756
7757 * Stabilized APIs:
7758   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
7759   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
7760   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
7761   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
7762   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
7763   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
7764   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
7765   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
7766   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
7767   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
7768   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
7769   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
7770   [`Path::read_link`], [`Path::symlink_metadata`],
7771   [`Utf8Error::valid_up_to`], [`Vec::resize`],
7772   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
7773   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
7774   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
7775   [`slice::split_first_mut`], [`slice::split_first`],
7776   [`slice::split_last_mut`], [`slice::split_last`],
7777   [`char::from_u32_unchecked`], [`fs::canonicalize`],
7778   [`str::MatchIndices`], [`str::RMatchIndices`],
7779   [`str::match_indices`], [`str::rmatch_indices`],
7780   [`str::slice_mut_unchecked`], [`string::ParseError`].
7781 * Rust applications hosted on crates.io can be installed locally to
7782   `~/.cargo/bin` with the [`cargo install`] command. Among other
7783   things this makes it easier to augment Cargo with new subcommands:
7784   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
7785   invoked as `cargo foo`.
7786 * Crates with wildcard (`*`) dependencies will [emit warnings when
7787   published][1.5w]. In 1.6 it will no longer be possible to publish
7788   crates with wildcard dependencies.
7789
7790 Breaking Changes
7791 ----------------
7792
7793 * The rules determining when a particular lifetime must outlive
7794   a particular value (known as '[dropck]') have been [modified
7795   to not rely on parametricity][1.5p].
7796 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
7797   and `Arc`][1.5a]. Because these smart pointer types implement
7798   `Deref`, this causes breakage in cases where the interior type
7799   contains methods of the same name.
7800 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
7801   that they could drop their content. Soundness fix.
7802 * All method invocations are [properly checked][1.5wf1] for
7803   [well-formedness][1.5wf2]. Soundness fix.
7804 * Traits whose supertraits contain `Self` are [not object
7805   safe][1.5o]. Soundness fix.
7806 * Target specifications support a [`no_default_libraries`][1.5nd]
7807   setting that controls whether `-nodefaultlibs` is passed to the
7808   linker, and in turn the `is_like_windows` setting no longer affects
7809   the `-nodefaultlibs` flag.
7810 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
7811 * The `#[inline]` and `#[repr]` attributes [can only appear
7812   in valid locations][1.5at].
7813 * Native libraries linked from the local crate are [passed to
7814   the linker before native libraries from upstream crates][1.5nl].
7815 * Two rarely-used attributes, `#[no_debug]` and
7816   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
7817 * Negation of unsigned integers, which has been a warning for
7818   several releases, [is now behind a feature gate and will
7819   generate errors][1.5nu].
7820 * The parser accidentally accepted visibility modifiers on
7821   enum variants, a bug [which has been fixed][1.5ev].
7822 * [A bug was fixed that allowed `use` statements to import unstable
7823   features][1.5use].
7824
7825 Language
7826 --------
7827
7828 * When evaluating expressions at compile-time that are not
7829   compile-time constants (const-evaluating expressions in non-const
7830   contexts), incorrect code such as overlong bitshifts and arithmetic
7831   overflow will [generate a warning instead of an error][1.5ce],
7832   delaying the error until runtime. This will allow the
7833   const-evaluator to be expanded in the future backwards-compatibly.
7834 * The `improper_ctypes` lint [no longer warns about using `isize` and
7835   `usize` in FFI][1.5ict].
7836
7837 Libraries
7838 ---------
7839
7840 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
7841   invariant][1.5c].
7842 * `Default` is [implemented for mutable slices][1.5d].
7843 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
7844 * There are now `From` conversions [between floating point
7845   types][1.5f] where the conversions are lossless.
7846 * There are now `From` conversions [between integer types][1.5i] where
7847   the conversions are lossless.
7848 * [`fs::Metadata` implements `Clone`][1.5fs].
7849 * The `parse` method [accepts a leading "+" when parsing
7850   integers][1.5pi].
7851 * [`AsMut` is implemented for `Vec`][1.5am].
7852 * The `clone_from` implementations for `String` and `BinaryHeap` [have
7853   been optimized][1.5cf] and no longer rely on the default impl.
7854 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
7855   `unsafe extern "C"` function types now [implement `Clone`,
7856   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
7857   `fmt::Debug` for up to 12 arguments][1.5fp].
7858 * [Dropping `Vec`s is much faster in unoptimized builds when the
7859   element types don't implement `Drop`][1.5dv].
7860 * A bug that caused in incorrect behavior when [combining `VecDeque`
7861   with zero-sized types][1.5vdz] was resolved.
7862 * [`PartialOrd` for slices is faster][1.5po].
7863
7864 Miscellaneous
7865 -------------
7866
7867 * [Crate metadata size was reduced by 20%][1.5md].
7868 * [Improvements to code generation reduced the size of libcore by 3.3
7869   MB and rustc's memory usage by 18MB][1.5m].
7870 * [Improvements to deref translation increased performance in
7871   unoptimized builds][1.5dr].
7872 * Various errors in trait resolution [are deduplicated to only be
7873   reported once][1.5te].
7874 * Rust has preliminary [support for rumprun kernels][1.5rr].
7875 * Rust has preliminary [support for NetBSD on amd64][1.5na].
7876
7877 [1.5use]: https://github.com/rust-lang/rust/pull/28364
7878 [1.5po]: https://github.com/rust-lang/rust/pull/28436
7879 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
7880 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
7881 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
7882 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
7883 [1.5md]: https://github.com/rust-lang/rust/pull/28521
7884 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
7885 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
7886 [1.5na]: https://github.com/rust-lang/rust/pull/28543
7887 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
7888 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
7889 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
7890 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
7891 [1.5te]: https://github.com/rust-lang/rust/pull/28645
7892 [1.5at]: https://github.com/rust-lang/rust/pull/28650
7893 [1.5am]: https://github.com/rust-lang/rust/pull/28663
7894 [1.5m]: https://github.com/rust-lang/rust/pull/28778
7895 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
7896 [1.5a]: https://github.com/rust-lang/rust/pull/28811
7897 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
7898 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
7899 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
7900 [1.5i]: https://github.com/rust-lang/rust/pull/28921
7901 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
7902 [1.5f]: https://github.com/rust-lang/rust/pull/29129
7903 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
7904 [1.5s]: https://github.com/rust-lang/rust/pull/29190
7905 [1.5d]: https://github.com/rust-lang/rust/pull/29245
7906 [1.5o]: https://github.com/rust-lang/rust/pull/29259
7907 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
7908 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
7909 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
7910 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
7911 [1.5c]: https://github.com/rust-lang/rust/pull/29110
7912 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
7913 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
7914 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
7915 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
7916 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
7917 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
7918 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
7919 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
7920 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
7921 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
7922 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
7923 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
7924 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
7925 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
7926 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
7927 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
7928 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
7929 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
7930 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
7931 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
7932 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
7933 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
7934 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
7935 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
7936 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
7937 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
7938 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
7939 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
7940 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
7941 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
7942 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
7943 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
7944 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
7945 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
7946 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
7947 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
7948 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
7949 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
7950 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
7951 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
7952 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
7953 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
7954 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
7955 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
7956 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
7957 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
7958 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
7959 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
7960 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
7961 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
7962 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
7963 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
7964 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
7965 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
7966
7967 Version 1.4.0 (2015-10-29)
7968 ==========================
7969
7970 * ~1200 changes, numerous bugfixes
7971
7972 Highlights
7973 ----------
7974
7975 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
7976   GNU) are now supported and recommended for use.
7977
7978 Breaking Changes
7979 ----------------
7980
7981 * [Several changes have been made to fix type soundness and improve
7982   the behavior of associated types][sound]. See [RFC 1214]. Although
7983   we have mostly introduced these changes as warnings this release, to
7984   become errors next release, there are still some scenarios that will
7985   see immediate breakage.
7986 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
7987   line breaks in addition to `\n`][crlf].
7988 * [Loans of `'static` lifetime extend to the end of a function][stat].
7989 * [`str::parse` no longer introduces avoidable rounding error when
7990   parsing floating point numbers. Together with earlier changes to
7991   float formatting/output, "round trips" like f.to_string().parse()
7992   now preserve the value of f exactly. Additionally, leading plus
7993   signs are now accepted][fp3].
7994
7995
7996 Language
7997 --------
7998
7999 * `use` statements that import multiple items [can now rename
8000   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
8001 * [Binops work correctly on fat pointers][binfat].
8002 * `pub extern crate`, which does not behave as expected, [issues a
8003   warning][pec] until a better solution is found.
8004
8005 Libraries
8006 ---------
8007
8008 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
8009   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
8010   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
8011   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
8012   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
8013   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
8014   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
8015   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
8016   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
8017   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
8018   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
8019   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
8020   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
8021   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
8022   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
8023   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
8024   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
8025   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
8026   [`thread::sleep`].
8027 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
8028   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
8029   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
8030   `f64::from_str_radix`.
8031 * [Reverse-searching strings is faster with the 'two-way'
8032   algorithm][s].
8033 * [`std::io::copy` allows `?Sized` arguments][cc].
8034 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
8035   [override `count`, `nth` and `last` with an O(1)
8036   implementation][it].
8037 * [`Default` is implemented for arrays up to `[T; 32]`][d].
8038 * [`IntoRawFd` has been added to the Unix-specific prelude,
8039   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
8040   prelude][pr].
8041 * [`Extend<String>` and `FromIterator<String` are both implemented for
8042   `String`][es].
8043 * [`IntoIterator` is implemented for references to `Option` and
8044   `Result`][into2].
8045 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
8046   Copy`][ext] as part of [RFC 839]. This will cause type inference
8047   breakage in rare situations.
8048 * [`BinaryHeap` implements `Debug`][bh2].
8049 * [`Borrow` and `BorrowMut` are implemented for fixed-size
8050   arrays][bm].
8051 * [`extern fn`s with the "Rust" and "C" ABIs implement common
8052   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
8053 * [String comparison is faster][faststr].
8054 * `&mut T` where `T: std::fmt::Write` [also implements
8055   `std::fmt::Write`][mutw].
8056 * [A stable regression in `VecDeque::push_back` and other
8057   capacity-altering methods that caused panics for zero-sized types
8058   was fixed][vd].
8059 * [Function pointers implement traits for up to 12 parameters][fp2].
8060
8061 Miscellaneous
8062 -------------
8063
8064 * The compiler [no longer uses the 'morestack' feature to prevent
8065   stack overflow][mm]. Instead it uses guard pages and stack
8066   probes (though stack probes are not yet implemented on any platform
8067   but Windows).
8068 * [The compiler matches traits faster when projections are involved][p].
8069 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
8070   `usize`][ffi].
8071 * [Cargo now displays useful information about what its doing during
8072   `cargo update`][cu].
8073
8074 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
8075 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
8076 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
8077 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
8078 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
8079 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
8080 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
8081 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
8082 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
8083 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
8084 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
8085 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
8086 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
8087 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
8088 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
8089 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
8090 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
8091 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
8092 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8093 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8094 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8095 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8096 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
8097 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
8098 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
8099 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
8100 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
8101 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
8102 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
8103 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
8104 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
8105 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
8106 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
8107 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
8108 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
8109 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
8110 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
8111 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
8112 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
8113 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
8114 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
8115 [bh2]: https://github.com/rust-lang/rust/pull/28156
8116 [binfat]: https://github.com/rust-lang/rust/pull/28270
8117 [bm]: https://github.com/rust-lang/rust/pull/28197
8118 [cc]: https://github.com/rust-lang/rust/pull/27531
8119 [crlf]: https://github.com/rust-lang/rust/pull/28034
8120 [cu]: https://github.com/rust-lang/cargo/pull/1931
8121 [d]: https://github.com/rust-lang/rust/pull/27825
8122 [dep]: https://github.com/rust-lang/rust/pull/28339
8123 [es]: https://github.com/rust-lang/rust/pull/27956
8124 [ext]: https://github.com/rust-lang/rust/pull/28094
8125 [faststr]: https://github.com/rust-lang/rust/pull/28338
8126 [ffi]: https://github.com/rust-lang/rust/pull/28779
8127 [fp]: https://github.com/rust-lang/rust/pull/28268
8128 [fp2]: https://github.com/rust-lang/rust/pull/28560
8129 [fp3]: https://github.com/rust-lang/rust/pull/27307
8130 [i]: https://github.com/rust-lang/rust/pull/27451
8131 [into2]: https://github.com/rust-lang/rust/pull/28039
8132 [it]: https://github.com/rust-lang/rust/pull/27652
8133 [mm]: https://github.com/rust-lang/rust/pull/27338
8134 [mutw]: https://github.com/rust-lang/rust/pull/28368
8135 [sound]: https://github.com/rust-lang/rust/pull/27641
8136 [p]: https://github.com/rust-lang/rust/pull/27866
8137 [pec]: https://github.com/rust-lang/rust/pull/28486
8138 [pr]: https://github.com/rust-lang/rust/pull/27896
8139 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8140 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
8141 [s]: https://github.com/rust-lang/rust/pull/27474
8142 [stab]: https://github.com/rust-lang/rust/pull/28339
8143 [stat]: https://github.com/rust-lang/rust/pull/28321
8144 [vd]: https://github.com/rust-lang/rust/pull/28494
8145
8146 Version 1.3.0 (2015-09-17)
8147 ==============================
8148
8149 * ~900 changes, numerous bugfixes
8150
8151 Highlights
8152 ----------
8153
8154 * The [new object lifetime defaults][nold] have been [turned
8155   on][nold2] after a cycle of warnings about the change. Now types
8156   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
8157   being interpreted as `&'a Box<Trait+'a>` to `&'a
8158   Box<Trait+'static>`.
8159 * [The Rustonomicon][nom] is a new book in the official documentation
8160   that dives into writing unsafe Rust.
8161 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
8162   timekeeping is employed by other std APIs, as well as out-of-tree
8163   time crates.
8164
8165 Breaking Changes
8166 ----------------
8167
8168 * The [new object lifetime defaults][nold] have been [turned
8169   on][nold2] after a cycle of warnings about the change.
8170 * There is a known [regression][lr] in how object lifetime elision is
8171   interpreted, the proper solution for which is undetermined.
8172 * The `#[prelude_import]` attribute, an internal implementation
8173   detail, was accidentally stabilized previously. [It has been put
8174   behind the `prelude_import` feature gate][pi]. This change is
8175   believed to break no existing code.
8176 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8177   [more sane for dynamically sized types][dst3]. Code that relied on
8178   the previous behavior is thought to be broken.
8179 * The `dropck` rules, which checks that destructors can't access
8180   destroyed values, [have been updated][dropck] to match the
8181   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
8182   cause some previously-compiling code to no longer build.
8183
8184 Language
8185 --------
8186
8187 * The [new object lifetime defaults][nold] have been [turned
8188   on][nold2] after a cycle of warnings about the change.
8189 * Semicolons may [now follow types and paths in
8190   macros](https://github.com/rust-lang/rust/pull/27000).
8191 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
8192   [more sane for dynamically sized types][dst3]. Code that relied on
8193   the previous behavior is not known to exist, and suspected to be
8194   broken.
8195 * `'static` variables [may now be recursive][st].
8196 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
8197   implementations correctly.
8198 * The `dropck` rules, which checks that destructors can't access
8199   destroyed values, [have been updated][dropck] to match the
8200   [RFC][dropckrfc].
8201
8202 Libraries
8203 ---------
8204
8205 * The [`Duration`] API, [has been stabilized][ds], as well as the
8206   `std::time` module, which presently contains only `Duration`.
8207 * `Box<str>` and `Box<[T]>` both implement `Clone`.
8208 * The owned C string, [`CString`], implements [`Borrow`] and the
8209   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
8210   these allow C strings to be borrowed and cloned in generic code.
8211 * [`CStr`] implements [`Debug`].
8212 * [`AtomicPtr`] implements [`Debug`].
8213 * [`Error`] trait objects [can be downcast to their concrete types][e]
8214   in many common configurations, using the [`is`], [`downcast`],
8215   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
8216   [`Any`] trait.
8217 * Searching for substrings now [employs the two-way algorithm][search]
8218   instead of doing a naive search. This gives major speedups to a
8219   number of methods, including [`contains`][sc], [`find`][sf],
8220   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
8221   [`ends_with`][sew] are also faster.
8222 * The performance of `PartialEq` for slices is [much faster][ps].
8223 * The [`Hash`] trait offers the default method, [`hash_slice`], which
8224   is overridden and optimized by the implementations for scalars.
8225 * The [`Hasher`] trait now has a number of specialized `write_*`
8226   methods for primitive types, for efficiency.
8227 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
8228   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
8229   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
8230   of [`std::error::Error::cause`][iec] also delegates to the inner
8231   error.
8232 * [`process::Child`][pc] gained the [`id`] method, which returns a
8233   `u32` representing the platform-specific process identifier.
8234 * The [`connect`] method on slices is deprecated, replaced by the new
8235   [`join`] method (note that both of these are on the *unstable*
8236   [`SliceConcatExt`] trait, but through the magic of the prelude are
8237   available to stable code anyway).
8238 * The [`Div`] operator is implemented for [`Wrapping`] types.
8239 * [`DerefMut` is implemented for `String`][dms].
8240 * Performance of SipHash (the default hasher for `HashMap`) is
8241   [better for long data][sh].
8242 * [`AtomicPtr`] implements [`Send`].
8243 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
8244   are now [specialized to use uninitialized buffers for increased
8245   performance][rte].
8246 * Lifetime parameters of foreign functions [are now resolved
8247   properly][f].
8248
8249 Misc
8250 ----
8251
8252 * Rust can now, with some coercion, [produce programs that run on
8253   Windows XP][xp], though XP is not considered a supported platform.
8254 * Porting Rust on Windows from the GNU toolchain to MSVC continues
8255   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
8256   recommended for use in 1.3, though should be fully-functional
8257   in the [64-bit 1.4 beta][b14].
8258 * On Fedora-based systems installation will [properly configure the
8259   dynamic linker][fl].
8260 * The compiler gained many new extended error descriptions, which can
8261   be accessed with the `--explain` flag.
8262 * The `dropck` pass, which checks that destructors can't access
8263   destroyed values, [has been rewritten][dropck]. This fixes some
8264   soundness holes, and as such will cause some previously-compiling
8265   code to no longer build.
8266 * `rustc` now uses [LLVM to write archive files where possible][ar].
8267   Eventually this will eliminate the compiler's dependency on the ar
8268   utility.
8269 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
8270   supported FreeBSD on x86_64).
8271 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
8272   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
8273   more strict.
8274 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
8275   will kill the process instead of leaking][nlp].
8276
8277 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
8278 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
8279 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
8280 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
8281 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
8282 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8283 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8284 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
8285 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
8286 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
8287 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
8288 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
8289 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
8290 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
8291 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
8292 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
8293 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
8294 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
8295 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8296 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
8297 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
8298 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
8299 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
8300 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8301 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
8302 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
8303 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
8304 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
8305 [ar]: https://github.com/rust-lang/rust/pull/26926
8306 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
8307 [dms]: https://github.com/rust-lang/rust/pull/26241
8308 [dropck]: https://github.com/rust-lang/rust/pull/27261
8309 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8310 [ds]: https://github.com/rust-lang/rust/pull/26818
8311 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
8312 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
8313 [dst3]: https://github.com/rust-lang/rust/pull/27351
8314 [e]: https://github.com/rust-lang/rust/pull/24793
8315 [f]: https://github.com/rust-lang/rust/pull/26588
8316 [fb]: https://github.com/rust-lang/rust/pull/26959
8317 [fl]: https://github.com/rust-lang/rust-installer/pull/41
8318 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
8319 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
8320 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
8321 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
8322 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
8323 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
8324 [lic]: https://github.com/rust-lang/rust/pull/26583
8325 [lnu]: https://github.com/rust-lang/rust/pull/27026
8326 [lr]: https://github.com/rust-lang/rust/issues/27248
8327 [lum]: https://github.com/rust-lang/rust/pull/26378
8328 [lur]: https://github.com/rust-lang/rust/pull/26783
8329 [nlp]: https://github.com/rust-lang/rust/pull/27176
8330 [nold2]: https://github.com/rust-lang/rust/pull/27045
8331 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
8332 [nom]: http://doc.rust-lang.org/nightly/nomicon/
8333 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
8334 [pi]: https://github.com/rust-lang/rust/pull/26699
8335 [ps]: https://github.com/rust-lang/rust/pull/26884
8336 [rte]: https://github.com/rust-lang/rust/pull/26950
8337 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
8338 [search]: https://github.com/rust-lang/rust/pull/26327
8339 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
8340 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
8341 [sh]: https://github.com/rust-lang/rust/pull/27280
8342 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
8343 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
8344 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
8345 [st]: https://github.com/rust-lang/rust/pull/26630
8346 [win1]: https://github.com/rust-lang/rust/pull/26569
8347 [win2]: https://github.com/rust-lang/rust/pull/26741
8348 [win3]: https://github.com/rust-lang/rust/pull/26741
8349 [win4]: https://github.com/rust-lang/rust/pull/27210
8350 [xp]: https://github.com/rust-lang/rust/pull/26569
8351
8352 Version 1.2.0 (2015-08-07)
8353 ==========================
8354
8355 * ~1200 changes, numerous bugfixes
8356
8357 Highlights
8358 ----------
8359
8360 * [Dynamically-sized-type coercions][dst] allow smart pointer types
8361   like `Rc` to contain types without a fixed size, arrays and trait
8362   objects, finally enabling use of `Rc<[T]>` and completing the
8363   implementation of DST.
8364 * [Parallel codegen][parcodegen] is now working again, which can
8365   substantially speed up large builds in debug mode; It also gets
8366   another ~33% speedup when bootstrapping on a 4 core machine (using 8
8367   jobs). It's not enabled by default, but will be "in the near
8368   future". It can be activated with the `-C codegen-units=N` flag to
8369   `rustc`.
8370 * This is the first release with [experimental support for linking
8371   with the MSVC linker and lib C on Windows (instead of using the GNU
8372   variants via MinGW)][win]. It is yet recommended only for the most
8373   intrepid Rustaceans.
8374 * Benchmark compilations are showing a 30% improvement in
8375   bootstrapping over 1.1.
8376
8377 Breaking Changes
8378 ----------------
8379
8380 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
8381   unicode case mapping, which is a previously-planned change in
8382   behavior and considered a bugfix.
8383 * [`mem::align_of`] now specifies [the *minimum alignment* for
8384   T][align], which is usually the alignment programs are interested
8385   in, and the same value reported by clang's
8386   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
8387   break real code.
8388 * [The `#[packed]` attribute is no longer silently accepted by the
8389   compiler][packed]. This attribute did nothing and code that
8390   mentioned it likely did not work as intended.
8391 * Associated type defaults are [now behind the
8392   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
8393   defaults *did not work*, but could be mentioned syntactically. As
8394   such this breakage has minimal impact.
8395
8396 Language
8397 --------
8398
8399 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
8400   matching against dereferenceable values.
8401
8402 Libraries
8403 ---------
8404
8405 * The [`Extend`] trait, which grows a collection from an iterator, is
8406   implemented over iterators of references, for `String`, `Vec`,
8407   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
8408   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
8409 * The [`iter::once`] function returns an iterator that yields a single
8410   element, and [`iter::empty`] returns an iterator that yields no
8411   elements.
8412 * The [`matches`] and [`rmatches`] methods on `str` return iterators
8413   over substring matches.
8414 * [`Cell`] and [`RefCell`] both implement `Eq`.
8415 * A number of methods for wrapping arithmetic are added to the
8416   integral types, [`wrapping_div`], [`wrapping_rem`],
8417   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
8418   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
8419   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
8420   type.. It is illegal for the default arithmetic operations in Rust
8421   to overflow; the desire to wrap must be explicit.
8422 * The `{:#?}` formatting specifier [displays the alternate,
8423   pretty-printed][debugfmt] form of the `Debug` formatter. This
8424   feature was actually introduced prior to 1.0 with little
8425   fanfare.
8426 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
8427   for writing data to formatted strings, similar to [`io::Write`].
8428 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
8429   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
8430   are used by code generators to emit implementations of [`Debug`].
8431 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
8432   methods that convert case, following Unicode case mapping.
8433 * It is now easier to handle poisoned locks. The [`PoisonError`]
8434   type, returned by failing lock operations, exposes `into_inner`,
8435   `get_ref`, and `get_mut`, which all give access to the inner lock
8436   guard, and allow the poisoned lock to continue to operate. The
8437   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
8438   poisoned lock without attempting to take the lock.
8439 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
8440   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
8441   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
8442   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
8443   `ChildStderr`.
8444 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
8445   malformed input.
8446
8447 Misc
8448 ----
8449
8450 * `rustc` employs smarter heuristics for guessing at [typos].
8451 * `rustc` emits more efficient code for [no-op conversions between
8452   unsafe pointers][nop].
8453 * Fat pointers are now [passed in pairs of immediate arguments][fat],
8454   resulting in faster compile times and smaller code.
8455
8456 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
8457 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
8458 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
8459 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
8460 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
8461 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
8462 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
8463 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
8464 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
8465 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
8466 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
8467 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
8468 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
8469 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
8470 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
8471 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
8472 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
8473 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
8474 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
8475 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
8476 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
8477 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
8478 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
8479 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
8480 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
8481 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
8482 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
8483 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
8484 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
8485 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
8486 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
8487 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
8488 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
8489 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8490 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8491 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
8492 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
8493 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
8494 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
8495 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
8496 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
8497 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
8498 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
8499 [align]: https://github.com/rust-lang/rust/pull/25646
8500 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
8501 [typos]: https://github.com/rust-lang/rust/pull/26087
8502 [nop]: https://github.com/rust-lang/rust/pull/26336
8503 [fat]: https://github.com/rust-lang/rust/pull/26411
8504 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
8505 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
8506 [packed]: https://github.com/rust-lang/rust/pull/25541
8507 [ad]: https://github.com/rust-lang/rust/pull/27382
8508 [win]: https://github.com/rust-lang/rust/pull/25350
8509
8510 Version 1.1.0 (2015-06-25)
8511 =========================
8512
8513 * ~850 changes, numerous bugfixes
8514
8515 Highlights
8516 ----------
8517
8518 * The [`std::fs` module has been expanded][fs] to expand the set of
8519   functionality exposed:
8520   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
8521     don't incur a syscall on some platforms.
8522   * A `symlink_metadata` function has been added.
8523   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
8524     access to all underlying information.
8525 * The compiler now contains extended explanations of many errors. When an error
8526   with an explanation occurs the compiler suggests using the `--explain` flag
8527   to read the explanation. Error explanations are also [available online][err-index].
8528 * Thanks to multiple [improvements][sk] to [type checking][pre], as
8529   well as other work, the time to bootstrap the compiler decreased by
8530   32%.
8531
8532 Libraries
8533 ---------
8534
8535 * The [`str::split_whitespace`] method splits a string on unicode
8536   whitespace boundaries.
8537 * On both Windows and Unix, new extension traits provide conversion of
8538   I/O types to and from the underlying system handles. On Unix, these
8539   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
8540   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
8541   `TcpListener`, and `UpdSocket`. Further implementations for
8542   `std::process` will be stabilized later.
8543 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
8544   Windows, symlinks can be created with
8545   `std::os::windows::symlink_dir` and
8546   `std::os::windows::symlink_file`.
8547 * The `mpsc::Receiver` type can now be converted into an iterator with
8548   `into_iter` on the [`IntoIterator`] trait.
8549 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
8550   implementation of the [`From`] trait.
8551 * The `Debug` implementation for `RangeFull` [creates output that is
8552   more consistent with other implementations][rf].
8553 * [`Debug` is implemented for `File`][file].
8554 * The `Default` implementation for `Arc` [no longer requires `Sync +
8555   Send`][arc].
8556 * [The `Iterator` methods `count`, `nth`, and `last` have been
8557   overridden for slices to have O(1) performance instead of O(n)][si].
8558 * Incorrect handling of paths on Windows has been improved in both the
8559   compiler and the standard library.
8560 * [`AtomicPtr` gained a `Default` implementation][ap].
8561 * In accordance with Rust's policy on arithmetic overflow `abs` now
8562   [panics on overflow when debug assertions are enabled][abs].
8563 * The [`Cloned`] iterator, which was accidentally left unstable for
8564   1.0 [has been stabilized][c].
8565 * The [`Incoming`] iterator, which iterates over incoming TCP
8566   connections, and which was accidentally unnamable in 1.0, [is now
8567   properly exported][inc].
8568 * [`BinaryHeap`] no longer corrupts itself [when functions called by
8569   `sift_up` or `sift_down` panic][bh].
8570 * The [`split_off`] method of `LinkedList` [no longer corrupts
8571   the list in certain scenarios][ll].
8572
8573 Misc
8574 ----
8575
8576 * Type checking performance [has improved notably][sk] with
8577   [multiple improvements][pre].
8578 * The compiler [suggests code changes][ch] for more errors.
8579 * rustc and it's build system have experimental support for [building
8580   toolchains against MUSL][m] instead of glibc on Linux.
8581 * The compiler defines the `target_env` cfg value, which is used for
8582   distinguishing toolchains that are otherwise for the same
8583   platform. Presently this is set to `gnu` for common GNU Linux
8584   targets and for MinGW targets, and `musl` for MUSL Linux targets.
8585 * The [`cargo rustc`][crc] command invokes a build with custom flags
8586   to rustc.
8587 * [Android executables are always position independent][pie].
8588 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
8589   with `Drop`][drop].
8590
8591 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
8592 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
8593 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
8594 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
8595 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
8596 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
8597 [rf]: https://github.com/rust-lang/rust/pull/24491
8598 [err-index]: https://doc.rust-lang.org/error-index.html
8599 [sk]: https://github.com/rust-lang/rust/pull/24615
8600 [pre]: https://github.com/rust-lang/rust/pull/25323
8601 [file]: https://github.com/rust-lang/rust/pull/24598
8602 [ch]: https://github.com/rust-lang/rust/pull/24683
8603 [arc]: https://github.com/rust-lang/rust/pull/24695
8604 [si]: https://github.com/rust-lang/rust/pull/24701
8605 [ap]: https://github.com/rust-lang/rust/pull/24834
8606 [m]: https://github.com/rust-lang/rust/pull/24777
8607 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
8608 [crc]: https://github.com/rust-lang/cargo/pull/1568
8609 [pie]: https://github.com/rust-lang/rust/pull/24953
8610 [abs]: https://github.com/rust-lang/rust/pull/25441
8611 [c]: https://github.com/rust-lang/rust/pull/25496
8612 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
8613 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
8614 [inc]: https://github.com/rust-lang/rust/pull/25522
8615 [bh]: https://github.com/rust-lang/rust/pull/25856
8616 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
8617 [ll]: https://github.com/rust-lang/rust/pull/26022
8618 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
8619 [drop]: https://github.com/rust-lang/rust/pull/24935
8620
8621 Version 1.0.0 (2015-05-15)
8622 ========================
8623
8624 * ~1500 changes, numerous bugfixes
8625
8626 Highlights
8627 ----------
8628
8629 * The vast majority of the standard library is now `#[stable]`. It is
8630   no longer possible to use unstable features with a stable build of
8631   the compiler.
8632 * Many popular crates on [crates.io] now work on the stable release
8633   channel.
8634 * Arithmetic on basic integer types now [checks for overflow in debug
8635   builds][overflow].
8636
8637 Language
8638 --------
8639
8640 * Several [restrictions have been added to trait coherence][coh] in
8641   order to make it easier for upstream authors to change traits
8642   without breaking downstream code.
8643 * Digits of binary and octal literals are [lexed more eagerly][lex] to
8644   improve error messages and macro behavior. For example, `0b1234` is
8645   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
8646 * Trait bounds [are always invariant][inv], eliminating the need for
8647   the `PhantomFn` and `MarkerTrait` lang items, which have been
8648   removed.
8649 * ["-" is no longer a valid character in crate names][cr], the `extern crate
8650   "foo" as bar` syntax has been replaced with `extern crate foo as
8651   bar`, and Cargo now automatically translates "-" in *package* names
8652   to underscore for the crate name.
8653 * [Lifetime shadowing is an error][lt].
8654 * [`Send` no longer implies `'static`][send-rfc].
8655 * [UFCS now supports trait-less associated paths][moar-ufcs] like
8656   `MyType::default()`.
8657 * Primitive types [now have inherent methods][prim-inherent],
8658   obviating the need for extension traits like `SliceExt`.
8659 * Methods with `Self: Sized` in their `where` clause are [considered
8660   object-safe][self-sized], allowing many extension traits like
8661   `IteratorExt` to be merged into the traits they extended.
8662 * You can now [refer to associated types][assoc-where] whose
8663   corresponding trait bounds appear only in a `where` clause.
8664 * The final bits of [OIBIT landed][oibit-final], meaning that traits
8665   like `Send` and `Sync` are now library-defined.
8666 * A [Reflect trait][reflect] was introduced, which means that
8667   downcasting via the `Any` trait is effectively limited to concrete
8668   types. This helps retain the potentially-important "parametricity"
8669   property: generic code cannot behave differently for different type
8670   arguments except in minor ways.
8671 * The `unsafe_destructor` feature is now deprecated in favor of the
8672   [new `dropck`][dropck]. This change is a major reduction in unsafe
8673   code.
8674
8675 Libraries
8676 ---------
8677
8678 * The `thread_local` module [has been renamed to `std::thread`][th].
8679 * The methods of `IteratorExt` [have been moved to the `Iterator`
8680   trait itself][ie].
8681 * Several traits that implement Rust's conventions for type
8682   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
8683   [centralized in the `std::convert` module][con].
8684 * The `FromError` trait [was removed in favor of `From`][fe].
8685 * The basic sleep function [has moved to
8686   `std::thread::sleep_ms`][slp].
8687 * The `splitn` function now takes an `n` parameter that represents the
8688   number of items yielded by the returned iterator [instead of the
8689   number of 'splits'][spl].
8690 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
8691 * [Derived implementations of `PartialOrd` now order enums according
8692   to their explicitly-assigned discriminants][po].
8693 * [Methods for searching strings are generic over `Pattern`s][pat],
8694   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
8695   some others.
8696 * [In method resolution, object methods are resolved before inherent
8697   methods][meth].
8698 * [`String::from_str` has been deprecated in favor of the `From` impl,
8699   `String::from`][sf].
8700 * [`io::Error` implements `Sync`][ios].
8701 * [The `words` method on `&str` has been replaced with
8702   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
8703   a word?'
8704 * The new path and IO modules are complete and `#[stable]`. This
8705   was the major library focus for this cycle.
8706 * The path API was [revised][path-normalize] to normalize `.`,
8707   adjusting the tradeoffs in favor of the most common usage.
8708 * A large number of remaining APIs in `std` were also stabilized
8709   during this cycle; about 75% of the non-deprecated API surface
8710   is now stable.
8711 * The new [string pattern API][string-pattern] landed, which makes
8712   the string slice API much more internally consistent and flexible.
8713 * A new set of [generic conversion traits][conversion] replaced
8714   many existing ad hoc traits.
8715 * Generic numeric traits were [completely removed][num-traits]. This
8716   was made possible thanks to inherent methods for primitive types,
8717   and the removal gives maximal flexibility for designing a numeric
8718   hierarchy in the future.
8719 * The `Fn` traits are now related via [inheritance][fn-inherit]
8720   and provide ergonomic [blanket implementations][fn-blanket].
8721 * The `Index` and `IndexMut` traits were changed to
8722   [take the index by value][index-value], enabling code like
8723   `hash_map["string"]` to work.
8724 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
8725   `Copy` data is known to be `Clone` as well.
8726
8727 Misc
8728 ----
8729
8730 * Many errors now have extended explanations that can be accessed with
8731   the `--explain` flag to `rustc`.
8732 * Many new examples have been added to the standard library
8733   documentation.
8734 * rustdoc has received a number of improvements focused on completion
8735   and polish.
8736 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
8737 * Much headway was made on ecosystem-wide CI, making it possible
8738   to [compare builds for breakage][ci-compare].
8739
8740
8741 [crates.io]: http://crates.io
8742 [clo]: https://github.com/rust-lang/rust/pull/24034
8743 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
8744 [con]: https://github.com/rust-lang/rust/pull/23875
8745 [cr]: https://github.com/rust-lang/rust/pull/23419
8746 [fe]: https://github.com/rust-lang/rust/pull/23879
8747 [ie]: https://github.com/rust-lang/rust/pull/23300
8748 [inv]: https://github.com/rust-lang/rust/pull/23938
8749 [ios]: https://github.com/rust-lang/rust/pull/24133
8750 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
8751 [lt]: https://github.com/rust-lang/rust/pull/24057
8752 [meth]: https://github.com/rust-lang/rust/pull/24056
8753 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
8754 [po]: https://github.com/rust-lang/rust/pull/24270
8755 [sf]: https://github.com/rust-lang/rust/pull/24517
8756 [slp]: https://github.com/rust-lang/rust/pull/23949
8757 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
8758 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
8759 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
8760 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
8761 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
8762 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
8763 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
8764 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
8765 [self-sized]: https://github.com/rust-lang/rust/pull/22301
8766 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
8767 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
8768 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
8769 [reflect]: https://github.com/rust-lang/rust/pull/23712
8770 [conversion]: https://github.com/rust-lang/rfcs/pull/529
8771 [num-traits]: https://github.com/rust-lang/rust/pull/23549
8772 [index-value]: https://github.com/rust-lang/rust/pull/23601
8773 [dropck]: https://github.com/rust-lang/rfcs/pull/769
8774 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
8775 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
8776 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
8777 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
8778 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
8779
8780
8781 Version 1.0.0-alpha.2 (2015-02-20)
8782 =====================================
8783
8784 * ~1300 changes, numerous bugfixes
8785
8786 * Highlights
8787
8788     * The various I/O modules were [overhauled][io-rfc] to reduce
8789       unnecessary abstractions and provide better interoperation with
8790       the underlying platform. The old `io` module remains temporarily
8791       at `std::old_io`.
8792     * The standard library now [participates in feature gating][feat],
8793       so use of unstable libraries now requires a `#![feature(...)]`
8794       attribute. The impact of this change is [described on the
8795       forum][feat-forum]. [RFC][feat-rfc].
8796
8797 * Language
8798
8799     * `for` loops [now operate on the `IntoIterator` trait][into],
8800       which eliminates the need to call `.iter()`, etc. to iterate
8801       over collections. There are some new subtleties to remember
8802       though regarding what sort of iterators various types yield, in
8803       particular that `for foo in bar { }` yields values from a move
8804       iterator, destroying the original collection. [RFC][into-rfc].
8805     * Objects now have [default lifetime bounds][obj], so you don't
8806       have to write `Box<Trait+'static>` when you don't care about
8807       storing references. [RFC][obj-rfc].
8808     * In types that implement `Drop`, [lifetimes must outlive the
8809       value][drop]. This will soon make it possible to safely
8810       implement `Drop` for types where `#[unsafe_destructor]` is now
8811       required. Read the [gorgeous RFC][drop-rfc] for details.
8812     * The fully qualified <T as Trait>::X syntax lets you set the Self
8813       type for a trait method or associated type. [RFC][ufcs-rfc].
8814     * References to types that implement `Deref<U>` now [automatically
8815       coerce to references][deref] to the dereferenced type `U`,
8816       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
8817       should eliminate many unsightly uses of `&*`, as when converting
8818       from references to vectors into references to
8819       slices. [RFC][deref-rfc].
8820     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
8821       `|:|`) is obsolete and closure kind is inferred from context.
8822     * [`Self` is a keyword][Self].
8823
8824 * Libraries
8825
8826     * The `Show` and `String` formatting traits [have been
8827       renamed][fmt] to `Debug` and `Display` to more clearly reflect
8828       their related purposes. Automatically getting a string
8829       conversion to use with `format!("{:?}", something_to_debug)` is
8830       now written `#[derive(Debug)]`.
8831     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
8832       OsStr}`, provide strings in platform-specific encodings for easier
8833       interop with system APIs. [RFC][osstr-rfc].
8834     * The `boxed::into_raw` and `Box::from_raw` functions [convert
8835       between `Box<T>` and `*mut T`][boxraw], a common pattern for
8836       creating raw pointers.
8837
8838 * Tooling
8839
8840     * Certain long error messages of the form 'expected foo found bar'
8841       are now [split neatly across multiple
8842       lines][multiline]. Examples in the PR.
8843     * On Unix Rust can be [uninstalled][un] by running
8844       `/usr/local/lib/rustlib/uninstall.sh`.
8845     * The `#[rustc_on_unimplemented]` attribute, requiring the
8846       'on_unimplemented' feature, lets rustc [display custom error
8847       messages when a trait is expected to be implemented for a type
8848       but is not][onun].
8849
8850 * Misc
8851
8852     * Rust is tested against a [LALR grammar][lalr], which parses
8853       almost all the Rust files that rustc does.
8854
8855 [boxraw]: https://github.com/rust-lang/rust/pull/21318
8856 [close]: https://github.com/rust-lang/rust/pull/21843
8857 [deref]: https://github.com/rust-lang/rust/pull/21351
8858 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
8859 [drop]: https://github.com/rust-lang/rust/pull/21972
8860 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
8861 [feat]: https://github.com/rust-lang/rust/pull/21248
8862 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
8863 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
8864 [fmt]: https://github.com/rust-lang/rust/pull/21457
8865 [into]: https://github.com/rust-lang/rust/pull/20790
8866 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
8867 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8868 [lalr]: https://github.com/rust-lang/rust/pull/21452
8869 [multiline]: https://github.com/rust-lang/rust/pull/19870
8870 [obj]: https://github.com/rust-lang/rust/pull/22230
8871 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
8872 [onun]: https://github.com/rust-lang/rust/pull/20889
8873 [osstr]: https://github.com/rust-lang/rust/pull/21488
8874 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
8875 [Self]: https://github.com/rust-lang/rust/pull/22158
8876 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
8877 [un]: https://github.com/rust-lang/rust/pull/22256
8878
8879
8880 Version 1.0.0-alpha (2015-01-09)
8881 ==================================
8882
8883   * ~2400 changes, numerous bugfixes
8884
8885   * Highlights
8886
8887     * The language itself is considered feature complete for 1.0,
8888       though there will be many usability improvements and bugfixes
8889       before the final release.
8890     * Nearly 50% of the public API surface of the standard library has
8891       been declared 'stable'. Those interfaces are unlikely to change
8892       before 1.0.
8893     * The long-running debate over integer types has been
8894       [settled][ints]: Rust will ship with types named `isize` and
8895       `usize`, rather than `int` and `uint`, for pointer-sized
8896       integers. Guidelines will be rolled out during the alpha cycle.
8897     * Most crates that are not `std` have been moved out of the Rust
8898       distribution into the Cargo ecosystem so they can evolve
8899       separately and don't need to be stabilized as quickly, including
8900       'time', 'getopts', 'num', 'regex', and 'term'.
8901     * Documentation continues to be expanded with more API coverage, more
8902       examples, and more in-depth explanations. The guides have been
8903       consolidated into [The Rust Programming Language][trpl].
8904     * "[Rust By Example][rbe]" is now maintained by the Rust team.
8905     * All official Rust binary installers now come with [Cargo], the
8906       Rust package manager.
8907
8908 * Language
8909
8910     * Closures have been [completely redesigned][unboxed] to be
8911       implemented in terms of traits, can now be used as generic type
8912       bounds and thus monomorphized and inlined, or via an opaque
8913       pointer (boxed) as in the old system. The new system is often
8914       referred to as 'unboxed' closures.
8915     * Traits now support [associated types][assoc], allowing families
8916       of related types to be defined together and used generically in
8917       powerful ways.
8918     * Enum variants are [namespaced by their type names][enum].
8919     * [`where` clauses][where] provide a more versatile and attractive
8920       syntax for specifying generic bounds, though the previous syntax
8921       remains valid.
8922     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
8923       numeric types.
8924     * Rust [no longer has a runtime][rt] of any description, and only
8925       supports OS threads, not green threads.
8926     * At long last, Rust has been overhauled for 'dynamically-sized
8927       types' ([DST]), which integrates 'fat pointers' (object types,
8928       arrays, and `str`) more deeply into the type system, making it
8929       more consistent.
8930     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
8931       `..j` that produce range types and which, when combined with the
8932       `Index` operator and multidispatch, leads to a convenient slice
8933       notation, `[i..j]`.
8934     * The new range syntax revealed an ambiguity in the fixed-length
8935       array syntax, so now fixed length arrays [are written `[T;
8936       N]`][arrays].
8937     * The `Copy` trait is no longer implemented automatically. Unsafe
8938       pointers no longer implement `Sync` and `Send` so types
8939       containing them don't automatically either. `Sync` and `Send`
8940       are now 'unsafe traits' so one can "forcibly" implement them via
8941       `unsafe impl` if a type confirms to the requirements for them
8942       even though the internals do not (e.g. structs containing unsafe
8943       pointers like `Arc`). These changes are intended to prevent some
8944       footguns and are collectively known as [opt-in built-in
8945       traits][oibit] (though `Sync` and `Send` will soon become pure
8946       library types unknown to the compiler).
8947     * Operator traits now take their operands [by value][ops], and
8948       comparison traits can use multidispatch to compare one type
8949       against multiple other types, allowing e.g. `String` to be
8950       compared with `&str`.
8951     * `if let` and `while let` are no longer feature-gated.
8952     * Rust has adopted a more [uniform syntax for escaping unicode
8953       characters][unicode].
8954     * `macro_rules!` [has been declared stable][mac]. Though it is a
8955       flawed system it is sufficiently popular that it must be usable
8956       for 1.0. Effort has gone into [future-proofing][mac-future] it
8957       in ways that will allow other macro systems to be developed in
8958       parallel, and won't otherwise impact the evolution of the
8959       language.
8960     * The prelude has been [pared back significantly][prelude] such
8961       that it is the minimum necessary to support the most pervasive
8962       code patterns, and through [generalized where clauses][where]
8963       many of the prelude extension traits have been consolidated.
8964     * Rust's rudimentary reflection [has been removed][refl], as it
8965       incurred too much code generation for little benefit.
8966     * [Struct variants][structvars] are no longer feature-gated.
8967     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
8968       known as 'higher-ranked trait bounds', this crucially allows
8969       unboxed closures to work.
8970     * Macros invocations surrounded by parens or square brackets and
8971       not terminated by a semicolon are [parsed as
8972       expressions][macros], which makes expressions like `vec![1i32,
8973       2, 3].len()` work as expected.
8974     * Trait objects now implement their traits automatically, and
8975       traits that can be coerced to objects now must be [object
8976       safe][objsafe].
8977     * Automatically deriving traits is now done with `#[derive(...)]`
8978       not `#[deriving(...)]` for [consistency with other naming
8979       conventions][derive].
8980     * Importing the containing module or enum at the same time as
8981       items or variants they contain is [now done with `self` instead
8982       of `mod`][self], as in use `foo::{self, bar}`
8983     * Glob imports are no longer feature-gated.
8984     * The `box` operator and `box` patterns have been feature-gated
8985       pending a redesign. For now unique boxes should be allocated
8986       like other containers, with `Box::new`.
8987
8988 * Libraries
8989
8990     * A [series][coll1] of [efforts][coll2] to establish
8991       [conventions][coll3] for collections types has resulted in API
8992       improvements throughout the standard library.
8993     * New [APIs for error handling][err] provide ergonomic interop
8994       between error types, and [new conventions][err-conv] describe
8995       more clearly the recommended error handling strategies in Rust.
8996     * The `fail!` macro has been renamed to [`panic!`][panic] so that
8997       it is easier to discuss failure in the context of error handling
8998       without making clarifications as to whether you are referring to
8999       the 'fail' macro or failure more generally.
9000     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
9001       syscall when available.
9002     * The 'serialize' crate has been renamed 'rustc-serialize' and
9003       moved out of the distribution to Cargo. Although it is widely
9004       used now, it is expected to be superseded in the near future.
9005     * The `Show` formatter, typically implemented with
9006       `#[derive(Show)]` is [now requested with the `{:?}`
9007       specifier][show] and is intended for use by all types, for uses
9008       such as `println!` debugging. The new `String` formatter must be
9009       implemented by hand, uses the `{}` specifier, and is intended
9010       for full-fidelity conversions of things that can logically be
9011       represented as strings.
9012
9013 * Tooling
9014
9015     * [Flexible target specification][flex] allows rustc's code
9016       generation to be configured to support otherwise-unsupported
9017       platforms.
9018     * Rust comes with rust-gdb and rust-lldb scripts that launch their
9019       respective debuggers with Rust-appropriate pretty-printing.
9020     * The Windows installation of Rust is distributed with the
9021       MinGW components currently required to link binaries on that
9022       platform.
9023
9024 * Misc
9025
9026     * Nullable enum optimizations have been extended to more types so
9027       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
9028       space than the inner types themselves.
9029     * Work has begun on supporting AArch64.
9030
9031 [Cargo]: https://crates.io
9032 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
9033 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
9034 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
9035 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
9036 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
9037 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
9038 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
9039 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
9040 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
9041 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
9042 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
9043 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
9044 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
9045 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
9046 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
9047 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
9048 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
9049 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
9050 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
9051 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
9052 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
9053 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
9054 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
9055 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
9056 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
9057 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
9058 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
9059 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
9060 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
9061 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
9062 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
9063 [trpl]: https://doc.rust-lang.org/book/index.html
9064 [rbe]: http://rustbyexample.com/
9065
9066
9067 Version 0.12.0 (2014-10-09)
9068 =============================
9069
9070   * ~1900 changes, numerous bugfixes
9071
9072   * Highlights
9073
9074     * The introductory documentation (now called The Rust Guide) has
9075       been completely rewritten, as have a number of supplementary
9076       guides.
9077     * Rust's package manager, Cargo, continues to improve and is
9078       sometimes considered to be quite awesome.
9079     * Many API's in `std` have been reviewed and updated for
9080       consistency with the in-development Rust coding
9081       guidelines. The standard library documentation tracks
9082       stabilization progress.
9083     * Minor libraries have been moved out-of-tree to the rust-lang org
9084       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
9085       be installed with Cargo.
9086     * Lifetime elision allows lifetime annotations to be left off of
9087       function declarations in many common scenarios.
9088     * Rust now works on 64-bit Windows.
9089
9090   * Language
9091     * Indexing can be overloaded with the `Index` and `IndexMut`
9092       traits.
9093     * The `if let` construct takes a branch only if the `let` pattern
9094       matches, currently behind the 'if_let' feature gate.
9095     * 'where clauses', a more flexible syntax for specifying trait
9096       bounds that is more aesthetic, have been added for traits and
9097       free functions. Where clauses will in the future make it
9098       possible to constrain associated types, which would be
9099       impossible with the existing syntax.
9100     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
9101       the 'slicing_syntax' feature gate, and can be overloaded with
9102       the `Slice` or `SliceMut` traits.
9103     * The syntax for matching of sub-slices has been changed to use a
9104       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
9105       consistency with other uses of `..` and to future-proof
9106       potential additional uses of the syntax.
9107     * The syntax for matching inclusive ranges in patterns has changed
9108       from `0..3` to `0...4` to be consistent with the exclusive range
9109       syntax for slicing.
9110     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
9111       c]`) has been put behind the 'advanced_slice_patterns' feature
9112       gate and may be removed in the future.
9113     * Components of tuples and tuple structs can be extracted using
9114       the `value.0` syntax, currently behind the `tuple_indexing`
9115       feature gate.
9116     * The `#[crate_id]` attribute is no longer supported; versioning
9117       is handled by the package manager.
9118     * Renaming crate imports are now written `extern crate foo as bar`
9119       instead of `extern crate bar = foo`.
9120     * Renaming use statements are now written `use foo as bar` instead
9121       of `use bar = foo`.
9122     * `let` and `match` bindings and argument names in macros are now
9123       hygienic.
9124     * The new, more efficient, closure types ('unboxed closures') have
9125       been added under a feature gate, 'unboxed_closures'. These will
9126       soon replace the existing closure types, once higher-ranked
9127       trait lifetimes are added to the language.
9128     * `move` has been added as a keyword, for indicating closures
9129       that capture by value.
9130     * Mutation and assignment is no longer allowed in pattern guards.
9131     * Generic structs and enums can now have trait bounds.
9132     * The `Share` trait is now called `Sync` to free up the term
9133       'shared' to refer to 'shared reference' (the default reference
9134       type.
9135     * Dynamically-sized types have been mostly implemented,
9136       unifying the behavior of fat-pointer types with the rest of the
9137       type system.
9138     * As part of dynamically-sized types, the `Sized` trait has been
9139       introduced, which qualifying types implement by default, and
9140       which type parameters expect by default. To specify that a type
9141       parameter does not need to be sized, write `<Sized? T>`. Most
9142       types are `Sized`, notable exceptions being unsized arrays
9143       (`[T]`) and trait types.
9144     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
9145     * Lifetime bounds can now be applied to type parameters and object
9146       types.
9147     * The old, reference counted GC type, `Gc<T>` which was once
9148       denoted by the `@` sigil, has finally been removed. GC will be
9149       revisited in the future.
9150
9151   * Libraries
9152     * Library documentation has been improved for a number of modules.
9153     * Bit-vectors, collections::bitv has been modernized.
9154     * The url crate is deprecated in favor of
9155       http://github.com/servo/rust-url, which can be installed with
9156       Cargo.
9157     * Most I/O stream types can be cloned and subsequently closed from
9158       a different thread.
9159     * A `std::time::Duration` type has been added for use in I/O
9160       methods that rely on timers, as well as in the 'time' crate's
9161       `Timespec` arithmetic.
9162     * The runtime I/O abstraction layer that enabled the green thread
9163       scheduler to do non-thread-blocking I/O has been removed, along
9164       with the libuv-based implementation employed by the green thread
9165       scheduler. This will greatly simplify the future I/O work.
9166     * `collections::btree` has been rewritten to have a more
9167       idiomatic and efficient design.
9168
9169   * Tooling
9170     * rustdoc output now indicates the stability levels of API's.
9171     * The `--crate-name` flag can specify the name of the crate
9172       being compiled, like `#[crate_name]`.
9173     * The `-C metadata` specifies additional metadata to hash into
9174       symbol names, and `-C extra-filename` specifies additional
9175       information to put into the output filename, for use by the
9176       package manager for versioning.
9177     * debug info generation has continued to improve and should be
9178       more reliable under both gdb and lldb.
9179     * rustc has experimental support for compiling in parallel
9180       using the `-C codegen-units` flag.
9181     * rustc no longer encodes rpath information into binaries by
9182       default.
9183
9184   * Misc
9185     * Stack usage has been optimized with LLVM lifetime annotations.
9186     * Official Rust binaries on Linux are more compatible with older
9187       kernels and distributions, built on CentOS 5.10.
9188
9189
9190 Version 0.11.0 (2014-07-02)
9191 ==========================
9192
9193   * ~1700 changes, numerous bugfixes
9194
9195   * Language
9196     * ~[T] has been removed from the language. This type is superseded by
9197       the Vec<T> type.
9198     * ~str has been removed from the language. This type is superseded by
9199       the String type.
9200     * ~T has been removed from the language. This type is superseded by the
9201       Box<T> type.
9202     * @T has been removed from the language. This type is superseded by the
9203       standard library's std::gc::Gc<T> type.
9204     * Struct fields are now all private by default.
9205     * Vector indices and shift amounts are both required to be a `uint`
9206       instead of any integral type.
9207     * Byte character, byte string, and raw byte string literals are now all
9208       supported by prefixing the normal literal with a `b`.
9209     * Multiple ABIs are no longer allowed in an ABI string
9210     * The syntax for lifetimes on closures/procedures has been tweaked
9211       slightly: `<'a>|A, B|: 'b + K -> T`
9212     * Floating point modulus has been removed from the language; however it
9213       is still provided by a library implementation.
9214     * Private enum variants are now disallowed.
9215     * The `priv` keyword has been removed from the language.
9216     * A closure can no longer be invoked through a &-pointer.
9217     * The `use foo, bar, baz;` syntax has been removed from the language.
9218     * The transmute intrinsic no longer works on type parameters.
9219     * Statics now allow blocks/items in their definition.
9220     * Trait bounds are separated from objects with + instead of : now.
9221     * Objects can no longer be read while they are mutably borrowed.
9222     * The address of a static is now marked as insignificant unless the
9223       #[inline(never)] attribute is placed it.
9224     * The #[unsafe_destructor] attribute is now behind a feature gate.
9225     * Struct literals are no longer allowed in ambiguous positions such as
9226       if, while, match, and for..in.
9227     * Declaration of lang items and intrinsics are now feature-gated by
9228       default.
9229     * Integral literals no longer default to `int`, and floating point
9230       literals no longer default to `f64`. Literals must be suffixed with an
9231       appropriate type if inference cannot determine the type of the
9232       literal.
9233     * The Box<T> type is no longer implicitly borrowed to &mut T.
9234     * Procedures are now required to not capture borrowed references.
9235
9236   * Libraries
9237     * The standard library is now a "facade" over a number of underlying
9238       libraries. This means that development on the standard library should
9239       be speedier due to smaller crates, as well as a clearer line between
9240       all dependencies.
9241     * A new library, libcore, lives under the standard library's facade
9242       which is Rust's "0-assumption" library, suitable for embedded and
9243       kernel development for example.
9244     * A regex crate has been added to the standard distribution. This crate
9245       includes statically compiled regular expressions.
9246     * The unwrap/unwrap_err methods on Result require a Show bound for
9247       better error messages.
9248     * The return types of the std::comm primitives have been centralized
9249       around the Result type.
9250     * A number of I/O primitives have gained the ability to time out their
9251       operations.
9252     * A number of I/O primitives have gained the ability to close their
9253       reading/writing halves to cancel pending operations.
9254     * Reverse iterator methods have been removed in favor of `rev()` on
9255       their forward-iteration counterparts.
9256     * A bitflags! macro has been added to enable easy interop with C and
9257       management of bit flags.
9258     * A debug_assert! macro is now provided which is disabled when
9259       `--cfg ndebug` is passed to the compiler.
9260     * A graphviz crate has been added for creating .dot files.
9261     * The std::cast module has been migrated into std::mem.
9262     * The std::local_data api has been migrated from freestanding functions
9263       to being based on methods.
9264     * The Pod trait has been renamed to Copy.
9265     * jemalloc has been added as the default allocator for types.
9266     * The API for allocating memory has been changed to use proper alignment
9267       and sized deallocation
9268     * Connecting a TcpStream or binding a TcpListener is now based on a
9269       string address and a u16 port. This allows connecting to a hostname as
9270       opposed to an IP.
9271     * The Reader trait now contains a core method, read_at_least(), which
9272       correctly handles many repeated 0-length reads.
9273     * The process-spawning API is now centered around a builder-style
9274       Command struct.
9275     * The :? printing qualifier has been moved from the standard library to
9276       an external libdebug crate.
9277     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
9278       have been renamed to Eq/Ord.
9279     * The select/plural methods have been removed from format!. The escapes
9280       for { and } have also changed from \{ and \} to {{ and }},
9281       respectively.
9282     * The TaskBuilder API has been re-worked to be a true builder, and
9283       extension traits for spawning native/green tasks have been added.
9284
9285   * Tooling
9286     * All breaking changes to the language or libraries now have their
9287       commit message annotated with `[breaking-change]` to allow for easy
9288       discovery of breaking changes.
9289     * The compiler will now try to suggest how to annotate lifetimes if a
9290       lifetime-related error occurs.
9291     * Debug info continues to be improved greatly with general bug fixes and
9292       better support for situations like link time optimization (LTO).
9293     * Usage of syntax extensions when cross-compiling has been fixed.
9294     * Functionality equivalent to GCC & Clang's -ffunction-sections,
9295       -fdata-sections and --gc-sections has been enabled by default
9296     * The compiler is now stricter about where it will load module files
9297       from when a module is declared via `mod foo;`.
9298     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
9299       Syntax extensions are now discovered via a "plugin registrar" type
9300       which will be extended in the future to other various plugins.
9301     * Lints have been restructured to allow for dynamically loadable lints.
9302     * A number of rustdoc improvements:
9303       * The HTML output has been visually redesigned.
9304       * Markdown is now powered by hoedown instead of sundown.
9305       * Searching heuristics have been greatly improved.
9306       * The search index has been reduced in size by a great amount.
9307       * Cross-crate documentation via `pub use` has been greatly improved.
9308       * Primitive types are now hyperlinked and documented.
9309     * Documentation has been moved from static.rust-lang.org/doc to
9310       doc.rust-lang.org
9311     * A new sandbox, play.rust-lang.org, is available for running and
9312       sharing rust code examples on-line.
9313     * Unused attributes are now more robustly warned about.
9314     * The dead_code lint now warns about unused struct fields.
9315     * Cross-compiling to iOS is now supported.
9316     * Cross-compiling to mipsel is now supported.
9317     * Stability attributes are now inherited by default and no longer apply
9318       to intra-crate usage, only inter-crate usage.
9319     * Error message related to non-exhaustive match expressions have been
9320       greatly improved.
9321
9322
9323 Version 0.10 (2014-04-03)
9324 =========================
9325
9326   * ~1500 changes, numerous bugfixes
9327
9328   * Language
9329     * A new RFC process is now in place for modifying the language.
9330     * Patterns with `@`-pointers have been removed from the language.
9331     * Patterns with unique vectors (`~[T]`) have been removed from the
9332       language.
9333     * Patterns with unique strings (`~str`) have been removed from the
9334       language.
9335     * `@str` has been removed from the language.
9336     * `@[T]` has been removed from the language.
9337     * `@self` has been removed from the language.
9338     * `@Trait` has been removed from the language.
9339     * Headers on `~` allocations which contain `@` boxes inside the type for
9340       reference counting have been removed.
9341     * The semantics around the lifetimes of temporary expressions have changed,
9342       see #3511 and #11585 for more information.
9343     * Cross-crate syntax extensions are now possible, but feature gated. See
9344       #11151 for more information. This includes both `macro_rules!` macros as
9345       well as syntax extensions such as `format!`.
9346     * New lint modes have been added, and older ones have been turned on to be
9347       warn-by-default.
9348       * Unnecessary parentheses
9349       * Uppercase statics
9350       * Camel Case types
9351       * Uppercase variables
9352       * Publicly visible private types
9353       * `#[deriving]` with raw pointers
9354     * Unsafe functions can no longer be coerced to closures.
9355     * Various obscure macros such as `log_syntax!` are now behind feature gates.
9356     * The `#[simd]` attribute is now behind a feature gate.
9357     * Visibility is no longer allowed on `extern crate` statements, and
9358       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
9359     * Trailing commas are now allowed in argument lists and tuple patterns.
9360     * The `do` keyword has been removed, it is now a reserved keyword.
9361     * Default type parameters have been implemented, but are feature gated.
9362     * Borrowed variables through captures in closures are now considered soundly.
9363     * `extern mod` is now `extern crate`
9364     * The `Freeze` trait has been removed.
9365     * The `Share` trait has been added for types that can be shared among
9366       threads.
9367     * Labels in macros are now hygienic.
9368     * Expression/statement macro invocations can be delimited with `{}` now.
9369     * Treatment of types allowed in `static mut` locations has been tweaked.
9370     * The `*` and `.` operators are now overloadable through the `Deref` and
9371       `DerefMut` traits.
9372     * `~Trait` and `proc` no longer have `Send` bounds by default.
9373     * Partial type hints are now supported with the `_` type marker.
9374     * An `Unsafe` type was introduced for interior mutability. It is now
9375       considered undefined to transmute from `&T` to `&mut T` without using the
9376       `Unsafe` type.
9377     * The #[linkage] attribute was implemented for extern statics/functions.
9378     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
9379     * `Pod` was renamed to `Copy`.
9380
9381   * Libraries
9382     * The `libextra` library has been removed. It has now been decomposed into
9383       component libraries with smaller and more focused nuggets of
9384       functionality. The full list of libraries can be found on the
9385       documentation index page.
9386     * std: `std::condition` has been removed. All I/O errors are now propagated
9387       through the `Result` type. In order to assist with error handling, a
9388       `try!` macro for unwrapping errors with an early return and a lint for
9389       unused results has been added. See #12039 for more information.
9390     * std: The `vec` module has been renamed to `slice`.
9391     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
9392       This will become the only growable vector in the future.
9393     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
9394       are now found at `std::io::BufferedReader` instead of
9395       `std::io::buffered::BufferedReader`.
9396     * std: `print` and `println` are no longer in the prelude, the `print!` and
9397       `println!` macros are intended to be used instead.
9398     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
9399       attempts to statically prevent cycles.
9400     * std: The standard distribution is adopting the policy of pushing failure
9401       to the user rather than failing in libraries. Many functions (such as
9402       `slice::last()`) now return `Option<T>` instead of `T` + failing.
9403     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
9404       deriving mode: `#[deriving(Show)]`.
9405     * std: `ToStr` is now implemented for all types implementing `Show`.
9406     * std: The formatting trait methods now take `&self` instead of `&T`
9407     * std: The `invert()` method on iterators has been renamed to `rev()`
9408     * std: `std::num` has seen a reduction in the genericity of its traits,
9409       consolidating functionality into a few core traits.
9410     * std: Backtraces are now printed on task failure if the environment
9411       variable `RUST_BACKTRACE` is present.
9412     * std: Naming conventions for iterators have been standardized. More details
9413       can be found on the wiki's style guide.
9414     * std: `eof()` has been removed from the `Reader` trait. Specific types may
9415       still implement the function.
9416     * std: Networking types are now cloneable to allow simultaneous reads/writes.
9417     * std: `assert_approx_eq!` has been removed
9418     * std: The `e` and `E` formatting specifiers for floats have been added to
9419       print them in exponential notation.
9420     * std: The `Times` trait has been removed
9421     * std: Indications of variance and opting out of builtin bounds is done
9422       through marker types in `std::kinds::marker` now
9423     * std: `hash` has been rewritten, `IterBytes` has been removed, and
9424       `#[deriving(Hash)]` is now possible.
9425     * std: `SharedChan` has been removed, `Sender` is now cloneable.
9426     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
9427     * std: `Chan::new` is now `channel()`.
9428     * std: A new synchronous channel type has been implemented.
9429     * std: A `select!` macro is now provided for selecting over `Receiver`s.
9430     * std: `hashmap` and `trie` have been moved to `libcollections`
9431     * std: `run` has been rolled into `io::process`
9432     * std: `assert_eq!` now uses `{}` instead of `{:?}`
9433     * std: The equality and comparison traits have seen some reorganization.
9434     * std: `rand` has moved to `librand`.
9435     * std: `to_{lower,upper}case` has been implemented for `char`.
9436     * std: Logging has been moved to `liblog`.
9437     * collections: `HashMap` has been rewritten for higher performance and less
9438       memory usage.
9439     * native: The default runtime is now `libnative`. If `libgreen` is desired,
9440       it can be booted manually. The runtime guide has more information and
9441       examples.
9442     * native: All I/O functionality except signals has been implemented.
9443     * green: Task spawning with `libgreen` has been optimized with stack caching
9444       and various trimming of code.
9445     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
9446     * sync: The `extra::sync` module has been updated to modern rust (and moved
9447       to the `sync` library), tweaking and improving various interfaces while
9448       dropping redundant functionality.
9449     * sync: A new `Barrier` type has been added to the `sync` library.
9450     * sync: An efficient mutex for native and green tasks has been implemented.
9451     * serialize: The `base64` module has seen some improvement. It treats
9452       newlines better, has non-string error values, and has seen general
9453       cleanup.
9454     * fourcc: A `fourcc!` macro was introduced
9455     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
9456       hexadecimal literal.
9457
9458   * Tooling
9459     * `rustpkg` has been deprecated and removed from the main repository. Its
9460       replacement, `cargo`, is under development.
9461     * Nightly builds of rust are now available
9462     * The memory usage of rustc has been improved many times throughout this
9463       release cycle.
9464     * The build process supports disabling rpath support for the rustc binary
9465       itself.
9466     * Code generation has improved in some cases, giving more information to the
9467       LLVM optimization passes to enable more extensive optimizations.
9468     * Debuginfo compatibility with lldb on OSX has been restored.
9469     * The master branch is now gated on an android bot, making building for
9470       android much more reliable.
9471     * Output flags have been centralized into one `--emit` flag.
9472     * Crate type flags have been centralized into one `--crate-type` flag.
9473     * Codegen flags have been consolidated behind a `-C` flag.
9474     * Linking against outdated crates now has improved error messages.
9475     * Error messages with lifetimes will often suggest how to annotate the
9476       function to fix the error.
9477     * Many more types are documented in the standard library, and new guides
9478       were written.
9479     * Many `rustdoc` improvements:
9480       * code blocks are syntax highlighted.
9481       * render standalone markdown files.
9482       * the --test flag tests all code blocks by default.
9483       * exported macros are displayed.
9484       * re-exported types have their documentation inlined at the location of the
9485         first re-export.
9486       * search works across crates that have been rendered to the same output
9487         directory.
9488
9489
9490 Version 0.9 (2014-01-09)
9491 ==========================
9492
9493    * ~1800 changes, numerous bugfixes
9494
9495    * Language
9496       * The `float` type has been removed. Use `f32` or `f64` instead.
9497       * A new facility for enabling experimental features (feature gating) has
9498         been added, using the crate-level `#[feature(foo)]` attribute.
9499       * Managed boxes (@) are now behind a feature gate
9500         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
9501         standard library's `Gc` or `Rc` types instead.
9502       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
9503       * Jumping back to the top of a loop is now done with `continue` instead of
9504         `loop`.
9505       * Strings can no longer be mutated through index assignment.
9506       * Raw strings can be created via the basic `r"foo"` syntax or with matched
9507         hash delimiters, as in `r###"foo"###`.
9508       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
9509         called once.
9510       * The `&fn` type is now written `|args| -> ret` to match the literal form.
9511       * `@fn`s have been removed.
9512       * `do` only works with procs in order to make it obvious what the cost
9513         of `do` is.
9514       * Single-element tuple-like structs can no longer be dereferenced to
9515         obtain the inner value. A more comprehensive solution for overloading
9516         the dereference operator will be provided in the future.
9517       * The `#[link(...)]` attribute has been replaced with
9518         `#[crate_id = "name#vers"]`.
9519       * Empty `impl`s must be terminated with empty braces and may not be
9520         terminated with a semicolon.
9521       * Keywords are no longer allowed as lifetime names; the `self` lifetime
9522         no longer has any special meaning.
9523       * The old `fmt!` string formatting macro has been removed.
9524       * `printf!` and `printfln!` (old-style formatting) removed in favor of
9525         `print!` and `println!`.
9526       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
9527       * The `extern mod foo (name = "bar")` syntax has been removed. Use
9528         `extern mod foo = "bar"` instead.
9529       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
9530       * Macros can have attributes.
9531       * Macros can expand to items with attributes.
9532       * Macros can expand to multiple items.
9533       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
9534       * Comments may be nested.
9535       * Values automatically coerce to trait objects they implement, without
9536         an explicit `as`.
9537       * Enum discriminants are no longer an entire word but as small as needed to
9538         contain all the variants. The `repr` attribute can be used to override
9539         the discriminant size, as in `#[repr(int)]` for integer-sized, and
9540         `#[repr(C)]` to match C enums.
9541       * Non-string literals are not allowed in attributes (they never worked).
9542       * The FFI now supports variadic functions.
9543       * Octal numeric literals, as in `0o7777`.
9544       * The `concat!` syntax extension performs compile-time string concatenation.
9545       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
9546         removed as Rust no longer uses segmented stacks.
9547       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
9548       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
9549         not `*`; ignoring remaining fields of a struct is also done with `..`,
9550         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
9551       * `rustc` supports the "win64" calling convention via `extern "win64"`.
9552       * `rustc` supports the "system" calling convention, which defaults to the
9553         preferred convention for the target platform, "stdcall" on 32-bit Windows,
9554         "C" elsewhere.
9555       * The `type_overflow` lint (default: warn) checks literals for overflow.
9556       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
9557       * The `attribute_usage` lint (default: warn) warns about unknown
9558         attributes.
9559       * The `unknown_features` lint (default: warn) warns about unknown
9560         feature gates.
9561       * The `dead_code` lint (default: warn) checks for dead code.
9562       * Rust libraries can be linked statically to one another
9563       * `#[link_args]` is behind the `link_args` feature gate.
9564       * Native libraries are now linked with `#[link(name = "foo")]`
9565       * Native libraries can be statically linked to a rust crate
9566         (`#[link(name = "foo", kind = "static")]`).
9567       * Native OS X frameworks are now officially supported
9568         (`#[link(name = "foo", kind = "framework")]`).
9569       * The `#[thread_local]` attribute creates thread-local (not task-local)
9570         variables. Currently behind the `thread_local` feature gate.
9571       * The `return` keyword may be used in closures.
9572       * Types that can be copied via a memcpy implement the `Pod` kind.
9573       * The `cfg` attribute can now be used on struct fields and enum variants.
9574
9575    * Libraries
9576       * std: The `option` and `result` API's have been overhauled to make them
9577         simpler, more consistent, and more composable.
9578       * std: The entire `std::io` module has been replaced with one that is
9579         more comprehensive and that properly interfaces with the underlying
9580         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
9581         implemented.
9582       * std: `io::util` contains a number of useful implementations of
9583         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
9584         `ZeroReader`, `TeeReader`.
9585       * std: The reference counted pointer type `extra::rc` moved into std.
9586       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
9587         just a wrapper around it).
9588       * std: The `Either` type has been removed.
9589       * std: `fmt::Default` can be implemented for any type to provide default
9590         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
9591       * std: The `rand` API continues to be tweaked.
9592       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
9593         on failure in gdb, is now named `rust_fail`.
9594       * std: The `each_key` and `each_value` methods on `HashMap` have been
9595         replaced by the `keys` and `values` iterators.
9596       * std: Functions dealing with type size and alignment have moved from the
9597         `sys` module to the `mem` module.
9598       * std: The `path` module was written and API changed.
9599       * std: `str::from_utf8` has been changed to cast instead of allocate.
9600       * std: `starts_with` and `ends_with` methods added to vectors via the
9601         `ImmutableEqVector` trait, which is in the prelude.
9602       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
9603         if the index is out of bounds.
9604       * std: Task failure no longer propagates between tasks, as the model was
9605         complex, expensive, and incompatible with thread-based tasks.
9606       * std: The `Any` type can be used for dynamic typing.
9607       * std: `~Any` can be passed to the `fail!` macro and retrieved via
9608         `task::try`.
9609       * std: Methods that produce iterators generally do not have an `_iter`
9610         suffix now.
9611       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
9612         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
9613       * std: `util::ignore` renamed to `prelude::drop`.
9614       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
9615         trait.
9616       * std: `vec::raw` has seen a lot of cleanup and API changes.
9617       * std: The standard library no longer includes any C++ code, and very
9618         minimal C, eliminating the dependency on libstdc++.
9619       * std: Runtime scheduling and I/O functionality has been factored out into
9620         extensible interfaces and is now implemented by two different crates:
9621         libnative, for native threading and I/O; and libgreen, for green threading
9622         and I/O. This paves the way for using the standard library in more limited
9623         embedded environments.
9624       * std: The `comm` module has been rewritten to be much faster, have a
9625         simpler, more consistent API, and to work for both native and green
9626         threading.
9627       * std: All libuv dependencies have been moved into the rustuv crate.
9628       * native: New implementations of runtime scheduling on top of OS threads.
9629       * native: New native implementations of TCP, UDP, file I/O, process spawning,
9630         and other I/O.
9631       * green: The green thread scheduler and message passing types are almost
9632         entirely lock-free.
9633       * extra: The `flatpipes` module had bitrotted and was removed.
9634       * extra: All crypto functions have been removed and Rust now has a policy of
9635         not reimplementing crypto in the standard library. In the future crypto
9636         will be provided by external crates with bindings to established libraries.
9637       * extra: `c_vec` has been modernized.
9638       * extra: The `sort` module has been removed. Use the `sort` method on
9639         mutable slices.
9640
9641    * Tooling
9642       * The `rust` and `rusti` commands have been removed, due to lack of
9643         maintenance.
9644       * `rustdoc` was completely rewritten.
9645       * `rustdoc` can test code examples in documentation.
9646       * `rustpkg` can test packages with the argument, 'test'.
9647       * `rustpkg` supports arbitrary dependencies, including C libraries.
9648       * `rustc`'s support for generating debug info is improved again.
9649       * `rustc` has better error reporting for unbalanced delimiters.
9650       * `rustc`'s JIT support was removed due to bitrot.
9651       * Executables and static libraries can be built with LTO (-Z lto)
9652       * `rustc` adds a `--dep-info` flag for communicating dependencies to
9653         build tools.
9654
9655
9656 Version 0.8 (2013-09-26)
9657 ============================
9658
9659    * ~2200 changes, numerous bugfixes
9660
9661    * Language
9662       * The `for` loop syntax has changed to work with the `Iterator` trait.
9663       * At long last, unwinding works on Windows.
9664       * Default methods are ready for use.
9665       * Many trait inheritance bugs fixed.
9666       * Owned and borrowed trait objects work more reliably.
9667       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
9668       * rustc can omit emission of code for the `debug!` macro if it is passed
9669         `--cfg ndebug`
9670       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
9671         for foo.rs, then foo/mod.rs, and will generate an error when both are
9672         present.
9673       * Strings no longer contain trailing nulls. The new `std::c_str` module
9674         provides new mechanisms for converting to C strings.
9675       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
9676       * The FFI has been overhauled such that foreign functions are called directly,
9677         instead of through a stack-switching wrapper.
9678       * Calling a foreign function must be done through a Rust function with the
9679         `#[fixed_stack_segment]` attribute.
9680       * The `externfn!` macro can be used to declare both a foreign function and
9681         a `#[fixed_stack_segment]` wrapper at once.
9682       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
9683       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
9684       * `priv` is disallowed everywhere except for struct fields and enum variants.
9685       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
9686       * `ref` bindings in irrefutable patterns work correctly now.
9687       * `char` is now prevented from containing invalid code points.
9688       * Casting to `bool` is no longer allowed.
9689       * `\0` is now accepted as an escape in chars and strings.
9690       * `yield` is a reserved keyword.
9691       * `typeof` is a reserved keyword.
9692       * Crates may be imported by URL with `extern mod foo = "url";`.
9693       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
9694       * Static vectors can be initialized with repeating elements,
9695         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
9696       * Static structs can be initialized with functional record update,
9697         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
9698       * `cfg!` can be used to conditionally execute code based on the crate
9699         configuration, similarly to `#[cfg(...)]`.
9700       * The `unnecessary_qualification` lint detects unneeded module
9701         prefixes (default: allow).
9702       * Arithmetic operations have been implemented on the SIMD types in
9703         `std::unstable::simd`.
9704       * Exchange allocation headers were removed, reducing memory usage.
9705       * `format!` implements a completely new, extensible, and higher-performance
9706         string formatting system. It will replace `fmt!`.
9707       * `print!` and `println!` write formatted strings (using the `format!`
9708         extension) to stdout.
9709       * `write!` and `writeln!` write formatted strings (using the `format!`
9710         extension) to the new Writers in `std::rt::io`.
9711       * The library section in which a function or static is placed may
9712         be specified with `#[link_section = "..."]`.
9713       * The `proto!` syntax extension for defining bounded message protocols
9714         was removed.
9715       * `macro_rules!` is hygienic for `let` declarations.
9716       * The `#[export_name]` attribute specifies the name of a symbol.
9717       * `unreachable!` can be used to indicate unreachable code, and fails
9718         if executed.
9719
9720    * Libraries
9721       * std: Transitioned to the new runtime, written in Rust.
9722       * std: Added an experimental I/O library, `rt::io`, based on the new
9723         runtime.
9724       * std: A new generic `range` function was added to the prelude, replacing
9725         `uint::range` and friends.
9726       * std: `range_rev` no longer exists. Since range is an iterator it can be
9727         reversed with `range(lo, hi).invert()`.
9728       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
9729         renamed to `unwrap_or`.
9730       * std: The `iterator` module was renamed to `iter`.
9731       * std: Integral types now support the `checked_add`, `checked_sub`, and
9732         `checked_mul` operations for detecting overflow.
9733       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
9734         consistency.
9735       * std: Methods are standardizing on conventions for casting methods:
9736         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
9737         and cheap casts.
9738       * std: The `CString` type in `c_str` provides new ways to convert to and
9739         from C strings.
9740       * std: `DoubleEndedIterator` can yield elements in two directions.
9741       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
9742         two splices.
9743       * std: `str::from_bytes` renamed to `str::from_utf8`.
9744       * std: `pop_opt` and `shift_opt` methods added to vectors.
9745       * std: The task-local data interface no longer uses @, and keys are
9746         no longer function pointers.
9747       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
9748       * std: Added `SharedPort` to `comm`.
9749       * std: `Eq` has a default method for `ne`; only `eq` is required
9750         in implementations.
9751       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
9752         is required in implementations.
9753       * std: `is_utf8` performance is improved, impacting many string functions.
9754       * std: `os::MemoryMap` provides cross-platform mmap.
9755       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
9756         are not 'in-bounds' are considered undefined.
9757       * std: Many freestanding functions in `vec` removed in favor of methods.
9758       * std: Many freestanding functions on scalar types removed in favor of
9759         methods.
9760       * std: Many options to task builders were removed since they don't make
9761         sense in the new scheduler design.
9762       * std: More containers implement `FromIterator` so can be created by the
9763         `collect` method.
9764       * std: More complete atomic types in `unstable::atomics`.
9765       * std: `comm::PortSet` removed.
9766       * std: Mutating methods in the `Set` and `Map` traits have been moved into
9767         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
9768         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
9769         default implementations.
9770       * std: Various `from_str` functions were removed in favor of a generic
9771         `from_str` which is available in the prelude.
9772       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
9773       * extra: `dlist`, the doubly-linked list was modernized.
9774       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
9775       * extra: Added `glob` module, replacing `std::os::glob`.
9776       * extra: `rope` was removed.
9777       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
9778       * extra: `net`, and `timer` were removed. The experimental replacements
9779         are `std::rt::io::net` and `std::rt::io::timer`.
9780       * extra: Iterators implemented for `SmallIntMap`.
9781       * extra: Iterators implemented for `Bitv` and `BitvSet`.
9782       * extra: `SmallIntSet` removed. Use `BitvSet`.
9783       * extra: Performance of JSON parsing greatly improved.
9784       * extra: `semver` updated to SemVer 2.0.0.
9785       * extra: `term` handles more terminals correctly.
9786       * extra: `dbg` module removed.
9787       * extra: `par` module removed.
9788       * extra: `future` was cleaned up, with some method renames.
9789       * extra: Most free functions in `getopts` were converted to methods.
9790
9791    * Other
9792       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
9793       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
9794         similarly to gcc's `--march` flag.
9795       * rustc's performance compiling small crates is much better.
9796       * rustpkg has received many improvements.
9797       * rustpkg supports git tags as package IDs.
9798       * rustpkg builds into target-specific directories so it can be used for
9799         cross-compiling.
9800       * The number of concurrent test tasks is controlled by the environment
9801         variable RUST_TEST_TASKS.
9802       * The test harness can now report metrics for benchmarks.
9803       * All tools have man pages.
9804       * Programs compiled with `--test` now support the `-h` and `--help` flags.
9805       * The runtime uses jemalloc for allocations.
9806       * Segmented stacks are temporarily disabled as part of the transition to
9807         the new runtime. Stack overflows are possible!
9808       * A new documentation backend, rustdoc_ng, is available for use. It is
9809         still invoked through the normal `rustdoc` command.
9810
9811
9812 Version 0.7 (2013-07-03)
9813 =======================
9814
9815    * ~2000 changes, numerous bugfixes
9816
9817    * Language
9818       * `impl`s no longer accept a visibility qualifier. Put them on methods
9819         instead.
9820       * The borrow checker has been rewritten with flow-sensitivity, fixing
9821         many bugs and inconveniences.
9822       * The `self` parameter no longer implicitly means `&'self self`,
9823         and can be explicitly marked with a lifetime.
9824       * Overloadable compound operators (`+=`, etc.) have been temporarily
9825         removed due to bugs.
9826       * The `for` loop protocol now requires `for`-iterators to return `bool`
9827         so they compose better.
9828       * The `Durable` trait is replaced with the `'static` bounds.
9829       * Trait default methods work more often.
9830       * Structs with the `#[packed]` attribute have byte alignment and
9831         no padding between fields.
9832       * Type parameters bound by `Copy` must now be copied explicitly with
9833         the `copy` keyword.
9834       * It is now illegal to move out of a dereferenced unsafe pointer.
9835       * `Option<~T>` is now represented as a nullable pointer.
9836       * `@mut` does dynamic borrow checks correctly.
9837       * The `main` function is only detected at the topmost level of the crate.
9838         The `#[main]` attribute is still valid anywhere.
9839       * Struct fields may no longer be mutable. Use inherited mutability.
9840       * The `#[no_send]` attribute makes a type that would otherwise be
9841         `Send`, not.
9842       * The `#[no_freeze]` attribute makes a type that would otherwise be
9843         `Freeze`, not.
9844       * Unbounded recursion will abort the process after reaching the limit
9845         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
9846       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
9847         are never implicitly copyable.
9848       * `#[static_assert]` makes compile-time assertions about static bools.
9849       * At long last, 'argument modes' no longer exist.
9850       * The rarely used `use mod` statement no longer exists.
9851
9852    * Syntax extensions
9853       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
9854         argument list.
9855       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
9856         `Rand`, `Zero` and `ToStr` can all be automatically derived with
9857         `#[deriving(...)]`.
9858       * The `bytes!` macro returns a vector of bytes for string, u8, char,
9859         and unsuffixed integer literals.
9860
9861    * Libraries
9862       * The `core` crate was renamed to `std`.
9863       * The `std` crate was renamed to `extra`.
9864       * More and improved documentation.
9865       * std: `iterator` module for external iterator objects.
9866       * Many old-style (internal, higher-order function) iterators replaced by
9867         implementations of `Iterator`.
9868       * std: Many old internal vector and string iterators,
9869         incl. `any`, `all`. removed.
9870       * std: The `finalize` method of `Drop` renamed to `drop`.
9871       * std: The `drop` method now takes `&mut self` instead of `&self`.
9872       * std: The prelude no longer re-exports any modules, only types and traits.
9873       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
9874         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
9875       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
9876         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
9877       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
9878         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
9879       * std: Many types implement `Clone`.
9880       * std: `path` type renamed to `Path`.
9881       * std: `mut` module and `Mut` type removed.
9882       * std: Many standalone functions removed in favor of methods and iterators
9883         in `vec`, `str`. In the future methods will also work as functions.
9884       * std: `reinterpret_cast` removed. Use `transmute`.
9885       * std: ascii string handling in `std::ascii`.
9886       * std: `Rand` is implemented for ~/@.
9887       * std: `run` module for spawning processes overhauled.
9888       * std: Various atomic types added to `unstable::atomic`.
9889       * std: Various types implement `Zero`.
9890       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
9891       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
9892       * std: Added `os::mkdir_recursive`.
9893       * std: Added `os::glob` function performs filesystems globs.
9894       * std: `FuzzyEq` renamed to `ApproxEq`.
9895       * std: `Map` now defines `pop` and `swap` methods.
9896       * std: `Cell` constructors converted to static methods.
9897       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
9898       * extra: `flate` module moved from `std` to `extra`.
9899       * extra: `fileinput` module for iterating over a series of files.
9900       * extra: `Complex` number type and `complex` module.
9901       * extra: `Rational` number type and `rational` module.
9902       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
9903       * extra: `term` uses terminfo now, is more correct.
9904       * extra: `arc` functions converted to methods.
9905       * extra: Implementation of fixed output size variations of SHA-2.
9906
9907    * Tooling
9908       * `unused_variables` lint mode for unused variables (default: warn).
9909       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
9910         (default: warn).
9911       * `unused_mut` lint mode for identifying unused `mut` qualifiers
9912         (default: warn).
9913       * `dead_assignment` lint mode for unread variables (default: warn).
9914       * `unnecessary_allocation` lint mode detects some heap allocations that are
9915         immediately borrowed so could be written without allocating (default: warn).
9916       * `missing_doc` lint mode (default: allow).
9917       * `unreachable_code` lint mode (default: warn).
9918       * The `rusti` command has been rewritten and a number of bugs addressed.
9919       * rustc outputs in color on more terminals.
9920       * rustc accepts a `--link-args` flag to pass arguments to the linker.
9921       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
9922       * Compiling with `-g` will make the binary record information about
9923         dynamic borrowcheck failures for debugging.
9924       * rustdoc has a nicer stylesheet.
9925       * Various improvements to rustdoc.
9926       * Improvements to rustpkg (see the detailed release notes).
9927
9928
9929 Version 0.6 (2013-04-03)
9930 ========================
9931
9932    * ~2100 changes, numerous bugfixes
9933
9934    * Syntax changes
9935       * The self type parameter in traits is now spelled `Self`
9936       * The `self` parameter in trait and impl methods must now be explicitly
9937         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
9938       * Static methods no longer require the `static` keyword and instead
9939         are distinguished by the lack of a `self` parameter
9940       * Replaced the `Durable` trait with the `'static` lifetime
9941       * The old closure type syntax with the trailing sigil has been
9942         removed in favor of the more consistent leading sigil
9943       * `super` is a keyword, and may be prefixed to paths
9944       * Trait bounds are separated with `+` instead of whitespace
9945       * Traits are implemented with `impl Trait for Type`
9946         instead of `impl Type: Trait`
9947       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
9948       * The `export` keyword has finally been removed
9949       * The `move` keyword has been removed (see "Semantic changes")
9950       * The interior mutability qualifier on vectors, `[mut T]`, has been
9951         removed. Use `&mut [T]`, etc.
9952       * `mut` is no longer valid in `~mut T`. Use inherited mutability
9953       * `fail` is no longer a keyword. Use `fail!()`
9954       * `assert` is no longer a keyword. Use `assert!()`
9955       * `log` is no longer a keyword. use `debug!`, etc.
9956       * 1-tuples may be represented as `(T,)`
9957       * Struct fields may no longer be `mut`. Use inherited mutability,
9958         `@mut T`, `core::mut` or `core::cell`
9959       * `extern mod { ... }` is no longer valid syntax for foreign
9960         function modules. Use extern blocks: `extern { ... }`
9961       * Newtype enums removed. Use tuple-structs.
9962       * Trait implementations no longer support visibility modifiers
9963       * Pattern matching over vectors improved and expanded
9964       * `const` renamed to `static` to correspond to lifetime name,
9965         and make room for future `static mut` unsafe mutable globals.
9966       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
9967       * `Clone` implementations can be automatically generated with
9968         `#[deriving(Clone)]`
9969       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
9970         instead of `foo as Bar`.
9971       * Fixed length vector types are now written as `[int, .. 3]`
9972         instead of `[int * 3]`.
9973       * Fixed length vector types can express the length as a constant
9974         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
9975
9976    * Semantic changes
9977       * Types with owned pointers or custom destructors move by default,
9978         eliminating the `move` keyword
9979       * All foreign functions are considered unsafe
9980       * &mut is now unaliasable
9981       * Writes to borrowed @mut pointers are prevented dynamically
9982       * () has size 0
9983       * The name of the main function can be customized using #[main]
9984       * The default type of an inferred closure is &fn instead of @fn
9985       * `use` statements may no longer be "chained" - they cannot import
9986         identifiers imported by previous `use` statements
9987       * `use` statements are crate relative, importing from the "top"
9988         of the crate by default. Paths may be prefixed with `super::`
9989         or `self::` to change the search behavior.
9990       * Method visibility is inherited from the implementation declaration
9991       * Structural records have been removed
9992       * Many more types can be used in static items, including enums
9993         'static-lifetime pointers and vectors
9994       * Pattern matching over vectors improved and expanded
9995       * Typechecking of closure types has been overhauled to
9996         improve inference and eliminate unsoundness
9997       * Macros leave scope at the end of modules, unless that module is
9998         tagged with #[macro_escape]
9999
10000    * Libraries
10001       * Added big integers to `std::bigint`
10002       * Removed `core::oldcomm` module
10003       * Added pipe-based `core::comm` module
10004       * Numeric traits have been reorganized under `core::num`
10005       * `vec::slice` finally returns a slice
10006       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
10007       * Containers reorganized around traits in `core::container`
10008       * `core::dvec` removed, `~[T]` is a drop-in replacement
10009       * `core::send_map` renamed to `core::hashmap`
10010       * `std::map` removed; replaced with `core::hashmap`
10011       * `std::treemap` reimplemented as an owned balanced tree
10012       * `std::deque` and `std::smallintmap` reimplemented as owned containers
10013       * `core::trie` added as a fast ordered map for integer keys
10014       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
10015       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
10016         overload the comparison operators, whereas `TotalOrd` is used
10017         by certain container types
10018
10019    * Other
10020       * Replaced the 'cargo' package manager with 'rustpkg'
10021       * Added all-purpose 'rust' tool
10022       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
10023       * rustc now *attempts* to offer spelling suggestions
10024       * Improved support for ARM and Android
10025       * Preliminary MIPS backend
10026       * Improved foreign function ABI implementation for x86, x86_64
10027       * Various memory usage improvements
10028       * Rust code may be embedded in foreign code under limited circumstances
10029       * Inline assembler supported by new asm!() syntax extension.
10030
10031
10032 Version 0.5 (2012-12-21)
10033 ===========================
10034
10035    * ~900 changes, numerous bugfixes
10036
10037    * Syntax changes
10038       * Removed `<-` move operator
10039       * Completed the transition from the `#fmt` extension syntax to `fmt!`
10040       * Removed old fixed length vector syntax - `[T]/N`
10041       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
10042       * Macros may now expand to items and statements
10043       * `a.b()` is always parsed as a method call, never as a field projection
10044       * `Eq` and `IterBytes` implementations can be automatically generated
10045         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
10046       * Removed the special crate language for `.rc` files
10047       * Function arguments may consist of any irrefutable pattern
10048
10049    * Semantic changes
10050       * `&` and `~` pointers may point to objects
10051       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
10052       * Enum variants may be structs
10053       * Destructors can be added to all nominal types with the Drop trait
10054       * Structs and nullary enum variants may be constants
10055       * Values that cannot be implicitly copied are now automatically moved
10056         without writing `move` explicitly
10057       * `&T` may now be coerced to `*T`
10058       * Coercions happen in `let` statements as well as function calls
10059       * `use` statements now take crate-relative paths
10060       * The module and type namespaces have been merged so that static
10061         method names can be resolved under the trait in which they are
10062         declared
10063
10064    * Improved support for language features
10065       * Trait inheritance works in many scenarios
10066       * More support for explicit self arguments in methods - `self`, `&self`
10067         `@self`, and `~self` all generally work as expected
10068       * Static methods work in more situations
10069       * Experimental: Traits may declare default methods for the implementations
10070         to use
10071
10072    * Libraries
10073       * New condition handling system in `core::condition`
10074       * Timsort added to `std::sort`
10075       * New priority queue, `std::priority_queue`
10076       * Pipes for serializable types, `std::flatpipes'
10077       * Serialization overhauled to be trait-based
10078       * Expanded `getopts` definitions
10079       * Moved futures to `std`
10080       * More functions are pure now
10081       * `core::comm` renamed to `oldcomm`. Still deprecated
10082       * `rustdoc` and `cargo` are libraries now
10083
10084    * Misc
10085       * Added a preliminary REPL, `rusti`
10086       * License changed from MIT to dual MIT/APL2
10087
10088
10089 Version 0.4 (2012-10-15)
10090 ==========================
10091
10092    * ~2000 changes, numerous bugfixes
10093
10094    * Syntax
10095       * All keywords are now strict and may not be used as identifiers anywhere
10096       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
10097         'of', 'with', 'to', 'class'.
10098       * Classes are replaced with simpler structs
10099       * Explicit method self types
10100       * `ret` became `return` and `alt` became `match`
10101       * `import` is now `use`; `use is now `extern mod`
10102       * `extern mod { ... }` is now `extern { ... }`
10103       * `use mod` is the recommended way to import modules
10104       * `pub` and `priv` replace deprecated export lists
10105       * The syntax of `match` pattern arms now uses fat arrow (=>)
10106       * `main` no longer accepts an args vector; use `os::args` instead
10107
10108    * Semantics
10109       * Trait implementations are now coherent, ala Haskell typeclasses
10110       * Trait methods may be static
10111       * Argument modes are deprecated
10112       * Borrowed pointers are much more mature and recommended for use
10113       * Strings and vectors in the static region are stored in constant memory
10114       * Typestate was removed
10115       * Resolution rewritten to be more reliable
10116       * Support for 'dual-mode' data structures (freezing and thawing)
10117
10118    * Libraries
10119       * Most binary operators can now be overloaded via the traits in
10120         `core::ops'
10121       * `std::net::url` for representing URLs
10122       * Sendable hash maps in `core::send_map`
10123       * `core::task' gained a (currently unsafe) task-local storage API
10124
10125    * Concurrency
10126       * An efficient new intertask communication primitive called the pipe,
10127         along with a number of higher-level channel types, in `core::pipes`
10128       * `std::arc`, an atomically reference counted, immutable, shared memory
10129         type
10130       * `std::sync`, various exotic synchronization tools based on arcs and pipes
10131       * Futures are now based on pipes and sendable
10132       * More robust linked task failure
10133       * Improved task builder API
10134
10135    * Other
10136       * Improved error reporting
10137       * Preliminary JIT support
10138       * Preliminary work on precise GC
10139       * Extensive architectural improvements to rustc
10140       * Begun a transition away from buggy C++-based reflection (shape) code to
10141         Rust-based (visitor) code
10142       * All hash functions and tables converted to secure, randomized SipHash
10143
10144
10145 Version 0.3  (2012-07-12)
10146 ========================
10147
10148    * ~1900 changes, numerous bugfixes
10149
10150    * New coding conveniences
10151       * Integer-literal suffix inference
10152       * Per-item control over warnings, errors
10153       * #[cfg(windows)] and #[cfg(unix)] attributes
10154       * Documentation comments
10155       * More compact closure syntax
10156       * 'do' expressions for treating higher-order functions as
10157         control structures
10158       * *-patterns (wildcard extended to all constructor fields)
10159
10160    * Semantic cleanup
10161       * Name resolution pass and exhaustiveness checker rewritten
10162       * Region pointers and borrow checking supersede alias
10163         analysis
10164       * Init-ness checking is now provided by a region-based liveness
10165         pass instead of the typestate pass; same for last-use analysis
10166       * Extensive work on region pointers
10167
10168    * Experimental new language features
10169       * Slices and fixed-size, interior-allocated vectors
10170       * #!-comments for lang versioning, shell execution
10171       * Destructors and iface implementation for classes;
10172         type-parameterized classes and class methods
10173       * 'const' type kind for types that can be used to implement
10174         shared-memory concurrency patterns
10175
10176    * Type reflection
10177
10178    * Removal of various obsolete features
10179       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
10180                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
10181
10182       * Constructs: do-while loops ('do' repurposed), fn binding,
10183                     resources (replaced by destructors)
10184
10185    * Compiler reorganization
10186       * Syntax-layer of compiler split into separate crate
10187       * Clang (from LLVM project) integrated into build
10188       * Typechecker split into sub-modules
10189
10190    * New library code
10191       * New time functions
10192       * Extension methods for many built-in types
10193       * Arc: atomic-refcount read-only / exclusive-use shared cells
10194       * Par: parallel map and search routines
10195       * Extensive work on libuv interface
10196       * Much vector code moved to libraries
10197       * Syntax extensions: #line, #col, #file, #mod, #stringify,
10198         #include, #include_str, #include_bin
10199
10200    * Tool improvements
10201       * Cargo automatically resolves dependencies
10202
10203
10204 Version 0.2  (2012-03-29)
10205 =========================
10206
10207    * >1500 changes, numerous bugfixes
10208
10209    * New docs and doc tooling
10210
10211    * New port: FreeBSD x86_64
10212
10213    * Compilation model enhancements
10214       * Generics now specialized, multiply instantiated
10215       * Functions now inlined across separate crates
10216
10217    * Scheduling, stack and threading fixes
10218       * Noticeably improved message-passing performance
10219       * Explicit schedulers
10220       * Callbacks from C
10221       * Helgrind clean
10222
10223    * Experimental new language features
10224       * Operator overloading
10225       * Region pointers
10226       * Classes
10227
10228    * Various language extensions
10229       * C-callback function types: 'crust fn ...'
10230       * Infinite-loop construct: 'loop { ... }'
10231       * Shorten 'mutable' to 'mut'
10232       * Required mutable-local qualifier: 'let mut ...'
10233       * Basic glob-exporting: 'export foo::*;'
10234       * Alt now exhaustive, 'alt check' for runtime-checked
10235       * Block-function form of 'for' loop, with 'break' and 'ret'.
10236
10237    * New library code
10238       * AST quasi-quote syntax extension
10239       * Revived libuv interface
10240       * New modules: core::{future, iter}, std::arena
10241       * Merged per-platform std::{os*, fs*} to core::{libc, os}
10242       * Extensive cleanup, regularization in libstd, libcore
10243
10244
10245 Version 0.1  (2012-01-20)
10246 ===============================
10247
10248    * Most language features work, including:
10249       * Unique pointers, unique closures, move semantics
10250       * Interface-constrained generics
10251       * Static interface dispatch
10252       * Stack growth
10253       * Multithread task scheduling
10254       * Typestate predicates
10255       * Failure unwinding, destructors
10256       * Pattern matching and destructuring assignment
10257       * Lightweight block-lambda syntax
10258       * Preliminary macro-by-example
10259
10260    * Compiler works with the following configurations:
10261       * Linux: x86 and x86_64 hosts and targets
10262       * macOS: x86 and x86_64 hosts and targets
10263       * Windows: x86 hosts and targets
10264
10265    * Cross compilation / multi-target configuration supported.
10266
10267    * Preliminary API-documentation and package-management tools included.
10268
10269 Known issues:
10270
10271    * Documentation is incomplete.
10272
10273    * Performance is below intended target.
10274
10275    * Standard library APIs are subject to extensive change, reorganization.
10276
10277    * Language-level versioning is not yet operational - future code will
10278      break unexpectedly.