RELEASES.md

   1 Version 1.45.0 (2020-07-16)
   2 ==========================
   3
   4 Language
   5 --------
   6 - [Out of range float to int conversions using `as` has been defined as a saturating
   7   conversion.][71269] This was previously undefined behaviour, but you can use the
   8    `{f64, f32}::to_int_unchecked` methods to continue using the current behaviour, which
   9    may be desirable in rare performance sensitive situations.
  10 - [`mem::Discriminant<T>` now uses `T`'s discriminant type instead of always
  11   using `u64`.][70705]
  12 - [Function like procedural macros can now be used in expression, pattern, and  statement
  13   positions.][68717] This means you can now use a function-like procedural macro
  14   anywhere you can use a declarative (`macro_rules!`) macro.
  15
  16 Compiler
  17 --------
  18 - [You can now override individual target features through the `target-feature`
  19   flag.][72094] E.g. `-C target-feature=+avx2 -C target-feature=+fma` is now
  20   equivalent to `-C target-feature=+avx2,+fma`.
  21 - [Added the `force-unwind-tables` flag.][69984] This option allows
  22   rustc to always generate unwind tables regardless of panic strategy.
  23 - [Added the `embed-bitcode` flag.][71716] This codegen flag allows rustc
  24   to include LLVM bitcode into generated `rlib`s (this is on by default).
  25 - [Added the `tiny` value to the `code-model` codegen flag.][72397]
  26 - [Added tier 3 support\* for the `mipsel-sony-psp` target.][72062]
  27 - [Added tier 3 support for the `thumbv7a-uwp-windows-msvc` target.][72133]
  28
  29 \* Refer to Rust's [platform support page][forge-platform-support] for more
  30 information on Rust's tiered platform support.
  31
  32
  33 Libraries
  34 ---------
  35 - [`net::{SocketAddr, SocketAddrV4, SocketAddrV6}` now implements `PartialOrd`
  36   and `Ord`.][72239]
  37 - [`proc_macro::TokenStream` now implements `Default`.][72234]
  38 - [You can now use `char` with
  39   `ops::{Range, RangeFrom, RangeFull, RangeInclusive, RangeTo}` to iterate over
  40   a range of codepoints.][72413] E.g.
  41   you can now write the following;
  42   ```rust
  43   for ch in 'a'..='z' {
  44       print!("{}", ch);
  45   }
  46   println!();
  47   // Prints "abcdefghijklmnopqrstuvwxyz"
  48   ```
  49 - [`OsString` now implements `FromStr`.][71662]
  50 - [The `saturating_neg` method has been added to all signed integer primitive
  51   types, and the `saturating_abs` method has been added for all integer
  52   primitive types.][71886]
  53 - [`Arc<T>`, `Rc<T>` now implement  `From<Cow<'_, T>>`, and `Box` now
  54   implements `From<Cow>` when `T` is `[T: Copy]`, `str`, `CStr`, `OsStr`,
  55   or `Path`.][71447]
  56 - [`Box<[T]>` now implements `From<[T; N]>`.][71095]
  57 - [`BitOr` and `BitOrAssign` are implemented for all `NonZero`
  58   integer types.][69813]
  59 - [The `fetch_min`, and `fetch_max` methods have been added to all atomic
  60   integer types.][72324]
  61 - [The `fetch_update` method has been added to all atomic integer types.][71843]
  62
  63 Stabilized APIs
  64 ---------------
  65 - [`Arc::as_ptr`]
  66 - [`BTreeMap::remove_entry`]
  67 - [`Rc::as_ptr`]
  68 - [`rc::Weak::as_ptr`]
  69 - [`rc::Weak::from_raw`]
  70 - [`rc::Weak::into_raw`]
  71 - [`str::strip_prefix`]
  72 - [`str::strip_suffix`]
  73 - [`sync::Weak::as_ptr`]
  74 - [`sync::Weak::from_raw`]
  75 - [`sync::Weak::into_raw`]
  76 - [`char::UNICODE_VERSION`]
  77 - [`Span::resolved_at`]
  78 - [`Span::located_at`]
  79 - [`Span::mixed_site`]
  80 - [`unix::process::CommandExt::arg0`]
  81
  82 Cargo
  83 -----
  84
  85 - [Cargo uses the `embed-bitcode` flag to optimize disk usage and build
  86   time.][cargo/8066]
  87
  88 Misc
  89 ----
  90 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
  91   `~~outdated information~~` becomes "~~outdated information~~".
  92 - [Added an emoji to Rustdoc's deprecated API message.][72014]
  93
  94 Compatibility Notes
  95 -------------------
  96 - [Trying to self initialize a static value (that is creating a value using
  97   itself) is unsound and now causes a compile error.][71140]
  98 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
  99   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
 100 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
 101   previously undocumented and not intended for public use. Rustdoc still provides
 102   a non-zero exit code on errors.
 103 - [Rustc's `lto` flag is incompatible with the new `embed-bitcode=no`.][71848]
 104   This may cause issues if LTO is enabled through `RUSTFLAGS` or `cargo rustc`
 105   flags while cargo is adding `embed-bitcode` itself. The recommended way to
 106   control LTO is with Cargo profiles, either in `Cargo.toml` or `.cargo/config`,
 107   or by setting `CARGO_PROFILE_<name>_LTO` in the environment.
 108
 109 Internals Only
 110 --------------
 111 - [Make clippy a git subtree instead of a git submodule][70655]
 112 - [Unify the undo log of all snapshot types][69464]
 113
 114 [71848]: https://github.com/rust-lang/rust/issues/71848/
 115 [73420]: https://github.com/rust-lang/rust/issues/73420/
 116 [72324]: https://github.com/rust-lang/rust/pull/72324/
 117 [71843]: https://github.com/rust-lang/rust/pull/71843/
 118 [71886]: https://github.com/rust-lang/rust/pull/71886/
 119 [72234]: https://github.com/rust-lang/rust/pull/72234/
 120 [72239]: https://github.com/rust-lang/rust/pull/72239/
 121 [72397]: https://github.com/rust-lang/rust/pull/72397/
 122 [72413]: https://github.com/rust-lang/rust/pull/72413/
 123 [72014]: https://github.com/rust-lang/rust/pull/72014/
 124 [72062]: https://github.com/rust-lang/rust/pull/72062/
 125 [72094]: https://github.com/rust-lang/rust/pull/72094/
 126 [72133]: https://github.com/rust-lang/rust/pull/72133/
 127 [71900]: https://github.com/rust-lang/rust/pull/71900/
 128 [71928]: https://github.com/rust-lang/rust/pull/71928/
 129 [71662]: https://github.com/rust-lang/rust/pull/71662/
 130 [71716]: https://github.com/rust-lang/rust/pull/71716/
 131 [71447]: https://github.com/rust-lang/rust/pull/71447/
 132 [71269]: https://github.com/rust-lang/rust/pull/71269/
 133 [71095]: https://github.com/rust-lang/rust/pull/71095/
 134 [71140]: https://github.com/rust-lang/rust/pull/71140/
 135 [70655]: https://github.com/rust-lang/rust/pull/70655/
 136 [70705]: https://github.com/rust-lang/rust/pull/70705/
 137 [69984]: https://github.com/rust-lang/rust/pull/69984/
 138 [69813]: https://github.com/rust-lang/rust/pull/69813/
 139 [69464]: https://github.com/rust-lang/rust/pull/69464/
 140 [68717]: https://github.com/rust-lang/rust/pull/68717/
 141 [cargo/8066]: https://github.com/rust-lang/cargo/pull/8066
 142 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
 143 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
 144 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
 145 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
 146 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
 147 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
 148 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
 149 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
 150 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
 151 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
 152 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
 153 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
 154 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
 155 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
 156 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
 157 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
 158
 159
 160 Version 1.44.1 (2020-06-18)
 161 ===========================
 162
 163 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 164 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
 165 * [Fix crashes when finding backtrace on macOS.][71397]
 166 * [Clippy applies lint levels into different files.][clippy/5356]
 167
 168 [71397]: https://github.com/rust-lang/rust/issues/71397
 169 [73078]: https://github.com/rust-lang/rust/issues/73078
 170 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
 171 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
 172
 173
 174 Version 1.44.0 (2020-06-04)
 175 ==========================
 176
 177 Language
 178 --------
 179 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
 180 - [Added the `unused_braces` lint.][70081]
 181
 182 **Syntax-only changes**
 183
 184 - [Expansion-driven outline module parsing][69838]
 185 ```rust
 186 #[cfg(FALSE)]
 187 mod foo {
 188     mod bar {
 189         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
 190     }
 191 }
 192 ```
 193
 194 These are still rejected semantically, so you will likely receive an error but
 195 these changes can be seen and parsed by macros and conditional compilation.
 196
 197 Compiler
 198 --------
 199 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
 200   Additionally when in incremental mode rustc defaults to 256 codegen units.
 201 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
 202   a panic is thrown.][67502]
 203 - [Added tier 3\* support for the `aarch64-unknown-none` and
 204   `aarch64-unknown-none-softfloat` targets.][68334]
 205 - [Added tier 3 support for `arm64-apple-tvos` and
 206   `x86_64-apple-tvos` targets.][68191]
 207
 208
 209 Libraries
 210 ---------
 211 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
 212   `vec![]` to be able to be used in `const` contexts.
 213 - [`convert::Infallible` now implements `Hash`.][70281]
 214 - [`OsString` now implements `DerefMut` and `IndexMut` returning
 215   a `&mut OsStr`.][70048]
 216 - [Unicode 13 is now supported.][69929]
 217 - [`String` now implements `From<&mut str>`.][69661]
 218 - [`IoSlice` now implements `Copy`.][69403]
 219 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
 220 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
 221 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
 222   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
 223   integer types.][69373]
 224
 225 Stabilized APIs
 226 ---------------
 227 - [`PathBuf::with_capacity`]
 228 - [`PathBuf::capacity`]
 229 - [`PathBuf::clear`]
 230 - [`PathBuf::reserve`]
 231 - [`PathBuf::reserve_exact`]
 232 - [`PathBuf::shrink_to_fit`]
 233 - [`f32::to_int_unchecked`]
 234 - [`f64::to_int_unchecked`]
 235 - [`Layout::align_to`]
 236 - [`Layout::pad_to_align`]
 237 - [`Layout::array`]
 238 - [`Layout::extend`]
 239
 240 Cargo
 241 -----
 242 - [Added the `cargo tree` command which will print a tree graph of
 243   your dependencies.][cargo/8062] E.g.
 244   ```
 245     mdbook v0.3.2 (/Users/src/rust/mdbook)
 246   ├── ammonia v3.0.0
 247   │   ├── html5ever v0.24.0
 248   │   │   ├── log v0.4.8
 249   │   │   │   └── cfg-if v0.1.9
 250   │   │   ├── mac v0.1.1
 251   │   │   └── markup5ever v0.9.0
 252   │   │       ├── log v0.4.8 (*)
 253   │   │       ├── phf v0.7.24
 254   │   │       │   └── phf_shared v0.7.24
 255   │   │       │       ├── siphasher v0.2.3
 256   │   │       │       └── unicase v1.4.2
 257   │   │       │           [build-dependencies]
 258   │   │       │           └── version_check v0.1.5
 259   ...
 260   ```
 261   You can also display dependencies on multiple versions of the same crate with
 262   `cargo tree -d` (short for `cargo tree --duplicates`).
 263
 264 Misc
 265 ----
 266 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
 267   the version in the sidebar.][69494]
 268
 269 Compatibility Notes
 270 -------------------
 271 - [Rustc now correctly generates static libraries on Windows GNU targets with
 272   the `.a` extension, rather than the previous `.lib`.][70937]
 273 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
 274 - [The `file_name` property in JSON output of macro errors now points the actual
 275   source file rather than the previous format of `<NAME macros>`.][70969]
 276   **Note:** this may not point to a file that actually exists on the user's system.
 277 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
 278 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
 279   not allow zero initialization such as `NonZeroU8`.][66059] This was
 280   previously a warning.
 281 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
 282   operator has been defined as a saturating operation.][71269] This was previously
 283   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
 284   continue using the current behaviour, which may be desirable in rare performance
 285   sensitive situations.
 286
 287 Internal Only
 288 -------------
 289 These changes provide no direct user facing benefits, but represent significant
 290 improvements to the internals and overall performance of rustc and
 291 related tools.
 292
 293 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
 294 - [Replace big JS dict with JSON parsing.][71250]
 295
 296 [69373]: https://github.com/rust-lang/rust/pull/69373/
 297 [66059]: https://github.com/rust-lang/rust/pull/66059/
 298 [68191]: https://github.com/rust-lang/rust/pull/68191/
 299 [68899]: https://github.com/rust-lang/rust/pull/68899/
 300 [71147]: https://github.com/rust-lang/rust/pull/71147/
 301 [71250]: https://github.com/rust-lang/rust/pull/71250/
 302 [70937]: https://github.com/rust-lang/rust/pull/70937/
 303 [70969]: https://github.com/rust-lang/rust/pull/70969/
 304 [70632]: https://github.com/rust-lang/rust/pull/70632/
 305 [70281]: https://github.com/rust-lang/rust/pull/70281/
 306 [70345]: https://github.com/rust-lang/rust/pull/70345/
 307 [70048]: https://github.com/rust-lang/rust/pull/70048/
 308 [70081]: https://github.com/rust-lang/rust/pull/70081/
 309 [70156]: https://github.com/rust-lang/rust/pull/70156/
 310 [71269]: https://github.com/rust-lang/rust/pull/71269/
 311 [69838]: https://github.com/rust-lang/rust/pull/69838/
 312 [69929]: https://github.com/rust-lang/rust/pull/69929/
 313 [69661]: https://github.com/rust-lang/rust/pull/69661/
 314 [69778]: https://github.com/rust-lang/rust/pull/69778/
 315 [69494]: https://github.com/rust-lang/rust/pull/69494/
 316 [69403]: https://github.com/rust-lang/rust/pull/69403/
 317 [69033]: https://github.com/rust-lang/rust/pull/69033/
 318 [68692]: https://github.com/rust-lang/rust/pull/68692/
 319 [68334]: https://github.com/rust-lang/rust/pull/68334/
 320 [67502]: https://github.com/rust-lang/rust/pull/67502/
 321 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
 322 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
 323 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
 324 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
 325 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
 326 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
 327 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
 328 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
 329 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
 330 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
 331 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
 332 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
 333 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
 334
 335
 336 Version 1.43.1 (2020-05-07)
 337 ===========================
 338
 339 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
 340 * [Fixed the stabilization of AVX-512 features.][71473]
 341 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
 342
 343 [71430]: https://github.com/rust-lang/rust/pull/71430
 344 [71473]: https://github.com/rust-lang/rust/issues/71473
 345 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
 346
 347
 348 Version 1.43.0 (2020-04-23)
 349 ==========================
 350
 351 Language
 352 --------
 353 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
 354   the type inferred correctly.][68129]
 355 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
 356
 357 **Syntax only changes**
 358 - [Allow `type Foo: Ord` syntactically.][69361]
 359 - [Fuse associated and extern items up to defaultness.][69194]
 360 - [Syntactically allow `self` in all `fn` contexts.][68764]
 361 - [Merge `fn` syntax + cleanup item parsing.][68728]
 362 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
 363   For example, you may now write:
 364   ```rust
 365   macro_rules! mac_trait {
 366       ($i:item) => {
 367           trait T { $i }
 368       }
 369   }
 370   mac_trait! {
 371       fn foo() {}
 372   }
 373   ```
 374
 375 These are still rejected *semantically*, so you will likely receive an error but
 376 these changes can be seen and parsed by macros and
 377 conditional compilation.
 378
 379
 380 Compiler
 381 --------
 382 - [You can now pass multiple lint flags to rustc to override the previous
 383   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
 384   everything in the `unused` lint group except `unused-variables` which
 385   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
 386   everything in the `unused` lint group **including** `unused-variables` since
 387   the allow flag is specified before the deny flag (and therefore overridden).
 388 - [rustc will now prefer your system MinGW libraries over its bundled libraries
 389   if they are available on `windows-gnu`.][67429]
 390 - [rustc now buffers errors/warnings printed in JSON.][69227]
 391
 392 Libraries
 393 ---------
 394 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
 395   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
 396   respectively.][69538] **Note** These conversions are only available when `N`
 397   is `0..=32`.
 398 - [You can now use associated constants on floats and integers directly, rather
 399   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
 400   `f32::NAN` with no imports.
 401 - [`u8::is_ascii` is now `const`.][68984]
 402 - [`String` now implements `AsMut<str>`.][68742]
 403 - [Added the `primitive` module to `std` and `core`.][67637] This module
 404   reexports Rust's primitive types. This is mainly useful in macros
 405   where you want avoid these types being shadowed.
 406 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
 407 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
 408
 409 Stabilized APIs
 410 ---------------
 411 - [`Once::is_completed`]
 412 - [`f32::LOG10_2`]
 413 - [`f32::LOG2_10`]
 414 - [`f64::LOG10_2`]
 415 - [`f64::LOG2_10`]
 416 - [`iter::once_with`]
 417
 418 Cargo
 419 -----
 420 - [You can now set config `[profile]`s in your `.cargo/config`, or through
 421   your environment.][cargo/7823]
 422 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
 423   executable path when running integration tests or benchmarks.][cargo/7697]
 424   `<name>` is the name of your binary as-is e.g. If you wanted the executable
 425   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
 426
 427 Misc
 428 ----
 429 - [Certain checks in the `const_err` lint were deemed unrelated to const
 430   evaluation][69185], and have been moved to the `unconditional_panic` and
 431   `arithmetic_overflow` lints.
 432
 433 Compatibility Notes
 434 -------------------
 435
 436 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
 437   has been a warning since 1.36.0.
 438 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
 439   led to some instances being accepted, and now correctly emits a hard error.
 440
 441 [69340]: https://github.com/rust-lang/rust/pull/69340
 442
 443 Internal Only
 444 -------------
 445 These changes provide no direct user facing benefits, but represent significant
 446 improvements to the internals and overall performance of `rustc` and
 447 related tools.
 448
 449 - [All components are now built with `opt-level=3` instead of `2`.][67878]
 450 - [Improved how rustc generates drop code.][67332]
 451 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
 452 - [traits: preallocate 2 Vecs of known initial size][69022]
 453 - [Avoid exponential behaviour when relating types][68772]
 454 - [Skip `Drop` terminators for enum variants without drop glue][68943]
 455 - [Improve performance of coherence checks][68966]
 456 - [Deduplicate types in the generator witness][68672]
 457 - [Invert control in struct_lint_level.][68725]
 458
 459 [67332]: https://github.com/rust-lang/rust/pull/67332/
 460 [67429]: https://github.com/rust-lang/rust/pull/67429/
 461 [67637]: https://github.com/rust-lang/rust/pull/67637/
 462 [67642]: https://github.com/rust-lang/rust/pull/67642/
 463 [67878]: https://github.com/rust-lang/rust/pull/67878/
 464 [67885]: https://github.com/rust-lang/rust/pull/67885/
 465 [68129]: https://github.com/rust-lang/rust/pull/68129/
 466 [68672]: https://github.com/rust-lang/rust/pull/68672/
 467 [68725]: https://github.com/rust-lang/rust/pull/68725/
 468 [68728]: https://github.com/rust-lang/rust/pull/68728/
 469 [68738]: https://github.com/rust-lang/rust/pull/68738/
 470 [68742]: https://github.com/rust-lang/rust/pull/68742/
 471 [68764]: https://github.com/rust-lang/rust/pull/68764/
 472 [68772]: https://github.com/rust-lang/rust/pull/68772/
 473 [68943]: https://github.com/rust-lang/rust/pull/68943/
 474 [68952]: https://github.com/rust-lang/rust/pull/68952/
 475 [68966]: https://github.com/rust-lang/rust/pull/68966/
 476 [68984]: https://github.com/rust-lang/rust/pull/68984/
 477 [69022]: https://github.com/rust-lang/rust/pull/69022/
 478 [69185]: https://github.com/rust-lang/rust/pull/69185/
 479 [69194]: https://github.com/rust-lang/rust/pull/69194/
 480 [69201]: https://github.com/rust-lang/rust/pull/69201/
 481 [69227]: https://github.com/rust-lang/rust/pull/69227/
 482 [69548]: https://github.com/rust-lang/rust/pull/69548/
 483 [69256]: https://github.com/rust-lang/rust/pull/69256/
 484 [69361]: https://github.com/rust-lang/rust/pull/69361/
 485 [69366]: https://github.com/rust-lang/rust/pull/69366/
 486 [69538]: https://github.com/rust-lang/rust/pull/69538/
 487 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
 488 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
 489 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
 490 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
 491 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
 492 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
 493 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
 494 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
 495
 496
 497 Version 1.42.0 (2020-03-12)
 498 ==========================
 499
 500 Language
 501 --------
 502 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
 503   ```rust
 504   fn foo(words: &[&str]) {
 505       match words {
 506           ["Hello", "World", "!", ..] => println!("Hello World!"),
 507           ["Foo", "Bar", ..] => println!("Baz"),
 508           rest => println!("{:?}", rest),
 509       }
 510   }
 511   ```
 512 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
 513   that you can create an enum that has the exact layout and ABI of the type
 514   it contains.
 515 - [There are some *syntax-only* changes:][67131]
 516    - `default` is syntactically allowed before items in `trait` definitions.
 517    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
 518      leave out their bodies in favor of `;`.
 519    - Bounds on associated types in `impl`s are now syntactically allowed
 520      (e.g. `type Foo: Ord;`).
 521    - `...` (the C-variadic type) may occur syntactically directly as the type of
 522       any function parameter.
 523
 524   These are still rejected *semantically*, so you will likely receive an error
 525   but these changes can be seen and parsed by procedural macros and
 526   conditional compilation.
 527
 528 Compiler
 529 --------
 530 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
 531 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
 532 - [`Option::{expect,unwrap}` and
 533    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
 534    pointing to the location where they were called, rather than
 535    `core`'s internals. ][67887]
 536
 537 \* Refer to Rust's [platform support page][forge-platform-support] for more
 538 information on Rust's tiered platform support.
 539
 540 Libraries
 541 ---------
 542 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
 543 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
 544    to implement `Sized`.][67935]
 545 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
 546 - [`Layout::new` is now `const`.][66254]
 547 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
 548
 549
 550 Stabilized APIs
 551 ---------------
 552 - [`CondVar::wait_while`]
 553 - [`CondVar::wait_timeout_while`]
 554 - [`DebugMap::key`]
 555 - [`DebugMap::value`]
 556 - [`ManuallyDrop::take`]
 557 - [`matches!`]
 558 - [`ptr::slice_from_raw_parts_mut`]
 559 - [`ptr::slice_from_raw_parts`]
 560
 561 Cargo
 562 -----
 563 - [You no longer need to include `extern crate proc_macro;` to be able to
 564   `use proc_macro;` in the `2018` edition.][cargo/7700]
 565
 566 Compatibility Notes
 567 -------------------
 568 - [`Error::description` has been deprecated, and its use will now produce a
 569   warning.][66919] It's recommended to use `Display`/`to_string` instead.
 570
 571 [68253]: https://github.com/rust-lang/rust/pull/68253/
 572 [68348]: https://github.com/rust-lang/rust/pull/68348/
 573 [67935]: https://github.com/rust-lang/rust/pull/67935/
 574 [68339]: https://github.com/rust-lang/rust/pull/68339/
 575 [68122]: https://github.com/rust-lang/rust/pull/68122/
 576 [67712]: https://github.com/rust-lang/rust/pull/67712/
 577 [67887]: https://github.com/rust-lang/rust/pull/67887/
 578 [67131]: https://github.com/rust-lang/rust/pull/67131/
 579 [67233]: https://github.com/rust-lang/rust/pull/67233/
 580 [66899]: https://github.com/rust-lang/rust/pull/66899/
 581 [66919]: https://github.com/rust-lang/rust/pull/66919/
 582 [66254]: https://github.com/rust-lang/rust/pull/66254/
 583 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
 584 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
 585 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
 586 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
 587 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
 588 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
 589 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
 590 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
 591 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
 592
 593
 594 Version 1.41.1 (2020-02-27)
 595 ===========================
 596
 597 * [Always check types of static items][69145]
 598 * [Always check lifetime bounds of `Copy` impls][69145]
 599 * [Fix miscompilation in callers of `Layout::repeat`][69225]
 600
 601 [69225]: https://github.com/rust-lang/rust/issues/69225
 602 [69145]: https://github.com/rust-lang/rust/pull/69145
 603
 604
 605 Version 1.41.0 (2020-01-30)
 606 ===========================
 607
 608 Language
 609 --------
 610
 611 - [You can now pass type parameters to foreign items when implementing
 612   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
 613 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
 614   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
 615   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
 616 - [You can now use any valid identifier in a `format_args` macro.][66847]
 617   Previously identifiers starting with an underscore were not allowed.
 618 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
 619   enum variants.][66183] These are still rejected semantically, but
 620   can be seen and parsed by procedural macros and conditional compilation.
 621
 622 Compiler
 623 --------
 624
 625 - [Rustc will now warn if you have unused loop `'label`s.][66325]
 626 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
 627 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
 628 - [You can now pass an arguments file passing the `@path` syntax
 629   to rustc.][66172] Note that the format differs somewhat from what is
 630   found in other tooling; please see [the documentation][argfile-docs] for
 631   more information.
 632 - [You can now provide `--extern` flag without a path, indicating that it is
 633   available from the search path or specified with an `-L` flag.][64882]
 634
 635 \* Refer to Rust's [platform support page][forge-platform-support] for more
 636 information on Rust's tiered platform support.
 637
 638 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
 639
 640 Libraries
 641 ---------
 642
 643 - [The `core::panic` module is now stable.][66771] It was already stable
 644   through `std`.
 645 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
 646   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
 647 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
 648
 649 Stabilized APIs
 650 ---------------
 651
 652 - [`Result::map_or`]
 653 - [`Result::map_or_else`]
 654 - [`std::rc::Weak::weak_count`]
 655 - [`std::rc::Weak::strong_count`]
 656 - [`std::sync::Weak::weak_count`]
 657 - [`std::sync::Weak::strong_count`]
 658
 659 Cargo
 660 -----
 661
 662 - [Cargo will now document all the private items for binary crates
 663   by default.][cargo/7593]
 664 - [`cargo-install` will now reinstall the package if it detects that it is out
 665   of date.][cargo/7560]
 666 - [Cargo.lock now uses a more git friendly format that should help to reduce
 667   merge conflicts.][cargo/7579]
 668 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
 669   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
 670   optimisation level to `2` for debug builds. You can also use
 671   `[profile.<profile>.build-override]` to override build scripts and
 672   their dependencies.
 673
 674 Misc
 675 ----
 676
 677 - [You can now specify `edition` in documentation code blocks to compile the block
 678   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
 679   should be compiled the 2018 edition of Rust.
 680 - [You can now provide custom themes to rustdoc with `--theme`, and check the
 681   current theme with `--check-theme`.][54733]
 682 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
 683
 684 Compatibility Notes
 685 -------------------
 686
 687 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
 688   Apple targets.][apple-32bit-drop] This means that the source code is still
 689   available to build, but the targets are no longer being tested and release
 690   binaries for those platforms will no longer be distributed by the Rust project.
 691   Please refer to the linked blog post for more information.
 692
 693 [54733]: https://github.com/rust-lang/rust/pull/54733/
 694 [61351]: https://github.com/rust-lang/rust/pull/61351/
 695 [67255]: https://github.com/rust-lang/rust/pull/67255/
 696 [66661]: https://github.com/rust-lang/rust/pull/66661/
 697 [66771]: https://github.com/rust-lang/rust/pull/66771/
 698 [66847]: https://github.com/rust-lang/rust/pull/66847/
 699 [66238]: https://github.com/rust-lang/rust/pull/66238/
 700 [66277]: https://github.com/rust-lang/rust/pull/66277/
 701 [66325]: https://github.com/rust-lang/rust/pull/66325/
 702 [66172]: https://github.com/rust-lang/rust/pull/66172/
 703 [66183]: https://github.com/rust-lang/rust/pull/66183/
 704 [65879]: https://github.com/rust-lang/rust/pull/65879/
 705 [65013]: https://github.com/rust-lang/rust/pull/65013/
 706 [64882]: https://github.com/rust-lang/rust/pull/64882/
 707 [64325]: https://github.com/rust-lang/rust/pull/64325/
 708 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
 709 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
 710 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
 711 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
 712 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
 713 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
 714 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
 715 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
 716 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
 717 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
 718 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
 719
 720 Version 1.40.0 (2019-12-19)
 721 ===========================
 722
 723 Language
 724 --------
 725 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
 726   `const` contexts.][65188] e.g.
 727
 728   ```rust
 729   pub struct Point(i32, i32);
 730
 731   const ORIGIN: Point = {
 732       let constructor = Point;
 733
 734       constructor(0, 0)
 735   };
 736   ```
 737
 738 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
 739   indicate that there may be variants or fields added in the future.][64639]
 740   For example this requires adding a wild-card branch (`_ => {}`) to any match
 741   statements on a non-exhaustive `enum`. [(RFC 2008)]
 742 - [You can now use function-like procedural macros in `extern` blocks and in
 743   type positions.][63931] e.g. `type Generated = macro!();`
 744 - [Function-like and attribute procedural macros can now emit
 745   `macro_rules!` items, so you can now have your macros generate macros.][64035]
 746 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
 747   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
 748   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
 749
 750 Compiler
 751 --------
 752 - [Added tier 3 support\* for the
 753   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
 754 - [Added tier 3 support for the
 755   `aarch64-unknown-none-softfloat` target.][64589]
 756 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
 757   `mips64el-unknown-linux-muslabi64` targets.][65843]
 758
 759 \* Refer to Rust's [platform support page][forge-platform-support] for more
 760   information on Rust's tiered platform support.
 761
 762 Libraries
 763 ---------
 764 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
 765
 766 Stabilized APIs
 767 ---------------
 768 - [`BTreeMap::get_key_value`]
 769 - [`HashMap::get_key_value`]
 770 - [`Option::as_deref_mut`]
 771 - [`Option::as_deref`]
 772 - [`Option::flatten`]
 773 - [`UdpSocket::peer_addr`]
 774 - [`f32::to_be_bytes`]
 775 - [`f32::to_le_bytes`]
 776 - [`f32::to_ne_bytes`]
 777 - [`f64::to_be_bytes`]
 778 - [`f64::to_le_bytes`]
 779 - [`f64::to_ne_bytes`]
 780 - [`f32::from_be_bytes`]
 781 - [`f32::from_le_bytes`]
 782 - [`f32::from_ne_bytes`]
 783 - [`f64::from_be_bytes`]
 784 - [`f64::from_le_bytes`]
 785 - [`f64::from_ne_bytes`]
 786 - [`mem::take`]
 787 - [`slice::repeat`]
 788 - [`todo!`]
 789
 790 Cargo
 791 -----
 792 - [Cargo will now always display warnings, rather than only on
 793   fresh builds.][cargo/7450]
 794 - [Feature flags (except `--all-features`) passed to a virtual workspace will
 795   now produce an error.][cargo/7507] Previously these flags were ignored.
 796 - [You can now publish `dev-dependencies` without including
 797   a `version`.][cargo/7333]
 798
 799 Misc
 800 ----
 801 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
 802   when running documentation tests with `rustdoc`.][63803]
 803
 804 Compatibility Notes
 805 -------------------
 806 - [As previously announced, any previous NLL warnings in the 2015 edition are
 807   now hard errors.][64221]
 808 - [The `include!` macro will now warn if it failed to include the
 809   entire file.][64284] The `include!` macro unintentionally only includes the
 810   first _expression_ in a file, and this can be unintuitive. This will become
 811   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
 812 - [Using `#[inline]` on function prototypes and consts now emits a warning under
 813   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
 814   or `extern` blocks now correctly emits a hard error.
 815
 816 [65294]: https://github.com/rust-lang/rust/pull/65294/
 817 [66103]: https://github.com/rust-lang/rust/pull/66103/
 818 [65843]: https://github.com/rust-lang/rust/pull/65843/
 819 [65188]: https://github.com/rust-lang/rust/pull/65188/
 820 [65092]: https://github.com/rust-lang/rust/pull/65092/
 821 [64589]: https://github.com/rust-lang/rust/pull/64589/
 822 [64639]: https://github.com/rust-lang/rust/pull/64639/
 823 [64221]: https://github.com/rust-lang/rust/pull/64221/
 824 [64284]: https://github.com/rust-lang/rust/pull/64284/
 825 [63931]: https://github.com/rust-lang/rust/pull/63931/
 826 [64035]: https://github.com/rust-lang/rust/pull/64035/
 827 [63674]: https://github.com/rust-lang/rust/pull/63674/
 828 [63803]: https://github.com/rust-lang/rust/pull/63803/
 829 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
 830 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
 831 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
 832 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
 833 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
 834 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
 835 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
 836 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
 837 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
 838 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
 839 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
 840 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
 841 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
 842 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
 843 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
 844 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
 845 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
 846 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
 847 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
 848 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
 849 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
 850 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
 851 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
 852 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
 853 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
 854 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
 855
 856
 857 Version 1.39.0 (2019-11-07)
 858 ===========================
 859
 860 Language
 861 --------
 862 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
 863   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
 864 - [You can now use certain attributes on function, closure, and function pointer
 865   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
 866   `deny`, `forbid` as well as inert helper attributes used by procedural macro
 867   attributes applied to items. e.g.
 868   ```rust
 869   fn len(
 870       #[cfg(windows)] slice: &[u16],
 871       #[cfg(not(windows))] slice: &[u8],
 872   ) -> usize {
 873       slice.len()
 874   }
 875   ```
 876 - [You can now take shared references to bind-by-move patterns in the `if` guards
 877   of `match` arms.][63118] e.g.
 878   ```rust
 879   fn main() {
 880       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
 881
 882       match array {
 883           nums
 884   //      ---- `nums` is bound by move.
 885               if nums.iter().sum::<u8>() == 10
 886   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
 887           => {
 888               drop(nums);
 889   //          ----------- Legal as `nums` was bound by move and so we have ownership.
 890           }
 891           _ => unreachable!(),
 892       }
 893   }
 894   ```
 895
 896
 897
 898 Compiler
 899 --------
 900 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
 901 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
 902 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
 903   **Note** Cargo currently doesn't use this feature. Refer to
 904   [cargo#7315][cargo/7315] to track this feature's progress.
 905 - [You can now pass `--show-output` argument to test binaries to print the
 906   output of successful tests.][62600]
 907
 908
 909 \* Refer to Rust's [platform support page][forge-platform-support] for more
 910 information on Rust's tiered platform support.
 911
 912 Libraries
 913 ---------
 914 - [`Vec::new` and `String::new` are now `const` functions.][64028]
 915 - [`LinkedList::new` is now a `const` function.][63684]
 916 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
 917 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
 918   now `const`.][63786]
 919
 920 Stabilized APIs
 921 ---------------
 922 - [`Pin::into_inner`]
 923 - [`Instant::checked_duration_since`]
 924 - [`Instant::saturating_duration_since`]
 925
 926 Cargo
 927 -----
 928 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
 929 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
 930   `--all` is now deprecated.
 931
 932 Misc
 933 ----
 934 - [You can now pass `-Clinker` to rustdoc to control the linker used
 935   for compiling doctests.][63834]
 936
 937 Compatibility Notes
 938 -------------------
 939 - [Code that was previously accepted by the old borrow checker, but rejected by
 940   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
 941   previously a warning, and will also become a hard error in the Rust 2015
 942   edition in the 1.40.0 release.
 943 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
 944   run tests.][63827] This should improve performance when running a large
 945   amount of doctests.
 946 - [The `try!` macro will now issue a deprecation warning.][62672] It is
 947   recommended to use the `?` operator instead.
 948 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
 949   returned `0.0`.
 950
 951 [62600]: https://github.com/rust-lang/rust/pull/62600/
 952 [62672]: https://github.com/rust-lang/rust/pull/62672/
 953 [63118]: https://github.com/rust-lang/rust/pull/63118/
 954 [63209]: https://github.com/rust-lang/rust/pull/63209/
 955 [63402]: https://github.com/rust-lang/rust/pull/63402/
 956 [63565]: https://github.com/rust-lang/rust/pull/63565/
 957 [63595]: https://github.com/rust-lang/rust/pull/63595/
 958 [63684]: https://github.com/rust-lang/rust/pull/63684/
 959 [63698]: https://github.com/rust-lang/rust/pull/63698/
 960 [63770]: https://github.com/rust-lang/rust/pull/63770/
 961 [63786]: https://github.com/rust-lang/rust/pull/63786/
 962 [63827]: https://github.com/rust-lang/rust/pull/63827/
 963 [63834]: https://github.com/rust-lang/rust/pull/63834/
 964 [63927]: https://github.com/rust-lang/rust/pull/63927/
 965 [63933]: https://github.com/rust-lang/rust/pull/63933/
 966 [63934]: https://github.com/rust-lang/rust/pull/63934/
 967 [63938]: https://github.com/rust-lang/rust/pull/63938/
 968 [63940]: https://github.com/rust-lang/rust/pull/63940/
 969 [63941]: https://github.com/rust-lang/rust/pull/63941/
 970 [63945]: https://github.com/rust-lang/rust/pull/63945/
 971 [64010]: https://github.com/rust-lang/rust/pull/64010/
 972 [64028]: https://github.com/rust-lang/rust/pull/64028/
 973 [64334]: https://github.com/rust-lang/rust/pull/64334/
 974 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 975 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 976 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 977 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 978 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 979 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 980
 981 Version 1.38.0 (2019-09-26)
 982 ==========================
 983
 984 Language
 985 --------
 986 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 987 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 988
 989 Compiler
 990 --------
 991 - [Added pipelined compilation support to `rustc`.][62766] This will
 992   improve compilation times in some cases. For further information please refer
 993   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 994 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 995   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 996   `x86_64-uwp-windows-msvc` targets.][60260]
 997 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 998   `armv7-unknown-linux-musleabi` targets.][63107]
 999 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
1000 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
1001
1002 \* Refer to Rust's [platform support page][forge-platform-support] for more
1003 information on Rust's tiered platform support.
1004
1005 Libraries
1006 ---------
1007 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
1008 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
1009   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1010   is available at `std::clone::Clone`). This also makes all built-in macros
1011   available in `std`/`core` root. e.g. `std::include_bytes!`.
1012 - [`str::Chars` now implements `Debug`.][63000]
1013 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1014 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1015 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1016 - [Added euclidean remainder and division operations (`div_euclid`,
1017   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1018   `overflowing`, and `wrapping` versions are available for all
1019   integer primitives.
1020 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1021   `PartialEq`.][61491]
1022 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1023
1024 Stabilized APIs
1025 ---------------
1026 - [`<*const T>::cast`]
1027 - [`<*mut T>::cast`]
1028 - [`Duration::as_secs_f32`]
1029 - [`Duration::as_secs_f64`]
1030 - [`Duration::div_f32`]
1031 - [`Duration::div_f64`]
1032 - [`Duration::from_secs_f32`]
1033 - [`Duration::from_secs_f64`]
1034 - [`Duration::mul_f32`]
1035 - [`Duration::mul_f64`]
1036 - [`any::type_name`]
1037
1038 Cargo
1039 -----
1040 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1041 - [You can now pass the `--features` option multiple times to enable
1042   multiple features.][cargo/7084]
1043
1044 Misc
1045 ----
1046 - [`rustc` will now warn about some incorrect uses of
1047   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1048
1049 Compatibility Notes
1050 -------------------
1051 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1052   1.38.0.
1053 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1054   issues][62896] with certain crates such as libc.
1055
1056 [60260]: https://github.com/rust-lang/rust/pull/60260/
1057 [61457]: https://github.com/rust-lang/rust/pull/61457/
1058 [61491]: https://github.com/rust-lang/rust/pull/61491/
1059 [61884]: https://github.com/rust-lang/rust/pull/61884/
1060 [61953]: https://github.com/rust-lang/rust/pull/61953/
1061 [62042]: https://github.com/rust-lang/rust/pull/62042/
1062 [62528]: https://github.com/rust-lang/rust/pull/62528/
1063 [62583]: https://github.com/rust-lang/rust/pull/62583/
1064 [62735]: https://github.com/rust-lang/rust/pull/62735/
1065 [62766]: https://github.com/rust-lang/rust/pull/62766/
1066 [62784]: https://github.com/rust-lang/rust/pull/62784/
1067 [62785]: https://github.com/rust-lang/rust/issues/62785/
1068 [62814]: https://github.com/rust-lang/rust/pull/62814/
1069 [62896]: https://github.com/rust-lang/rust/issues/62896/
1070 [63000]: https://github.com/rust-lang/rust/pull/63000/
1071 [63056]: https://github.com/rust-lang/rust/pull/63056/
1072 [63107]: https://github.com/rust-lang/rust/pull/63107/
1073 [63346]: https://github.com/rust-lang/rust/pull/63346/
1074 [63421]: https://github.com/rust-lang/rust/pull/63421/
1075 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1076 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1077 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1078 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1079 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1080 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1081 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1082 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1083 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1084 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1085 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1086 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1087 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1088 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1089 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1090
1091 Version 1.37.0 (2019-08-15)
1092 ==========================
1093
1094 Language
1095 --------
1096 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1097   [`Box`][62228], or an [array][62235] and unused.
1098 - [You can now use the `cfg` and `cfg_attr` attributes on
1099   generic parameters.][61547]
1100 - [You can now use enum variants through type alias.][61682] e.g. You can
1101   write the following:
1102   ```rust
1103   type MyOption = Option<u8>;
1104
1105   fn increment_or_zero(x: MyOption) -> u8 {
1106       match x {
1107           MyOption::Some(y) => y + 1,
1108           MyOption::None => 0,
1109       }
1110   }
1111   ```
1112 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1113   `const _: u32 = 5;`.
1114 - [You can now use `#[repr(align(X)]` on enums.][61229]
1115 - [The  `?` Kleene macro operator is now available in the
1116   2015 edition.][60932]
1117
1118 Compiler
1119 --------
1120 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1121   and `-C profile-use` flags.][61268] For more information on how to use profile
1122   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1123 - [The `rust-lldb` wrapper script should now work again.][61827]
1124
1125 Libraries
1126 ---------
1127 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1128
1129 Stabilized APIs
1130 ---------------
1131 - [`BufReader::buffer`]
1132 - [`BufWriter::buffer`]
1133 - [`Cell::from_mut`]
1134 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1135 - [`DoubleEndedIterator::nth_back`]
1136 - [`Option::xor`]
1137 - [`Wrapping::reverse_bits`]
1138 - [`i128::reverse_bits`]
1139 - [`i16::reverse_bits`]
1140 - [`i32::reverse_bits`]
1141 - [`i64::reverse_bits`]
1142 - [`i8::reverse_bits`]
1143 - [`isize::reverse_bits`]
1144 - [`slice::copy_within`]
1145 - [`u128::reverse_bits`]
1146 - [`u16::reverse_bits`]
1147 - [`u32::reverse_bits`]
1148 - [`u64::reverse_bits`]
1149 - [`u8::reverse_bits`]
1150 - [`usize::reverse_bits`]
1151
1152 Cargo
1153 -----
1154 - [`Cargo.lock` files are now included by default when publishing executable crates
1155   with executables.][cargo/7026]
1156 - [You can now specify `default-run="foo"` in `[package]` to specify the
1157   default executable to use for `cargo run`.][cargo/7056]
1158
1159 Misc
1160 ----
1161
1162 Compatibility Notes
1163 -------------------
1164 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1165   Please transition your code to using the `..=` syntax for inclusive
1166   ranges instead.
1167 - [Using a trait object without the `dyn` will now warn by default.][61203]
1168   Please transition your code to use `dyn Trait` for trait objects instead.
1169
1170 [62228]: https://github.com/rust-lang/rust/pull/62228/
1171 [62235]: https://github.com/rust-lang/rust/pull/62235/
1172 [61802]: https://github.com/rust-lang/rust/pull/61802/
1173 [61827]: https://github.com/rust-lang/rust/pull/61827/
1174 [61547]: https://github.com/rust-lang/rust/pull/61547/
1175 [61682]: https://github.com/rust-lang/rust/pull/61682/
1176 [61268]: https://github.com/rust-lang/rust/pull/61268/
1177 [61342]: https://github.com/rust-lang/rust/pull/61342/
1178 [61347]: https://github.com/rust-lang/rust/pull/61347/
1179 [61100]: https://github.com/rust-lang/rust/pull/61100/
1180 [61203]: https://github.com/rust-lang/rust/pull/61203/
1181 [61229]: https://github.com/rust-lang/rust/pull/61229/
1182 [60932]: https://github.com/rust-lang/rust/pull/60932/
1183 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1184 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1185 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1186 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1187 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1188 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1189 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1190 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1191 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1192 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1193 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1194 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1195 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1196 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1197 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1198 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1199 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1200 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1201 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1202 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1203 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1204 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1205 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1206 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1207
1208
1209 Version 1.36.0 (2019-07-04)
1210 ==========================
1211
1212 Language
1213 --------
1214 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1215 - [The order of traits in trait objects no longer affects the semantics of that
1216   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1217   `dyn fmt::Debug + Send`, where this was previously not the case.
1218
1219 Libraries
1220 ---------
1221 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1222 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1223 - [`mem::needs_drop` is now available as a const fn.][60364]
1224 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1225 - [`String` now implements `BorrowMut<str>`.][60404]
1226 - [`io::Cursor` now implements `Default`.][60234]
1227 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1228 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1229   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1230   environment has access to heap memory allocation.
1231 - [`String` now implements `From<&String>`.][59825]
1232 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1233   return a tuple of each argument when there is multiple arguments.
1234 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1235   not used.][59648]
1236
1237 Stabilized APIs
1238 ---------------
1239 - [`VecDeque::rotate_left`]
1240 - [`VecDeque::rotate_right`]
1241 - [`Iterator::copied`]
1242 - [`io::IoSlice`]
1243 - [`io::IoSliceMut`]
1244 - [`Read::read_vectored`]
1245 - [`Write::write_vectored`]
1246 - [`str::as_mut_ptr`]
1247 - [`mem::MaybeUninit`]
1248 - [`pointer::align_offset`]
1249 - [`future::Future`]
1250 - [`task::Context`]
1251 - [`task::RawWaker`]
1252 - [`task::RawWakerVTable`]
1253 - [`task::Waker`]
1254 - [`task::Poll`]
1255
1256 Cargo
1257 -----
1258 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1259 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1260
1261 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1262
1263 Clippy
1264 ------
1265 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1266
1267 Misc
1268 ----
1269
1270 Compatibility Notes
1271 -------------------
1272 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1273   longer recommended, and will be deprecated in 1.39.0.
1274
1275 [60318]: https://github.com/rust-lang/rust/pull/60318/
1276 [60364]: https://github.com/rust-lang/rust/pull/60364/
1277 [60370]: https://github.com/rust-lang/rust/pull/60370/
1278 [60404]: https://github.com/rust-lang/rust/pull/60404/
1279 [60234]: https://github.com/rust-lang/rust/pull/60234/
1280 [60244]: https://github.com/rust-lang/rust/pull/60244/
1281 [58623]: https://github.com/rust-lang/rust/pull/58623/
1282 [59648]: https://github.com/rust-lang/rust/pull/59648/
1283 [59675]: https://github.com/rust-lang/rust/pull/59675/
1284 [59825]: https://github.com/rust-lang/rust/pull/59825/
1285 [59826]: https://github.com/rust-lang/rust/pull/59826/
1286 [59445]: https://github.com/rust-lang/rust/pull/59445/
1287 [59114]: https://github.com/rust-lang/rust/pull/59114/
1288 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1289 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1290 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1291 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1292 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1293 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1294 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1295 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1296 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1297 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1298 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1299 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1300 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1301 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1302 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1303 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1304 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1305 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1306 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1307 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1308
1309
1310 Version 1.35.0 (2019-05-23)
1311 ==========================
1312
1313 Language
1314 --------
1315 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1316   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1317 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1318   ```rust
1319   unsafe fn call_unsafe(func: unsafe fn()) {
1320       func()
1321   }
1322
1323   pub fn main() {
1324       unsafe { call_unsafe(|| {}); }
1325   }
1326   ```
1327
1328
1329 Compiler
1330 --------
1331 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1332   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1333 - [Added the `wasm32-unknown-wasi` target.][59464]
1334
1335
1336 Libraries
1337 ---------
1338 - [`Thread` will now show its ID in `Debug` output.][59460]
1339 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1340 - [`alloc::System` now implements `Default`.][59451]
1341 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1342   last field.][59076]
1343 - [`char::{ToLowercase, ToUppercase}` now
1344   implement `ExactSizeIterator`.][58778]
1345 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1346 - [Removed the `Read` trait bounds
1347   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1348 - [You can now call the `dbg!` macro without any parameters to print the file
1349   and line where it is called.][57847]
1350 - [In place ASCII case conversions are now up to 4× faster.][59283]
1351   e.g. `str::make_ascii_lowercase`
1352 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1353   and `Send`.][58369]
1354
1355 Stabilized APIs
1356 ---------------
1357 - [`f32::copysign`]
1358 - [`f64::copysign`]
1359 - [`RefCell::replace_with`]
1360 - [`RefCell::map_split`]
1361 - [`ptr::hash`]
1362 - [`Range::contains`]
1363 - [`RangeFrom::contains`]
1364 - [`RangeTo::contains`]
1365 - [`RangeInclusive::contains`]
1366 - [`RangeToInclusive::contains`]
1367 - [`Option::copied`]
1368
1369 Cargo
1370 -----
1371 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1372   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1373   platform specific.
1374
1375 Misc
1376 ----
1377 - [The Rust toolchain is now available natively for musl based distros.][58575]
1378
1379 [59460]: https://github.com/rust-lang/rust/pull/59460/
1380 [59464]: https://github.com/rust-lang/rust/pull/59464/
1381 [59500]: https://github.com/rust-lang/rust/pull/59500/
1382 [59512]: https://github.com/rust-lang/rust/pull/59512/
1383 [59580]: https://github.com/rust-lang/rust/pull/59580/
1384 [59283]: https://github.com/rust-lang/rust/pull/59283/
1385 [59451]: https://github.com/rust-lang/rust/pull/59451/
1386 [59076]: https://github.com/rust-lang/rust/pull/59076/
1387 [58778]: https://github.com/rust-lang/rust/pull/58778/
1388 [58717]: https://github.com/rust-lang/rust/pull/58717/
1389 [58369]: https://github.com/rust-lang/rust/pull/58369/
1390 [58423]: https://github.com/rust-lang/rust/pull/58423/
1391 [58080]: https://github.com/rust-lang/rust/pull/58080/
1392 [57847]: https://github.com/rust-lang/rust/pull/57847/
1393 [58575]: https://github.com/rust-lang/rust/pull/58575
1394 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1395 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1396 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1397 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1398 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1399 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1400 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1401 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1402 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1403 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1404 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1405 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1406
1407 Version 1.34.2 (2019-05-14)
1408 ===========================
1409
1410 * [Destabilize the `Error::type_id` function due to a security
1411    vulnerability][60785] ([CVE-2019-12083])
1412
1413 [60785]: https://github.com/rust-lang/rust/pull/60785
1414 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1415
1416 Version 1.34.1 (2019-04-25)
1417 ===========================
1418
1419 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1420 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1421 * [Fix Clippy panic when checking some macros][clippy/3805]
1422
1423 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1424 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1425 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1426
1427 Version 1.34.0 (2019-04-11)
1428 ==========================
1429
1430 Language
1431 --------
1432 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1433   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1434   but had no effect.
1435 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1436   `#[attr{}]` procedural macros.][57367]
1437 - [You can now write `extern crate self as foo;`][57407] to import your
1438   crate's root into the extern prelude.
1439
1440
1441 Compiler
1442 --------
1443 - [You can now target `riscv64imac-unknown-none-elf` and
1444   `riscv64gc-unknown-none-elf`.][58406]
1445 - [You can now enable linker plugin LTO optimisations with
1446   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1447   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1448   boundaries.
1449 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1450
1451
1452 Libraries
1453 ---------
1454 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1455   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1456   the `Hash` trait to create an iterator.
1457 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1458   methods.][58421] Most notably you no longer require the `Ord` trait to create
1459   an iterator.
1460 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1461   for all numeric types.][58044]
1462 - [Indexing a `str` is now generic over all types that
1463   implement `SliceIndex<str>`.][57604]
1464 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1465   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1466   produce a warning if their returning type is unused.
1467 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1468   `overflowing_pow` are now available for all numeric types.][57873] These are
1469   equivalent to methods such as `wrapping_add` for the `pow` operation.
1470
1471
1472 Stabilized APIs
1473 ---------------
1474
1475 #### std & core
1476 * [`Any::type_id`]
1477 * [`Error::type_id`]
1478 * [`atomic::AtomicI16`]
1479 * [`atomic::AtomicI32`]
1480 * [`atomic::AtomicI64`]
1481 * [`atomic::AtomicI8`]
1482 * [`atomic::AtomicU16`]
1483 * [`atomic::AtomicU32`]
1484 * [`atomic::AtomicU64`]
1485 * [`atomic::AtomicU8`]
1486 * [`convert::Infallible`]
1487 * [`convert::TryFrom`]
1488 * [`convert::TryInto`]
1489 * [`iter::from_fn`]
1490 * [`iter::successors`]
1491 * [`num::NonZeroI128`]
1492 * [`num::NonZeroI16`]
1493 * [`num::NonZeroI32`]
1494 * [`num::NonZeroI64`]
1495 * [`num::NonZeroI8`]
1496 * [`num::NonZeroIsize`]
1497 * [`slice::sort_by_cached_key`]
1498 * [`str::escape_debug`]
1499 * [`str::escape_default`]
1500 * [`str::escape_unicode`]
1501 * [`str::split_ascii_whitespace`]
1502
1503 #### std
1504 * [`Instant::checked_add`]
1505 * [`Instant::checked_sub`]
1506 * [`SystemTime::checked_add`]
1507 * [`SystemTime::checked_sub`]
1508
1509 Cargo
1510 -----
1511 - [You can now use alternative registries to crates.io.][cargo/6654]
1512
1513 Misc
1514 ----
1515 - [You can now use the `?` operator in your documentation tests without manually
1516   adding `fn main() -> Result<(), _> {}`.][56470]
1517
1518 Compatibility Notes
1519 -------------------
1520 - [`Command::before_exec` is being replaced by the unsafe method
1521   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1522 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1523   can now use `const` functions in `static` variables.
1524
1525 [58370]: https://github.com/rust-lang/rust/pull/58370/
1526 [58406]: https://github.com/rust-lang/rust/pull/58406/
1527 [58421]: https://github.com/rust-lang/rust/pull/58421/
1528 [58166]: https://github.com/rust-lang/rust/pull/58166/
1529 [58044]: https://github.com/rust-lang/rust/pull/58044/
1530 [58057]: https://github.com/rust-lang/rust/pull/58057/
1531 [58059]: https://github.com/rust-lang/rust/pull/58059/
1532 [57809]: https://github.com/rust-lang/rust/pull/57809/
1533 [57873]: https://github.com/rust-lang/rust/pull/57873/
1534 [57604]: https://github.com/rust-lang/rust/pull/57604/
1535 [57367]: https://github.com/rust-lang/rust/pull/57367/
1536 [57407]: https://github.com/rust-lang/rust/pull/57407/
1537 [57425]: https://github.com/rust-lang/rust/pull/57425/
1538 [57106]: https://github.com/rust-lang/rust/pull/57106/
1539 [56470]: https://github.com/rust-lang/rust/pull/56470/
1540 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1541 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1542 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1543 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1544 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1545 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1546 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1547 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1548 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1549 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1550 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1551 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1552 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1553 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1554 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1555 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1556 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1557 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1558 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1559 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1560 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1561 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1562 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1563 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1564 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1565 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1566 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1567 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1568 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1569 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1570 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1571
1572
1573 Version 1.33.0 (2019-02-28)
1574 ==========================
1575
1576 Language
1577 --------
1578 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1579   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1580 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1581   E.g. You can have match statement on a `u8` that covers `0..=255` and
1582   you would no longer be required to have a `_ => unreachable!()` case.
1583 - [You can now have multiple patterns in `if let` and `while let`
1584   expressions.][57532] You can do this with the same syntax as a `match`
1585   expression. E.g.
1586   ```rust
1587   enum Creature {
1588       Crab(String),
1589       Lobster(String),
1590       Person(String),
1591   }
1592
1593   fn main() {
1594       let state = Creature::Crab("Ferris");
1595
1596       if let Creature::Crab(name) | Creature::Person(name) = state {
1597           println!("This creature's name is: {}", name);
1598       }
1599   }
1600   ```
1601 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1602   this feature will by default produce a warning as this behaviour can be
1603   unintuitive. E.g. `if let _ = 5 {}`
1604 - [You can now use `let` bindings, assignments, expression statements,
1605   and irrefutable pattern destructuring in const functions.][57175]
1606 - [You can now call unsafe const functions.][57067] E.g.
1607   ```rust
1608   const unsafe fn foo() -> i32 { 5 }
1609   const fn bar() -> i32 {
1610       unsafe { foo() }
1611   }
1612   ```
1613 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1614   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1615 - [You can now specify a specific alignment with the `#[repr(packed)]`
1616   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1617   with an alignment of 2 bytes and a size of 6 bytes.
1618 - [You can now import an item from a module as an `_`.][56303] This allows you to
1619   import a trait's impls, and not have the name in the namespace. E.g.
1620   ```rust
1621   use std::io::Read as _;
1622
1623   // Allowed as there is only one `Read` in the module.
1624   pub trait Read {}
1625   ```
1626 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1627
1628 Compiler
1629 --------
1630 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1631   command line argument.][56351]
1632 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1633 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1634 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1635   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1636   information on Rust's platform support.
1637 - [Added support for the `thumbv7neon-linux-androideabi` and
1638   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1639 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1640
1641 Libraries
1642 ---------
1643 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1644   functions for all numeric types.][57566]
1645 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1646   are now `const` functions for all numeric types.][57105]
1647 - [The methods `is_positive` and `is_negative` are now `const` functions for
1648   all signed numeric types.][57105]
1649 - [The `get` method for all `NonZero` types is now `const`.][57167]
1650 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1651   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1652   numeric types.][57234]
1653 - [`Ipv4Addr::new` is now a `const` function][57234]
1654
1655 Stabilized APIs
1656 ---------------
1657 - [`unix::FileExt::read_exact_at`]
1658 - [`unix::FileExt::write_all_at`]
1659 - [`Option::transpose`]
1660 - [`Result::transpose`]
1661 - [`convert::identity`]
1662 - [`pin::Pin`]
1663 - [`marker::Unpin`]
1664 - [`marker::PhantomPinned`]
1665 - [`Vec::resize_with`]
1666 - [`VecDeque::resize_with`]
1667 - [`Duration::as_millis`]
1668 - [`Duration::as_micros`]
1669 - [`Duration::as_nanos`]
1670
1671
1672 Cargo
1673 -----
1674 - [You can now publish crates that require a feature flag to compile with
1675   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1676 - [Cargo should now rebuild a crate if a file was modified during the initial
1677   build.][cargo/6484]
1678
1679 Compatibility Notes
1680 -------------------
1681 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1682   are now deprecated in the standard library, and their usage will now produce a warning.
1683   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1684   methods instead.
1685 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1686   downcasting.
1687 - [Libtest no longer creates a new thread for each test when
1688   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1689
1690 [55982]: https://github.com/rust-lang/rust/pull/55982/
1691 [56243]: https://github.com/rust-lang/rust/pull/56243
1692 [56303]: https://github.com/rust-lang/rust/pull/56303/
1693 [56351]: https://github.com/rust-lang/rust/pull/56351/
1694 [56362]: https://github.com/rust-lang/rust/pull/56362
1695 [56642]: https://github.com/rust-lang/rust/pull/56642/
1696 [56769]: https://github.com/rust-lang/rust/pull/56769/
1697 [56805]: https://github.com/rust-lang/rust/pull/56805
1698 [56947]: https://github.com/rust-lang/rust/pull/56947/
1699 [57049]: https://github.com/rust-lang/rust/pull/57049/
1700 [57067]: https://github.com/rust-lang/rust/pull/57067/
1701 [57105]: https://github.com/rust-lang/rust/pull/57105
1702 [57130]: https://github.com/rust-lang/rust/pull/57130/
1703 [57167]: https://github.com/rust-lang/rust/pull/57167/
1704 [57175]: https://github.com/rust-lang/rust/pull/57175/
1705 [57234]: https://github.com/rust-lang/rust/pull/57234/
1706 [57332]: https://github.com/rust-lang/rust/pull/57332/
1707 [57465]: https://github.com/rust-lang/rust/pull/57465/
1708 [57532]: https://github.com/rust-lang/rust/pull/57532/
1709 [57535]: https://github.com/rust-lang/rust/pull/57535/
1710 [57566]: https://github.com/rust-lang/rust/pull/57566/
1711 [57615]: https://github.com/rust-lang/rust/pull/57615/
1712 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1713 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1714 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1715 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1716 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1717 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1718 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1719 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1720 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1721 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1722 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1723 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1724 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1725 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1726 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1727 [platform-support]: https://forge.rust-lang.org/platform-support.html
1728
1729 Version 1.32.0 (2019-01-17)
1730 ==========================
1731
1732 Language
1733 --------
1734 #### 2018 edition
1735 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1736   operator allows you to specify zero or one repetitions similar to the `*` and
1737   `+` operators.
1738 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1739   now always resolve to the item (`enum`, `struct`, etc.) available in the
1740   module if present, before resolving to a external crate or an item the prelude.][56759]
1741   E.g.
1742   ```rust
1743   enum Color { Red, Green, Blue }
1744
1745   use Color::*;
1746   ```
1747
1748 #### All editions
1749 - [You can now match against `PhantomData<T>` types.][55837]
1750 - [You can now match against literals in macros with the `literal`
1751   specifier.][56072] This will match against a literal of any type.
1752   E.g. `1`, `'A'`, `"Hello World"`
1753 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1754   ```rust
1755   struct Point(i32, i32);
1756
1757   impl Point {
1758       pub fn new(x: i32, y: i32) -> Self {
1759           Self(x, y)
1760       }
1761
1762       pub fn is_origin(&self) -> bool {
1763           match self {
1764               Self(0, 0) => true,
1765               _ => false,
1766           }
1767       }
1768   }
1769   ```
1770 - [Self can also now be used in type definitions.][56366] E.g.
1771   ```rust
1772   enum List<T>
1773   where
1774       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1775   {
1776       Nil,
1777       Cons(T, Box<Self>) // likewise here
1778   }
1779   ```
1780 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1781   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1782
1783 Compiler
1784 --------
1785 - [The default allocator has changed from jemalloc to the default allocator on
1786   your system.][55238] The compiler itself on Linux & macOS will still use
1787   jemalloc, but programs compiled with it will use the system allocator.
1788 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1789
1790 Libraries
1791 ---------
1792 - [`PathBuf` now implements `FromStr`.][55148]
1793 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1794 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1795   easily debug expressions in your rust program. E.g.
1796   ```rust
1797   let a = 2;
1798   let b = dbg!(a * 2) + 1;
1799   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1800   assert_eq!(b, 5);
1801   ```
1802
1803 The following APIs are now `const` functions and can be used in a
1804 `const` context.
1805
1806 - [`Cell::as_ptr`]
1807 - [`UnsafeCell::get`]
1808 - [`char::is_ascii`]
1809 - [`iter::empty`]
1810 - [`ManuallyDrop::new`]
1811 - [`ManuallyDrop::into_inner`]
1812 - [`RangeInclusive::start`]
1813 - [`RangeInclusive::end`]
1814 - [`NonNull::as_ptr`]
1815 - [`slice::as_ptr`]
1816 - [`str::as_ptr`]
1817 - [`Duration::as_secs`]
1818 - [`Duration::subsec_millis`]
1819 - [`Duration::subsec_micros`]
1820 - [`Duration::subsec_nanos`]
1821 - [`CStr::as_ptr`]
1822 - [`Ipv4Addr::is_unspecified`]
1823 - [`Ipv6Addr::new`]
1824 - [`Ipv6Addr::octets`]
1825
1826 Stabilized APIs
1827 ---------------
1828 - [`i8::to_be_bytes`]
1829 - [`i8::to_le_bytes`]
1830 - [`i8::to_ne_bytes`]
1831 - [`i8::from_be_bytes`]
1832 - [`i8::from_le_bytes`]
1833 - [`i8::from_ne_bytes`]
1834 - [`i16::to_be_bytes`]
1835 - [`i16::to_le_bytes`]
1836 - [`i16::to_ne_bytes`]
1837 - [`i16::from_be_bytes`]
1838 - [`i16::from_le_bytes`]
1839 - [`i16::from_ne_bytes`]
1840 - [`i32::to_be_bytes`]
1841 - [`i32::to_le_bytes`]
1842 - [`i32::to_ne_bytes`]
1843 - [`i32::from_be_bytes`]
1844 - [`i32::from_le_bytes`]
1845 - [`i32::from_ne_bytes`]
1846 - [`i64::to_be_bytes`]
1847 - [`i64::to_le_bytes`]
1848 - [`i64::to_ne_bytes`]
1849 - [`i64::from_be_bytes`]
1850 - [`i64::from_le_bytes`]
1851 - [`i64::from_ne_bytes`]
1852 - [`i128::to_be_bytes`]
1853 - [`i128::to_le_bytes`]
1854 - [`i128::to_ne_bytes`]
1855 - [`i128::from_be_bytes`]
1856 - [`i128::from_le_bytes`]
1857 - [`i128::from_ne_bytes`]
1858 - [`isize::to_be_bytes`]
1859 - [`isize::to_le_bytes`]
1860 - [`isize::to_ne_bytes`]
1861 - [`isize::from_be_bytes`]
1862 - [`isize::from_le_bytes`]
1863 - [`isize::from_ne_bytes`]
1864 - [`u8::to_be_bytes`]
1865 - [`u8::to_le_bytes`]
1866 - [`u8::to_ne_bytes`]
1867 - [`u8::from_be_bytes`]
1868 - [`u8::from_le_bytes`]
1869 - [`u8::from_ne_bytes`]
1870 - [`u16::to_be_bytes`]
1871 - [`u16::to_le_bytes`]
1872 - [`u16::to_ne_bytes`]
1873 - [`u16::from_be_bytes`]
1874 - [`u16::from_le_bytes`]
1875 - [`u16::from_ne_bytes`]
1876 - [`u32::to_be_bytes`]
1877 - [`u32::to_le_bytes`]
1878 - [`u32::to_ne_bytes`]
1879 - [`u32::from_be_bytes`]
1880 - [`u32::from_le_bytes`]
1881 - [`u32::from_ne_bytes`]
1882 - [`u64::to_be_bytes`]
1883 - [`u64::to_le_bytes`]
1884 - [`u64::to_ne_bytes`]
1885 - [`u64::from_be_bytes`]
1886 - [`u64::from_le_bytes`]
1887 - [`u64::from_ne_bytes`]
1888 - [`u128::to_be_bytes`]
1889 - [`u128::to_le_bytes`]
1890 - [`u128::to_ne_bytes`]
1891 - [`u128::from_be_bytes`]
1892 - [`u128::from_le_bytes`]
1893 - [`u128::from_ne_bytes`]
1894 - [`usize::to_be_bytes`]
1895 - [`usize::to_le_bytes`]
1896 - [`usize::to_ne_bytes`]
1897 - [`usize::from_be_bytes`]
1898 - [`usize::from_le_bytes`]
1899 - [`usize::from_ne_bytes`]
1900
1901 Cargo
1902 -----
1903 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1904 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1905
1906 Misc
1907 ----
1908 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1909
1910 Compatibility Notes
1911 -------------------
1912 - [The argument types for AVX's
1913   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1914   been changed from `*const` to `*mut` as the previous implementation
1915   was unsound.
1916
1917
1918 [55148]: https://github.com/rust-lang/rust/pull/55148/
1919 [55238]: https://github.com/rust-lang/rust/pull/55238/
1920 [55280]: https://github.com/rust-lang/rust/pull/55280/
1921 [55610]: https://github.com/rust-lang/rust/pull/55610/
1922 [55663]: https://github.com/rust-lang/rust/pull/55663/
1923 [55702]: https://github.com/rust-lang/rust/pull/55702/
1924 [55837]: https://github.com/rust-lang/rust/pull/55837/
1925 [55843]: https://github.com/rust-lang/rust/pull/55843/
1926 [56072]: https://github.com/rust-lang/rust/pull/56072/
1927 [56245]: https://github.com/rust-lang/rust/pull/56245/
1928 [56365]: https://github.com/rust-lang/rust/pull/56365/
1929 [56366]: https://github.com/rust-lang/rust/pull/56366/
1930 [56395]: https://github.com/rust-lang/rust/pull/56395/
1931 [56759]: https://github.com/rust-lang/rust/pull/56759/
1932 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1933 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1934 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1935 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1936 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1937 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1938 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1939 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1940 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1941 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1942 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1943 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1944 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1945 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1946 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1947 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1948 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1949 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1950 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1951 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1952 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1953 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1954 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1955 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1956 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1957 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1958 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1959 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1960 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1961 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1962 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1963 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1964 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1965 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1966 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1967 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1968 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1969 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1970 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1971 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1972 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1973 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1974 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1975 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1976 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1977 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1978 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1979 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1980 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1981 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1982 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1983 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1984 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1985 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1986 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1987 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1988 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1989 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1990 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1991 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1992 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1993 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1994 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1995 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1996 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1997 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1998 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1999 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
2000 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
2001 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
2002 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
2003 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
2004 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
2005 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
2006 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
2007 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
2008 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
2009 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2010 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2011 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2012 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2013 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2014 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2015 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2016 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2017 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2018 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2019 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2020 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2021 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2022 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2023 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2024 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2025
2026
2027 Version 1.31.1 (2018-12-20)
2028 ===========================
2029
2030 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2031 - [Fix broken go-to-definition in RLS][rls/1171]
2032 - [Fix infinite loop on hover in RLS][rls/1170]
2033
2034 [56562]: https://github.com/rust-lang/rust/pull/56562
2035 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2036 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2037
2038 Version 1.31.0 (2018-12-06)
2039 ==========================
2040
2041 Language
2042 --------
2043 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2044 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2045   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2046   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2047   in structs.
2048 - [You can now define and use `const` functions.][54835] These are currently
2049   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2050   [language reference][const-reference] for what exactly is available.
2051 - [You can now use tool lints, which allow you to scope lints from external
2052   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2053 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2054   a crate, not just in exported functions.][54451]
2055 - [You can now use parentheses in pattern matches.][54497]
2056
2057 Compiler
2058 --------
2059 - [Updated musl to 1.1.20][54430]
2060
2061 Libraries
2062 ---------
2063 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2064   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2065 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2066   into `Option<&mut T>` using the `From` trait.][53218]
2067 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2068
2069
2070 Stabilized APIs
2071 ---------------
2072 - [`slice::align_to`]
2073 - [`slice::align_to_mut`]
2074 - [`slice::chunks_exact`]
2075 - [`slice::chunks_exact_mut`]
2076 - [`slice::rchunks`]
2077 - [`slice::rchunks_mut`]
2078 - [`slice::rchunks_exact`]
2079 - [`slice::rchunks_exact_mut`]
2080 - [`Option::replace`]
2081
2082 Cargo
2083 -----
2084 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2085 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2086   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2087
2088 [52813]: https://github.com/rust-lang/rust/pull/52813/
2089 [53218]: https://github.com/rust-lang/rust/pull/53218/
2090 [53555]: https://github.com/rust-lang/rust/issues/53555/
2091 [54057]: https://github.com/rust-lang/rust/pull/54057/
2092 [54240]: https://github.com/rust-lang/rust/pull/54240/
2093 [54430]: https://github.com/rust-lang/rust/pull/54430/
2094 [54451]: https://github.com/rust-lang/rust/pull/54451/
2095 [54497]: https://github.com/rust-lang/rust/pull/54497/
2096 [54778]: https://github.com/rust-lang/rust/pull/54778/
2097 [54835]: https://github.com/rust-lang/rust/pull/54835/
2098 [54870]: https://github.com/rust-lang/rust/pull/54870/
2099 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2100 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2101 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2102 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2103 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2104 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2105 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2106 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2107 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2108 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2109 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2110 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2111 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2112 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2113
2114 Version 1.30.1 (2018-11-08)
2115 ===========================
2116
2117 - [Fixed overflow ICE in rustdoc][54199]
2118 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2119
2120 [54199]: https://github.com/rust-lang/rust/pull/54199
2121 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2122
2123 Version 1.30.0 (2018-10-25)
2124 ==========================
2125
2126 Language
2127 --------
2128 - [Procedural macros are now available.][52081] These kinds of macros allow for
2129   more powerful code generation. There is a [new chapter available][proc-macros]
2130   in the Rust Programming Language book that goes further in depth.
2131 - [You can now use keywords as identifiers using the raw identifiers
2132   syntax (`r#`),][53236] e.g. `let r#for = true;`
2133 - [Using anonymous parameters in traits is now deprecated with a warning and
2134   will be a hard error in the 2018 edition.][53272]
2135 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2136   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2137 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2138   Previously, using a external crate in a module without a use statement
2139   required `let json = ::serde_json::from_str(foo);` but can now be written
2140   as `let json = serde_json::from_str(foo);`.
2141 - [You can now apply the `#[used]` attribute to static items to prevent the
2142   compiler from optimising them away, even if they appear to be unused,][51363]
2143   e.g. `#[used] static FOO: u32 = 1;`
2144 - [You can now import and reexport macros from other crates with the `use`
2145   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2146   the root module of the crate. If your macro relies on calling other local
2147   macros, it is recommended to export with the
2148   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2149   those macros.
2150 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2151   using the `vis` specifier.][53370]
2152 - [Non-macro attributes now allow all forms of literals, not just
2153   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2154   write `#[attr(true)]`.
2155 - [You can now specify a function to handle a panic in the Rust runtime with the
2156   `#[panic_handler]` attribute.][51366]
2157
2158 Compiler
2159 --------
2160 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2161 - [Added the `aarch64-unknown-netbsd` target][53165]
2162
2163 Libraries
2164 ---------
2165 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2166
2167 Stabilized APIs
2168 ---------------
2169 - [`Ipv4Addr::BROADCAST`]
2170 - [`Ipv4Addr::LOCALHOST`]
2171 - [`Ipv4Addr::UNSPECIFIED`]
2172 - [`Ipv6Addr::LOCALHOST`]
2173 - [`Ipv6Addr::UNSPECIFIED`]
2174 - [`Iterator::find_map`]
2175
2176   The following methods are replacement methods for `trim_left`, `trim_right`,
2177   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2178   in 1.33.0:
2179 - [`str::trim_end_matches`]
2180 - [`str::trim_end`]
2181 - [`str::trim_start_matches`]
2182 - [`str::trim_start`]
2183
2184 Cargo
2185 ----
2186 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2187 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2188   equivalent to calling `rustdoc --error-format=json`.
2189 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2190
2191 Misc
2192 ----
2193 - [`rustdoc` allows you to specify what edition to treat your code as with the
2194   `--edition` option.][54057]
2195 - [`rustdoc` now has the `--color` (specify whether to output color) and
2196   `--error-format` (specify error format, e.g. `json`) options.][53003]
2197 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2198   debug symbols.][53774]
2199 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2200   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2201
2202 [50911]: https://github.com/rust-lang/rust/pull/50911/
2203 [51363]: https://github.com/rust-lang/rust/pull/51363/
2204 [51366]: https://github.com/rust-lang/rust/pull/51366/
2205 [52081]: https://github.com/rust-lang/rust/pull/52081/
2206 [53003]: https://github.com/rust-lang/rust/pull/53003/
2207 [53033]: https://github.com/rust-lang/rust/pull/53033/
2208 [53044]: https://github.com/rust-lang/rust/pull/53044/
2209 [53165]: https://github.com/rust-lang/rust/pull/53165/
2210 [53213]: https://github.com/rust-lang/rust/pull/53213/
2211 [53236]: https://github.com/rust-lang/rust/pull/53236/
2212 [53272]: https://github.com/rust-lang/rust/pull/53272/
2213 [53370]: https://github.com/rust-lang/rust/pull/53370/
2214 [53459]: https://github.com/rust-lang/rust/pull/53459/
2215 [53774]: https://github.com/rust-lang/rust/pull/53774/
2216 [53822]: https://github.com/rust-lang/rust/pull/53822/
2217 [54057]: https://github.com/rust-lang/rust/pull/54057/
2218 [54146]: https://github.com/rust-lang/rust/pull/54146/
2219 [54404]: https://github.com/rust-lang/rust/pull/54404/
2220 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2221 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2222 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2223 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2224
2225 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2226 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2227 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2228 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2229 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2230 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2231 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2232 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2233 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2234 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2235
2236
2237 Version 1.29.2 (2018-10-11)
2238 ===========================
2239
2240 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2241 - The `rls-preview` component on the windows-gnu targets has been restored.
2242
2243 [54639]: https://github.com/rust-lang/rust/pull/54639
2244
2245
2246 Version 1.29.1 (2018-09-25)
2247 ===========================
2248
2249 Security Notes
2250 --------------
2251
2252 - The standard library's `str::repeat` function contained an out of bounds write
2253   caused by an integer overflow. This has been fixed by deterministically
2254   panicking when an overflow happens.
2255
2256   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2257   us.
2258
2259
2260 Version 1.29.0 (2018-09-13)
2261 ==========================
2262
2263 Compiler
2264 --------
2265 - [Bumped minimum LLVM version to 5.0.][51899]
2266 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2267 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2268
2269 Libraries
2270 ---------
2271 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2272 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2273 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2274 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2275   for `&str`.][51178]
2276 - [`Cell<T>` now allows `T` to be unsized.][50494]
2277 - [`SocketAddr` is now stable on Redox.][52656]
2278
2279 Stabilized APIs
2280 ---------------
2281 - [`Arc::downcast`]
2282 - [`Iterator::flatten`]
2283 - [`Rc::downcast`]
2284
2285 Cargo
2286 -----
2287 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2288   `--locked` to disable this behavior.
2289 - [`cargo-install` will now allow you to cross compile an install
2290   using `--target`.][cargo/5614]
2291 - [Added the `cargo-fix` subcommand to automatically move project code from
2292   2015 edition to 2018.][cargo/5723]
2293 - [`cargo doc` can now optionally document private types using the
2294   `--document-private-items` flag.][cargo/5543]
2295
2296 Misc
2297 ----
2298 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2299   the specified level to that level.][52354] For example `--cap-lints warn`
2300   will demote `deny` and `forbid` lints to `warn`.
2301 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2302   fails and `101` if there is a panic.][52197]
2303 - [A preview of clippy has been made available through rustup.][51122]
2304   You can install the preview with `rustup component add clippy-preview`.
2305
2306 Compatibility Notes
2307 -------------------
2308 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2309   Use `str::get_unchecked(begin..end)` instead.
2310 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2311   Consider using the `home_dir` function from
2312   https://crates.io/crates/dirs instead.
2313 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2314 - [`cfg` attributes and `--cfg` command line flags are now more
2315   strictly validated.][53893]
2316
2317 [53893]: https://github.com/rust-lang/rust/pull/53893/
2318 [52861]: https://github.com/rust-lang/rust/pull/52861/
2319 [52656]: https://github.com/rust-lang/rust/pull/52656/
2320 [52239]: https://github.com/rust-lang/rust/pull/52239/
2321 [52330]: https://github.com/rust-lang/rust/pull/52330/
2322 [52354]: https://github.com/rust-lang/rust/pull/52354/
2323 [52402]: https://github.com/rust-lang/rust/pull/52402/
2324 [52103]: https://github.com/rust-lang/rust/pull/52103/
2325 [52197]: https://github.com/rust-lang/rust/pull/52197/
2326 [51807]: https://github.com/rust-lang/rust/pull/51807/
2327 [51899]: https://github.com/rust-lang/rust/pull/51899/
2328 [51912]: https://github.com/rust-lang/rust/pull/51912/
2329 [51511]: https://github.com/rust-lang/rust/pull/51511/
2330 [51619]: https://github.com/rust-lang/rust/pull/51619/
2331 [51656]: https://github.com/rust-lang/rust/pull/51656/
2332 [51178]: https://github.com/rust-lang/rust/pull/51178/
2333 [51122]: https://github.com/rust-lang/rust/pull/51122
2334 [50494]: https://github.com/rust-lang/rust/pull/50494/
2335 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2336 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2337 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2338 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2339 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2340 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2341 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2342
2343
2344 Version 1.28.0 (2018-08-02)
2345 ===========================
2346
2347 Language
2348 --------
2349 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2350   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2351   the inner type across Foreign Function Interface (FFI) boundaries.
2352 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2353   and can now be used as identifiers.][51196]
2354 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2355   stable.][51241] This will allow users to specify a global allocator for
2356   their program.
2357 - [Unit test functions marked with the `#[test]` attribute can now return
2358   `Result<(), E: Debug>` in addition to `()`.][51298]
2359 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2360   allows macros to easily target lifetimes.
2361
2362 Compiler
2363 --------
2364 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2365   prioritise making smaller binary sizes. `z` is the same as `s` with the
2366   exception that it does not vectorise loops, which typically results in an even
2367   smaller binary.
2368 - [The short error format is now stable.][49546] Specified with
2369   `--error-format=short` this option will provide a more compressed output of
2370   rust error messages.
2371 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2372 - [Reduced the number of allocations in the macro parser.][50855] This can
2373   improve compile times of macro heavy crates on average by 5%.
2374
2375 Libraries
2376 ---------
2377 - [Implemented `Default` for `&mut str`.][51306]
2378 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2379 - [Implemented `Extend` for `()`.][50234]
2380 - [The `Debug` implementation of `time::Duration` should now be more easily
2381   human readable.][50364] Previously a `Duration` of one second would printed as
2382   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2383 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2384   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2385   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2386   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2387   for `PathBuf`.][50170]
2388 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2389   and `Wrapping<i128>`.][50465]
2390 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2391   possible.][51050] This can provide up to a 40% speed increase.
2392 - [Improved error messages when using `format!`.][50610]
2393
2394 Stabilized APIs
2395 ---------------
2396 - [`Iterator::step_by`]
2397 - [`Path::ancestors`]
2398 - [`SystemTime::UNIX_EPOCH`]
2399 - [`alloc::GlobalAlloc`]
2400 - [`alloc::Layout`]
2401 - [`alloc::LayoutErr`]
2402 - [`alloc::System`]
2403 - [`alloc::alloc`]
2404 - [`alloc::alloc_zeroed`]
2405 - [`alloc::dealloc`]
2406 - [`alloc::realloc`]
2407 - [`alloc::handle_alloc_error`]
2408 - [`btree_map::Entry::or_default`]
2409 - [`fmt::Alignment`]
2410 - [`hash_map::Entry::or_default`]
2411 - [`iter::repeat_with`]
2412 - [`num::NonZeroUsize`]
2413 - [`num::NonZeroU128`]
2414 - [`num::NonZeroU16`]
2415 - [`num::NonZeroU32`]
2416 - [`num::NonZeroU64`]
2417 - [`num::NonZeroU8`]
2418 - [`ops::RangeBounds`]
2419 - [`slice::SliceIndex`]
2420 - [`slice::from_mut`]
2421 - [`slice::from_ref`]
2422 - [`{Any + Send + Sync}::downcast_mut`]
2423 - [`{Any + Send + Sync}::downcast_ref`]
2424 - [`{Any + Send + Sync}::is`]
2425
2426 Cargo
2427 -----
2428 - [Cargo will now no longer allow you to publish crates with build scripts that
2429   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2430   considered to be immutable.
2431
2432 Misc
2433 ----
2434 - [The `suggestion_applicability` field in `rustc`'s json output is now
2435   stable.][50486] This will allow dev tools to check whether a code suggestion
2436   would apply to them.
2437
2438 Compatibility Notes
2439 -------------------
2440 - [Rust will consider trait objects with duplicated constraints to be the same
2441   type as without the duplicated constraint.][51276] For example the below code will
2442   now fail to compile.
2443   ```rust
2444   trait Trait {}
2445
2446   impl Trait + Send {
2447       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2448   }
2449
2450   impl Trait + Send + Send {
2451       fn test(&self) { println!("two"); }
2452   }
2453   ```
2454
2455 [49546]: https://github.com/rust-lang/rust/pull/49546/
2456 [50143]: https://github.com/rust-lang/rust/pull/50143/
2457 [50170]: https://github.com/rust-lang/rust/pull/50170/
2458 [50234]: https://github.com/rust-lang/rust/pull/50234/
2459 [50265]: https://github.com/rust-lang/rust/pull/50265/
2460 [50364]: https://github.com/rust-lang/rust/pull/50364/
2461 [50385]: https://github.com/rust-lang/rust/pull/50385/
2462 [50465]: https://github.com/rust-lang/rust/pull/50465/
2463 [50486]: https://github.com/rust-lang/rust/pull/50486/
2464 [50554]: https://github.com/rust-lang/rust/pull/50554/
2465 [50610]: https://github.com/rust-lang/rust/pull/50610/
2466 [50855]: https://github.com/rust-lang/rust/pull/50855/
2467 [51050]: https://github.com/rust-lang/rust/pull/51050/
2468 [51196]: https://github.com/rust-lang/rust/pull/51196/
2469 [51200]: https://github.com/rust-lang/rust/pull/51200/
2470 [51241]: https://github.com/rust-lang/rust/pull/51241/
2471 [51276]: https://github.com/rust-lang/rust/pull/51276/
2472 [51298]: https://github.com/rust-lang/rust/pull/51298/
2473 [51306]: https://github.com/rust-lang/rust/pull/51306/
2474 [51562]: https://github.com/rust-lang/rust/pull/51562/
2475 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2476 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2477 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2478 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2479 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2480 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2481 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2482 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2483 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2484 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2485 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2486 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2487 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2488 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2489 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2490 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2491 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2492 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2493 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2494 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2495 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2496 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2497 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2498 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2499 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2500 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2501 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2502 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2503 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2504 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2505
2506 Version 1.27.2 (2018-07-20)
2507 ===========================
2508
2509 Compatibility Notes
2510 -------------------
2511
2512 - The borrow checker was fixed to avoid potential unsoundness when using
2513   match ergonomics: [#52213][52213].
2514
2515 [52213]: https://github.com/rust-lang/rust/issues/52213
2516
2517 Version 1.27.1 (2018-07-10)
2518 ===========================
2519
2520 Security Notes
2521 --------------
2522
2523 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2524   when running, which enabled executing code as some other user on a
2525   given machine. This release fixes that vulnerability; you can read
2526   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2527
2528   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2529
2530 Compatibility Notes
2531 -------------------
2532
2533 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2534   match ergonomics: [#51415][51415], [#49534][49534].
2535
2536 [51415]: https://github.com/rust-lang/rust/issues/51415
2537 [49534]: https://github.com/rust-lang/rust/issues/49534
2538 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2539 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2540
2541 Version 1.27.0 (2018-06-21)
2542 ==========================
2543
2544 Language
2545 --------
2546 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2547   be used as an identifier.
2548 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2549   bare `Trait` syntax, and should make it clearer when being used in tandem with
2550   `impl Trait` because it is equivalent to the following syntax:
2551   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2552   `Box<Trait> == Box<dyn Trait>`.
2553 - [Attributes on generic parameters such as types and lifetimes are
2554   now stable.][48851] e.g.
2555   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2556 - [The `#[must_use]` attribute can now also be used on functions as well as
2557   types.][48925] It provides a lint that by default warns users when the
2558   value returned by a function has not been used.
2559
2560 Compiler
2561 --------
2562 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2563
2564 Libraries
2565 ---------
2566 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2567   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2568   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2569   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2570   the `cfg` attribute.
2571 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2572   std are now available in core.][49896]
2573 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2574   to `Self`.][49630]
2575 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2576   that the operation isn't done in place.
2577 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2578   the `#[must_use]` attribute][49533] to warn about unused potentially
2579   expensive allocations.
2580
2581 Stabilized APIs
2582 ---------------
2583 - [`DoubleEndedIterator::rfind`]
2584 - [`DoubleEndedIterator::rfold`]
2585 - [`DoubleEndedIterator::try_rfold`]
2586 - [`Duration::from_micros`]
2587 - [`Duration::from_nanos`]
2588 - [`Duration::subsec_micros`]
2589 - [`Duration::subsec_millis`]
2590 - [`HashMap::remove_entry`]
2591 - [`Iterator::try_fold`]
2592 - [`Iterator::try_for_each`]
2593 - [`NonNull::cast`]
2594 - [`Option::filter`]
2595 - [`String::replace_range`]
2596 - [`Take::set_limit`]
2597 - [`hint::unreachable_unchecked`]
2598 - [`os::unix::process::parent_id`]
2599 - [`ptr::swap_nonoverlapping`]
2600 - [`slice::rsplit_mut`]
2601 - [`slice::rsplit`]
2602 - [`slice::swap_with_slice`]
2603
2604 Cargo
2605 -----
2606 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2607   `readme`, and `repository` fields.][cargo/5386]
2608 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2609 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2610   a different directory than `target` for placing compilation artifacts.
2611 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2612   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2613   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2614   where cargo would infer a binary, Cargo will produce a warning. You can
2615   disable this feature ahead of time by setting any of the following to false:
2616   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2617 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2618   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2619
2620 Misc
2621 ----
2622 - [Added “The Rustc book” into the official documentation.][49707]
2623   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2624 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2625
2626 Compatibility Notes
2627 -------------------
2628 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2629   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2630   compile, `"".is_empty()` will still compile.
2631 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2632   will only print the inner type.][48553] E.g.
2633   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2634   not `AtomicBool(true)`.
2635 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2636   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2637   alignment should cover all use cases.
2638 - The `.description()` method on the `std::error::Error` trait
2639   [has been soft-deprecated][50163]. It is no longer required to implement it.
2640
2641 [48553]: https://github.com/rust-lang/rust/pull/48553/
2642 [48851]: https://github.com/rust-lang/rust/pull/48851/
2643 [48925]: https://github.com/rust-lang/rust/pull/48925/
2644 [49533]: https://github.com/rust-lang/rust/pull/49533/
2645 [49623]: https://github.com/rust-lang/rust/pull/49623/
2646 [49630]: https://github.com/rust-lang/rust/pull/49630/
2647 [49664]: https://github.com/rust-lang/rust/pull/49664/
2648 [49699]: https://github.com/rust-lang/rust/pull/49699/
2649 [49707]: https://github.com/rust-lang/rust/pull/49707/
2650 [49719]: https://github.com/rust-lang/rust/pull/49719/
2651 [49896]: https://github.com/rust-lang/rust/pull/49896/
2652 [49968]: https://github.com/rust-lang/rust/pull/49968/
2653 [50163]: https://github.com/rust-lang/rust/pull/50163
2654 [50177]: https://github.com/rust-lang/rust/pull/50177/
2655 [50378]: https://github.com/rust-lang/rust/pull/50378/
2656 [50398]: https://github.com/rust-lang/rust/pull/50398/
2657 [50423]: https://github.com/rust-lang/rust/pull/50423/
2658 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2659 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2660 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2661 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2662 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2663 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2664 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2665 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2666 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2667 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2668 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2669 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2670 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2671 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2672 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2673 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2674 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2675 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2676 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2677 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2678 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2679 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2680 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2681 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2682 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2683 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2684 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2685 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2686 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2687 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2688
2689
2690 Version 1.26.2 (2018-06-05)
2691 ==========================
2692
2693 Compatibility Notes
2694 -------------------
2695
2696 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2697
2698 [51117]: https://github.com/rust-lang/rust/issues/51117
2699
2700
2701 Version 1.26.1 (2018-05-29)
2702 ==========================
2703
2704 Tools
2705 -----
2706
2707 - [RLS now works on Windows.][50646]
2708 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2709
2710
2711 Compatibility Notes
2712 --------
2713
2714 - [`fn main() -> impl Trait` no longer works for non-Termination
2715   trait.][50656]
2716   This reverts an accidental stabilization.
2717 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2718 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2719
2720 [50646]: https://github.com/rust-lang/rust/issues/50646
2721 [50656]: https://github.com/rust-lang/rust/pull/50656
2722 [50812]: https://github.com/rust-lang/rust/pull/50812
2723 [50950]: https://github.com/rust-lang/rust/issues/50950
2724 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2725
2726 Version 1.26.0 (2018-05-10)
2727 ==========================
2728
2729 Language
2730 --------
2731 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2732   implement either or both traits.][49299]
2733 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2734 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2735   lifetime can be elided.][49458]
2736 - [`impl Trait` is now stable allowing you to have abstract types in returns
2737    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2738   `fn open(path: impl AsRef<Path>)`.
2739 - [Pattern matching will now automatically apply dereferences.][49394]
2740 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2741 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2742 - [A lot of operations are now available in a const context.][46882] E.g. You
2743   can now index into constant arrays, reference and dereference into constants,
2744   and use tuple struct constructors.
2745 - [Fixed entry slice patterns are now stable.][48516] E.g.
2746   ```rust
2747   let points = [1, 2, 3, 4];
2748   match points {
2749       [1, 2, 3, 4] => println!("All points were sequential."),
2750       _ => println!("Not all points were sequential."),
2751   }
2752   ```
2753
2754
2755 Compiler
2756 --------
2757 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2758 - [Fixed exponential projection complexity on nested types.][48296]
2759   This can provide up to a ~12% reduction in compile times for certain crates.
2760 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2761   to remap path prefixes outputted by the compiler.
2762 - [Added `powerpc-unknown-netbsd` target.][48281]
2763
2764 Libraries
2765 ---------
2766 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2767 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2768   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2769 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2770 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2771 - [`ascii::escape_default` is now available in libcore.][48735]
2772 - [Trailing commas are now supported in std and core macros.][48056]
2773 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2774 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2775
2776 Stabilized APIs
2777 ---------------
2778 - [`*const T::add`]
2779 - [`*const T::copy_to_nonoverlapping`]
2780 - [`*const T::copy_to`]
2781 - [`*const T::read_unaligned`]
2782 - [`*const T::read_volatile`]
2783 - [`*const T::read`]
2784 - [`*const T::sub`]
2785 - [`*const T::wrapping_add`]
2786 - [`*const T::wrapping_sub`]
2787 - [`*mut T::add`]
2788 - [`*mut T::copy_to_nonoverlapping`]
2789 - [`*mut T::copy_to`]
2790 - [`*mut T::read_unaligned`]
2791 - [`*mut T::read_volatile`]
2792 - [`*mut T::read`]
2793 - [`*mut T::replace`]
2794 - [`*mut T::sub`]
2795 - [`*mut T::swap`]
2796 - [`*mut T::wrapping_add`]
2797 - [`*mut T::wrapping_sub`]
2798 - [`*mut T::write_bytes`]
2799 - [`*mut T::write_unaligned`]
2800 - [`*mut T::write_volatile`]
2801 - [`*mut T::write`]
2802 - [`Box::leak`]
2803 - [`FromUtf8Error::as_bytes`]
2804 - [`LocalKey::try_with`]
2805 - [`Option::cloned`]
2806 - [`btree_map::Entry::and_modify`]
2807 - [`fs::read_to_string`]
2808 - [`fs::read`]
2809 - [`fs::write`]
2810 - [`hash_map::Entry::and_modify`]
2811 - [`iter::FusedIterator`]
2812 - [`ops::RangeInclusive`]
2813 - [`ops::RangeToInclusive`]
2814 - [`process::id`]
2815 - [`slice::rotate_left`]
2816 - [`slice::rotate_right`]
2817 - [`String::retain`]
2818
2819
2820 Cargo
2821 -----
2822 - [Cargo will now output path to custom commands when `-v` is
2823   passed with `--list`][cargo/5041]
2824 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2825
2826 Misc
2827 ----
2828 - [The second edition of "The Rust Programming Language" book is now recommended
2829   over the first.][48404]
2830
2831 Compatibility Notes
2832 -------------------
2833
2834 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2835   syntax is now invalid.
2836   ```
2837   use std::ops::Fn as dyn;
2838   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2839   ```
2840 - [The result of dereferences are no longer promoted to `'static`.][47408]
2841   e.g.
2842   ```rust
2843   fn main() {
2844       const PAIR: &(i32, i32) = &(0, 1);
2845       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2846   }
2847   ```
2848 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2849 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2850   an error.][48235]
2851 - [Removed hoedown from rustdoc.][48274]
2852 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2853
2854 [46882]: https://github.com/rust-lang/rust/pull/46882
2855 [47379]: https://github.com/rust-lang/rust/pull/47379
2856 [47408]: https://github.com/rust-lang/rust/pull/47408
2857 [47813]: https://github.com/rust-lang/rust/pull/47813
2858 [48056]: https://github.com/rust-lang/rust/pull/48056
2859 [48125]: https://github.com/rust-lang/rust/pull/48125
2860 [48166]: https://github.com/rust-lang/rust/pull/48166
2861 [48235]: https://github.com/rust-lang/rust/pull/48235
2862 [48274]: https://github.com/rust-lang/rust/pull/48274
2863 [48281]: https://github.com/rust-lang/rust/pull/48281
2864 [48296]: https://github.com/rust-lang/rust/pull/48296
2865 [48326]: https://github.com/rust-lang/rust/pull/48326
2866 [48359]: https://github.com/rust-lang/rust/pull/48359
2867 [48404]: https://github.com/rust-lang/rust/pull/48404
2868 [48481]: https://github.com/rust-lang/rust/pull/48481
2869 [48516]: https://github.com/rust-lang/rust/pull/48516
2870 [48628]: https://github.com/rust-lang/rust/pull/48628
2871 [48629]: https://github.com/rust-lang/rust/pull/48629
2872 [48657]: https://github.com/rust-lang/rust/pull/48657
2873 [48735]: https://github.com/rust-lang/rust/pull/48735
2874 [48978]: https://github.com/rust-lang/rust/pull/48978
2875 [49101]: https://github.com/rust-lang/rust/pull/49101
2876 [49109]: https://github.com/rust-lang/rust/pull/49109
2877 [49121]: https://github.com/rust-lang/rust/pull/49121
2878 [49162]: https://github.com/rust-lang/rust/pull/49162
2879 [49184]: https://github.com/rust-lang/rust/pull/49184
2880 [49234]: https://github.com/rust-lang/rust/pull/49234
2881 [49255]: https://github.com/rust-lang/rust/pull/49255
2882 [49299]: https://github.com/rust-lang/rust/pull/49299
2883 [49305]: https://github.com/rust-lang/rust/pull/49305
2884 [49394]: https://github.com/rust-lang/rust/pull/49394
2885 [49458]: https://github.com/rust-lang/rust/pull/49458
2886 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2887 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2888 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2889 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2890 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2891 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2892 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2893 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2894 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2895 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2896 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2897 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2898 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2899 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2900 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2901 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2902 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2903 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2904 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2905 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2906 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2907 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2908 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2909 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2910 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2911 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2912 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2913 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2914 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2915 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2916 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2917 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2918 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2919 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2920 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2921 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2922 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2923 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2924 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2925 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2926 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2927 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2928
2929
2930 Version 1.25.0 (2018-03-29)
2931 ==========================
2932
2933 Language
2934 --------
2935 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2936 - [You can now use nested groups of imports.][47948]
2937   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2938 - [You can now have `|` at the start of a match arm.][47947] e.g.
2939 ```rust
2940 enum Foo { A, B, C }
2941
2942 fn main() {
2943     let x = Foo::A;
2944     match x {
2945         | Foo::A
2946         | Foo::B => println!("AB"),
2947         | Foo::C => println!("C"),
2948     }
2949 }
2950 ```
2951
2952 Compiler
2953 --------
2954 - [Upgraded to LLVM 6.][47828]
2955 - [Added `-C lto=val` option.][47521]
2956 - [Added `i586-unknown-linux-musl` target][47282]
2957
2958 Libraries
2959 ---------
2960 - [Impl Send for `process::Command` on Unix.][47760]
2961 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2962 - [`UnsafeCell::into_inner` is now safe.][47204]
2963 - [Implement libstd for CloudABI.][47268]
2964 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2965 - [Implement `AsRef<Path>` for Component][46985]
2966 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2967 - [Moved `Duration` to libcore.][46666]
2968
2969 Stabilized APIs
2970 ---------------
2971 - [`Location::column`]
2972 - [`ptr::NonNull`]
2973
2974 The following functions can now be used in a constant expression.
2975 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2976 - [`Duration::new`][47300]
2977 - [`Duration::from_secs`][47300]
2978 - [`Duration::from_millis`][47300]
2979
2980 Cargo
2981 -----
2982 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2983 - [`cargo new` now defaults to creating a binary crate, instead of a
2984   library crate.][cargo/5029]
2985
2986 Misc
2987 ----
2988 - [Rust by example is now shipped with new releases][46196]
2989
2990 Compatibility Notes
2991 -------------------
2992 - [Deprecated `net::lookup_host`.][47510]
2993 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2994 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2995   around indexing operations (see [#47349][47349]). This has been fixed (which also
2996   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2997 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2998
2999 [33903]: https://github.com/rust-lang/rust/pull/33903
3000 [47947]: https://github.com/rust-lang/rust/pull/47947
3001 [47948]: https://github.com/rust-lang/rust/pull/47948
3002 [47760]: https://github.com/rust-lang/rust/pull/47760
3003 [47790]: https://github.com/rust-lang/rust/pull/47790
3004 [47828]: https://github.com/rust-lang/rust/pull/47828
3005 [47398]: https://github.com/rust-lang/rust/pull/47398
3006 [47510]: https://github.com/rust-lang/rust/pull/47510
3007 [47521]: https://github.com/rust-lang/rust/pull/47521
3008 [47204]: https://github.com/rust-lang/rust/pull/47204
3009 [47251]: https://github.com/rust-lang/rust/pull/47251
3010 [47268]: https://github.com/rust-lang/rust/pull/47268
3011 [47282]: https://github.com/rust-lang/rust/pull/47282
3012 [47300]: https://github.com/rust-lang/rust/pull/47300
3013 [47349]: https://github.com/rust-lang/rust/pull/47349
3014 [46931]: https://github.com/rust-lang/rust/pull/46931
3015 [46985]: https://github.com/rust-lang/rust/pull/46985
3016 [47006]: https://github.com/rust-lang/rust/pull/47006
3017 [46830]: https://github.com/rust-lang/rust/pull/46830
3018 [46095]: https://github.com/rust-lang/rust/pull/46095
3019 [46666]: https://github.com/rust-lang/rust/pull/46666
3020 [46196]: https://github.com/rust-lang/rust/pull/46196
3021 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3022 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3023 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3024 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3025 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3026
3027
3028 Version 1.24.1 (2018-03-01)
3029 ==========================
3030
3031  - [Do not abort when unwinding through FFI][48251]
3032  - [Emit UTF-16 files for linker arguments on Windows][48318]
3033  - [Make the error index generator work again][48308]
3034  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3035
3036 [48251]: https://github.com/rust-lang/rust/issues/48251
3037 [48308]: https://github.com/rust-lang/rust/issues/48308
3038 [48318]: https://github.com/rust-lang/rust/issues/48318
3039 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3040
3041
3042 Version 1.24.0 (2018-02-15)
3043 ==========================
3044
3045 Language
3046 --------
3047 - [External `sysv64` ffi is now available.][46528]
3048   eg. `extern "sysv64" fn foo () {}`
3049
3050 Compiler
3051 --------
3052 - [rustc now uses 16 codegen units by default for release builds.][46910]
3053   For the fastest builds, utilize `codegen-units=1`.
3054 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3055 - [Add `aarch64-unknown-openbsd` support][46760]
3056
3057 Libraries
3058 ---------
3059 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3060   improvement in performance in the majority of cases.
3061 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3062   with Windows.][46798]
3063 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3064 - [impl `From<bool>` for `AtomicBool`][46293]
3065 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3066 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3067 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3068 - [float::from_bits now just uses transmute.][46012] This provides
3069   some optimisations from LLVM.
3070 - [Copied `AsciiExt` methods onto `char`][46077]
3071 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3072 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3073 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3074 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3075
3076 Stabilized APIs
3077 ---------------
3078 - [`RefCell::replace`]
3079 - [`RefCell::swap`]
3080 - [`atomic::spin_loop_hint`]
3081
3082 The following functions can now be used in a constant expression.
3083 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3084
3085 - [`AtomicBool::new`][46287]
3086 - [`AtomicUsize::new`][46287]
3087 - [`AtomicIsize::new`][46287]
3088 - [`AtomicPtr::new`][46287]
3089 - [`Cell::new`][46287]
3090 - [`{integer}::min_value`][46287]
3091 - [`{integer}::max_value`][46287]
3092 - [`mem::size_of`][46287]
3093 - [`mem::align_of`][46287]
3094 - [`ptr::null`][46287]
3095 - [`ptr::null_mut`][46287]
3096 - [`RefCell::new`][46287]
3097 - [`UnsafeCell::new`][46287]
3098
3099 Cargo
3100 -----
3101 - [Added a `workspace.default-members` config that
3102   overrides implied `--all` in virtual workspaces.][cargo/4743]
3103 - [Enable incremental by default on development builds.][cargo/4817] Also added
3104   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3105   per-project or global basis respectively.
3106
3107 Misc
3108 ----
3109
3110 Compatibility Notes
3111 -------------------
3112 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3113 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3114   in accordance with IETF RFC 4291 §2.2.
3115 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3116 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3117   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3118 - [Leading zeros in tuple struct members is now an error][47084]
3119 - [`column!()` macro is one-based instead of zero-based][46977]
3120 - [`fmt::Arguments` can no longer be shared across threads][45198]
3121 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3122 - [Cargo sets a different working directory for the compiler][cargo/4788]
3123
3124 [44884]: https://github.com/rust-lang/rust/pull/44884
3125 [45198]: https://github.com/rust-lang/rust/pull/45198
3126 [45506]: https://github.com/rust-lang/rust/pull/45506
3127 [45904]: https://github.com/rust-lang/rust/pull/45904
3128 [45990]: https://github.com/rust-lang/rust/pull/45990
3129 [46012]: https://github.com/rust-lang/rust/pull/46012
3130 [46077]: https://github.com/rust-lang/rust/pull/46077
3131 [46094]: https://github.com/rust-lang/rust/pull/46094
3132 [46284]: https://github.com/rust-lang/rust/pull/46284
3133 [46287]: https://github.com/rust-lang/rust/pull/46287
3134 [46293]: https://github.com/rust-lang/rust/pull/46293
3135 [46528]: https://github.com/rust-lang/rust/pull/46528
3136 [46671]: https://github.com/rust-lang/rust/pull/46671
3137 [46713]: https://github.com/rust-lang/rust/pull/46713
3138 [46735]: https://github.com/rust-lang/rust/pull/46735
3139 [46749]: https://github.com/rust-lang/rust/pull/46749
3140 [46760]: https://github.com/rust-lang/rust/pull/46760
3141 [46798]: https://github.com/rust-lang/rust/pull/46798
3142 [46828]: https://github.com/rust-lang/rust/pull/46828
3143 [46831]: https://github.com/rust-lang/rust/pull/46831
3144 [46833]: https://github.com/rust-lang/rust/pull/46833
3145 [46910]: https://github.com/rust-lang/rust/pull/46910
3146 [46977]: https://github.com/rust-lang/rust/pull/46977
3147 [47018]: https://github.com/rust-lang/rust/pull/47018
3148 [47080]: https://github.com/rust-lang/rust/pull/47080
3149 [47084]: https://github.com/rust-lang/rust/pull/47084
3150 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3151 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3152 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3153 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3154 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3155 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3156
3157
3158 Version 1.23.0 (2018-01-04)
3159 ==========================
3160
3161 Language
3162 --------
3163 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3164 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3165   Which should fix some confusing errors in some operations.
3166
3167 Compiler
3168 --------
3169 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3170   undefined behavior.][45920]
3171 - [rustc now suggests renaming import if names clash.][45660]
3172 - [Display errors/warnings correctly when there are zero-width or
3173   wide characters.][45711]
3174 - [rustc now avoids unnecessary copies of arguments that are
3175   simple bindings][45380] This should improve memory usage on average by 5-10%.
3176 - [Updated musl used to build musl rustc to 1.1.17][45393]
3177
3178 Libraries
3179 ---------
3180 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3181 - [Implement Hash for raw pointers to unsized types][45483]
3182 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3183 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3184 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3185 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3186   and `<*mut T>::as_mut`][44932]
3187 - [Optimized `Thread::{park, unpark}` implementation][45524]
3188 - [Improved `SliceExt::binary_search` performance.][45333]
3189 - [impl `FromIterator<()>` for `()`][45379]
3190 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3191   is now deprecated.
3192
3193 Stabilized APIs
3194 ---------------
3195
3196 Cargo
3197 -----
3198 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3199   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3200 - [Added unit test checking to `cargo check`][cargo/4592]
3201 - [Cargo now lets you install a specific version
3202   using `cargo install --version`][cargo/4637]
3203
3204 Misc
3205 ----
3206 - [Releases now ship with the Cargo book documentation.][45692]
3207 - [rustdoc now prints rendering warnings on every run.][45324]
3208
3209 Compatibility Notes
3210 -------------------
3211 - [Changes have been made to type equality to make it more correct,
3212   in rare cases this could break some code.][45853] [Tracking issue for
3213   further information][45852]
3214 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3215 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3216   Android 9, the minimum supported version is Android 14.
3217 - [Bumped the minimum LLVM to 3.9][45326]
3218
3219 [44042]: https://github.com/rust-lang/rust/pull/44042
3220 [44932]: https://github.com/rust-lang/rust/pull/44932
3221 [45267]: https://github.com/rust-lang/rust/pull/45267
3222 [45324]: https://github.com/rust-lang/rust/pull/45324
3223 [45326]: https://github.com/rust-lang/rust/pull/45326
3224 [45333]: https://github.com/rust-lang/rust/pull/45333
3225 [45379]: https://github.com/rust-lang/rust/pull/45379
3226 [45380]: https://github.com/rust-lang/rust/pull/45380
3227 [45393]: https://github.com/rust-lang/rust/pull/45393
3228 [45435]: https://github.com/rust-lang/rust/pull/45435
3229 [45483]: https://github.com/rust-lang/rust/pull/45483
3230 [45524]: https://github.com/rust-lang/rust/pull/45524
3231 [45571]: https://github.com/rust-lang/rust/pull/45571
3232 [45580]: https://github.com/rust-lang/rust/pull/45580
3233 [45610]: https://github.com/rust-lang/rust/pull/45610
3234 [45660]: https://github.com/rust-lang/rust/pull/45660
3235 [45692]: https://github.com/rust-lang/rust/pull/45692
3236 [45711]: https://github.com/rust-lang/rust/pull/45711
3237 [45772]: https://github.com/rust-lang/rust/pull/45772
3238 [45852]: https://github.com/rust-lang/rust/issues/45852
3239 [45853]: https://github.com/rust-lang/rust/pull/45853
3240 [45887]: https://github.com/rust-lang/rust/pull/45887
3241 [45920]: https://github.com/rust-lang/rust/pull/45920
3242 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3243 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3244 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3245
3246
3247 Version 1.22.1 (2017-11-22)
3248 ==========================
3249
3250 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3251
3252 [46183]: https://github.com/rust-lang/rust/pull/46183
3253
3254 Version 1.22.0 (2017-11-22)
3255 ==========================
3256
3257 Language
3258 --------
3259 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3260 - [Now accepts underscores in unicode escapes][43716]
3261 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3262 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3263
3264 Compiler
3265 --------
3266 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3267 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3268   This should decrease compile times for debug builds.
3269 - [strict memory alignment now enabled on ARMv6][45094]
3270 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3271
3272 Libraries
3273 ---------
3274 - [Allow atomic operations up to 32 bits
3275   on `armv5te_unknown_linux_gnueabi`][44978]
3276 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3277 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3278 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3279 - [Properly detect overflow in `Instant += Duration`.][44220]
3280 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3281 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3282 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3283
3284 Stabilized APIs
3285 ---------------
3286
3287 Cargo
3288 -----
3289 - [Cargo will now build multi file examples in subdirectories of the `examples`
3290   folder that have a `main.rs` file.][cargo/4496]
3291 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3292   the old format will continue to work and can be updated with `cargo update`.
3293 - [Now supports vendoring git repositories][cargo/3992]
3294
3295 Misc
3296 ----
3297 - [`libbacktrace` is now available on Apple platforms.][44251]
3298 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3299   This now lets you specify that a given code example will fail to compile.
3300
3301 Compatibility Notes
3302 -------------------
3303 - [The minimum Android version that rustc can build for has been bumped
3304   to `4.0` from `2.3`][45656]
3305 - [Allowing `T op= &T` for numeric types has broken some type
3306   inference cases][45480]
3307
3308
3309 [42526]: https://github.com/rust-lang/rust/pull/42526
3310 [43017]: https://github.com/rust-lang/rust/pull/43017
3311 [43716]: https://github.com/rust-lang/rust/pull/43716
3312 [43949]: https://github.com/rust-lang/rust/pull/43949
3313 [44015]: https://github.com/rust-lang/rust/pull/44015
3314 [44220]: https://github.com/rust-lang/rust/pull/44220
3315 [44251]: https://github.com/rust-lang/rust/pull/44251
3316 [44287]: https://github.com/rust-lang/rust/pull/44287
3317 [44303]: https://github.com/rust-lang/rust/pull/44303
3318 [44456]: https://github.com/rust-lang/rust/pull/44456
3319 [44466]: https://github.com/rust-lang/rust/pull/44466
3320 [44895]: https://github.com/rust-lang/rust/pull/44895
3321 [44966]: https://github.com/rust-lang/rust/pull/44966
3322 [44978]: https://github.com/rust-lang/rust/pull/44978
3323 [45041]: https://github.com/rust-lang/rust/pull/45041
3324 [45064]: https://github.com/rust-lang/rust/pull/45064
3325 [45075]: https://github.com/rust-lang/rust/pull/45075
3326 [45094]: https://github.com/rust-lang/rust/pull/45094
3327 [45095]: https://github.com/rust-lang/rust/pull/45095
3328 [45480]: https://github.com/rust-lang/rust/issues/45480
3329 [45656]: https://github.com/rust-lang/rust/pull/45656
3330 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3331 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3332 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3333
3334
3335
3336
3337
3338
3339 Version 1.21.0 (2017-10-12)
3340 ==========================
3341
3342 Language
3343 --------
3344 - [You can now use static references for literals.][43838]
3345   Example:
3346   ```rust
3347   fn main() {
3348       let x: &'static u32 = &0;
3349   }
3350   ```
3351 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3352   Example:
3353   ```rust
3354   my_macro!(Vec<i32>::new); // Always worked
3355   my_macro!(Vec::<i32>::new); // Now works
3356   ```
3357
3358 Compiler
3359 --------
3360 - [Upgraded jemalloc to 4.5.0][43911]
3361 - [Enabled unwinding panics on Redox][43917]
3362 - [Now runs LLVM in parallel during translation phase.][43506]
3363   This should reduce peak memory usage.
3364
3365 Libraries
3366 ---------
3367 - [Generate builtin impls for `Clone` for all arrays and tuples that
3368   are `T: Clone`][43690]
3369 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3370 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3371   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3372
3373 Stabilized APIs
3374 ---------------
3375
3376 [`std::mem::discriminant`]
3377
3378 Cargo
3379 -----
3380 - [You can now call `cargo install` with multiple package names][cargo/4216]
3381 - [Cargo commands inside a virtual workspace will now implicitly
3382   pass `--all`][cargo/4335]
3383 - [Added a `[patch]` section to `Cargo.toml` to handle
3384   prepublication dependencies][cargo/4123] [RFC 1969]
3385 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3386   like patterns][cargo/4270]
3387 - [Added the `--all-targets` option][cargo/4400]
3388 - [Using required dependencies as a feature is now deprecated and emits
3389   a warning][cargo/4364]
3390
3391
3392 Misc
3393 ----
3394 - [Cargo docs are moving][43916]
3395   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3396 - [The rustdoc book is now available][43863]
3397   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3398 - [Added a preview of RLS has been made available through rustup][44204]
3399   Install with `rustup component add rls-preview`
3400 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3401   Previously only showed `std::os::unix`.
3402
3403 Compatibility Notes
3404 -------------------
3405 - [Changes in method matching against higher-ranked types][43880] This may cause
3406   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3407 - [rustc's JSON error output's byte position start at top of file.][42973]
3408   Was previously relative to the rustc's internal `CodeMap` struct which
3409   required the unstable library `libsyntax` to correctly use.
3410 - [`unused_results` lint no longer ignores booleans][43728]
3411
3412 [42565]: https://github.com/rust-lang/rust/pull/42565
3413 [42973]: https://github.com/rust-lang/rust/pull/42973
3414 [43348]: https://github.com/rust-lang/rust/pull/43348
3415 [43459]: https://github.com/rust-lang/rust/pull/43459
3416 [43506]: https://github.com/rust-lang/rust/pull/43506
3417 [43540]: https://github.com/rust-lang/rust/pull/43540
3418 [43690]: https://github.com/rust-lang/rust/pull/43690
3419 [43728]: https://github.com/rust-lang/rust/pull/43728
3420 [43838]: https://github.com/rust-lang/rust/pull/43838
3421 [43863]: https://github.com/rust-lang/rust/pull/43863
3422 [43880]: https://github.com/rust-lang/rust/pull/43880
3423 [43911]: https://github.com/rust-lang/rust/pull/43911
3424 [43916]: https://github.com/rust-lang/rust/pull/43916
3425 [43917]: https://github.com/rust-lang/rust/pull/43917
3426 [44204]: https://github.com/rust-lang/rust/pull/44204
3427 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3428 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3429 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3430 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3431 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3432 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3433 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3434 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3435 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3436
3437 Version 1.20.0 (2017-08-31)
3438 ===========================
3439
3440 Language
3441 --------
3442 - [Associated constants are now stabilised.][42809]
3443 - [A lot of macro bugs are now fixed.][42913]
3444
3445 Compiler
3446 --------
3447
3448 - [Struct fields are now properly coerced to the expected field type.][42807]
3449 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3450   `wasm32-experimental-emscripten` target.
3451 - [Changed some of the error messages to be more helpful.][42033]
3452 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3453   it.][43170]
3454 - [rustc now reports the total number of errors on compilation failure][43015]
3455   previously this was only the number of errors in the pass that failed.
3456 - [Expansion in rustc has been sped up 29x.][42533]
3457 - [added `msp430-none-elf` target.][43099]
3458 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3459   applicable][43178]
3460 - [Fixes backtraces on Redox][43228]
3461 - [rustc now identifies different versions of same crate when absolute paths of
3462   different types match in an error message.][42826]
3463
3464 Libraries
3465 ---------
3466
3467
3468 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3469 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3470   tuples.][43011]
3471 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3472   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3473 - [Impl `Clone` for `DefaultHasher`.][42799]
3474 - [Impl `Sync` for `SyncSender`.][42397]
3475 - [Impl `FromStr` for `char`][42271]
3476 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3477   NaN.][42431]
3478 - [allow messages in the `unimplemented!()` macro.][42155]
3479   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3480 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3481 - [Upgrade to Unicode 10.0.0][42999]
3482 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3483 - [Skip the main thread's manual stack guard on Linux][43072]
3484 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3485 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3486   previously 2^15.
3487 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3488
3489 Stabilized APIs
3490 ---------------
3491
3492 - [`CStr::into_c_string`]
3493 - [`CString::as_c_str`]
3494 - [`CString::into_boxed_c_str`]
3495 - [`Chain::get_mut`]
3496 - [`Chain::get_ref`]
3497 - [`Chain::into_inner`]
3498 - [`Option::get_or_insert_with`]
3499 - [`Option::get_or_insert`]
3500 - [`OsStr::into_os_string`]
3501 - [`OsString::into_boxed_os_str`]
3502 - [`Take::get_mut`]
3503 - [`Take::get_ref`]
3504 - [`Utf8Error::error_len`]
3505 - [`char::EscapeDebug`]
3506 - [`char::escape_debug`]
3507 - [`compile_error!`]
3508 - [`f32::from_bits`]
3509 - [`f32::to_bits`]
3510 - [`f64::from_bits`]
3511 - [`f64::to_bits`]
3512 - [`mem::ManuallyDrop`]
3513 - [`slice::sort_unstable_by_key`]
3514 - [`slice::sort_unstable_by`]
3515 - [`slice::sort_unstable`]
3516 - [`str::from_boxed_utf8_unchecked`]
3517 - [`str::as_bytes_mut`]
3518 - [`str::as_bytes_mut`]
3519 - [`str::from_utf8_mut`]
3520 - [`str::from_utf8_unchecked_mut`]
3521 - [`str::get_mut`]
3522 - [`str::get_unchecked_mut`]
3523 - [`str::get_unchecked`]
3524 - [`str::get`]
3525 - [`str::into_boxed_bytes`]
3526
3527
3528 Cargo
3529 -----
3530 - [Cargo API token location moved from `~/.cargo/config` to
3531   `~/.cargo/credentials`.][cargo/3978]
3532 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3533   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3534   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3535 - [You can now specify version of a binary when installed through
3536   `cargo install` using `--vers`.][cargo/4229]
3537 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3538   failure.][cargo/4248]
3539 - [Changed the convention around which file is the crate root.][cargo/4259]
3540 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3541   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3542
3543 Compatibility Notes
3544 -------------------
3545
3546 - [Functions with `'static` in their return types will now not be as usable as
3547   if they were using lifetime parameters instead.][42417]
3548 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3549   takes the sign of NaN into account where previously didn't.][42430]
3550
3551 [42033]: https://github.com/rust-lang/rust/pull/42033
3552 [42155]: https://github.com/rust-lang/rust/pull/42155
3553 [42271]: https://github.com/rust-lang/rust/pull/42271
3554 [42397]: https://github.com/rust-lang/rust/pull/42397
3555 [42417]: https://github.com/rust-lang/rust/pull/42417
3556 [42430]: https://github.com/rust-lang/rust/pull/42430
3557 [42431]: https://github.com/rust-lang/rust/pull/42431
3558 [42533]: https://github.com/rust-lang/rust/pull/42533
3559 [42571]: https://github.com/rust-lang/rust/pull/42571
3560 [42613]: https://github.com/rust-lang/rust/pull/42613
3561 [42799]: https://github.com/rust-lang/rust/pull/42799
3562 [42807]: https://github.com/rust-lang/rust/pull/42807
3563 [42809]: https://github.com/rust-lang/rust/pull/42809
3564 [42822]: https://github.com/rust-lang/rust/pull/42822
3565 [42826]: https://github.com/rust-lang/rust/pull/42826
3566 [42854]: https://github.com/rust-lang/rust/pull/42854
3567 [42913]: https://github.com/rust-lang/rust/pull/42913
3568 [42999]: https://github.com/rust-lang/rust/pull/42999
3569 [43011]: https://github.com/rust-lang/rust/pull/43011
3570 [43015]: https://github.com/rust-lang/rust/pull/43015
3571 [43072]: https://github.com/rust-lang/rust/pull/43072
3572 [43077]: https://github.com/rust-lang/rust/pull/43077
3573 [43097]: https://github.com/rust-lang/rust/pull/43097
3574 [43099]: https://github.com/rust-lang/rust/pull/43099
3575 [43170]: https://github.com/rust-lang/rust/pull/43170
3576 [43178]: https://github.com/rust-lang/rust/pull/43178
3577 [43185]: https://github.com/rust-lang/rust/pull/43185
3578 [43228]: https://github.com/rust-lang/rust/pull/43228
3579 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3580 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3581 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3582 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3583 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3584 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3585 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3586 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3587 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3588 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3589 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3590 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3591 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3592 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3593 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3594 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3595 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3596 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3597 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3598 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3599 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3600 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3601 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3602 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3603 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3604 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3605 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3606 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3607 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3608 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3609 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3610 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3611 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3612 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3613 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3614 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3615 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3616 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3617 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3618
3619
3620 Version 1.19.0 (2017-07-20)
3621 ===========================
3622
3623 Language
3624 --------
3625
3626 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3627   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3628 - [Macro recursion limit increased to 1024 from 64.][41676]
3629 - [Added lint for detecting unused macros.][41907]
3630 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3631   For example: `let x = loop { break 7; };`
3632 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3633   contain `Copy` types and cannot have a `Drop` implementation.
3634   Example: `union Foo { bar: u8, baz: usize }`
3635 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3636   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3637
3638 Compiler
3639 --------
3640
3641 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3642 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3643   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3644   you should use `--target armv7-linux-androideabi`.
3645 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3646 - [Minor optimisation of string operations.][42037]
3647 - [Compiler error message is now `aborting due to previous error(s)` instead of
3648   `aborting due to N previous errors`][42150] This was previously inaccurate and
3649   would only count certain kinds of errors.
3650 - [The compiler now supports Visual Studio 2017][42225]
3651 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3652 - [Added a lot][42264] of [new error codes][42302]
3653 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3654   libraries with C Run-time Libraries(CRT) to be statically linked.
3655 - [Fixed various ARM codegen bugs][42740]
3656
3657 Libraries
3658 ---------
3659
3660 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3661   `Extend<Cow<'a, str>>`][41449]
3662 - [`Vec` now implements `From<&mut [T]>`][41530]
3663 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3664 - [`SplitWhitespace` now implements `Clone`][41659]
3665 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3666   1.5x faster][41764]
3667 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3668   macros, but for printing to stderr.
3669
3670 Stabilized APIs
3671 ---------------
3672
3673 - [`OsString::shrink_to_fit`]
3674 - [`cmp::Reverse`]
3675 - [`Command::envs`]
3676 - [`thread::ThreadId`]
3677
3678 Cargo
3679 -----
3680
3681 - [Build scripts can now add environment variables to the environment
3682   the crate is being compiled in.
3683   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3684 - [Subcommands now replace the current process rather than spawning a new
3685   child process][cargo/3970]
3686 - [Workspace members can now accept glob file patterns][cargo/3979]
3687 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3688   the members in a given workspace.][cargo/3988]
3689 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3690 - [Target directory path is now in the cargo metadata][cargo/4022]
3691 - [Cargo no longer checks out a local working directory for the
3692   crates.io index][cargo/4026] This should provide smaller file size for the
3693   registry, and improve cloning times, especially on Windows machines.
3694 - [Added an `--exclude` option for excluding certain packages when using the
3695   `--all` option][cargo/4031]
3696 - [Cargo will now automatically retry when receiving a 5xx error
3697   from crates.io][cargo/4032]
3698 - [The `--features` option now accepts multiple comma or space
3699   delimited values.][cargo/4084]
3700 - [Added support for custom target specific runners][cargo/3954]
3701
3702 Misc
3703 ----
3704
3705 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3706   Windows Debugger.
3707 - [Rust will now release XZ compressed packages][rust-installer/57]
3708 - [rustup will now prefer to download rust packages with
3709   XZ compression][rustup/1100] over GZip packages.
3710 - [Added the ability to escape `#` in rust documentation][41785] By adding
3711   additional `#`'s ie. `##` is now `#`
3712
3713 Compatibility Notes
3714 -------------------
3715
3716 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3717 - [`-Z` flags are now no longer allowed to be used on the stable
3718   compiler.][41751] This has been a warning for a year previous to this.
3719 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3720   longer works][42844]. Users should migrate to the built-in `check`
3721   command, which has been available since 1.16.
3722 - [Ending a float literal with `._` is now a hard error.
3723   Example: `42._` .][41946]
3724 - [Any use of a private `extern crate` outside of its module is now a
3725   hard error.][36886] This was previously a warning.
3726 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3727   relative while the `::` prefix makes a path absolute, but was ignored and the
3728   path was relative regardless.
3729 - [Floating point constants in match patterns is now a hard error][36890]
3730   This was previously a warning.
3731 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3732   match patterns is now a hard error][36891] This was previously a warning.
3733 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3734   a warning.
3735 - [From the pound escape, lines consisting of multiple `#`s are
3736   now visible][41785]
3737 - [It is an error to re-export private enum variants][42460]. This is
3738   known to break a number of crates that depend on an older version of
3739   mustache.
3740 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3741   to use it to find the linker, and the build will fail where it did
3742   not previously][42607]
3743
3744 [36886]: https://github.com/rust-lang/rust/issues/36886
3745 [36888]: https://github.com/rust-lang/rust/issues/36888
3746 [36890]: https://github.com/rust-lang/rust/issues/36890
3747 [36891]: https://github.com/rust-lang/rust/issues/36891
3748 [36892]: https://github.com/rust-lang/rust/issues/36892
3749 [37406]: https://github.com/rust-lang/rust/issues/37406
3750 [39983]: https://github.com/rust-lang/rust/pull/39983
3751 [41145]: https://github.com/rust-lang/rust/pull/41145
3752 [41192]: https://github.com/rust-lang/rust/pull/41192
3753 [41258]: https://github.com/rust-lang/rust/pull/41258
3754 [41370]: https://github.com/rust-lang/rust/pull/41370
3755 [41449]: https://github.com/rust-lang/rust/pull/41449
3756 [41530]: https://github.com/rust-lang/rust/pull/41530
3757 [41624]: https://github.com/rust-lang/rust/pull/41624
3758 [41656]: https://github.com/rust-lang/rust/pull/41656
3759 [41659]: https://github.com/rust-lang/rust/pull/41659
3760 [41676]: https://github.com/rust-lang/rust/pull/41676
3761 [41751]: https://github.com/rust-lang/rust/pull/41751
3762 [41764]: https://github.com/rust-lang/rust/pull/41764
3763 [41785]: https://github.com/rust-lang/rust/pull/41785
3764 [41873]: https://github.com/rust-lang/rust/pull/41873
3765 [41907]: https://github.com/rust-lang/rust/pull/41907
3766 [41946]: https://github.com/rust-lang/rust/pull/41946
3767 [42016]: https://github.com/rust-lang/rust/pull/42016
3768 [42037]: https://github.com/rust-lang/rust/pull/42037
3769 [42068]: https://github.com/rust-lang/rust/pull/42068
3770 [42150]: https://github.com/rust-lang/rust/pull/42150
3771 [42162]: https://github.com/rust-lang/rust/pull/42162
3772 [42225]: https://github.com/rust-lang/rust/pull/42225
3773 [42264]: https://github.com/rust-lang/rust/pull/42264
3774 [42302]: https://github.com/rust-lang/rust/pull/42302
3775 [42460]: https://github.com/rust-lang/rust/issues/42460
3776 [42607]: https://github.com/rust-lang/rust/issues/42607
3777 [42740]: https://github.com/rust-lang/rust/pull/42740
3778 [42844]: https://github.com/rust-lang/rust/issues/42844
3779 [42948]: https://github.com/rust-lang/rust/pull/42948
3780 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3781 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3782 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3783 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3784 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3785 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3786 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3787 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3788 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3789 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3790 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3791 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3792 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3793 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3794 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3795 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3796 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3797 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3798 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3799 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3800 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3801 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3802
3803
3804 Version 1.18.0 (2017-06-08)
3805 ===========================
3806
3807 Language
3808 --------
3809
3810 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3811   make the item visible to just that module tree. Also accepts the keyword
3812   `crate` to make something public to the whole crate but not users of the
3813   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3814 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3815   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3816 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3817   types like `Write + Send`, trailing `+` are now supported in trait objects,
3818   and better error reporting for trait objects starting with `?Sized`.
3819 - [0e+10 is now a valid floating point literal][40589]
3820 - [Now warns if you bind a lifetime parameter to 'static][40734]
3821 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3822   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3823   representation in some cases.][40377]
3824
3825 Compiler
3826 --------
3827
3828 - [rustc can now emit mir with `--emit mir`][39891]
3829 - [Improved LLVM IR for trivial functions][40367]
3830 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3831 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3832   opportunities found through profiling
3833 - [Improved backtrace formatting when panicking][38165]
3834
3835 Libraries
3836 ---------
3837
3838 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3839   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3840   iteration or reallocation.
3841 - [Simplified HashMap Bucket interface][40561] provides performance
3842   improvements for iterating and cloning.
3843 - [Specialize Vec::from_elem to use calloc][40409]
3844 - [Fixed Race condition in fs::create_dir_all][39799]
3845 - [No longer caching stdio on Windows][40516]
3846 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3847   2.50%~ faster and in one case now 12.50% faster.
3848 - [Optimized `AtomicBool::fetch_nand`][41143]
3849
3850 Stabilized APIs
3851 ---------------
3852
3853 - [`Child::try_wait`]
3854 - [`HashMap::retain`]
3855 - [`HashSet::retain`]
3856 - [`PeekMut::pop`]
3857 - [`TcpStream::peek`]
3858 - [`UdpSocket::peek`]
3859 - [`UdpSocket::peek_from`]
3860
3861 Cargo
3862 -----
3863
3864 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3865   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3866 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3867 - [Added Android build support][cargo/3885]
3868 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3869   of a certain type, for example `cargo build --bins` will build all
3870   binaries.
3871 - [Added support for haiku][cargo/3952]
3872
3873 Misc
3874 ----
3875
3876 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3877 - [Added rust-windbg script for better debugging on Windows][39983]
3878 - [Rust now uses the official cross compiler for NetBSD][40612]
3879 - [rustdoc now accepts `#` at the start of files][40828]
3880 - [Fixed jemalloc support for musl][41168]
3881
3882 Compatibility Notes
3883 -------------------
3884
3885 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3886   always placed after the sign if it exists and before the digits. With the `#`
3887   flag the zeroes are placed after the prefix and before the digits.
3888 - [Due to the struct field optimisation][40377], using `transmute` on structs
3889   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3890   always been undefined behavior, but is now more likely to break in practice.
3891 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3892   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3893   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3894 - [Overlapping inherent `impl`s are now a hard error][40728]
3895 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3896 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3897   `out.asm` and `out.ll` instead of only one of the filetypes.
3898 - [ calling a function that returns `Self` will no longer work][41805] when
3899   the size of `Self` cannot be statically determined.
3900 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3901   this has caused a few regressions namely:
3902
3903   - Changed the link order of local static/dynamic libraries (respecting the
3904     order on given rather than having the compiler reorder).
3905   - Changed how MinGW is linked, native code linked to dynamic libraries
3906     may require manually linking to the gcc support library (for the native
3907     code itself)
3908
3909 [38165]: https://github.com/rust-lang/rust/pull/38165
3910 [39799]: https://github.com/rust-lang/rust/pull/39799
3911 [39891]: https://github.com/rust-lang/rust/pull/39891
3912 [39983]: https://github.com/rust-lang/rust/pull/39983
3913 [40043]: https://github.com/rust-lang/rust/pull/40043
3914 [40241]: https://github.com/rust-lang/rust/pull/40241
3915 [40338]: https://github.com/rust-lang/rust/pull/40338
3916 [40367]: https://github.com/rust-lang/rust/pull/40367
3917 [40377]: https://github.com/rust-lang/rust/pull/40377
3918 [40409]: https://github.com/rust-lang/rust/pull/40409
3919 [40516]: https://github.com/rust-lang/rust/pull/40516
3920 [40556]: https://github.com/rust-lang/rust/pull/40556
3921 [40561]: https://github.com/rust-lang/rust/pull/40561
3922 [40589]: https://github.com/rust-lang/rust/pull/40589
3923 [40612]: https://github.com/rust-lang/rust/pull/40612
3924 [40723]: https://github.com/rust-lang/rust/pull/40723
3925 [40728]: https://github.com/rust-lang/rust/pull/40728
3926 [40731]: https://github.com/rust-lang/rust/pull/40731
3927 [40734]: https://github.com/rust-lang/rust/pull/40734
3928 [40805]: https://github.com/rust-lang/rust/pull/40805
3929 [40807]: https://github.com/rust-lang/rust/pull/40807
3930 [40828]: https://github.com/rust-lang/rust/pull/40828
3931 [40870]: https://github.com/rust-lang/rust/pull/40870
3932 [41085]: https://github.com/rust-lang/rust/pull/41085
3933 [41143]: https://github.com/rust-lang/rust/pull/41143
3934 [41168]: https://github.com/rust-lang/rust/pull/41168
3935 [41270]: https://github.com/rust-lang/rust/issues/41270
3936 [41469]: https://github.com/rust-lang/rust/pull/41469
3937 [41805]: https://github.com/rust-lang/rust/issues/41805
3938 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3939 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3940 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3941 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3942 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3943 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3944 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3945 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3946 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3947 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3948 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3949 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3950 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3951 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3952
3953
3954 Version 1.17.0 (2017-04-27)
3955 ===========================
3956
3957 Language
3958 --------
3959
3960 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3961 * [Fields of structs may be initialized without duplicating the field/variable
3962   names][39761]. [RFC 1682]
3963 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3964 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3965   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3966   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3967   `'b`. Soundness fix.
3968 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3969 * [Static variables may contain references to other statics][40027]
3970
3971 Compiler
3972 --------
3973
3974 * [Exit quickly on only `--emit dep-info`][40336]
3975 * [Make `-C relocation-model` more correctly determine whether the linker
3976   creates a position-independent executable][40245]
3977 * [Add `-C overflow-checks` to directly control whether integer overflow
3978   panics][40037]
3979 * [The rustc type checker now checks items on demand instead of in a single
3980   in-order pass][40008]. This is mostly an internal refactoring in support of
3981   future work, including incremental type checking, but also resolves [RFC
3982   1647], allowing `Self` to appear in `impl` `where` clauses.
3983 * [Optimize vtable loads][39995]
3984 * [Turn off vectorization for Emscripten targets][39990]
3985 * [Provide suggestions for unknown macros imported with `use`][39953]
3986 * [Fix ICEs in path resolution][39939]
3987 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3988 * [Add clearer error message using `&str + &str`][39116]
3989
3990 Stabilized APIs
3991 ---------------
3992
3993 * [`Arc::into_raw`]
3994 * [`Arc::from_raw`]
3995 * [`Arc::ptr_eq`]
3996 * [`Rc::into_raw`]
3997 * [`Rc::from_raw`]
3998 * [`Rc::ptr_eq`]
3999 * [`Ordering::then`]
4000 * [`Ordering::then_with`]
4001 * [`BTreeMap::range`]
4002 * [`BTreeMap::range_mut`]
4003 * [`collections::Bound`]
4004 * [`process::abort`]
4005 * [`ptr::read_unaligned`]
4006 * [`ptr::write_unaligned`]
4007 * [`Result::expect_err`]
4008 * [`Cell::swap`]
4009 * [`Cell::replace`]
4010 * [`Cell::into_inner`]
4011 * [`Cell::take`]
4012
4013 Libraries
4014 ---------
4015
4016 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4017 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4018 * [`String` implements `FromIterator<&char>`][40028]
4019 * `Box` [implements][40009] a number of new conversions:
4020   `From<Box<str>> for String`,
4021   `From<Box<[T]>> for Vec<T>`,
4022   `From<Box<CStr>> for CString`,
4023   `From<Box<OsStr>> for OsString`,
4024   `From<Box<Path>> for PathBuf`,
4025   `Into<Box<str>> for String`,
4026   `Into<Box<[T]>> for Vec<T>`,
4027   `Into<Box<CStr>> for CString`,
4028   `Into<Box<OsStr>> for OsString`,
4029   `Into<Box<Path>> for PathBuf`,
4030   `Default for Box<str>`,
4031   `Default for Box<CStr>`,
4032   `Default for Box<OsStr>`,
4033   `From<&CStr> for Box<CStr>`,
4034   `From<&OsStr> for Box<OsStr>`,
4035   `From<&Path> for Box<Path>`
4036 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4037 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4038 * [Slightly optimize `slice::sort`][39538]
4039 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4040 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4041   `Box<str>` implements `From<&str>`][39438]
4042 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4043   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4044 * [`format!` estimates the needed capacity before writing a string][39356]
4045 * [Support unprivileged symlink creation in Windows][38921]
4046 * [`PathBuf` implements `Default`][38764]
4047 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4048 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4049   and poor hash functions.
4050
4051 Cargo
4052 -----
4053
4054 * [Add `cargo check --all`][cargo/3731]
4055 * [Add an option to ignore SSL revocation checking][cargo/3699]
4056 * [Add `cargo run --package`][cargo/3691]
4057 * [Add `required_features`][cargo/3667]
4058 * [Assume `build.rs` is a build script][cargo/3664]
4059 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4060
4061 Misc
4062 ----
4063
4064 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4065   `rustbook`][39633]
4066 * [The "Unstable Book" documents nightly-only features][ubook]
4067 * [Improve the style of the sidebar in rustdoc output][40265]
4068 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4069 * [Fix MSP430 breakage due to `i128`][40257]
4070 * [Preliminary Solaris/SPARCv9 support][39903]
4071 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4072   run without installing the MSVC runtime.
4073 * [`rustdoc --test` includes file names in test names][39788]
4074 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4075   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4076 * [Initial support for `aarch64-unknown-freebsd`][39491]
4077 * [Initial support for `i686-unknown-netbsd`][39426]
4078 * [This release no longer includes the old makefile build system][39431]. Rust
4079   is built with a custom build system, written in Rust, and with Cargo.
4080 * [Add Debug implementations for libcollection structs][39002]
4081 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4082 * [`--test-threads=0` produces an error][38945]
4083 * [`rustup` installs documentation by default][40526]
4084 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4085   WinDbg and Visual Studio to improve the debugging experience.
4086
4087 Compatibility Notes
4088 -------------------
4089
4090 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4091   workaround, either use MSVC 2015 or run vcvars.bat.
4092 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4093   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4094   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4095   fix.
4096 * [`format!` and `Display::to_string` panic if an underlying formatting
4097   implementation returns an error][40117]. Previously the error was silently
4098   ignored. It is incorrect for `write_fmt` to return an error when writing
4099   to a string.
4100 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4101   crates were marked stable and could be accessed from the stable toolchain.
4102 * [Rust git source no longer includes vendored crates][39728]. Those that need
4103   to build with vendored crates should build from release tarballs.
4104 * [Fix inert attributes from `proc_macro_derives`][39572]
4105 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4106   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4107   build system.
4108 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4109   existing code generally ignores the type of dead-code unless a type-hint is
4110   provided; this can cause surprising inference interactions particularly around
4111   defaulting. The new code uniformly ignores the result type of dead-code.
4112 * [Tuple-struct constructors with private fields are no longer visible][38932]
4113 * [Lifetime parameters that do not appear in the arguments are now considered
4114   early-bound][38897], resolving a soundness bug (#[32330]). The
4115   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4116   April of 2016.
4117 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4118 * [Make transmuting from fn item types to pointer-sized types a hard
4119   error][34198]
4120
4121 [27787]: https://github.com/rust-lang/rust/issues/27787
4122 [32330]: https://github.com/rust-lang/rust/issues/32330
4123 [34198]: https://github.com/rust-lang/rust/pull/34198
4124 [38161]: https://github.com/rust-lang/rust/pull/38161
4125 [38368]: https://github.com/rust-lang/rust/pull/38368
4126 [38584]: https://github.com/rust-lang/rust/issues/38584
4127 [38661]: https://github.com/rust-lang/rust/pull/38661
4128 [38764]: https://github.com/rust-lang/rust/pull/38764
4129 [38864]: https://github.com/rust-lang/rust/issues/38864
4130 [38897]: https://github.com/rust-lang/rust/pull/38897
4131 [38921]: https://github.com/rust-lang/rust/pull/38921
4132 [38932]: https://github.com/rust-lang/rust/pull/38932
4133 [38945]: https://github.com/rust-lang/rust/pull/38945
4134 [38981]: https://github.com/rust-lang/rust/pull/38981
4135 [39002]: https://github.com/rust-lang/rust/pull/39002
4136 [39116]: https://github.com/rust-lang/rust/pull/39116
4137 [39193]: https://github.com/rust-lang/rust/pull/39193
4138 [39265]: https://github.com/rust-lang/rust/pull/39265
4139 [39356]: https://github.com/rust-lang/rust/pull/39356
4140 [39372]: https://github.com/rust-lang/rust/pull/39372
4141 [39426]: https://github.com/rust-lang/rust/pull/39426
4142 [39431]: https://github.com/rust-lang/rust/pull/39431
4143 [39438]: https://github.com/rust-lang/rust/pull/39438
4144 [39440]: https://github.com/rust-lang/rust/pull/39440
4145 [39485]: https://github.com/rust-lang/rust/pull/39485
4146 [39491]: https://github.com/rust-lang/rust/pull/39491
4147 [39518]: https://github.com/rust-lang/rust/pull/39518
4148 [39538]: https://github.com/rust-lang/rust/pull/39538
4149 [39572]: https://github.com/rust-lang/rust/pull/39572
4150 [39633]: https://github.com/rust-lang/rust/pull/39633
4151 [39642]: https://github.com/rust-lang/rust/pull/39642
4152 [39728]: https://github.com/rust-lang/rust/pull/39728
4153 [39761]: https://github.com/rust-lang/rust/pull/39761
4154 [39788]: https://github.com/rust-lang/rust/pull/39788
4155 [39793]: https://github.com/rust-lang/rust/pull/39793
4156 [39837]: https://github.com/rust-lang/rust/pull/39837
4157 [39843]: https://github.com/rust-lang/rust/pull/39843
4158 [39851]: https://github.com/rust-lang/rust/pull/39851
4159 [39903]: https://github.com/rust-lang/rust/pull/39903
4160 [39939]: https://github.com/rust-lang/rust/pull/39939
4161 [39953]: https://github.com/rust-lang/rust/pull/39953
4162 [39960]: https://github.com/rust-lang/rust/pull/39960
4163 [39990]: https://github.com/rust-lang/rust/pull/39990
4164 [39995]: https://github.com/rust-lang/rust/pull/39995
4165 [40008]: https://github.com/rust-lang/rust/pull/40008
4166 [40009]: https://github.com/rust-lang/rust/pull/40009
4167 [40027]: https://github.com/rust-lang/rust/pull/40027
4168 [40028]: https://github.com/rust-lang/rust/pull/40028
4169 [40037]: https://github.com/rust-lang/rust/pull/40037
4170 [40117]: https://github.com/rust-lang/rust/pull/40117
4171 [40166]: https://github.com/rust-lang/rust/pull/40166
4172 [40245]: https://github.com/rust-lang/rust/pull/40245
4173 [40257]: https://github.com/rust-lang/rust/pull/40257
4174 [40261]: https://github.com/rust-lang/rust/pull/40261
4175 [40265]: https://github.com/rust-lang/rust/pull/40265
4176 [40319]: https://github.com/rust-lang/rust/pull/40319
4177 [40336]: https://github.com/rust-lang/rust/pull/40336
4178 [40526]: https://github.com/rust-lang/rust/pull/40526
4179 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4180 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4181 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4182 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4183 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4184 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4185 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4186 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4187 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4188 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4189 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4190 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4191 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4192 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4193 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4194 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4195 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4196 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4197 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4198 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4199 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4200 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4201 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4202 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4203 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4204 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4205 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4206 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4207 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4208 [mdbook]: https://crates.io/crates/mdbook
4209 [ubook]: https://doc.rust-lang.org/unstable-book/
4210
4211
4212 Version 1.16.0 (2017-03-16)
4213 ===========================
4214
4215 Language
4216 --------
4217
4218 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4219 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4220   match patterns][38069]
4221 * [Clean up semantics of `self` in an import list][38313]
4222 * [`Self` may appear in `impl` headers][38920]
4223 * [`Self` may appear in struct expressions][39282]
4224
4225 Compiler
4226 --------
4227
4228 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4229   a `.rmeta` file containing only crate metadata][38571]. This can be
4230   used by tools like the Rust Language Service to perform
4231   metadata-only builds.
4232 * [Levenshtein based typo suggestions now work in most places, while
4233   previously they worked only for fields and sometimes for local
4234   variables][38927]. Together with the overhaul of "no
4235   resolution"/"unexpected resolution" errors (#[38154]) they result in
4236   large and systematic improvement in resolution diagnostics.
4237 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4238   `U`][38670]
4239 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4240 * [`rustc` no longer attempts to provide "consider using an explicit
4241   lifetime" suggestions][37057]. They were inaccurate.
4242
4243 Stabilized APIs
4244 ---------------
4245
4246 * [`VecDeque::truncate`]
4247 * [`VecDeque::resize`]
4248 * [`String::insert_str`]
4249 * [`Duration::checked_add`]
4250 * [`Duration::checked_sub`]
4251 * [`Duration::checked_div`]
4252 * [`Duration::checked_mul`]
4253 * [`str::replacen`]
4254 * [`str::repeat`]
4255 * [`SocketAddr::is_ipv4`]
4256 * [`SocketAddr::is_ipv6`]
4257 * [`IpAddr::is_ipv4`]
4258 * [`IpAddr::is_ipv6`]
4259 * [`Vec::dedup_by`]
4260 * [`Vec::dedup_by_key`]
4261 * [`Result::unwrap_or_default`]
4262 * [`<*const T>::wrapping_offset`]
4263 * [`<*mut T>::wrapping_offset`]
4264 * `CommandExt::creation_flags`
4265 * [`File::set_permissions`]
4266 * [`String::split_off`]
4267
4268 Libraries
4269 ---------
4270
4271 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4272   their argument by `Borrow` parameter][37761]
4273 * [All public types in std implement `Debug`][38006]
4274 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4275 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4276 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4277   Windows][38274]
4278 * [std: Fix partial writes in `LineWriter`][38062]
4279 * [std: Clamp max read/write sizes on Unix][38062]
4280 * [Use more specific panic message for `&str` slicing errors][38066]
4281 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4282   functionality cannot be achieved in std currently.
4283 * [`writeln!`, like `println!`, now accepts a form with no string
4284   or formatting arguments, to just print a newline][38469]
4285 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4286 * [Reduce the size of static data in `std_unicode::tables`][38781]
4287 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4288   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4289   `Display`][38909]
4290 * [`Duration` implements `Sum`][38712]
4291 * [`String` implements `ToSocketAddrs`][39048]
4292
4293 Cargo
4294 -----
4295
4296 * [The `cargo check` command does a type check of a project without
4297   building it][cargo/3296]
4298 * [crates.io will display CI badges from Travis and AppVeyor, if
4299   specified in Cargo.toml][cargo/3546]
4300 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4301 * [Compilation profiles accept integer values for `debug`, in addition
4302   to `true` and `false`. These are passed to `rustc` as the value to
4303   `-C debuginfo`][cargo/3534]
4304 * [Implement `cargo --version --verbose`][cargo/3604]
4305 * [All builds now output 'dep-info' build dependencies compatible with
4306   make and ninja][cargo/3557]
4307 * [Build all workspace members with `build --all`][cargo/3511]
4308 * [Document all workspace members with `doc --all`][cargo/3515]
4309 * [Path deps outside workspace are not members][cargo/3443]
4310
4311 Misc
4312 ----
4313
4314 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4315   the path to the Rust implementation][38589]
4316 * [The `armv7-linux-androideabi` target no longer enables NEON
4317   extensions, per Google's ABI guide][38413]
4318 * [The stock standard library can be compiled for Redox OS][38401]
4319 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4320   available.
4321 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4322   builds available.
4323 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4324
4325 Compatibility Notes
4326 -------------------
4327
4328 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4329   match patterns][38069]
4330 * In this release, references to uninhabited types can not be
4331   pattern-matched. This was accidentally allowed in 1.15.
4332 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4333 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4334   Windows][38274]
4335 * [Clean up semantics of `self` in an import list][38313]
4336 * Reimplemented lifetime elision. This change was almost entirely compatible
4337   with existing code, but it did close a number of small bugs and loopholes,
4338   as well as being more accepting in some other [cases][41105].
4339
4340 [37057]: https://github.com/rust-lang/rust/pull/37057
4341 [37761]: https://github.com/rust-lang/rust/pull/37761
4342 [38006]: https://github.com/rust-lang/rust/pull/38006
4343 [38051]: https://github.com/rust-lang/rust/pull/38051
4344 [38062]: https://github.com/rust-lang/rust/pull/38062
4345 [38062]: https://github.com/rust-lang/rust/pull/38622
4346 [38066]: https://github.com/rust-lang/rust/pull/38066
4347 [38069]: https://github.com/rust-lang/rust/pull/38069
4348 [38131]: https://github.com/rust-lang/rust/pull/38131
4349 [38154]: https://github.com/rust-lang/rust/pull/38154
4350 [38274]: https://github.com/rust-lang/rust/pull/38274
4351 [38304]: https://github.com/rust-lang/rust/pull/38304
4352 [38313]: https://github.com/rust-lang/rust/pull/38313
4353 [38314]: https://github.com/rust-lang/rust/pull/38314
4354 [38327]: https://github.com/rust-lang/rust/pull/38327
4355 [38401]: https://github.com/rust-lang/rust/pull/38401
4356 [38413]: https://github.com/rust-lang/rust/pull/38413
4357 [38469]: https://github.com/rust-lang/rust/pull/38469
4358 [38559]: https://github.com/rust-lang/rust/pull/38559
4359 [38571]: https://github.com/rust-lang/rust/pull/38571
4360 [38580]: https://github.com/rust-lang/rust/pull/38580
4361 [38589]: https://github.com/rust-lang/rust/pull/38589
4362 [38670]: https://github.com/rust-lang/rust/pull/38670
4363 [38712]: https://github.com/rust-lang/rust/pull/38712
4364 [38726]: https://github.com/rust-lang/rust/pull/38726
4365 [38781]: https://github.com/rust-lang/rust/pull/38781
4366 [38798]: https://github.com/rust-lang/rust/pull/38798
4367 [38909]: https://github.com/rust-lang/rust/pull/38909
4368 [38920]: https://github.com/rust-lang/rust/pull/38920
4369 [38927]: https://github.com/rust-lang/rust/pull/38927
4370 [39048]: https://github.com/rust-lang/rust/pull/39048
4371 [39282]: https://github.com/rust-lang/rust/pull/39282
4372 [39379]: https://github.com/rust-lang/rust/pull/39379
4373 [41105]: https://github.com/rust-lang/rust/issues/41105
4374 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4375 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4376 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4377 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4378 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4379 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4380 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4381 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4382 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4383 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4384 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4385 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4386 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4387 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4388 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4389 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4390 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4391 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4392 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4393 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4394 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4395 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4396 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4397 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4398 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4399 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4400 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4401 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4402 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4403 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4404
4405
4406 Version 1.15.1 (2017-02-09)
4407 ===========================
4408
4409 * [Fix IntoIter::as_mut_slice's signature][39466]
4410 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4411
4412 [39466]: https://github.com/rust-lang/rust/pull/39466
4413 [39523]: https://github.com/rust-lang/rust/pull/39523
4414
4415
4416 Version 1.15.0 (2017-02-02)
4417 ===========================
4418
4419 Language
4420 --------
4421
4422 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4423   stable. This allows popular code-generating crates like Serde and Diesel to
4424   work ergonomically. [RFC 1681].
4425 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4426   with curly braces][36868]. Part of [RFC 1506].
4427 * [A number of minor changes to name resolution have been activated][37127].
4428   They add up to more consistent semantics, allowing for future evolution of
4429   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4430   details of what is different. The breaking changes here have been transitioned
4431   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4432 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4433   bounds][38279]
4434 * [`?Sized` can be used in `where` clauses][37791]
4435 * [There is now a limit on the size of monomorphized types and it can be
4436   modified with the `#![type_size_limit]` crate attribute, similarly to
4437   the `#![recursion_limit]` attribute][37789]
4438
4439 Compiler
4440 --------
4441
4442 * [On Windows, the compiler will apply dllimport attributes when linking to
4443   extern functions][37973]. Additional attributes and flags can control which
4444   library kind is linked and its name. [RFC 1717].
4445 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4446 * [The `--test` flag works with procedural macro crates][38107]
4447 * [Fix `extern "aapcs" fn` ABI][37814]
4448 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4449 * [The `format!` expander recognizes incorrect `printf` and shell-style
4450   formatting directives and suggests the correct format][37613].
4451 * [Only report one error for all unused imports in an import list][37456]
4452
4453 Compiler Performance
4454 --------------------
4455
4456 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4457 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4458 * [Don't clone in `UnificationTable::probe`][37848]
4459 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4460 * [Use small vectors in type walker][37760]
4461 * [Macro expansion performance was improved][37701]
4462 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4463 * [Replace FNV with a faster hash function][37229]
4464
4465 Stabilized APIs
4466 ---------------
4467
4468 * [`std::iter::Iterator::min_by`]
4469 * [`std::iter::Iterator::max_by`]
4470 * [`std::os::*::fs::FileExt`]
4471 * [`std::sync::atomic::Atomic*::get_mut`]
4472 * [`std::sync::atomic::Atomic*::into_inner`]
4473 * [`std::vec::IntoIter::as_slice`]
4474 * [`std::vec::IntoIter::as_mut_slice`]
4475 * [`std::sync::mpsc::Receiver::try_iter`]
4476 * [`std::os::unix::process::CommandExt::before_exec`]
4477 * [`std::rc::Rc::strong_count`]
4478 * [`std::rc::Rc::weak_count`]
4479 * [`std::sync::Arc::strong_count`]
4480 * [`std::sync::Arc::weak_count`]
4481 * [`std::char::encode_utf8`]
4482 * [`std::char::encode_utf16`]
4483 * [`std::cell::Ref::clone`]
4484 * [`std::io::Take::into_inner`]
4485
4486 Libraries
4487 ---------
4488
4489 * [The standard sorting algorithm has been rewritten for dramatic performance
4490   improvements][38192]. It is a hybrid merge sort, drawing influences from
4491   Timsort. Previously it was a naive merge sort.
4492 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4493 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4494   performance.
4495 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4496   and `char_indices().last()`][37882]
4497 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4498 * [Chinese characters display correctly in `fmt::Debug`][37855]
4499 * [Derive `Default` for `Duration`][37699]
4500 * [Support creation of anonymous pipes on WinXP/2k][37677]
4501 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4502 * [Don't pass overlapped handles to processes][38835]
4503
4504 Cargo
4505 -----
4506
4507 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4508   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4509   should instead check the variable at runtime with `std::env`. That the value
4510   was set at build time was a bug, and incorrect when cross-compiling. This
4511   change is known to cause breakage.
4512 * [Add `--all` flag to `cargo test`][cargo/3221]
4513 * [Compile statically against the MSVC CRT][cargo/3363]
4514 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4515 * [Link OpenSSL statically on OSX][cargo/3311]
4516 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4517 * [Test for bad path overrides with summaries][cargo/3336]
4518 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4519 * [Fix retrying crate downloads for network errors][cargo/3348]
4520 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4521 * [Emit more info on --message-format=json][cargo/3319]
4522 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4523 * [Don't ignore errors in workspace manifest][cargo/3409]
4524 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4525
4526 Tooling
4527 -------
4528
4529 * [Test runners (binaries built with `--test`) now support a `--list` argument
4530   that lists the tests it contains][38185]
4531 * [Test runners now support a `--exact` argument that makes the test filter
4532   match exactly, instead of matching only a substring of the test name][38181]
4533 * [rustdoc supports a `--playground-url` flag][37763]
4534 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4535
4536 Misc
4537 ----
4538
4539 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4540   continue to be used in this release by passing `--disable-rustbuild` to the
4541   configure script, but they will be deleted soon. Note that the new build
4542   system uses a different on-disk layout that will likely affect any scripts
4543   building Rust.
4544 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4545   releases.
4546 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4547 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4548   releases.
4549
4550 Compatibility Notes
4551 -------------------
4552
4553 * [A number of minor changes to name resolution have been activated][37127].
4554   They add up to more consistent semantics, allowing for future evolution of
4555   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4556   details of what is different. The breaking changes here have been transitioned
4557   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4558 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4559   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4560   should instead check the variable at runtime with `std::env`. That the value
4561   was set at build time was a bug, and incorrect when cross-compiling. This
4562   change is known to cause breakage.
4563 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4564   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4565   1.10 and is now an error by default. It will become a hard error in the near
4566   future.
4567 * [The semantics relating modules to file system directories are changing in
4568   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4569   lint, which is a warning in this release, and will become a hard error in the
4570   future.
4571 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4572 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4573   the underlying iterator][37834]
4574
4575 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4576 [33685]: https://github.com/rust-lang/rust/issues/33685
4577 [36868]: https://github.com/rust-lang/rust/pull/36868
4578 [37127]: https://github.com/rust-lang/rust/pull/37127
4579 [37229]: https://github.com/rust-lang/rust/pull/37229
4580 [37456]: https://github.com/rust-lang/rust/pull/37456
4581 [37527]: https://github.com/rust-lang/rust/pull/37527
4582 [37602]: https://github.com/rust-lang/rust/pull/37602
4583 [37613]: https://github.com/rust-lang/rust/pull/37613
4584 [37615]: https://github.com/rust-lang/rust/pull/37615
4585 [37636]: https://github.com/rust-lang/rust/pull/37636
4586 [37627]: https://github.com/rust-lang/rust/pull/37627
4587 [37642]: https://github.com/rust-lang/rust/pull/37642
4588 [37677]: https://github.com/rust-lang/rust/pull/37677
4589 [37699]: https://github.com/rust-lang/rust/pull/37699
4590 [37701]: https://github.com/rust-lang/rust/pull/37701
4591 [37705]: https://github.com/rust-lang/rust/pull/37705
4592 [37749]: https://github.com/rust-lang/rust/pull/37749
4593 [37760]: https://github.com/rust-lang/rust/pull/37760
4594 [37763]: https://github.com/rust-lang/rust/pull/37763
4595 [37764]: https://github.com/rust-lang/rust/pull/37764
4596 [37789]: https://github.com/rust-lang/rust/pull/37789
4597 [37791]: https://github.com/rust-lang/rust/pull/37791
4598 [37814]: https://github.com/rust-lang/rust/pull/37814
4599 [37817]: https://github.com/rust-lang/rust/pull/37817
4600 [37834]: https://github.com/rust-lang/rust/pull/37834
4601 [37848]: https://github.com/rust-lang/rust/pull/37848
4602 [37855]: https://github.com/rust-lang/rust/pull/37855
4603 [37882]: https://github.com/rust-lang/rust/pull/37882
4604 [37888]: https://github.com/rust-lang/rust/pull/37888
4605 [37973]: https://github.com/rust-lang/rust/pull/37973
4606 [37979]: https://github.com/rust-lang/rust/pull/37979
4607 [38086]: https://github.com/rust-lang/rust/pull/38086
4608 [38107]: https://github.com/rust-lang/rust/pull/38107
4609 [38117]: https://github.com/rust-lang/rust/pull/38117
4610 [38134]: https://github.com/rust-lang/rust/pull/38134
4611 [38146]: https://github.com/rust-lang/rust/pull/38146
4612 [38181]: https://github.com/rust-lang/rust/pull/38181
4613 [38182]: https://github.com/rust-lang/rust/pull/38182
4614 [38185]: https://github.com/rust-lang/rust/pull/38185
4615 [38192]: https://github.com/rust-lang/rust/pull/38192
4616 [38279]: https://github.com/rust-lang/rust/pull/38279
4617 [38835]: https://github.com/rust-lang/rust/pull/38835
4618 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4619 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4620 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4621 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4622 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4623 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4624 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4625 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4626 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4627 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4628 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4629 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4630 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4631 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4632 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4633 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4634 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4635 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4636 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4637 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4638 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4639 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4640 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4641 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4642 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4643 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4644 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4645 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4646 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4647 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4648 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4649 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4650 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4651 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4652 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4653 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4654 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4655 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4656
4657
4658 Version 1.14.0 (2016-12-22)
4659 ===========================
4660
4661 Language
4662 --------
4663
4664 * [`..` matches multiple tuple fields in enum variants, structs
4665   and tuples][36843]. [RFC 1492].
4666 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4667 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4668 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4669   dereferencing][36822]
4670
4671 Compiler
4672 --------
4673
4674 * [Mark enums with non-zero discriminant as non-zero][37224]
4675 * [Lower-case `static mut` names are linted like other
4676   statics and consts][37162]
4677 * [Fix ICE on some macros in const integer positions
4678    (e.g. `[u8; m!()]`)][36819]
4679 * [Improve error message and snippet for "did you mean `x`"][36798]
4680 * [Add a panic-strategy field to the target specification][36794]
4681 * [Include LLVM version in `--version --verbose`][37200]
4682
4683 Compile-time Optimizations
4684 --------------------------
4685
4686 * [Improve macro expansion performance][37569]
4687 * [Shrink `Expr_::ExprInlineAsm`][37445]
4688 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4689 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4690 * [Avoid more allocations when compiling html5ever][37373]
4691 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4692 * [Avoid some allocations in the macro parser][37318]
4693 * [Use a faster deflate setting][37298]
4694 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4695   during interning of slices][37270]
4696 * [Optimize `write_metadata`][37267]
4697 * [Don't process obligation forest cycles when stalled][37231]
4698 * [Avoid many `CrateConfig` clones][37161]
4699 * [Optimize `Substs::super_fold_with`][37108]
4700 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4701 * [Speed up `plug_leaks`][36917]
4702
4703 Libraries
4704 ---------
4705
4706 * [`println!()`, with no arguments, prints newline][36825].
4707   Previously, an empty string was required to achieve the same.
4708 * [`Wrapping` impls standard binary and unary operators, as well as
4709    the `Sum` and `Product` iterators][37356]
4710 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4711   Vec<T>`][37326]
4712 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4713   `VecDeque` iterators][37315]
4714 * [Improve `SipHasher` performance on small values][37312]
4715 * [Add Iterator trait TrustedLen to enable better FromIterator /
4716   Extend][37306]
4717 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4718 * [`ReadDir` implements `Debug`][37221]
4719 * [Implement `RefUnwindSafe` for atomic types][37178]
4720 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4721 * [Avoid allocations in `Decoder::read_str`][37064]
4722 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4723 * [Impl `Debug` for raw pointers to unsized data][36880]
4724 * [Don't reuse `HashMap` random seeds][37470]
4725 * [The internal memory layout of `HashMap` is more cache-friendly, for
4726   significant improvements in some operations][36692]
4727 * [`HashMap` uses less memory on 32-bit architectures][36595]
4728 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4729
4730 Cargo
4731 -----
4732
4733 * [Expose rustc cfg values to build scripts][cargo/3243]
4734 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4735 * [Fix passing --features when testing multiple packages][cargo/3280]
4736 * [Use a single profile set per workspace][cargo/3249]
4737 * [Load `replace` sections from lock files][cargo/3220]
4738 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4739
4740 Tooling
4741 -------
4742
4743 * [rustup is the recommended Rust installation method][1.14rustup]
4744 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4745   S390x. These are [tier 2] platforms and may have major defects. Follow the
4746   instructions on the website to install, or add the targets to an existing
4747   installation with `rustup target add`. The new target triples are:
4748   - `mips-unknown-linux-gnu`
4749   - `mipsel-unknown-linux-gnu`
4750   - `mips64-unknown-linux-gnuabi64`
4751   - `mips64el-unknown-linux-gnuabi64 `
4752   - `powerpc-unknown-linux-gnu`
4753   - `powerpc64-unknown-linux-gnu`
4754   - `powerpc64le-unknown-linux-gnu`
4755   - `s390x-unknown-linux-gnu `
4756 * This release includes target (std) builds for ARM Linux running MUSL
4757   libc. These are [tier 2] platforms and may have major defects. Add the
4758   following triples to an existing rustup installation with `rustup target add`:
4759   - `arm-unknown-linux-musleabi`
4760   - `arm-unknown-linux-musleabihf`
4761   - `armv7-unknown-linux-musleabihf`
4762 * This release includes [experimental support for WebAssembly][1.14wasm], via
4763   the `wasm32-unknown-emscripten` target. This target is known to have major
4764   defects. Please test, report, and fix.
4765 * rustup no longer installs documentation by default. Run `rustup
4766   component add rust-docs` to install.
4767 * [Fix line stepping in debugger][37310]
4768 * [Enable line number debuginfo in releases][37280]
4769
4770 Misc
4771 ----
4772
4773 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4774 * [Add support for Fuchsia OS][37313]
4775 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4776
4777 Compatibility Notes
4778 -------------------
4779
4780 * [A number of forward-compatibility lints used by the compiler
4781   to gradually introduce language changes have been converted
4782   to deny by default][36894]:
4783   - ["use of inaccessible extern crate erroneously allowed"][36886]
4784   - ["type parameter default erroneously allowed in invalid location"][36887]
4785   - ["detects super or self keywords at the beginning of global path"][36888]
4786   - ["two overlapping inherent impls define an item with the same name
4787     were erroneously allowed"][36889]
4788   - ["floating-point constants cannot be used in patterns"][36890]
4789   - ["constants of struct or enum type can only be used in a pattern if
4790      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4791   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4792 * [Prohibit patterns in trait methods without bodies][37378]
4793 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4794 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4795 * [The `$crate` macro variable is accepted in fewer locations][37213]
4796 * [Impls specifying extra region requirements beyond the trait
4797   they implement are rejected][37167]
4798 * [Enums may not be unsized][37111]. Unsized enums are intended to
4799   work but never have. For now they are forbidden.
4800 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4801
4802 [tier 2]: https://forge.rust-lang.org/platform-support.html
4803 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4804 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4805 [36430]: https://github.com/rust-lang/rust/pull/36430
4806 [36595]: https://github.com/rust-lang/rust/pull/36595
4807 [36595]: https://github.com/rust-lang/rust/pull/36595
4808 [36692]: https://github.com/rust-lang/rust/pull/36692
4809 [36767]: https://github.com/rust-lang/rust/pull/36767
4810 [36794]: https://github.com/rust-lang/rust/pull/36794
4811 [36798]: https://github.com/rust-lang/rust/pull/36798
4812 [36819]: https://github.com/rust-lang/rust/pull/36819
4813 [36822]: https://github.com/rust-lang/rust/pull/36822
4814 [36825]: https://github.com/rust-lang/rust/pull/36825
4815 [36843]: https://github.com/rust-lang/rust/pull/36843
4816 [36880]: https://github.com/rust-lang/rust/pull/36880
4817 [36886]: https://github.com/rust-lang/rust/issues/36886
4818 [36887]: https://github.com/rust-lang/rust/issues/36887
4819 [36888]: https://github.com/rust-lang/rust/issues/36888
4820 [36889]: https://github.com/rust-lang/rust/issues/36889
4821 [36890]: https://github.com/rust-lang/rust/issues/36890
4822 [36891]: https://github.com/rust-lang/rust/issues/36891
4823 [36892]: https://github.com/rust-lang/rust/issues/36892
4824 [36894]: https://github.com/rust-lang/rust/pull/36894
4825 [36917]: https://github.com/rust-lang/rust/pull/36917
4826 [36993]: https://github.com/rust-lang/rust/pull/36993
4827 [37037]: https://github.com/rust-lang/rust/pull/37037
4828 [37064]: https://github.com/rust-lang/rust/pull/37064
4829 [37094]: https://github.com/rust-lang/rust/pull/37094
4830 [37108]: https://github.com/rust-lang/rust/pull/37108
4831 [37111]: https://github.com/rust-lang/rust/pull/37111
4832 [37161]: https://github.com/rust-lang/rust/pull/37161
4833 [37162]: https://github.com/rust-lang/rust/pull/37162
4834 [37167]: https://github.com/rust-lang/rust/pull/37167
4835 [37178]: https://github.com/rust-lang/rust/pull/37178
4836 [37200]: https://github.com/rust-lang/rust/pull/37200
4837 [37213]: https://github.com/rust-lang/rust/pull/37213
4838 [37221]: https://github.com/rust-lang/rust/pull/37221
4839 [37224]: https://github.com/rust-lang/rust/pull/37224
4840 [37230]: https://github.com/rust-lang/rust/pull/37230
4841 [37231]: https://github.com/rust-lang/rust/pull/37231
4842 [37247]: https://github.com/rust-lang/rust/pull/37247
4843 [37267]: https://github.com/rust-lang/rust/pull/37267
4844 [37270]: https://github.com/rust-lang/rust/pull/37270
4845 [37273]: https://github.com/rust-lang/rust/pull/37273
4846 [37280]: https://github.com/rust-lang/rust/pull/37280
4847 [37298]: https://github.com/rust-lang/rust/pull/37298
4848 [37306]: https://github.com/rust-lang/rust/pull/37306
4849 [37310]: https://github.com/rust-lang/rust/pull/37310
4850 [37312]: https://github.com/rust-lang/rust/pull/37312
4851 [37313]: https://github.com/rust-lang/rust/pull/37313
4852 [37315]: https://github.com/rust-lang/rust/pull/37315
4853 [37318]: https://github.com/rust-lang/rust/pull/37318
4854 [37322]: https://github.com/rust-lang/rust/pull/37322
4855 [37326]: https://github.com/rust-lang/rust/pull/37326
4856 [37351]: https://github.com/rust-lang/rust/pull/37351
4857 [37356]: https://github.com/rust-lang/rust/pull/37356
4858 [37367]: https://github.com/rust-lang/rust/pull/37367
4859 [37373]: https://github.com/rust-lang/rust/pull/37373
4860 [37378]: https://github.com/rust-lang/rust/pull/37378
4861 [37389]: https://github.com/rust-lang/rust/pull/37389
4862 [37392]: https://github.com/rust-lang/rust/pull/37392
4863 [37427]: https://github.com/rust-lang/rust/pull/37427
4864 [37439]: https://github.com/rust-lang/rust/pull/37439
4865 [37445]: https://github.com/rust-lang/rust/pull/37445
4866 [37470]: https://github.com/rust-lang/rust/pull/37470
4867 [37569]: https://github.com/rust-lang/rust/pull/37569
4868 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4869 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4870 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4871 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4872 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4873 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4874 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4875
4876
4877 Version 1.13.0 (2016-11-10)
4878 ===========================
4879
4880 Language
4881 --------
4882
4883 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4884   errors, like the `try!` macro, described in [RFC 0243].
4885 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4886 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4887 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4888 * [Fix lifetime rules for 'if' conditions][36029]
4889 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4890
4891 Compiler
4892 --------
4893
4894 * [Add the `-C link-arg` argument][36574]
4895 * [Remove the old AST-based backend from rustc_trans][35764]
4896 * [Don't enable NEON by default on armv7 Linux][35814]
4897 * [Fix debug line number info for macro expansions][35238]
4898 * [Do not emit "class method" debuginfo for types that are not
4899   DICompositeType][36008]
4900 * [Warn about multiple conflicting #[repr] hints][34623]
4901 * [When sizing DST, don't double-count nested struct prefixes][36351]
4902 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4903 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4904 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4905 * [Expand macros without recursing to avoid stack overflows][36214]
4906
4907 Diagnostics
4908 -----------
4909
4910 * [Replace macro backtraces with labeled local uses][35702]
4911 * [Improve error message for misplaced doc comments][33922]
4912 * [Buffer unix and lock windows to prevent message interleaving][35975]
4913 * [Update lifetime errors to specifically note temporaries][36171]
4914 * [Special case a few colors for Windows][36178]
4915 * [Suggest `use self` when such an import resolves][36289]
4916 * [Be more specific when type parameter shadows primitive type][36338]
4917 * Many minor improvements
4918
4919 Compile-time Optimizations
4920 --------------------------
4921
4922 * [Compute and cache HIR hashes at beginning][35854]
4923 * [Don't hash types in loan paths][36004]
4924 * [Cache projections in trans][35761]
4925 * [Optimize the parser's last token handling][36527]
4926 * [Only instantiate #[inline] functions in codegen units referencing
4927   them][36524]. This leads to big improvements in cases where crates export
4928   define many inline functions without using them directly.
4929 * [Lazily allocate TypedArena's first chunk][36592]
4930 * [Don't allocate during default HashSet creation][36734]
4931
4932 Stabilized APIs
4933 ---------------
4934
4935 * [`checked_abs`]
4936 * [`wrapping_abs`]
4937 * [`overflowing_abs`]
4938 * [`RefCell::try_borrow`]
4939 * [`RefCell::try_borrow_mut`]
4940
4941 Libraries
4942 ---------
4943
4944 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4945 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4946   covariant][35354]
4947 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4948 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4949 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4950 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4951 * [Use arc4rand on FreeBSD][35884]
4952 * [memrchr: Correct aligned offset computation][35969]
4953 * [Improve Demangling of Rust Symbols][36059]
4954 * [Use monotonic time in condition variables][35048]
4955 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4956 * [Implement conversion traits for `char`][35755]
4957 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4958 * [Zero first byte of CString on drop][36264]
4959 * [Inherit overflow checks for sum and product][36372]
4960 * [Add missing Eq implementations][36423]
4961 * [Implement `Debug` for `DirEntry`][36631]
4962 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4963   `errno`][36754]
4964 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4965 * [Implement more traits for `std::io::ErrorKind`][35911]
4966 * [Optimize BinaryHeap bounds checking][36072]
4967 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4968   `extend_with_element`][36355]
4969 * [Fix overflow checking in unsigned pow()][34942]
4970
4971 Cargo
4972 -----
4973
4974 * This release includes security fixes to both curl and OpenSSL.
4975 * [Fix transitive doctests when panic=abort][cargo/3021]
4976 * [Add --all-features flag to cargo][cargo/3038]
4977 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4978 * [Don't parse the home directory more than once][cargo/3078]
4979 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4980 * [Update OpenSSL to 1.0.2j][cargo/3121]
4981 * [Add license and license_file to cargo metadata output][cargo/3110]
4982 * [Make crates-io registry URL optional in config; ignore all changes to
4983   source.crates-io][cargo/3089]
4984 * [Don't download dependencies from other platforms][cargo/3123]
4985 * [Build transitive dev-dependencies when needed][cargo/3125]
4986 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4987 * [Avoid updating registry when adding existing deps][cargo/3144]
4988 * [Warn about path overrides that won't work][cargo/3136]
4989 * [Use workspaces during `cargo install`][cargo/3146]
4990 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4991 * [Add --message-format flag][cargo/3000]
4992 * [Pass target environment for rustdoc][cargo/3205]
4993 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4994 * [Update curl and curl-sys][cargo/3241]
4995 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4996
4997 Tooling
4998 -------
4999
5000 * [rustdoc: Add the `--sysroot` argument][36586]
5001 * [rustdoc: Fix a couple of issues with the search results][35655]
5002 * [rustdoc: remove the `!` from macro URLs and titles][35234]
5003 * [gdb: Fix pretty-printing special-cased Rust types][35585]
5004 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
5005
5006 Misc
5007 ----
5008
5009 * [Remove unmaintained style guide][35124]
5010 * [Add s390x support][36369]
5011 * [Initial work at Haiku OS support][36727]
5012 * [Add mips-uclibc targets][35734]
5013 * [Crate-ify compiler-rt into compiler-builtins][35021]
5014 * [Add rustc version info (git hash + date) to dist tarball][36213]
5015 * Many documentation improvements
5016
5017 Compatibility Notes
5018 -------------------
5019
5020 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5021 * [Deny (by default) transmuting from fn item types to pointer-sized
5022   types][34923]. Continuing the long transition to zero-sized fn items,
5023   per [RFC 401].
5024 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5025   Part of [RFC 1506].
5026 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5027 * [Fix lifetime rules for 'if' conditions][36029].
5028 * [Inherit overflow checks for sum and product][36372].
5029 * [Forbid user-defined macros named "macro_rules"][36730].
5030
5031 [33922]: https://github.com/rust-lang/rust/pull/33922
5032 [34623]: https://github.com/rust-lang/rust/pull/34623
5033 [34923]: https://github.com/rust-lang/rust/pull/34923
5034 [34942]: https://github.com/rust-lang/rust/pull/34942
5035 [34982]: https://github.com/rust-lang/rust/pull/34982
5036 [35021]: https://github.com/rust-lang/rust/pull/35021
5037 [35048]: https://github.com/rust-lang/rust/pull/35048
5038 [35074]: https://github.com/rust-lang/rust/pull/35074
5039 [35124]: https://github.com/rust-lang/rust/pull/35124
5040 [35234]: https://github.com/rust-lang/rust/pull/35234
5041 [35238]: https://github.com/rust-lang/rust/pull/35238
5042 [35354]: https://github.com/rust-lang/rust/pull/35354
5043 [35559]: https://github.com/rust-lang/rust/pull/35559
5044 [35585]: https://github.com/rust-lang/rust/pull/35585
5045 [35627]: https://github.com/rust-lang/rust/pull/35627
5046 [35655]: https://github.com/rust-lang/rust/pull/35655
5047 [35702]: https://github.com/rust-lang/rust/pull/35702
5048 [35707]: https://github.com/rust-lang/rust/pull/35707
5049 [35728]: https://github.com/rust-lang/rust/pull/35728
5050 [35734]: https://github.com/rust-lang/rust/pull/35734
5051 [35755]: https://github.com/rust-lang/rust/pull/35755
5052 [35761]: https://github.com/rust-lang/rust/pull/35761
5053 [35764]: https://github.com/rust-lang/rust/pull/35764
5054 [35814]: https://github.com/rust-lang/rust/pull/35814
5055 [35854]: https://github.com/rust-lang/rust/pull/35854
5056 [35871]: https://github.com/rust-lang/rust/pull/35871
5057 [35884]: https://github.com/rust-lang/rust/pull/35884
5058 [35911]: https://github.com/rust-lang/rust/pull/35911
5059 [35969]: https://github.com/rust-lang/rust/pull/35969
5060 [35975]: https://github.com/rust-lang/rust/pull/35975
5061 [36004]: https://github.com/rust-lang/rust/pull/36004
5062 [36008]: https://github.com/rust-lang/rust/pull/36008
5063 [36014]: https://github.com/rust-lang/rust/pull/36014
5064 [36029]: https://github.com/rust-lang/rust/pull/36029
5065 [36059]: https://github.com/rust-lang/rust/pull/36059
5066 [36072]: https://github.com/rust-lang/rust/pull/36072
5067 [36101]: https://github.com/rust-lang/rust/pull/36101
5068 [36104]: https://github.com/rust-lang/rust/pull/36104
5069 [36171]: https://github.com/rust-lang/rust/pull/36171
5070 [36173]: https://github.com/rust-lang/rust/pull/36173
5071 [36178]: https://github.com/rust-lang/rust/pull/36178
5072 [36213]: https://github.com/rust-lang/rust/pull/36213
5073 [36214]: https://github.com/rust-lang/rust/pull/36214
5074 [36264]: https://github.com/rust-lang/rust/pull/36264
5075 [36266]: https://github.com/rust-lang/rust/pull/36266
5076 [36289]: https://github.com/rust-lang/rust/pull/36289
5077 [36338]: https://github.com/rust-lang/rust/pull/36338
5078 [36351]: https://github.com/rust-lang/rust/pull/36351
5079 [36355]: https://github.com/rust-lang/rust/pull/36355
5080 [36369]: https://github.com/rust-lang/rust/pull/36369
5081 [36372]: https://github.com/rust-lang/rust/pull/36372
5082 [36423]: https://github.com/rust-lang/rust/pull/36423
5083 [36482]: https://github.com/rust-lang/rust/pull/36482
5084 [36505]: https://github.com/rust-lang/rust/pull/36505
5085 [36524]: https://github.com/rust-lang/rust/pull/36524
5086 [36527]: https://github.com/rust-lang/rust/pull/36527
5087 [36551]: https://github.com/rust-lang/rust/pull/36551
5088 [36574]: https://github.com/rust-lang/rust/pull/36574
5089 [36586]: https://github.com/rust-lang/rust/pull/36586
5090 [36592]: https://github.com/rust-lang/rust/pull/36592
5091 [36631]: https://github.com/rust-lang/rust/pull/36631
5092 [36639]: https://github.com/rust-lang/rust/pull/36639
5093 [36721]: https://github.com/rust-lang/rust/pull/36721
5094 [36727]: https://github.com/rust-lang/rust/pull/36727
5095 [36730]: https://github.com/rust-lang/rust/pull/36730
5096 [36734]: https://github.com/rust-lang/rust/pull/36734
5097 [36754]: https://github.com/rust-lang/rust/pull/36754
5098 [36995]: https://github.com/rust-lang/rust/pull/36995
5099 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5100 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5101 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5102 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5103 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5104 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5105 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5106 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5107 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5108 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5109 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5110 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5111 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5112 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5113 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5114 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5115 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5116 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5117 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5118 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5119 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5120 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5121 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5122 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5123 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5124 [rustup]: https://www.rustup.rs
5125 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5126 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5127 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5128 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5129 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5130 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5131 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5132
5133
5134 Version 1.12.1 (2016-10-20)
5135 ===========================
5136
5137 Regression Fixes
5138 ----------------
5139
5140 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5141 * [Confusion with double negation and booleans][36856]
5142 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5143 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5144 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5145 * [Corrupted memory after updated to 1.12][36936]
5146 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5147 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5148 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5149
5150 [36381]: https://github.com/rust-lang/rust/issues/36381
5151 [36856]: https://github.com/rust-lang/rust/issues/36856
5152 [36875]: https://github.com/rust-lang/rust/issues/36875
5153 [36924]: https://github.com/rust-lang/rust/issues/36924
5154 [36926]: https://github.com/rust-lang/rust/issues/36926
5155 [36936]: https://github.com/rust-lang/rust/issues/36936
5156 [37026]: https://github.com/rust-lang/rust/issues/37026
5157 [37112]: https://github.com/rust-lang/rust/issues/37112
5158 [37153]: https://github.com/rust-lang/rust/issues/37153
5159
5160
5161 Version 1.12.0 (2016-09-29)
5162 ===========================
5163
5164 Highlights
5165 ----------
5166
5167 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5168   This translation pass is far simpler than the previous AST->LLVM pass, and
5169   creates opportunities to perform new optimizations directly on the MIR. It
5170   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5171 * [`rustc` presents a new, more readable error format, along with
5172   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5173   Most common editors supporting Rust have been updated to work with it. It was
5174   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5175
5176 Compiler
5177 --------
5178
5179 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5180   This translation pass is far simpler than the previous AST->LLVM pass, and
5181   creates opportunities to perform new optimizations directly on the MIR. It
5182   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5183 * [Print the Rust target name, not the LLVM target name, with
5184   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5185 * [The computation of `TypeId` is correct in some cases where it was previously
5186   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5187 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5188 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5189   `--print relocation-models`, and `--print code-models` print the available
5190   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5191   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5192 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5193   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5194   These targets produce statically-linked binaries. There are no binary release
5195   builds yet though.
5196
5197 Diagnostics
5198 -----------
5199
5200 * [`rustc` presents a new, more readable error format, along with
5201   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5202   Most common editors supporting Rust have been updated to work with it. It was
5203   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5204 * [In error descriptions, references are now described in plain English,
5205   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5206 * [In error type descriptions, unknown numeric types are named `{integer}` or
5207   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5208 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5209
5210 Language
5211 --------
5212
5213 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5214 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5215 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5216   useful](https://github.com/rust-lang/rust/pull/34908)
5217 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5218   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5219 * [Semicolons are properly required as statement delimiters inside
5220   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5221 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5222
5223 Stabilized APIs
5224 ---------------
5225
5226 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5227 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5228 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5229 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5230 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5231 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5232 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5233 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5234 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5235 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5236   Both on Unix and Windows.
5237 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5238 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5239 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5240 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5241 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5242 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5243 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5244 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5245
5246 Libraries
5247 ---------
5248
5249 * [The `format!` macro and friends now allow a single argument to be formatted
5250   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5251 * [The lifetime bounds on `[T]::binary_search_by` and
5252   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5253 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5254 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5255 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5256 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5257 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5258 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5259 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5260 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5261   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5262 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5263   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5264 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5265 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5266   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5267 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5268 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5269 * [`mpsc::sync_channel` `Receiver`s return any available message before
5270   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5271 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5272 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5273
5274 Cargo
5275 -----
5276
5277 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5278 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5279 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5280 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5281 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5282 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5283 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5284 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5285 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5286 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5287 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5288 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5289 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5290 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5291 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5292 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5293
5294 Performance
5295 -----------
5296
5297 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5298 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5299
5300 Tooling
5301 -------
5302
5303 * [Test binaries now support a `--test-threads` argument to specify the number
5304   of threads used to run tests, and which acts the same as the
5305   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5306 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5307 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5308 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5309 * [Rust releases now come with source packages that can be installed by rustup
5310   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5311   The resulting source code can be used by tools and IDES, located in the
5312   sysroot under `lib/rustlib/src`.
5313
5314 Misc
5315 ----
5316
5317 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5318 * Many minor improvements to the documentation.
5319 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5320
5321 Compatibility Notes
5322 -------------------
5323
5324 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5325   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5326 * [When formatting strings, if "precision" is specified, the "fill",
5327   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5328 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5329
5330
5331 Version 1.11.0 (2016-08-18)
5332 ===========================
5333
5334 Language
5335 --------
5336
5337 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5338 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5339 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5340 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5341
5342 Stabilized APIs
5343 ---------------
5344
5345 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5346 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5347 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5348 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5349 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5350 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5351   (in libcore - previously stabilized in libstd)
5352 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5353   (in libcore - previously stabilized in libstd)
5354 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5355   (in libcore - previously stabilized in libstd)
5356 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5357   (in libcore - previously stabilized in libstd)
5358 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5359 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5360 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5361 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5362
5363 Libraries
5364 ---------
5365
5366 * [The `thread_local!` macro supports multiple definitions in a single
5367    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5368 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5369 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5370   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5371 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5372 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5373 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5374 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5375
5376 Cargo
5377 -----
5378
5379 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5380 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5381 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5382 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5383 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5384   and `-vv` prints warnings for all crates.
5385 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5386 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5387   This provides room for expansion by arbitrary tools.
5388 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5389 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5390 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5391 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5392 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5393 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5394 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5395
5396 Performance
5397 -----------
5398
5399 * [Caching projections speeds up type check dramatically for some
5400   workloads](https://github.com/rust-lang/rust/pull/33816)
5401 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5402   This hasher is faster, but is believed to provide sufficient
5403   protection from collision attacks.
5404 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5405
5406 Rustdoc
5407 -------
5408
5409 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5410 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5411 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5412 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5413 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5414
5415 Tooling
5416 -------
5417
5418 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5419 * [When emitting debug info, rustc emits frame pointers for closures,
5420   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5421 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5422 * Many more errors have been given error codes and extended
5423   explanations
5424 * API documentation continues to be improved, with many new examples
5425
5426 Misc
5427 ----
5428
5429 * [rustc no longer hangs when dependencies recursively re-export
5430   submodules](https://github.com/rust-lang/rust/pull/34542)
5431 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5432 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5433   rewritten](https://github.com/rust-lang/rust/pull/33895)
5434 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5435   No targets use this yet, but it works toward AVR support.
5436
5437 Compatibility Notes
5438 -------------------
5439
5440 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5441 * [The new follow-set rules that place restrictions on `macro_rules!`
5442   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5443   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5444   and has been a warning since 1.10.
5445 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5446   This causes breakage in some corner cases.
5447
5448
5449 Version 1.10.0 (2016-07-07)
5450 ===========================
5451
5452 Language
5453 --------
5454
5455 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5456   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5457 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5458 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5459 * [`panic!` can be converted to a runtime abort with the
5460   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5461   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5462 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5463   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5464   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5465   Note that Cargo does not yet directly support cdylibs.
5466
5467 Stabilized APIs
5468 ---------------
5469
5470 * `os::windows::fs::OpenOptionsExt::access_mode`
5471 * `os::windows::fs::OpenOptionsExt::share_mode`
5472 * `os::windows::fs::OpenOptionsExt::custom_flags`
5473 * `os::windows::fs::OpenOptionsExt::attributes`
5474 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5475 * `os::unix::fs::OpenOptionsExt::custom_flags`
5476 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5477 * `Default for sync::Weak`
5478 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5479 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5480 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5481 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5482 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5483 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5484 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5485 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5486 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5487 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5488 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5489 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5490 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5491 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5492 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5493 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5494 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5495 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5496 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5497 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5498 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5499 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5500 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5501 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5502 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5503 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5504 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5505 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5506 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5507 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5508 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5509 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5510 * Read/Write/RawFd impls for `UnixStream`
5511 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5512 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5513 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5514 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5515 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5516 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5517 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5518 * RawFd impls for `UnixListener`
5519 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5520 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5521 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5522 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5523 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5524 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5525 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5526 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5527 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5528 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5529 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5530 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5531 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5532 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5533 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5534 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5535 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5536 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5537 * RawFd impls for `UnixDatagram`
5538 * `{BTree,Hash}Map::values_mut`
5539 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5540
5541 Libraries
5542 ---------
5543
5544 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5545   The semantics of this minor method are subtle and probably not what
5546   most people want.
5547 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5548 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5549   will fall back to `/dev/urandom` temporarily to avoid blocking
5550   during early boot](https://github.com/rust-lang/rust/pull/33086).
5551 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5552 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5553 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5554 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5555 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5556 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5557   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5558
5559 Cargo
5560 -----
5561 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5562   This controls the runtime behavior of the `panic!` macro
5563   and can be either "unwind" (the default), or "abort".
5564   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5565 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5566 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5567 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5568   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5569 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5570 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5571 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5572   By default they are retried twice, which can be customized with the
5573   `net.retry` value in `.cargo/config`.
5574 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5575 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5576 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5577 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5578   Makes it possible to install multiple crates in parallel.
5579 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5580 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5581 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5582 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5583 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5584 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5585
5586 Performance
5587 -----------
5588
5589 * [rustc memory usage was reduced by refactoring the context used for
5590   type checking](https://github.com/rust-lang/rust/pull/33425).
5591 * [Speed up creation of `HashMap`s by caching the random keys used
5592   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5593 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5594 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5595 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5596   10x faster than the previous lookup tables.
5597 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5598
5599 Usability
5600 ---------
5601
5602 * Many incremental improvements to documentation and rustdoc.
5603 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5604 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5605 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5606 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5607 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5608 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5609 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5610
5611 Misc
5612 ----
5613
5614 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5615 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5616 * [`std` no longer prints backtraces on platforms where the running
5617   module must be loaded with `env::current_exe`, which can't be relied
5618   on](https://github.com/rust-lang/rust/pull/33554).
5619 * This release includes std binaries for the i586-unknown-linux-gnu,
5620   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5621   i586 target is for old x86 hardware without SSE2, and the armv7
5622   target is for Android running on modern ARM architectures.
5623 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5624   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5625 * [On Unix the runtime aborts by calling `libc::abort` instead of
5626   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5627 * [Rust is now bootstrapped from the previous release of Rust,
5628   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5629
5630 Compatibility Notes
5631 -------------------
5632
5633 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5634 * [`target_env` for Linux ARM targets is just `gnu`, not
5635   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5636 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5637 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5638 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5639   Affects how macros are parsed.
5640 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5641 * [Feature-gated attributes on macro-generated macro invocations are
5642   now rejected](https://github.com/rust-lang/rust/pull/32791).
5643 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5644   This caused some minor changes to type inference.
5645
5646
5647 Version 1.9.0 (2016-05-26)
5648 ==========================
5649
5650 Language
5651 --------
5652
5653 * The `#[deprecated]` attribute when applied to an API will generate
5654   warnings when used. The warnings may be suppressed with
5655   `#[allow(deprecated)]`. [RFC 1270].
5656 * [`fn` item types are zero sized, and each `fn` names a unique
5657   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5658   `transmute` on a `fn` type will generate a warning for a few cycles,
5659   then will be converted to an error.
5660 * [Field and method resolution understand visibility, so private
5661   fields and methods cannot prevent the proper use of public fields
5662   and methods][1.9fv].
5663 * [The parser considers unicode codepoints in the
5664   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5665
5666 Stabilized APIs
5667 ---------------
5668
5669 * [`std::panic`]
5670 * [`std::panic::catch_unwind`] (renamed from `recover`)
5671 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5672 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5673 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5674 * [`str::is_char_boundary`]
5675 * [`<*const T>::as_ref`]
5676 * [`<*mut T>::as_ref`]
5677 * [`<*mut T>::as_mut`]
5678 * [`AsciiExt::make_ascii_uppercase`]
5679 * [`AsciiExt::make_ascii_lowercase`]
5680 * [`char::decode_utf16`]
5681 * [`char::DecodeUtf16`]
5682 * [`char::DecodeUtf16Error`]
5683 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5684 * [`BTreeSet::take`]
5685 * [`BTreeSet::replace`]
5686 * [`BTreeSet::get`]
5687 * [`HashSet::take`]
5688 * [`HashSet::replace`]
5689 * [`HashSet::get`]
5690 * [`OsString::with_capacity`]
5691 * [`OsString::clear`]
5692 * [`OsString::capacity`]
5693 * [`OsString::reserve`]
5694 * [`OsString::reserve_exact`]
5695 * [`OsStr::is_empty`]
5696 * [`OsStr::len`]
5697 * [`std::os::unix::thread`]
5698 * [`RawPthread`]
5699 * [`JoinHandleExt`]
5700 * [`JoinHandleExt::as_pthread_t`]
5701 * [`JoinHandleExt::into_pthread_t`]
5702 * [`HashSet::hasher`]
5703 * [`HashMap::hasher`]
5704 * [`CommandExt::exec`]
5705 * [`File::try_clone`]
5706 * [`SocketAddr::set_ip`]
5707 * [`SocketAddr::set_port`]
5708 * [`SocketAddrV4::set_ip`]
5709 * [`SocketAddrV4::set_port`]
5710 * [`SocketAddrV6::set_ip`]
5711 * [`SocketAddrV6::set_port`]
5712 * [`SocketAddrV6::set_flowinfo`]
5713 * [`SocketAddrV6::set_scope_id`]
5714 * [`slice::copy_from_slice`]
5715 * [`ptr::read_volatile`]
5716 * [`ptr::write_volatile`]
5717 * [`OpenOptions::create_new`]
5718 * [`TcpStream::set_nodelay`]
5719 * [`TcpStream::nodelay`]
5720 * [`TcpStream::set_ttl`]
5721 * [`TcpStream::ttl`]
5722 * [`TcpStream::set_only_v6`]
5723 * [`TcpStream::only_v6`]
5724 * [`TcpStream::take_error`]
5725 * [`TcpStream::set_nonblocking`]
5726 * [`TcpListener::set_ttl`]
5727 * [`TcpListener::ttl`]
5728 * [`TcpListener::set_only_v6`]
5729 * [`TcpListener::only_v6`]
5730 * [`TcpListener::take_error`]
5731 * [`TcpListener::set_nonblocking`]
5732 * [`UdpSocket::set_broadcast`]
5733 * [`UdpSocket::broadcast`]
5734 * [`UdpSocket::set_multicast_loop_v4`]
5735 * [`UdpSocket::multicast_loop_v4`]
5736 * [`UdpSocket::set_multicast_ttl_v4`]
5737 * [`UdpSocket::multicast_ttl_v4`]
5738 * [`UdpSocket::set_multicast_loop_v6`]
5739 * [`UdpSocket::multicast_loop_v6`]
5740 * [`UdpSocket::set_multicast_ttl_v6`]
5741 * [`UdpSocket::multicast_ttl_v6`]
5742 * [`UdpSocket::set_ttl`]
5743 * [`UdpSocket::ttl`]
5744 * [`UdpSocket::set_only_v6`]
5745 * [`UdpSocket::only_v6`]
5746 * [`UdpSocket::join_multicast_v4`]
5747 * [`UdpSocket::join_multicast_v6`]
5748 * [`UdpSocket::leave_multicast_v4`]
5749 * [`UdpSocket::leave_multicast_v6`]
5750 * [`UdpSocket::take_error`]
5751 * [`UdpSocket::connect`]
5752 * [`UdpSocket::send`]
5753 * [`UdpSocket::recv`]
5754 * [`UdpSocket::set_nonblocking`]
5755
5756 Libraries
5757 ---------
5758
5759 * [`std::sync::Once` is poisoned if its initialization function
5760   fails][1.9o].
5761 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5762 * [Most types implement `fmt::Debug`][1.9db].
5763 * [The default buffer size used by `BufReader` and `BufWriter` was
5764   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5765   used by other languages.
5766 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5767   `Duration` additionally implements `*=` and `/=`][1.9ta].
5768 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5769 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5770 * [`Chain` implements `BufRead`][1.9ch].
5771 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5772
5773 Cargo
5774 -----
5775
5776 * [Cargo can now run concurrently][1.9cc].
5777 * [Top-level overrides allow specific revisions of crates to be
5778   overridden through the entire crate graph][1.9ct].  This is intended
5779   to make upgrades easier for large projects, by allowing crates to be
5780   forked temporarily until they've been upgraded and republished.
5781 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5782 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5783   on the commandline][1.9cf]. `rustc` arguments can also be specified
5784   in the `build.rustflags` configuration key.
5785
5786 Performance
5787 -----------
5788
5789 * [The time complexity of comparing variables for equivalence during type
5790   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5791   to major compilation time improvement in some scenarios.
5792 * [`ToString` is specialized for `str`, giving it the same performance
5793   as `to_owned`][1.9ts].
5794 * [Spawning processes with `Command::output` no longer creates extra
5795   threads][1.9sp].
5796 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5797   for C-like enums][1.9cl].
5798
5799 Misc
5800 ----
5801
5802 * [Passing the `--quiet` flag to a test runner will produce
5803   much-abbreviated output][1.9q].
5804 * The Rust Project now publishes std binaries for the
5805   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5806   `i586-pc-windows-msvc` targets.
5807
5808 Compatibility Notes
5809 -------------------
5810
5811 * [`std::sync::Once` is poisoned if its initialization function
5812   fails][1.9o].
5813 * [It is illegal to define methods with the same name in overlapping
5814   inherent `impl` blocks][1.9sn].
5815 * [`fn` item types are zero sized, and each `fn` names a unique
5816   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5817   `transmute` on a `fn` type will generate a warning for a few cycles,
5818   then will be converted to an error.
5819 * [Improvements to const evaluation may trigger new errors when integer
5820   literals are out of range][1.9ce].
5821
5822
5823 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5824 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5825 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5826 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5827 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5828 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5829 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5830 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5831 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5832 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5833 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5834 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5835 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5836 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5837 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5838 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5839 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5840 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5841 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5842 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5843 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5844 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5845 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5846 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5847 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5848 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5849 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5850 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5851 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5852 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5853 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5854 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5855 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5856 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5857 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5858 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5859 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5860 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5861 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5862 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5863 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5864 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5865 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5866 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5867 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5868 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5869 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5870 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5871 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5872 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5873 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5874 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5875 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5876 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5877 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5878 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5879 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5880 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5881 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5882 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5883 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5884 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5885 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5886 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5887 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5888 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5889 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5890 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5891 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5892 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5893 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5894 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5895 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5896 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5897 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5898 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5899 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5900 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5901 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5902 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5903 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5904 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5905 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5906 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5907 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5908 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5909 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5910 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5911 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5912 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5913 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5914 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5915 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5916 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5917 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5918 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5919 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5920 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5921 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5922 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5923 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5924 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5925 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5926 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5927 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5928 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5929 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5930 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5931 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5932 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5933
5934
5935 Version 1.8.0 (2016-04-14)
5936 ==========================
5937
5938 Language
5939 --------
5940
5941 * Rust supports overloading of compound assignment statements like
5942   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5943   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5944   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5945   traits. [RFC 953].
5946 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5947   addition to the non-braced form, `struct Foo;`. [RFC 218].
5948
5949 Libraries
5950 ---------
5951
5952 * Stabilized APIs:
5953   * [`str::encode_utf16`] (renamed from `utf16_units`)
5954   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5955   * [`Ref::map`]
5956   * [`RefMut::map`]
5957   * [`ptr::drop_in_place`]
5958   * [`time::Instant`]
5959   * [`time::SystemTime`]
5960   * [`Instant::now`]
5961   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5962   * [`Instant::elapsed`]
5963   * [`SystemTime::now`]
5964   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5965   * [`SystemTime::elapsed`]
5966   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5967   * [`SystemTimeError`]
5968   * [`SystemTimeError::duration`]
5969   * Various impls for `SystemTimeError`
5970   * [`UNIX_EPOCH`]
5971   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5972     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5973     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5974 * [The `write!` and `writeln!` macros correctly emit errors if any of
5975   their arguments can't be formatted][1.8w].
5976 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5977 * [The Unix-specific `raw` modules, which contain a number of
5978   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5979   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5980   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5981   across platforms was making it difficult to implement `std`
5982   correctly. Those that need these definitions should use the `libc`
5983   crate. [RFC 1415].
5984 * The Unix-specific `MetadataExt` traits, including
5985   `os::unix::fs::MetadataExt`, which expose values such as inode
5986   numbers [no longer return platform-specific types][1.8r], but
5987   instead return widened integers. [RFC 1415].
5988 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5989 * [Atomic loads and stores are not volatile][1.8a].
5990 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5991
5992 Performance
5993 -----------
5994
5995 * [Inlining hash functions lead to a 3% compile-time improvement in
5996   some workloads][1.8h].
5997 * When using jemalloc, its symbols are [unprefixed so that it
5998   overrides the libc malloc implementation][1.8h]. This means that for
5999   rustc, LLVM is now using jemalloc, which results in a 6%
6000   compile-time improvement on a specific workload.
6001 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
6002
6003 Misc
6004 ----
6005
6006 * [32-bit MSVC builds finally implement unwinding][1.8ms].
6007   i686-pc-windows-msvc is now considered a tier-1 platform.
6008 * [The `--print targets` flag prints a list of supported targets][1.8t].
6009 * [The `--print cfg` flag prints the `cfg`s defined for the current
6010   target][1.8cf].
6011 * [`rustc` can be built with an new Cargo-based build system, written
6012   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6013   build system. To enable it configure with `configure --rustbuild`.
6014 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6015   variants while also indicating the total number of missing variants
6016   if more than 3][1.8m].
6017 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6018 * The Rust Project now publishes binary releases of the standard
6019   library for a number of tier-2 targets:
6020   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6021   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6022   `x86_64-rumprun-netbsd`. These can be installed with
6023   tools such as [multirust][1.8mr].
6024
6025 Cargo
6026 -----
6027
6028 * [`cargo init` creates a new Cargo project in the current
6029   directory][1.8ci].  It is otherwise like `cargo new`.
6030 * [Cargo has configuration keys for `-v` and
6031   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6032   `[term]` section of `.cargo/config`.
6033 * [Configuration keys that evaluate to strings or integers can be set
6034   via environment variables][1.8ce]. For example the `build.jobs` key
6035   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6036   precedence over config files.
6037 * [Target-specific dependencies support Rust `cfg` syntax for
6038   describing targets][1.8cfg] so that dependencies for multiple
6039   targets can be specified together. [RFC 1361].
6040 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6041   `RUSTDOC` take precedence over the `build.target-dir`,
6042   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6043 * [The child process tree is killed on Windows when Cargo is
6044   killed][1.8ck].
6045 * [The `build.target` configuration value sets the target platform,
6046   like `--target`][1.8ct].
6047
6048 Compatibility Notes
6049 -------------------
6050
6051 * [Unstable compiler flags have been further restricted][1.8u]. Since
6052   1.0 `-Z` flags have been considered unstable, and other flags that
6053   were considered unstable additionally required passing `-Z
6054   unstable-options` to access. Unlike unstable language and library
6055   features though, these options have been accessible on the stable
6056   release channel. Going forward, *new unstable flags will not be
6057   available on the stable release channel*, and old unstable flags
6058   will warn about their usage. In the future, all unstable flags will
6059   be unavailable on the stable release channel.
6060 * [It is no longer possible to `match` on empty enum variants using
6061   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6062 * The Unix-specific `MetadataExt` traits, including
6063   `os::unix::fs::MetadataExt`, which expose values such as inode
6064   numbers [no longer return platform-specific types][1.8r], but
6065   instead return widened integers. [RFC 1415].
6066 * [Modules sourced from the filesystem cannot appear within arbitrary
6067   blocks, but only within other modules][1.8mf].
6068 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6069 * On Unix, [stack overflow triggers a runtime abort instead of a
6070   SIGSEGV][1.8so].
6071 * [`Command::spawn` and its equivalents return an error if any of
6072   its command-line arguments contain interior `NUL`s][1.8n].
6073 * [Tuple and unit enum variants from other crates are in the type
6074   namespace][1.8tn].
6075 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6076   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6077   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6078   instead of `foo.lib`.
6079
6080
6081 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6082 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6083 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6084 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6085 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6086 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6087 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6088 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6089 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6090 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6091 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6092 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6093 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6094 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6095 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6096 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6097 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6098 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6099 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6100 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6101 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6102 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6103 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6104 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6105 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6106 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6107 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6108 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6109 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6110 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6111 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6112 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6113 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6114 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6115 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6116 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6117 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6118 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6119 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6120 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6121 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6122 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6123 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6124 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6125 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6126 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6127 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6128 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6129 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6130 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6131 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6132 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6133 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6134 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6135 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6136 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6137 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6138 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6139 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6140 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6141
6142
6143 Version 1.7.0 (2016-03-03)
6144 ==========================
6145
6146 Libraries
6147 ---------
6148
6149 * Stabilized APIs
6150   * `Path`
6151     * [`Path::strip_prefix`] (renamed from relative_from)
6152     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6153   * `Ipv4Addr`
6154     * [`Ipv4Addr::is_loopback`]
6155     * [`Ipv4Addr::is_private`]
6156     * [`Ipv4Addr::is_link_local`]
6157     * [`Ipv4Addr::is_multicast`]
6158     * [`Ipv4Addr::is_broadcast`]
6159     * [`Ipv4Addr::is_documentation`]
6160   * `Ipv6Addr`
6161     * [`Ipv6Addr::is_unspecified`]
6162     * [`Ipv6Addr::is_loopback`]
6163     * [`Ipv6Addr::is_multicast`]
6164   * `Vec`
6165     * [`Vec::as_slice`]
6166     * [`Vec::as_mut_slice`]
6167   * `String`
6168     * [`String::as_str`]
6169     * [`String::as_mut_str`]
6170   * Slices
6171     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6172     be the same length
6173     * `<[T]>::`[`sort_by_key`]
6174   * checked, saturated, and overflowing operations
6175     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6176     * [`i32::saturating_mul`]
6177     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6178     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6179     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6180     * [`u32::saturating_mul`]
6181     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6182     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6183     * and checked, saturated, and overflowing operations for other primitive types
6184   * FFI
6185     * [`ffi::IntoStringError`]
6186     * [`CString::into_string`]
6187     * [`CString::into_bytes`]
6188     * [`CString::into_bytes_with_nul`]
6189     * `From<CString> for Vec<u8>`
6190   * `IntoStringError`
6191     * [`IntoStringError::into_cstring`]
6192     * [`IntoStringError::utf8_error`]
6193     * `Error for IntoStringError`
6194   * Hashing
6195     * [`std::hash::BuildHasher`]
6196     * [`BuildHasher::Hasher`]
6197     * [`BuildHasher::build_hasher`]
6198     * [`std::hash::BuildHasherDefault`]
6199     * [`HashMap::with_hasher`]
6200     * [`HashMap::with_capacity_and_hasher`]
6201     * [`HashSet::with_hasher`]
6202     * [`HashSet::with_capacity_and_hasher`]
6203     * [`std::collections::hash_map::RandomState`]
6204     * [`RandomState::new`]
6205 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6206   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6207   from bytes is faster.
6208 * [The performance of `LineWriter` (and thus `io::stdout`) was
6209   improved by using `memchr` to search for newlines][1.7m].
6210 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6211   `f64` variants were stabilized previously.
6212 * [`BTreeMap` was rewritten to use less memory and improve the performance
6213   of insertion and iteration, the latter by as much as 5x][1.7bm].
6214 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6215   covariant over their contained type][1.7bt].
6216 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6217   over their contained type][1.7ll].
6218 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6219   searching methods.
6220 * [`Any` is implemented for unsized types][1.7a].
6221 * [`Hash` is implemented for `Duration`][1.7h].
6222
6223 Misc
6224 ----
6225
6226 * [When running tests with `--test`, rustdoc will pass `--cfg`
6227   arguments to the compiler][1.7dt].
6228 * [The compiler is built with RPATH information by default][1.7rpa].
6229   This means that it will be possible to run `rustc` when installed in
6230   unusual configurations without configuring the dynamic linker search
6231   path explicitly.
6232 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6233   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6234   over `LD_LIBRARY_PATH`.
6235
6236 Cargo
6237 -----
6238
6239 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6240   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6241 * [The `rerun-if-changed` build script directive no longer causes the
6242   build script to incorrectly run twice in certain scenarios][1.7rr].
6243
6244 Compatibility Notes
6245 -------------------
6246
6247 * Soundness fixes to the interactions between associated types and
6248   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6249   code that violates the new rules. This is a significant change that
6250   is known to break existing code, so it has emitted warnings for the
6251   new error cases since 1.4 to give crate authors time to adapt. The
6252   details of what is changing are subtle; read the RFC for more.
6253 * [Several bugs in the compiler's visibility calculations were
6254   fixed][1.7v]. Since this was found to break significant amounts of
6255   code, the new errors will be emitted as warnings for several release
6256   cycles, under the `private_in_public` lint.
6257 * Defaulted type parameters were accidentally accepted in positions
6258   that were not intended. In this release, [defaulted type parameters
6259   appearing outside of type definitions will generate a
6260   warning][1.7d], which will become an error in future releases.
6261 * [Parsing "." as a float results in an error instead of 0][1.7p].
6262   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6263 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6264
6265 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6266 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6267 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6268 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6269 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6270 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6271 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6272 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6273 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6274 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6275 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6276 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6277 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6278 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6279 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6280 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6281 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6282 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6283 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6284 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6285 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6286 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6287 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6288 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6289 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6290 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6291 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6292 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6293 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6294 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6295 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6296 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6297 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6298 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6299 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6300 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6301 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6302 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6303 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6304 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6305 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6306 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6307 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6308 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6309 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6310 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6311 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6312 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6313 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6314 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6315 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6316 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6317 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6318 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6319 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6320 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6321 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6322 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6323 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6324 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6325 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6326 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6327 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6328 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6329 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6330 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6331 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6332 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6333 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6334 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6335 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6336 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6337 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6338 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6339 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6340 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6341 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6342 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6343 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6344
6345
6346 Version 1.6.0 (2016-01-21)
6347 ==========================
6348
6349 Language
6350 --------
6351
6352 * The `#![no_std]` attribute causes a crate to not be linked to the
6353   standard library, but only the [core library][1.6co], as described
6354   in [RFC 1184]. The core library defines common types and traits but
6355   has no platform dependencies whatsoever, and is the basis for Rust
6356   software in environments that cannot support a full port of the
6357   standard library, such as operating systems. Most of the core
6358   library is now stable.
6359
6360 Libraries
6361 ---------
6362
6363 * Stabilized APIs:
6364   [`Read::read_exact`],
6365   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6366   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6367   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6368   [`os::unix::fs::DirBuilderExt`],
6369   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6370   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6371   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6372   [`collections::hash_map::Drain`],
6373   [`collections::hash_map::HashMap::drain`],
6374   [`collections::hash_set::Drain`],
6375   [`collections::hash_set::HashSet::drain`],
6376   [`collections::binary_heap::Drain`],
6377   [`collections::binary_heap::BinaryHeap::drain`],
6378   [`Vec::extend_from_slice`] (renamed from `push_all`),
6379   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6380   [`RwLock::into_inner`],
6381   [`Iterator::min_by_key`] (renamed from `min_by`),
6382   [`Iterator::max_by_key`] (renamed from `max_by`).
6383 * The [core library][1.6co] is stable, as are most of its APIs.
6384 * [The `assert_eq!` macro supports arguments that don't implement
6385   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6386   `assert!`.
6387 * Several timer functions that take duration in milliseconds [are
6388   deprecated in favor of those that take `Duration`][1.6ms]. These
6389   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6390   `thread::park_timeout_ms`.
6391 * The algorithm by which `Vec` reserves additional elements was
6392   [tweaked to not allocate excessive space][1.6a] while still growing
6393   exponentially.
6394 * `From` conversions are [implemented from integers to floats][1.6f]
6395   in cases where the conversion is lossless. Thus they are not
6396   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6397   or `f64`. They are also not implemented for `isize` and `usize`
6398   because the implementations would be platform-specific. `From` is
6399   also implemented from `f32` to `f64`.
6400 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6401 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6402 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6403 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6404   improvements.
6405 * Sorting slices that are already sorted [is 50% faster in some
6406   cases][1.6s].
6407
6408 Cargo
6409 -----
6410
6411 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6412 * Cargo build scripts can specify their dependencies by emitting the
6413   [`rerun-if-changed`][1.6rr] key.
6414 * crates.io will reject publication of crates with dependencies that
6415   have a wildcard version constraint. Crates with wildcard
6416   dependencies were seen to cause a variety of problems, as described
6417   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6418   warning.
6419 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6420   release folder.  A variety of artifacts that Cargo failed to clean
6421   are now correctly deleted.
6422
6423 Misc
6424 ----
6425
6426 * The `unreachable_code` lint [warns when a function call's argument
6427   diverges][1.6dv].
6428 * The parser indicates [failures that may be caused by
6429   confusingly-similar Unicode characters][1.6uc]
6430 * Certain macro errors [are reported at definition time][1.6m], not
6431   expansion.
6432
6433 Compatibility Notes
6434 -------------------
6435
6436 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6437   environment variable when locating crates. This was a pre-cargo
6438   feature for integrating with the package manager that was
6439   accidentally never removed.
6440 * [A number of bugs were fixed in the privacy checker][1.6p] that
6441   could cause previously-accepted code to break.
6442 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6443 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6444   struct pattern syntax (`Foo(..)`) can no longer be used to match
6445   unit structs. This is a warning now, but will become an error in
6446   future releases. Patterns that share the same name as a const are
6447   now an error.
6448 * A bug was fixed that causes [rustc not to apply default type
6449   parameters][1.6xc] when resolving certain method implementations of
6450   traits defined in other crates.
6451
6452 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6453 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6454 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6455 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6456 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6457 [1.6co]: http://doc.rust-lang.org/core/index.html
6458 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6459 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6460 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6461 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6462 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6463 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6464 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6465 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6466 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6467 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6468 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6469 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6470 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6471 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6472 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6473 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6474 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6475 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6476 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6477 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6478 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6479 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6480 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6481 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6482 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6483 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6484 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6485 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6486 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6487 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6488 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6489 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6490 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6491 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6492 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6493 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6494 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6495 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6496 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6497 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6498 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6499
6500
6501 Version 1.5.0 (2015-12-10)
6502 ==========================
6503
6504 * ~700 changes, numerous bugfixes
6505
6506 Highlights
6507 ----------
6508
6509 * Stabilized APIs:
6510   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6511   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6512   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6513   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6514   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6515   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6516   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6517   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6518   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6519   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6520   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6521   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6522   [`Path::read_link`], [`Path::symlink_metadata`],
6523   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6524   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6525   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6526   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6527   [`slice::split_first_mut`], [`slice::split_first`],
6528   [`slice::split_last_mut`], [`slice::split_last`],
6529   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6530   [`str::MatchIndices`], [`str::RMatchIndices`],
6531   [`str::match_indices`], [`str::rmatch_indices`],
6532   [`str::slice_mut_unchecked`], [`string::ParseError`].
6533 * Rust applications hosted on crates.io can be installed locally to
6534   `~/.cargo/bin` with the [`cargo install`] command. Among other
6535   things this makes it easier to augment Cargo with new subcommands:
6536   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6537   invoked as `cargo foo`.
6538 * Crates with wildcard (`*`) dependencies will [emit warnings when
6539   published][1.5w]. In 1.6 it will no longer be possible to publish
6540   crates with wildcard dependencies.
6541
6542 Breaking Changes
6543 ----------------
6544
6545 * The rules determining when a particular lifetime must outlive
6546   a particular value (known as '[dropck]') have been [modified
6547   to not rely on parametricity][1.5p].
6548 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6549   and `Arc`][1.5a]. Because these smart pointer types implement
6550   `Deref`, this causes breakage in cases where the interior type
6551   contains methods of the same name.
6552 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6553   that they could drop their content. Soundness fix.
6554 * All method invocations are [properly checked][1.5wf1] for
6555   [well-formedness][1.5wf2]. Soundness fix.
6556 * Traits whose supertraits contain `Self` are [not object
6557   safe][1.5o]. Soundness fix.
6558 * Target specifications support a [`no_default_libraries`][1.5nd]
6559   setting that controls whether `-nodefaultlibs` is passed to the
6560   linker, and in turn the `is_like_windows` setting no longer affects
6561   the `-nodefaultlibs` flag.
6562 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6563 * The `#[inline]` and `#[repr]` attributes [can only appear
6564   in valid locations][1.5at].
6565 * Native libraries linked from the local crate are [passed to
6566   the linker before native libraries from upstream crates][1.5nl].
6567 * Two rarely-used attributes, `#[no_debug]` and
6568   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6569 * Negation of unsigned integers, which has been a warning for
6570   several releases, [is now behind a feature gate and will
6571   generate errors][1.5nu].
6572 * The parser accidentally accepted visibility modifiers on
6573   enum variants, a bug [which has been fixed][1.5ev].
6574 * [A bug was fixed that allowed `use` statements to import unstable
6575   features][1.5use].
6576
6577 Language
6578 --------
6579
6580 * When evaluating expressions at compile-time that are not
6581   compile-time constants (const-evaluating expressions in non-const
6582   contexts), incorrect code such as overlong bitshifts and arithmetic
6583   overflow will [generate a warning instead of an error][1.5ce],
6584   delaying the error until runtime. This will allow the
6585   const-evaluator to be expanded in the future backwards-compatibly.
6586 * The `improper_ctypes` lint [no longer warns about using `isize` and
6587   `usize` in FFI][1.5ict].
6588
6589 Libraries
6590 ---------
6591
6592 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6593   invariant][1.5c].
6594 * `Default` is [implemented for mutable slices][1.5d].
6595 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6596 * There are now `From` conversions [between floating point
6597   types][1.5f] where the conversions are lossless.
6598 * There are now `From` conversions [between integer types][1.5i] where
6599   the conversions are lossless.
6600 * [`fs::Metadata` implements `Clone`][1.5fs].
6601 * The `parse` method [accepts a leading "+" when parsing
6602   integers][1.5pi].
6603 * [`AsMut` is implemented for `Vec`][1.5am].
6604 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6605   been optimized][1.5cf] and no longer rely on the default impl.
6606 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6607   `unsafe extern "C"` function types now [implement `Clone`,
6608   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6609   `fmt::Debug` for up to 12 arguments][1.5fp].
6610 * [Dropping `Vec`s is much faster in unoptimized builds when the
6611   element types don't implement `Drop`][1.5dv].
6612 * A bug that caused in incorrect behavior when [combining `VecDeque`
6613   with zero-sized types][1.5vdz] was resolved.
6614 * [`PartialOrd` for slices is faster][1.5po].
6615
6616 Miscellaneous
6617 -------------
6618
6619 * [Crate metadata size was reduced by 20%][1.5md].
6620 * [Improvements to code generation reduced the size of libcore by 3.3
6621   MB and rustc's memory usage by 18MB][1.5m].
6622 * [Improvements to deref translation increased performance in
6623   unoptimized builds][1.5dr].
6624 * Various errors in trait resolution [are deduplicated to only be
6625   reported once][1.5te].
6626 * Rust has preliminary [support for rumprun kernels][1.5rr].
6627 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6628
6629 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6630 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6631 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6632 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6633 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6634 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6635 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6636 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6637 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6638 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6639 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6640 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6641 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6642 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6643 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6644 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6645 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6646 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6647 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6648 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6649 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6650 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6651 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6652 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6653 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6654 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6655 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6656 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6657 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6658 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6659 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6660 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6661 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6662 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6663 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6664 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6665 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6666 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6667 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6668 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6669 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6670 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6671 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6672 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6673 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6674 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6675 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6676 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6677 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6678 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6679 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6680 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6681 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6682 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6683 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6684 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6685 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6686 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6687 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6688 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6689 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6690 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6691 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6692 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6693 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6694 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6695 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6696 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6697 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6698 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6699 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6700 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6701 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6702 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6703 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6704 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6705 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6706 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6707 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6708 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6709 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6710 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6711 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6712 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6713 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6714 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6715 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6716 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6717 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6718
6719 Version 1.4.0 (2015-10-29)
6720 ==========================
6721
6722 * ~1200 changes, numerous bugfixes
6723
6724 Highlights
6725 ----------
6726
6727 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6728   GNU) are now supported and recommended for use.
6729
6730 Breaking Changes
6731 ----------------
6732
6733 * [Several changes have been made to fix type soundness and improve
6734   the behavior of associated types][sound]. See [RFC 1214]. Although
6735   we have mostly introduced these changes as warnings this release, to
6736   become errors next release, there are still some scenarios that will
6737   see immediate breakage.
6738 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6739   line breaks in addition to `\n`][crlf].
6740 * [Loans of `'static` lifetime extend to the end of a function][stat].
6741 * [`str::parse` no longer introduces avoidable rounding error when
6742   parsing floating point numbers. Together with earlier changes to
6743   float formatting/output, "round trips" like f.to_string().parse()
6744   now preserve the value of f exactly. Additionally, leading plus
6745   signs are now accepted][fp3].
6746
6747
6748 Language
6749 --------
6750
6751 * `use` statements that import multiple items [can now rename
6752   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6753 * [Binops work correctly on fat pointers][binfat].
6754 * `pub extern crate`, which does not behave as expected, [issues a
6755   warning][pec] until a better solution is found.
6756
6757 Libraries
6758 ---------
6759
6760 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6761   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6762   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6763   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6764   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6765   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6766   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6767   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6768   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6769   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6770   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6771   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6772   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6773   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6774   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6775   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6776   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6777   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6778   [`thread::sleep`].
6779 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6780   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6781   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6782   `f64::from_str_radix`.
6783 * [Reverse-searching strings is faster with the 'two-way'
6784   algorithm][s].
6785 * [`std::io::copy` allows `?Sized` arguments][cc].
6786 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6787   [override `count`, `nth` and `last` with an O(1)
6788   implementation][it].
6789 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6790 * [`IntoRawFd` has been added to the Unix-specific prelude,
6791   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6792   prelude][pr].
6793 * [`Extend<String>` and `FromIterator<String` are both implemented for
6794   `String`][es].
6795 * [`IntoIterator` is implemented for references to `Option` and
6796   `Result`][into2].
6797 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6798   Copy`][ext] as part of [RFC 839]. This will cause type inference
6799   breakage in rare situations.
6800 * [`BinaryHeap` implements `Debug`][bh2].
6801 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6802   arrays][bm].
6803 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6804   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6805 * [String comparison is faster][faststr].
6806 * `&mut T` where `T: std::fmt::Write` [also implements
6807   `std::fmt::Write`][mutw].
6808 * [A stable regression in `VecDeque::push_back` and other
6809   capacity-altering methods that caused panics for zero-sized types
6810   was fixed][vd].
6811 * [Function pointers implement traits for up to 12 parameters][fp2].
6812
6813 Miscellaneous
6814 -------------
6815
6816 * The compiler [no longer uses the 'morestack' feature to prevent
6817   stack overflow][mm]. Instead it uses guard pages and stack
6818   probes (though stack probes are not yet implemented on any platform
6819   but Windows).
6820 * [The compiler matches traits faster when projections are involved][p].
6821 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6822   `usize`][ffi].
6823 * [Cargo now displays useful information about what its doing during
6824   `cargo update`][cu].
6825
6826 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6827 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6828 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6829 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6830 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6831 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6832 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6833 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6834 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6835 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6836 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6837 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6838 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6839 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6840 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6841 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6842 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6843 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6844 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6845 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6846 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6847 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6848 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6849 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6850 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6851 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6852 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6853 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6854 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6855 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6856 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6857 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6858 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6859 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6860 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6861 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6862 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6863 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6864 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6865 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6866 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6867 [bh2]: https://github.com/rust-lang/rust/pull/28156
6868 [binfat]: https://github.com/rust-lang/rust/pull/28270
6869 [bm]: https://github.com/rust-lang/rust/pull/28197
6870 [cc]: https://github.com/rust-lang/rust/pull/27531
6871 [crlf]: https://github.com/rust-lang/rust/pull/28034
6872 [cu]: https://github.com/rust-lang/cargo/pull/1931
6873 [d]: https://github.com/rust-lang/rust/pull/27825
6874 [dep]: https://github.com/rust-lang/rust/pull/28339
6875 [es]: https://github.com/rust-lang/rust/pull/27956
6876 [ext]: https://github.com/rust-lang/rust/pull/28094
6877 [faststr]: https://github.com/rust-lang/rust/pull/28338
6878 [ffi]: https://github.com/rust-lang/rust/pull/28779
6879 [fp]: https://github.com/rust-lang/rust/pull/28268
6880 [fp2]: https://github.com/rust-lang/rust/pull/28560
6881 [fp3]: https://github.com/rust-lang/rust/pull/27307
6882 [i]: https://github.com/rust-lang/rust/pull/27451
6883 [into2]: https://github.com/rust-lang/rust/pull/28039
6884 [it]: https://github.com/rust-lang/rust/pull/27652
6885 [mm]: https://github.com/rust-lang/rust/pull/27338
6886 [mutw]: https://github.com/rust-lang/rust/pull/28368
6887 [sound]: https://github.com/rust-lang/rust/pull/27641
6888 [p]: https://github.com/rust-lang/rust/pull/27866
6889 [pec]: https://github.com/rust-lang/rust/pull/28486
6890 [pr]: https://github.com/rust-lang/rust/pull/27896
6891 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6892 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6893 [s]: https://github.com/rust-lang/rust/pull/27474
6894 [stab]: https://github.com/rust-lang/rust/pull/28339
6895 [stat]: https://github.com/rust-lang/rust/pull/28321
6896 [vd]: https://github.com/rust-lang/rust/pull/28494
6897
6898 Version 1.3.0 (2015-09-17)
6899 ==============================
6900
6901 * ~900 changes, numerous bugfixes
6902
6903 Highlights
6904 ----------
6905
6906 * The [new object lifetime defaults][nold] have been [turned
6907   on][nold2] after a cycle of warnings about the change. Now types
6908   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6909   being interpreted as `&'a Box<Trait+'a>` to `&'a
6910   Box<Trait+'static>`.
6911 * [The Rustonomicon][nom] is a new book in the official documentation
6912   that dives into writing unsafe Rust.
6913 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6914   timekeeping is employed by other std APIs, as well as out-of-tree
6915   time crates.
6916
6917 Breaking Changes
6918 ----------------
6919
6920 * The [new object lifetime defaults][nold] have been [turned
6921   on][nold2] after a cycle of warnings about the change.
6922 * There is a known [regression][lr] in how object lifetime elision is
6923   interpreted, the proper solution for which is undetermined.
6924 * The `#[prelude_import]` attribute, an internal implementation
6925   detail, was accidentally stabilized previously. [It has been put
6926   behind the `prelude_import` feature gate][pi]. This change is
6927   believed to break no existing code.
6928 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6929   [more sane for dynamically sized types][dst3]. Code that relied on
6930   the previous behavior is thought to be broken.
6931 * The `dropck` rules, which checks that destructors can't access
6932   destroyed values, [have been updated][dropck] to match the
6933   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6934   cause some previously-compiling code to no longer build.
6935
6936 Language
6937 --------
6938
6939 * The [new object lifetime defaults][nold] have been [turned
6940   on][nold2] after a cycle of warnings about the change.
6941 * Semicolons may [now follow types and paths in
6942   macros](https://github.com/rust-lang/rust/pull/27000).
6943 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6944   [more sane for dynamically sized types][dst3]. Code that relied on
6945   the previous behavior is not known to exist, and suspected to be
6946   broken.
6947 * `'static` variables [may now be recursive][st].
6948 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6949   implementations correctly.
6950 * The `dropck` rules, which checks that destructors can't access
6951   destroyed values, [have been updated][dropck] to match the
6952   [RFC][dropckrfc].
6953
6954 Libraries
6955 ---------
6956
6957 * The [`Duration`] API, [has been stabilized][ds], as well as the
6958   `std::time` module, which presently contains only `Duration`.
6959 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6960 * The owned C string, [`CString`], implements [`Borrow`] and the
6961   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6962   these allow C strings to be borrowed and cloned in generic code.
6963 * [`CStr`] implements [`Debug`].
6964 * [`AtomicPtr`] implements [`Debug`].
6965 * [`Error`] trait objects [can be downcast to their concrete types][e]
6966   in many common configurations, using the [`is`], [`downcast`],
6967   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6968   [`Any`] trait.
6969 * Searching for substrings now [employs the two-way algorithm][search]
6970   instead of doing a naive search. This gives major speedups to a
6971   number of methods, including [`contains`][sc], [`find`][sf],
6972   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6973   [`ends_with`][sew] are also faster.
6974 * The performance of `PartialEq` for slices is [much faster][ps].
6975 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6976   is overridden and optimized by the implementations for scalars.
6977 * The [`Hasher`] trait now has a number of specialized `write_*`
6978   methods for primitive types, for efficiency.
6979 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6980   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6981   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6982   of [`std::error::Error::cause`][iec] also delegates to the inner
6983   error.
6984 * [`process::Child`][pc] gained the [`id`] method, which returns a
6985   `u32` representing the platform-specific process identifier.
6986 * The [`connect`] method on slices is deprecated, replaced by the new
6987   [`join`] method (note that both of these are on the *unstable*
6988   [`SliceConcatExt`] trait, but through the magic of the prelude are
6989   available to stable code anyway).
6990 * The [`Div`] operator is implemented for [`Wrapping`] types.
6991 * [`DerefMut` is implemented for `String`][dms].
6992 * Performance of SipHash (the default hasher for `HashMap`) is
6993   [better for long data][sh].
6994 * [`AtomicPtr`] implements [`Send`].
6995 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6996   are now [specialized to use uninitialized buffers for increased
6997   performance][rte].
6998 * Lifetime parameters of foreign functions [are now resolved
6999   properly][f].
7000
7001 Misc
7002 ----
7003
7004 * Rust can now, with some coercion, [produce programs that run on
7005   Windows XP][xp], though XP is not considered a supported platform.
7006 * Porting Rust on Windows from the GNU toolchain to MSVC continues
7007   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
7008   recommended for use in 1.3, though should be fully-functional
7009   in the [64-bit 1.4 beta][b14].
7010 * On Fedora-based systems installation will [properly configure the
7011   dynamic linker][fl].
7012 * The compiler gained many new extended error descriptions, which can
7013   be accessed with the `--explain` flag.
7014 * The `dropck` pass, which checks that destructors can't access
7015   destroyed values, [has been rewritten][dropck]. This fixes some
7016   soundness holes, and as such will cause some previously-compiling
7017   code to no longer build.
7018 * `rustc` now uses [LLVM to write archive files where possible][ar].
7019   Eventually this will eliminate the compiler's dependency on the ar
7020   utility.
7021 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7022   supported FreeBSD on x86_64).
7023 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7024   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7025   more strict.
7026 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7027   will kill the process instead of leaking][nlp].
7028
7029 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7030 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7031 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7032 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7033 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7034 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7035 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7036 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7037 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7038 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7039 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7040 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7041 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7042 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7043 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7044 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7045 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7046 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7047 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7048 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7049 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7050 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7051 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7052 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7053 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7054 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7055 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7056 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7057 [ar]: https://github.com/rust-lang/rust/pull/26926
7058 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7059 [dms]: https://github.com/rust-lang/rust/pull/26241
7060 [dropck]: https://github.com/rust-lang/rust/pull/27261
7061 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7062 [ds]: https://github.com/rust-lang/rust/pull/26818
7063 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7064 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7065 [dst3]: https://github.com/rust-lang/rust/pull/27351
7066 [e]: https://github.com/rust-lang/rust/pull/24793
7067 [f]: https://github.com/rust-lang/rust/pull/26588
7068 [fb]: https://github.com/rust-lang/rust/pull/26959
7069 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7070 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7071 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7072 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7073 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7074 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7075 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7076 [lic]: https://github.com/rust-lang/rust/pull/26583
7077 [lnu]: https://github.com/rust-lang/rust/pull/27026
7078 [lr]: https://github.com/rust-lang/rust/issues/27248
7079 [lum]: https://github.com/rust-lang/rust/pull/26378
7080 [lur]: https://github.com/rust-lang/rust/pull/26783
7081 [nlp]: https://github.com/rust-lang/rust/pull/27176
7082 [nold2]: https://github.com/rust-lang/rust/pull/27045
7083 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7084 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7085 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7086 [pi]: https://github.com/rust-lang/rust/pull/26699
7087 [ps]: https://github.com/rust-lang/rust/pull/26884
7088 [rte]: https://github.com/rust-lang/rust/pull/26950
7089 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7090 [search]: https://github.com/rust-lang/rust/pull/26327
7091 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7092 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7093 [sh]: https://github.com/rust-lang/rust/pull/27280
7094 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7095 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7096 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7097 [st]: https://github.com/rust-lang/rust/pull/26630
7098 [win1]: https://github.com/rust-lang/rust/pull/26569
7099 [win2]: https://github.com/rust-lang/rust/pull/26741
7100 [win3]: https://github.com/rust-lang/rust/pull/26741
7101 [win4]: https://github.com/rust-lang/rust/pull/27210
7102 [xp]: https://github.com/rust-lang/rust/pull/26569
7103
7104 Version 1.2.0 (2015-08-07)
7105 ==========================
7106
7107 * ~1200 changes, numerous bugfixes
7108
7109 Highlights
7110 ----------
7111
7112 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7113   like `Rc` to contain types without a fixed size, arrays and trait
7114   objects, finally enabling use of `Rc<[T]>` and completing the
7115   implementation of DST.
7116 * [Parallel codegen][parcodegen] is now working again, which can
7117   substantially speed up large builds in debug mode; It also gets
7118   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7119   jobs). It's not enabled by default, but will be "in the near
7120   future". It can be activated with the `-C codegen-units=N` flag to
7121   `rustc`.
7122 * This is the first release with [experimental support for linking
7123   with the MSVC linker and lib C on Windows (instead of using the GNU
7124   variants via MinGW)][win]. It is yet recommended only for the most
7125   intrepid Rustaceans.
7126 * Benchmark compilations are showing a 30% improvement in
7127   bootstrapping over 1.1.
7128
7129 Breaking Changes
7130 ----------------
7131
7132 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7133   unicode case mapping, which is a previously-planned change in
7134   behavior and considered a bugfix.
7135 * [`mem::align_of`] now specifies [the *minimum alignment* for
7136   T][align], which is usually the alignment programs are interested
7137   in, and the same value reported by clang's
7138   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7139   break real code.
7140 * [The `#[packed]` attribute is no longer silently accepted by the
7141   compiler][packed]. This attribute did nothing and code that
7142   mentioned it likely did not work as intended.
7143 * Associated type defaults are [now behind the
7144   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7145   defaults *did not work*, but could be mentioned syntactically. As
7146   such this breakage has minimal impact.
7147
7148 Language
7149 --------
7150
7151 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7152   matching against dereferenceable values.
7153
7154 Libraries
7155 ---------
7156
7157 * The [`Extend`] trait, which grows a collection from an iterator, is
7158   implemented over iterators of references, for `String`, `Vec`,
7159   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7160   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7161 * The [`iter::once`] function returns an iterator that yields a single
7162   element, and [`iter::empty`] returns an iterator that yields no
7163   elements.
7164 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7165   over substring matches.
7166 * [`Cell`] and [`RefCell`] both implement `Eq`.
7167 * A number of methods for wrapping arithmetic are added to the
7168   integral types, [`wrapping_div`], [`wrapping_rem`],
7169   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7170   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7171   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7172   type.. It is illegal for the default arithmetic operations in Rust
7173   to overflow; the desire to wrap must be explicit.
7174 * The `{:#?}` formatting specifier [displays the alternate,
7175   pretty-printed][debugfmt] form of the `Debug` formatter. This
7176   feature was actually introduced prior to 1.0 with little
7177   fanfare.
7178 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7179   for writing data to formatted strings, similar to [`io::Write`].
7180 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7181   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7182   are used by code generators to emit implementations of [`Debug`].
7183 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7184   methods that convert case, following Unicode case mapping.
7185 * It is now easier to handle poisoned locks. The [`PoisonError`]
7186   type, returned by failing lock operations, exposes `into_inner`,
7187   `get_ref`, and `get_mut`, which all give access to the inner lock
7188   guard, and allow the poisoned lock to continue to operate. The
7189   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7190   poisoned lock without attempting to take the lock.
7191 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7192   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7193   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7194   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7195   `ChildStderr`.
7196 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7197   malformed input.
7198
7199 Misc
7200 ----
7201
7202 * `rustc` employs smarter heuristics for guessing at [typos].
7203 * `rustc` emits more efficient code for [no-op conversions between
7204   unsafe pointers][nop].
7205 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7206   resulting in faster compile times and smaller code.
7207
7208 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7209 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7210 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7211 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7212 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7213 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7214 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7215 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7216 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7217 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7218 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7219 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7220 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7221 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7222 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7223 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7224 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7225 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7226 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7227 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7228 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7229 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7230 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7231 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7232 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7233 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7234 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7235 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7236 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7237 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7238 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7239 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7240 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7241 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7242 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7243 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7244 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7245 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7246 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7247 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7248 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7249 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7250 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7251 [align]: https://github.com/rust-lang/rust/pull/25646
7252 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7253 [typos]: https://github.com/rust-lang/rust/pull/26087
7254 [nop]: https://github.com/rust-lang/rust/pull/26336
7255 [fat]: https://github.com/rust-lang/rust/pull/26411
7256 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7257 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7258 [packed]: https://github.com/rust-lang/rust/pull/25541
7259 [ad]: https://github.com/rust-lang/rust/pull/27382
7260 [win]: https://github.com/rust-lang/rust/pull/25350
7261
7262 Version 1.1.0 (2015-06-25)
7263 =========================
7264
7265 * ~850 changes, numerous bugfixes
7266
7267 Highlights
7268 ----------
7269
7270 * The [`std::fs` module has been expanded][fs] to expand the set of
7271   functionality exposed:
7272   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7273     don't incur a syscall on some platforms.
7274   * A `symlink_metadata` function has been added.
7275   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7276     access to all underlying information.
7277 * The compiler now contains extended explanations of many errors. When an error
7278   with an explanation occurs the compiler suggests using the `--explain` flag
7279   to read the explanation. Error explanations are also [available online][err-index].
7280 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7281   well as other work, the time to bootstrap the compiler decreased by
7282   32%.
7283
7284 Libraries
7285 ---------
7286
7287 * The [`str::split_whitespace`] method splits a string on unicode
7288   whitespace boundaries.
7289 * On both Windows and Unix, new extension traits provide conversion of
7290   I/O types to and from the underlying system handles. On Unix, these
7291   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7292   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7293   `TcpListener`, and `UpdSocket`. Further implementations for
7294   `std::process` will be stabilized later.
7295 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7296   Windows, symlinks can be created with
7297   `std::os::windows::symlink_dir` and
7298   `std::os::windows::symlink_file`.
7299 * The `mpsc::Receiver` type can now be converted into an iterator with
7300   `into_iter` on the [`IntoIterator`] trait.
7301 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7302   implementation of the [`From`] trait.
7303 * The `Debug` implementation for `RangeFull` [creates output that is
7304   more consistent with other implementations][rf].
7305 * [`Debug` is implemented for `File`][file].
7306 * The `Default` implementation for `Arc` [no longer requires `Sync +
7307   Send`][arc].
7308 * [The `Iterator` methods `count`, `nth`, and `last` have been
7309   overridden for slices to have O(1) performance instead of O(n)][si].
7310 * Incorrect handling of paths on Windows has been improved in both the
7311   compiler and the standard library.
7312 * [`AtomicPtr` gained a `Default` implementation][ap].
7313 * In accordance with Rust's policy on arithmetic overflow `abs` now
7314   [panics on overflow when debug assertions are enabled][abs].
7315 * The [`Cloned`] iterator, which was accidentally left unstable for
7316   1.0 [has been stabilized][c].
7317 * The [`Incoming`] iterator, which iterates over incoming TCP
7318   connections, and which was accidentally unnamable in 1.0, [is now
7319   properly exported][inc].
7320 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7321   `sift_up` or `sift_down` panic][bh].
7322 * The [`split_off`] method of `LinkedList` [no longer corrupts
7323   the list in certain scenarios][ll].
7324
7325 Misc
7326 ----
7327
7328 * Type checking performance [has improved notably][sk] with
7329   [multiple improvements][pre].
7330 * The compiler [suggests code changes][ch] for more errors.
7331 * rustc and it's build system have experimental support for [building
7332   toolchains against MUSL][m] instead of glibc on Linux.
7333 * The compiler defines the `target_env` cfg value, which is used for
7334   distinguishing toolchains that are otherwise for the same
7335   platform. Presently this is set to `gnu` for common GNU Linux
7336   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7337 * The [`cargo rustc`][crc] command invokes a build with custom flags
7338   to rustc.
7339 * [Android executables are always position independent][pie].
7340 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7341   with `Drop`][drop].
7342
7343 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7344 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7345 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7346 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7347 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7348 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7349 [rf]: https://github.com/rust-lang/rust/pull/24491
7350 [err-index]: https://doc.rust-lang.org/error-index.html
7351 [sk]: https://github.com/rust-lang/rust/pull/24615
7352 [pre]: https://github.com/rust-lang/rust/pull/25323
7353 [file]: https://github.com/rust-lang/rust/pull/24598
7354 [ch]: https://github.com/rust-lang/rust/pull/24683
7355 [arc]: https://github.com/rust-lang/rust/pull/24695
7356 [si]: https://github.com/rust-lang/rust/pull/24701
7357 [ap]: https://github.com/rust-lang/rust/pull/24834
7358 [m]: https://github.com/rust-lang/rust/pull/24777
7359 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7360 [crc]: https://github.com/rust-lang/cargo/pull/1568
7361 [pie]: https://github.com/rust-lang/rust/pull/24953
7362 [abs]: https://github.com/rust-lang/rust/pull/25441
7363 [c]: https://github.com/rust-lang/rust/pull/25496
7364 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7365 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7366 [inc]: https://github.com/rust-lang/rust/pull/25522
7367 [bh]: https://github.com/rust-lang/rust/pull/25856
7368 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7369 [ll]: https://github.com/rust-lang/rust/pull/26022
7370 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7371 [drop]: https://github.com/rust-lang/rust/pull/24935
7372
7373 Version 1.0.0 (2015-05-15)
7374 ========================
7375
7376 * ~1500 changes, numerous bugfixes
7377
7378 Highlights
7379 ----------
7380
7381 * The vast majority of the standard library is now `#[stable]`. It is
7382   no longer possible to use unstable features with a stable build of
7383   the compiler.
7384 * Many popular crates on [crates.io] now work on the stable release
7385   channel.
7386 * Arithmetic on basic integer types now [checks for overflow in debug
7387   builds][overflow].
7388
7389 Language
7390 --------
7391
7392 * Several [restrictions have been added to trait coherence][coh] in
7393   order to make it easier for upstream authors to change traits
7394   without breaking downstream code.
7395 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7396   improve error messages and macro behavior. For example, `0b1234` is
7397   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7398 * Trait bounds [are always invariant][inv], eliminating the need for
7399   the `PhantomFn` and `MarkerTrait` lang items, which have been
7400   removed.
7401 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7402   "foo" as bar` syntax has been replaced with `extern crate foo as
7403   bar`, and Cargo now automatically translates "-" in *package* names
7404   to underscore for the crate name.
7405 * [Lifetime shadowing is an error][lt].
7406 * [`Send` no longer implies `'static`][send-rfc].
7407 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7408   `MyType::default()`.
7409 * Primitive types [now have inherent methods][prim-inherent],
7410   obviating the need for extension traits like `SliceExt`.
7411 * Methods with `Self: Sized` in their `where` clause are [considered
7412   object-safe][self-sized], allowing many extension traits like
7413   `IteratorExt` to be merged into the traits they extended.
7414 * You can now [refer to associated types][assoc-where] whose
7415   corresponding trait bounds appear only in a `where` clause.
7416 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7417   like `Send` and `Sync` are now library-defined.
7418 * A [Reflect trait][reflect] was introduced, which means that
7419   downcasting via the `Any` trait is effectively limited to concrete
7420   types. This helps retain the potentially-important "parametricity"
7421   property: generic code cannot behave differently for different type
7422   arguments except in minor ways.
7423 * The `unsafe_destructor` feature is now deprecated in favor of the
7424   [new `dropck`][dropck]. This change is a major reduction in unsafe
7425   code.
7426
7427 Libraries
7428 ---------
7429
7430 * The `thread_local` module [has been renamed to `std::thread`][th].
7431 * The methods of `IteratorExt` [have been moved to the `Iterator`
7432   trait itself][ie].
7433 * Several traits that implement Rust's conventions for type
7434   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7435   [centralized in the `std::convert` module][con].
7436 * The `FromError` trait [was removed in favor of `From`][fe].
7437 * The basic sleep function [has moved to
7438   `std::thread::sleep_ms`][slp].
7439 * The `splitn` function now takes an `n` parameter that represents the
7440   number of items yielded by the returned iterator [instead of the
7441   number of 'splits'][spl].
7442 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7443 * [Derived implementations of `PartialOrd` now order enums according
7444   to their explicitly-assigned discriminants][po].
7445 * [Methods for searching strings are generic over `Pattern`s][pat],
7446   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7447   some others.
7448 * [In method resolution, object methods are resolved before inherent
7449   methods][meth].
7450 * [`String::from_str` has been deprecated in favor of the `From` impl,
7451   `String::from`][sf].
7452 * [`io::Error` implements `Sync`][ios].
7453 * [The `words` method on `&str` has been replaced with
7454   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7455   a word?'
7456 * The new path and IO modules are complete and `#[stable]`. This
7457   was the major library focus for this cycle.
7458 * The path API was [revised][path-normalize] to normalize `.`,
7459   adjusting the tradeoffs in favor of the most common usage.
7460 * A large number of remaining APIs in `std` were also stabilized
7461   during this cycle; about 75% of the non-deprecated API surface
7462   is now stable.
7463 * The new [string pattern API][string-pattern] landed, which makes
7464   the string slice API much more internally consistent and flexible.
7465 * A new set of [generic conversion traits][conversion] replaced
7466   many existing ad hoc traits.
7467 * Generic numeric traits were [completely removed][num-traits]. This
7468   was made possible thanks to inherent methods for primitive types,
7469   and the removal gives maximal flexibility for designing a numeric
7470   hierarchy in the future.
7471 * The `Fn` traits are now related via [inheritance][fn-inherit]
7472   and provide ergonomic [blanket implementations][fn-blanket].
7473 * The `Index` and `IndexMut` traits were changed to
7474   [take the index by value][index-value], enabling code like
7475   `hash_map["string"]` to work.
7476 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7477   `Copy` data is known to be `Clone` as well.
7478
7479 Misc
7480 ----
7481
7482 * Many errors now have extended explanations that can be accessed with
7483   the `--explain` flag to `rustc`.
7484 * Many new examples have been added to the standard library
7485   documentation.
7486 * rustdoc has received a number of improvements focused on completion
7487   and polish.
7488 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7489 * Much headway was made on ecosystem-wide CI, making it possible
7490   to [compare builds for breakage][ci-compare].
7491
7492
7493 [crates.io]: http://crates.io
7494 [clo]: https://github.com/rust-lang/rust/pull/24034
7495 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7496 [con]: https://github.com/rust-lang/rust/pull/23875
7497 [cr]: https://github.com/rust-lang/rust/pull/23419
7498 [fe]: https://github.com/rust-lang/rust/pull/23879
7499 [ie]: https://github.com/rust-lang/rust/pull/23300
7500 [inv]: https://github.com/rust-lang/rust/pull/23938
7501 [ios]: https://github.com/rust-lang/rust/pull/24133
7502 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7503 [lt]: https://github.com/rust-lang/rust/pull/24057
7504 [meth]: https://github.com/rust-lang/rust/pull/24056
7505 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7506 [po]: https://github.com/rust-lang/rust/pull/24270
7507 [sf]: https://github.com/rust-lang/rust/pull/24517
7508 [slp]: https://github.com/rust-lang/rust/pull/23949
7509 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7510 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7511 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7512 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7513 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7514 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7515 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7516 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7517 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7518 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7519 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7520 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7521 [reflect]: https://github.com/rust-lang/rust/pull/23712
7522 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7523 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7524 [index-value]: https://github.com/rust-lang/rust/pull/23601
7525 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7526 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7527 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7528 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7529 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7530 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7531
7532
7533 Version 1.0.0-alpha.2 (2015-02-20)
7534 =====================================
7535
7536 * ~1300 changes, numerous bugfixes
7537
7538 * Highlights
7539
7540     * The various I/O modules were [overhauled][io-rfc] to reduce
7541       unnecessary abstractions and provide better interoperation with
7542       the underlying platform. The old `io` module remains temporarily
7543       at `std::old_io`.
7544     * The standard library now [participates in feature gating][feat],
7545       so use of unstable libraries now requires a `#![feature(...)]`
7546       attribute. The impact of this change is [described on the
7547       forum][feat-forum]. [RFC][feat-rfc].
7548
7549 * Language
7550
7551     * `for` loops [now operate on the `IntoIterator` trait][into],
7552       which eliminates the need to call `.iter()`, etc. to iterate
7553       over collections. There are some new subtleties to remember
7554       though regarding what sort of iterators various types yield, in
7555       particular that `for foo in bar { }` yields values from a move
7556       iterator, destroying the original collection. [RFC][into-rfc].
7557     * Objects now have [default lifetime bounds][obj], so you don't
7558       have to write `Box<Trait+'static>` when you don't care about
7559       storing references. [RFC][obj-rfc].
7560     * In types that implement `Drop`, [lifetimes must outlive the
7561       value][drop]. This will soon make it possible to safely
7562       implement `Drop` for types where `#[unsafe_destructor]` is now
7563       required. Read the [gorgeous RFC][drop-rfc] for details.
7564     * The fully qualified <T as Trait>::X syntax lets you set the Self
7565       type for a trait method or associated type. [RFC][ufcs-rfc].
7566     * References to types that implement `Deref<U>` now [automatically
7567       coerce to references][deref] to the dereferenced type `U`,
7568       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7569       should eliminate many unsightly uses of `&*`, as when converting
7570       from references to vectors into references to
7571       slices. [RFC][deref-rfc].
7572     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7573       `|:|`) is obsolete and closure kind is inferred from context.
7574     * [`Self` is a keyword][Self].
7575
7576 * Libraries
7577
7578     * The `Show` and `String` formatting traits [have been
7579       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7580       their related purposes. Automatically getting a string
7581       conversion to use with `format!("{:?}", something_to_debug)` is
7582       now written `#[derive(Debug)]`.
7583     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7584       OsStr}`, provide strings in platform-specific encodings for easier
7585       interop with system APIs. [RFC][osstr-rfc].
7586     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7587       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7588       creating raw pointers.
7589
7590 * Tooling
7591
7592     * Certain long error messages of the form 'expected foo found bar'
7593       are now [split neatly across multiple
7594       lines][multiline]. Examples in the PR.
7595     * On Unix Rust can be [uninstalled][un] by running
7596       `/usr/local/lib/rustlib/uninstall.sh`.
7597     * The `#[rustc_on_unimplemented]` attribute, requiring the
7598       'on_unimplemented' feature, lets rustc [display custom error
7599       messages when a trait is expected to be implemented for a type
7600       but is not][onun].
7601
7602 * Misc
7603
7604     * Rust is tested against a [LALR grammar][lalr], which parses
7605       almost all the Rust files that rustc does.
7606
7607 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7608 [close]: https://github.com/rust-lang/rust/pull/21843
7609 [deref]: https://github.com/rust-lang/rust/pull/21351
7610 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7611 [drop]: https://github.com/rust-lang/rust/pull/21972
7612 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7613 [feat]: https://github.com/rust-lang/rust/pull/21248
7614 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7615 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7616 [fmt]: https://github.com/rust-lang/rust/pull/21457
7617 [into]: https://github.com/rust-lang/rust/pull/20790
7618 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7619 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7620 [lalr]: https://github.com/rust-lang/rust/pull/21452
7621 [multiline]: https://github.com/rust-lang/rust/pull/19870
7622 [obj]: https://github.com/rust-lang/rust/pull/22230
7623 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7624 [onun]: https://github.com/rust-lang/rust/pull/20889
7625 [osstr]: https://github.com/rust-lang/rust/pull/21488
7626 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7627 [Self]: https://github.com/rust-lang/rust/pull/22158
7628 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7629 [un]: https://github.com/rust-lang/rust/pull/22256
7630
7631
7632 Version 1.0.0-alpha (2015-01-09)
7633 ==================================
7634
7635   * ~2400 changes, numerous bugfixes
7636
7637   * Highlights
7638
7639     * The language itself is considered feature complete for 1.0,
7640       though there will be many usability improvements and bugfixes
7641       before the final release.
7642     * Nearly 50% of the public API surface of the standard library has
7643       been declared 'stable'. Those interfaces are unlikely to change
7644       before 1.0.
7645     * The long-running debate over integer types has been
7646       [settled][ints]: Rust will ship with types named `isize` and
7647       `usize`, rather than `int` and `uint`, for pointer-sized
7648       integers. Guidelines will be rolled out during the alpha cycle.
7649     * Most crates that are not `std` have been moved out of the Rust
7650       distribution into the Cargo ecosystem so they can evolve
7651       separately and don't need to be stabilized as quickly, including
7652       'time', 'getopts', 'num', 'regex', and 'term'.
7653     * Documentation continues to be expanded with more API coverage, more
7654       examples, and more in-depth explanations. The guides have been
7655       consolidated into [The Rust Programming Language][trpl].
7656     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7657     * All official Rust binary installers now come with [Cargo], the
7658       Rust package manager.
7659
7660 * Language
7661
7662     * Closures have been [completely redesigned][unboxed] to be
7663       implemented in terms of traits, can now be used as generic type
7664       bounds and thus monomorphized and inlined, or via an opaque
7665       pointer (boxed) as in the old system. The new system is often
7666       referred to as 'unboxed' closures.
7667     * Traits now support [associated types][assoc], allowing families
7668       of related types to be defined together and used generically in
7669       powerful ways.
7670     * Enum variants are [namespaced by their type names][enum].
7671     * [`where` clauses][where] provide a more versatile and attractive
7672       syntax for specifying generic bounds, though the previous syntax
7673       remains valid.
7674     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7675       numeric types.
7676     * Rust [no longer has a runtime][rt] of any description, and only
7677       supports OS threads, not green threads.
7678     * At long last, Rust has been overhauled for 'dynamically-sized
7679       types' ([DST]), which integrates 'fat pointers' (object types,
7680       arrays, and `str`) more deeply into the type system, making it
7681       more consistent.
7682     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7683       `..j` that produce range types and which, when combined with the
7684       `Index` operator and multidispatch, leads to a convenient slice
7685       notation, `[i..j]`.
7686     * The new range syntax revealed an ambiguity in the fixed-length
7687       array syntax, so now fixed length arrays [are written `[T;
7688       N]`][arrays].
7689     * The `Copy` trait is no longer implemented automatically. Unsafe
7690       pointers no longer implement `Sync` and `Send` so types
7691       containing them don't automatically either. `Sync` and `Send`
7692       are now 'unsafe traits' so one can "forcibly" implement them via
7693       `unsafe impl` if a type confirms to the requirements for them
7694       even though the internals do not (e.g. structs containing unsafe
7695       pointers like `Arc`). These changes are intended to prevent some
7696       footguns and are collectively known as [opt-in built-in
7697       traits][oibit] (though `Sync` and `Send` will soon become pure
7698       library types unknown to the compiler).
7699     * Operator traits now take their operands [by value][ops], and
7700       comparison traits can use multidispatch to compare one type
7701       against multiple other types, allowing e.g. `String` to be
7702       compared with `&str`.
7703     * `if let` and `while let` are no longer feature-gated.
7704     * Rust has adopted a more [uniform syntax for escaping unicode
7705       characters][unicode].
7706     * `macro_rules!` [has been declared stable][mac]. Though it is a
7707       flawed system it is sufficiently popular that it must be usable
7708       for 1.0. Effort has gone into [future-proofing][mac-future] it
7709       in ways that will allow other macro systems to be developed in
7710       parallel, and won't otherwise impact the evolution of the
7711       language.
7712     * The prelude has been [pared back significantly][prelude] such
7713       that it is the minimum necessary to support the most pervasive
7714       code patterns, and through [generalized where clauses][where]
7715       many of the prelude extension traits have been consolidated.
7716     * Rust's rudimentary reflection [has been removed][refl], as it
7717       incurred too much code generation for little benefit.
7718     * [Struct variants][structvars] are no longer feature-gated.
7719     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7720       known as 'higher-ranked trait bounds', this crucially allows
7721       unboxed closures to work.
7722     * Macros invocations surrounded by parens or square brackets and
7723       not terminated by a semicolon are [parsed as
7724       expressions][macros], which makes expressions like `vec![1i32,
7725       2, 3].len()` work as expected.
7726     * Trait objects now implement their traits automatically, and
7727       traits that can be coerced to objects now must be [object
7728       safe][objsafe].
7729     * Automatically deriving traits is now done with `#[derive(...)]`
7730       not `#[deriving(...)]` for [consistency with other naming
7731       conventions][derive].
7732     * Importing the containing module or enum at the same time as
7733       items or variants they contain is [now done with `self` instead
7734       of `mod`][self], as in use `foo::{self, bar}`
7735     * Glob imports are no longer feature-gated.
7736     * The `box` operator and `box` patterns have been feature-gated
7737       pending a redesign. For now unique boxes should be allocated
7738       like other containers, with `Box::new`.
7739
7740 * Libraries
7741
7742     * A [series][coll1] of [efforts][coll2] to establish
7743       [conventions][coll3] for collections types has resulted in API
7744       improvements throughout the standard library.
7745     * New [APIs for error handling][err] provide ergonomic interop
7746       between error types, and [new conventions][err-conv] describe
7747       more clearly the recommended error handling strategies in Rust.
7748     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7749       it is easier to discuss failure in the context of error handling
7750       without making clarifications as to whether you are referring to
7751       the 'fail' macro or failure more generally.
7752     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7753       syscall when available.
7754     * The 'serialize' crate has been renamed 'rustc-serialize' and
7755       moved out of the distribution to Cargo. Although it is widely
7756       used now, it is expected to be superseded in the near future.
7757     * The `Show` formatter, typically implemented with
7758       `#[derive(Show)]` is [now requested with the `{:?}`
7759       specifier][show] and is intended for use by all types, for uses
7760       such as `println!` debugging. The new `String` formatter must be
7761       implemented by hand, uses the `{}` specifier, and is intended
7762       for full-fidelity conversions of things that can logically be
7763       represented as strings.
7764
7765 * Tooling
7766
7767     * [Flexible target specification][flex] allows rustc's code
7768       generation to be configured to support otherwise-unsupported
7769       platforms.
7770     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7771       respective debuggers with Rust-appropriate pretty-printing.
7772     * The Windows installation of Rust is distributed with the
7773       MinGW components currently required to link binaries on that
7774       platform.
7775
7776 * Misc
7777
7778     * Nullable enum optimizations have been extended to more types so
7779       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7780       space than the inner types themselves.
7781     * Work has begun on supporting AArch64.
7782
7783 [Cargo]: https://crates.io
7784 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7785 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7786 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7787 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7788 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7789 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7790 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7791 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7792 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7793 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7794 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7795 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7796 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7797 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7798 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7799 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7800 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7801 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7802 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7803 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7804 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7805 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7806 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7807 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7808 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7809 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7810 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7811 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7812 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7813 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7814 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7815 [trpl]: https://doc.rust-lang.org/book/index.html
7816 [rbe]: http://rustbyexample.com/
7817
7818
7819 Version 0.12.0 (2014-10-09)
7820 =============================
7821
7822   * ~1900 changes, numerous bugfixes
7823
7824   * Highlights
7825
7826     * The introductory documentation (now called The Rust Guide) has
7827       been completely rewritten, as have a number of supplementary
7828       guides.
7829     * Rust's package manager, Cargo, continues to improve and is
7830       sometimes considered to be quite awesome.
7831     * Many API's in `std` have been reviewed and updated for
7832       consistency with the in-development Rust coding
7833       guidelines. The standard library documentation tracks
7834       stabilization progress.
7835     * Minor libraries have been moved out-of-tree to the rust-lang org
7836       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7837       be installed with Cargo.
7838     * Lifetime elision allows lifetime annotations to be left off of
7839       function declarations in many common scenarios.
7840     * Rust now works on 64-bit Windows.
7841
7842   * Language
7843     * Indexing can be overloaded with the `Index` and `IndexMut`
7844       traits.
7845     * The `if let` construct takes a branch only if the `let` pattern
7846       matches, currently behind the 'if_let' feature gate.
7847     * 'where clauses', a more flexible syntax for specifying trait
7848       bounds that is more aesthetic, have been added for traits and
7849       free functions. Where clauses will in the future make it
7850       possible to constrain associated types, which would be
7851       impossible with the existing syntax.
7852     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7853       the 'slicing_syntax' feature gate, and can be overloaded with
7854       the `Slice` or `SliceMut` traits.
7855     * The syntax for matching of sub-slices has been changed to use a
7856       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7857       consistency with other uses of `..` and to future-proof
7858       potential additional uses of the syntax.
7859     * The syntax for matching inclusive ranges in patterns has changed
7860       from `0..3` to `0...4` to be consistent with the exclusive range
7861       syntax for slicing.
7862     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7863       c]`) has been put behind the 'advanced_slice_patterns' feature
7864       gate and may be removed in the future.
7865     * Components of tuples and tuple structs can be extracted using
7866       the `value.0` syntax, currently behind the `tuple_indexing`
7867       feature gate.
7868     * The `#[crate_id]` attribute is no longer supported; versioning
7869       is handled by the package manager.
7870     * Renaming crate imports are now written `extern crate foo as bar`
7871       instead of `extern crate bar = foo`.
7872     * Renaming use statements are now written `use foo as bar` instead
7873       of `use bar = foo`.
7874     * `let` and `match` bindings and argument names in macros are now
7875       hygienic.
7876     * The new, more efficient, closure types ('unboxed closures') have
7877       been added under a feature gate, 'unboxed_closures'. These will
7878       soon replace the existing closure types, once higher-ranked
7879       trait lifetimes are added to the language.
7880     * `move` has been added as a keyword, for indicating closures
7881       that capture by value.
7882     * Mutation and assignment is no longer allowed in pattern guards.
7883     * Generic structs and enums can now have trait bounds.
7884     * The `Share` trait is now called `Sync` to free up the term
7885       'shared' to refer to 'shared reference' (the default reference
7886       type.
7887     * Dynamically-sized types have been mostly implemented,
7888       unifying the behavior of fat-pointer types with the rest of the
7889       type system.
7890     * As part of dynamically-sized types, the `Sized` trait has been
7891       introduced, which qualifying types implement by default, and
7892       which type parameters expect by default. To specify that a type
7893       parameter does not need to be sized, write `<Sized? T>`. Most
7894       types are `Sized`, notable exceptions being unsized arrays
7895       (`[T]`) and trait types.
7896     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7897     * Lifetime bounds can now be applied to type parameters and object
7898       types.
7899     * The old, reference counted GC type, `Gc<T>` which was once
7900       denoted by the `@` sigil, has finally been removed. GC will be
7901       revisited in the future.
7902
7903   * Libraries
7904     * Library documentation has been improved for a number of modules.
7905     * Bit-vectors, collections::bitv has been modernized.
7906     * The url crate is deprecated in favor of
7907       http://github.com/servo/rust-url, which can be installed with
7908       Cargo.
7909     * Most I/O stream types can be cloned and subsequently closed from
7910       a different thread.
7911     * A `std::time::Duration` type has been added for use in I/O
7912       methods that rely on timers, as well as in the 'time' crate's
7913       `Timespec` arithmetic.
7914     * The runtime I/O abstraction layer that enabled the green thread
7915       scheduler to do non-thread-blocking I/O has been removed, along
7916       with the libuv-based implementation employed by the green thread
7917       scheduler. This will greatly simplify the future I/O work.
7918     * `collections::btree` has been rewritten to have a more
7919       idiomatic and efficient design.
7920
7921   * Tooling
7922     * rustdoc output now indicates the stability levels of API's.
7923     * The `--crate-name` flag can specify the name of the crate
7924       being compiled, like `#[crate_name]`.
7925     * The `-C metadata` specifies additional metadata to hash into
7926       symbol names, and `-C extra-filename` specifies additional
7927       information to put into the output filename, for use by the
7928       package manager for versioning.
7929     * debug info generation has continued to improve and should be
7930       more reliable under both gdb and lldb.
7931     * rustc has experimental support for compiling in parallel
7932       using the `-C codegen-units` flag.
7933     * rustc no longer encodes rpath information into binaries by
7934       default.
7935
7936   * Misc
7937     * Stack usage has been optimized with LLVM lifetime annotations.
7938     * Official Rust binaries on Linux are more compatible with older
7939       kernels and distributions, built on CentOS 5.10.
7940
7941
7942 Version 0.11.0 (2014-07-02)
7943 ==========================
7944
7945   * ~1700 changes, numerous bugfixes
7946
7947   * Language
7948     * ~[T] has been removed from the language. This type is superseded by
7949       the Vec<T> type.
7950     * ~str has been removed from the language. This type is superseded by
7951       the String type.
7952     * ~T has been removed from the language. This type is superseded by the
7953       Box<T> type.
7954     * @T has been removed from the language. This type is superseded by the
7955       standard library's std::gc::Gc<T> type.
7956     * Struct fields are now all private by default.
7957     * Vector indices and shift amounts are both required to be a `uint`
7958       instead of any integral type.
7959     * Byte character, byte string, and raw byte string literals are now all
7960       supported by prefixing the normal literal with a `b`.
7961     * Multiple ABIs are no longer allowed in an ABI string
7962     * The syntax for lifetimes on closures/procedures has been tweaked
7963       slightly: `<'a>|A, B|: 'b + K -> T`
7964     * Floating point modulus has been removed from the language; however it
7965       is still provided by a library implementation.
7966     * Private enum variants are now disallowed.
7967     * The `priv` keyword has been removed from the language.
7968     * A closure can no longer be invoked through a &-pointer.
7969     * The `use foo, bar, baz;` syntax has been removed from the language.
7970     * The transmute intrinsic no longer works on type parameters.
7971     * Statics now allow blocks/items in their definition.
7972     * Trait bounds are separated from objects with + instead of : now.
7973     * Objects can no longer be read while they are mutably borrowed.
7974     * The address of a static is now marked as insignificant unless the
7975       #[inline(never)] attribute is placed it.
7976     * The #[unsafe_destructor] attribute is now behind a feature gate.
7977     * Struct literals are no longer allowed in ambiguous positions such as
7978       if, while, match, and for..in.
7979     * Declaration of lang items and intrinsics are now feature-gated by
7980       default.
7981     * Integral literals no longer default to `int`, and floating point
7982       literals no longer default to `f64`. Literals must be suffixed with an
7983       appropriate type if inference cannot determine the type of the
7984       literal.
7985     * The Box<T> type is no longer implicitly borrowed to &mut T.
7986     * Procedures are now required to not capture borrowed references.
7987
7988   * Libraries
7989     * The standard library is now a "facade" over a number of underlying
7990       libraries. This means that development on the standard library should
7991       be speedier due to smaller crates, as well as a clearer line between
7992       all dependencies.
7993     * A new library, libcore, lives under the standard library's facade
7994       which is Rust's "0-assumption" library, suitable for embedded and
7995       kernel development for example.
7996     * A regex crate has been added to the standard distribution. This crate
7997       includes statically compiled regular expressions.
7998     * The unwrap/unwrap_err methods on Result require a Show bound for
7999       better error messages.
8000     * The return types of the std::comm primitives have been centralized
8001       around the Result type.
8002     * A number of I/O primitives have gained the ability to time out their
8003       operations.
8004     * A number of I/O primitives have gained the ability to close their
8005       reading/writing halves to cancel pending operations.
8006     * Reverse iterator methods have been removed in favor of `rev()` on
8007       their forward-iteration counterparts.
8008     * A bitflags! macro has been added to enable easy interop with C and
8009       management of bit flags.
8010     * A debug_assert! macro is now provided which is disabled when
8011       `--cfg ndebug` is passed to the compiler.
8012     * A graphviz crate has been added for creating .dot files.
8013     * The std::cast module has been migrated into std::mem.
8014     * The std::local_data api has been migrated from freestanding functions
8015       to being based on methods.
8016     * The Pod trait has been renamed to Copy.
8017     * jemalloc has been added as the default allocator for types.
8018     * The API for allocating memory has been changed to use proper alignment
8019       and sized deallocation
8020     * Connecting a TcpStream or binding a TcpListener is now based on a
8021       string address and a u16 port. This allows connecting to a hostname as
8022       opposed to an IP.
8023     * The Reader trait now contains a core method, read_at_least(), which
8024       correctly handles many repeated 0-length reads.
8025     * The process-spawning API is now centered around a builder-style
8026       Command struct.
8027     * The :? printing qualifier has been moved from the standard library to
8028       an external libdebug crate.
8029     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8030       have been renamed to Eq/Ord.
8031     * The select/plural methods have been removed from format!. The escapes
8032       for { and } have also changed from \{ and \} to {{ and }},
8033       respectively.
8034     * The TaskBuilder API has been re-worked to be a true builder, and
8035       extension traits for spawning native/green tasks have been added.
8036
8037   * Tooling
8038     * All breaking changes to the language or libraries now have their
8039       commit message annotated with `[breaking-change]` to allow for easy
8040       discovery of breaking changes.
8041     * The compiler will now try to suggest how to annotate lifetimes if a
8042       lifetime-related error occurs.
8043     * Debug info continues to be improved greatly with general bug fixes and
8044       better support for situations like link time optimization (LTO).
8045     * Usage of syntax extensions when cross-compiling has been fixed.
8046     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8047       -fdata-sections and --gc-sections has been enabled by default
8048     * The compiler is now stricter about where it will load module files
8049       from when a module is declared via `mod foo;`.
8050     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8051       Syntax extensions are now discovered via a "plugin registrar" type
8052       which will be extended in the future to other various plugins.
8053     * Lints have been restructured to allow for dynamically loadable lints.
8054     * A number of rustdoc improvements:
8055       * The HTML output has been visually redesigned.
8056       * Markdown is now powered by hoedown instead of sundown.
8057       * Searching heuristics have been greatly improved.
8058       * The search index has been reduced in size by a great amount.
8059       * Cross-crate documentation via `pub use` has been greatly improved.
8060       * Primitive types are now hyperlinked and documented.
8061     * Documentation has been moved from static.rust-lang.org/doc to
8062       doc.rust-lang.org
8063     * A new sandbox, play.rust-lang.org, is available for running and
8064       sharing rust code examples on-line.
8065     * Unused attributes are now more robustly warned about.
8066     * The dead_code lint now warns about unused struct fields.
8067     * Cross-compiling to iOS is now supported.
8068     * Cross-compiling to mipsel is now supported.
8069     * Stability attributes are now inherited by default and no longer apply
8070       to intra-crate usage, only inter-crate usage.
8071     * Error message related to non-exhaustive match expressions have been
8072       greatly improved.
8073
8074
8075 Version 0.10 (2014-04-03)
8076 =========================
8077
8078   * ~1500 changes, numerous bugfixes
8079
8080   * Language
8081     * A new RFC process is now in place for modifying the language.
8082     * Patterns with `@`-pointers have been removed from the language.
8083     * Patterns with unique vectors (`~[T]`) have been removed from the
8084       language.
8085     * Patterns with unique strings (`~str`) have been removed from the
8086       language.
8087     * `@str` has been removed from the language.
8088     * `@[T]` has been removed from the language.
8089     * `@self` has been removed from the language.
8090     * `@Trait` has been removed from the language.
8091     * Headers on `~` allocations which contain `@` boxes inside the type for
8092       reference counting have been removed.
8093     * The semantics around the lifetimes of temporary expressions have changed,
8094       see #3511 and #11585 for more information.
8095     * Cross-crate syntax extensions are now possible, but feature gated. See
8096       #11151 for more information. This includes both `macro_rules!` macros as
8097       well as syntax extensions such as `format!`.
8098     * New lint modes have been added, and older ones have been turned on to be
8099       warn-by-default.
8100       * Unnecessary parentheses
8101       * Uppercase statics
8102       * Camel Case types
8103       * Uppercase variables
8104       * Publicly visible private types
8105       * `#[deriving]` with raw pointers
8106     * Unsafe functions can no longer be coerced to closures.
8107     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8108     * The `#[simd]` attribute is now behind a feature gate.
8109     * Visibility is no longer allowed on `extern crate` statements, and
8110       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8111     * Trailing commas are now allowed in argument lists and tuple patterns.
8112     * The `do` keyword has been removed, it is now a reserved keyword.
8113     * Default type parameters have been implemented, but are feature gated.
8114     * Borrowed variables through captures in closures are now considered soundly.
8115     * `extern mod` is now `extern crate`
8116     * The `Freeze` trait has been removed.
8117     * The `Share` trait has been added for types that can be shared among
8118       threads.
8119     * Labels in macros are now hygienic.
8120     * Expression/statement macro invocations can be delimited with `{}` now.
8121     * Treatment of types allowed in `static mut` locations has been tweaked.
8122     * The `*` and `.` operators are now overloadable through the `Deref` and
8123       `DerefMut` traits.
8124     * `~Trait` and `proc` no longer have `Send` bounds by default.
8125     * Partial type hints are now supported with the `_` type marker.
8126     * An `Unsafe` type was introduced for interior mutability. It is now
8127       considered undefined to transmute from `&T` to `&mut T` without using the
8128       `Unsafe` type.
8129     * The #[linkage] attribute was implemented for extern statics/functions.
8130     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8131     * `Pod` was renamed to `Copy`.
8132
8133   * Libraries
8134     * The `libextra` library has been removed. It has now been decomposed into
8135       component libraries with smaller and more focused nuggets of
8136       functionality. The full list of libraries can be found on the
8137       documentation index page.
8138     * std: `std::condition` has been removed. All I/O errors are now propagated
8139       through the `Result` type. In order to assist with error handling, a
8140       `try!` macro for unwrapping errors with an early return and a lint for
8141       unused results has been added. See #12039 for more information.
8142     * std: The `vec` module has been renamed to `slice`.
8143     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8144       This will become the only growable vector in the future.
8145     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8146       are now found at `std::io::BufferedReader` instead of
8147       `std::io::buffered::BufferedReader`.
8148     * std: `print` and `println` are no longer in the prelude, the `print!` and
8149       `println!` macros are intended to be used instead.
8150     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8151       attempts to statically prevent cycles.
8152     * std: The standard distribution is adopting the policy of pushing failure
8153       to the user rather than failing in libraries. Many functions (such as
8154       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8155     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8156       deriving mode: `#[deriving(Show)]`.
8157     * std: `ToStr` is now implemented for all types implementing `Show`.
8158     * std: The formatting trait methods now take `&self` instead of `&T`
8159     * std: The `invert()` method on iterators has been renamed to `rev()`
8160     * std: `std::num` has seen a reduction in the genericity of its traits,
8161       consolidating functionality into a few core traits.
8162     * std: Backtraces are now printed on task failure if the environment
8163       variable `RUST_BACKTRACE` is present.
8164     * std: Naming conventions for iterators have been standardized. More details
8165       can be found on the wiki's style guide.
8166     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8167       still implement the function.
8168     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8169     * std: `assert_approx_eq!` has been removed
8170     * std: The `e` and `E` formatting specifiers for floats have been added to
8171       print them in exponential notation.
8172     * std: The `Times` trait has been removed
8173     * std: Indications of variance and opting out of builtin bounds is done
8174       through marker types in `std::kinds::marker` now
8175     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8176       `#[deriving(Hash)]` is now possible.
8177     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8178     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8179     * std: `Chan::new` is now `channel()`.
8180     * std: A new synchronous channel type has been implemented.
8181     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8182     * std: `hashmap` and `trie` have been moved to `libcollections`
8183     * std: `run` has been rolled into `io::process`
8184     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8185     * std: The equality and comparison traits have seen some reorganization.
8186     * std: `rand` has moved to `librand`.
8187     * std: `to_{lower,upper}case` has been implemented for `char`.
8188     * std: Logging has been moved to `liblog`.
8189     * collections: `HashMap` has been rewritten for higher performance and less
8190       memory usage.
8191     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8192       it can be booted manually. The runtime guide has more information and
8193       examples.
8194     * native: All I/O functionality except signals has been implemented.
8195     * green: Task spawning with `libgreen` has been optimized with stack caching
8196       and various trimming of code.
8197     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8198     * sync: The `extra::sync` module has been updated to modern rust (and moved
8199       to the `sync` library), tweaking and improving various interfaces while
8200       dropping redundant functionality.
8201     * sync: A new `Barrier` type has been added to the `sync` library.
8202     * sync: An efficient mutex for native and green tasks has been implemented.
8203     * serialize: The `base64` module has seen some improvement. It treats
8204       newlines better, has non-string error values, and has seen general
8205       cleanup.
8206     * fourcc: A `fourcc!` macro was introduced
8207     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8208       hexadecimal literal.
8209
8210   * Tooling
8211     * `rustpkg` has been deprecated and removed from the main repository. Its
8212       replacement, `cargo`, is under development.
8213     * Nightly builds of rust are now available
8214     * The memory usage of rustc has been improved many times throughout this
8215       release cycle.
8216     * The build process supports disabling rpath support for the rustc binary
8217       itself.
8218     * Code generation has improved in some cases, giving more information to the
8219       LLVM optimization passes to enable more extensive optimizations.
8220     * Debuginfo compatibility with lldb on OSX has been restored.
8221     * The master branch is now gated on an android bot, making building for
8222       android much more reliable.
8223     * Output flags have been centralized into one `--emit` flag.
8224     * Crate type flags have been centralized into one `--crate-type` flag.
8225     * Codegen flags have been consolidated behind a `-C` flag.
8226     * Linking against outdated crates now has improved error messages.
8227     * Error messages with lifetimes will often suggest how to annotate the
8228       function to fix the error.
8229     * Many more types are documented in the standard library, and new guides
8230       were written.
8231     * Many `rustdoc` improvements:
8232       * code blocks are syntax highlighted.
8233       * render standalone markdown files.
8234       * the --test flag tests all code blocks by default.
8235       * exported macros are displayed.
8236       * re-exported types have their documentation inlined at the location of the
8237         first re-export.
8238       * search works across crates that have been rendered to the same output
8239         directory.
8240
8241
8242 Version 0.9 (2014-01-09)
8243 ==========================
8244
8245    * ~1800 changes, numerous bugfixes
8246
8247    * Language
8248       * The `float` type has been removed. Use `f32` or `f64` instead.
8249       * A new facility for enabling experimental features (feature gating) has
8250         been added, using the crate-level `#[feature(foo)]` attribute.
8251       * Managed boxes (@) are now behind a feature gate
8252         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8253         standard library's `Gc` or `Rc` types instead.
8254       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8255       * Jumping back to the top of a loop is now done with `continue` instead of
8256         `loop`.
8257       * Strings can no longer be mutated through index assignment.
8258       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8259         hash delimiters, as in `r###"foo"###`.
8260       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8261         called once.
8262       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8263       * `@fn`s have been removed.
8264       * `do` only works with procs in order to make it obvious what the cost
8265         of `do` is.
8266       * Single-element tuple-like structs can no longer be dereferenced to
8267         obtain the inner value. A more comprehensive solution for overloading
8268         the dereference operator will be provided in the future.
8269       * The `#[link(...)]` attribute has been replaced with
8270         `#[crate_id = "name#vers"]`.
8271       * Empty `impl`s must be terminated with empty braces and may not be
8272         terminated with a semicolon.
8273       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8274         no longer has any special meaning.
8275       * The old `fmt!` string formatting macro has been removed.
8276       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8277         `print!` and `println!`.
8278       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8279       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8280         `extern mod foo = "bar"` instead.
8281       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8282       * Macros can have attributes.
8283       * Macros can expand to items with attributes.
8284       * Macros can expand to multiple items.
8285       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8286       * Comments may be nested.
8287       * Values automatically coerce to trait objects they implement, without
8288         an explicit `as`.
8289       * Enum discriminants are no longer an entire word but as small as needed to
8290         contain all the variants. The `repr` attribute can be used to override
8291         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8292         `#[repr(C)]` to match C enums.
8293       * Non-string literals are not allowed in attributes (they never worked).
8294       * The FFI now supports variadic functions.
8295       * Octal numeric literals, as in `0o7777`.
8296       * The `concat!` syntax extension performs compile-time string concatenation.
8297       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8298         removed as Rust no longer uses segmented stacks.
8299       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8300       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8301         not `*`; ignoring remaining fields of a struct is also done with `..`,
8302         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8303       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8304       * `rustc` supports the "system" calling convention, which defaults to the
8305         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8306         "C" elsewhere.
8307       * The `type_overflow` lint (default: warn) checks literals for overflow.
8308       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8309       * The `attribute_usage` lint (default: warn) warns about unknown
8310         attributes.
8311       * The `unknown_features` lint (default: warn) warns about unknown
8312         feature gates.
8313       * The `dead_code` lint (default: warn) checks for dead code.
8314       * Rust libraries can be linked statically to one another
8315       * `#[link_args]` is behind the `link_args` feature gate.
8316       * Native libraries are now linked with `#[link(name = "foo")]`
8317       * Native libraries can be statically linked to a rust crate
8318         (`#[link(name = "foo", kind = "static")]`).
8319       * Native OS X frameworks are now officially supported
8320         (`#[link(name = "foo", kind = "framework")]`).
8321       * The `#[thread_local]` attribute creates thread-local (not task-local)
8322         variables. Currently behind the `thread_local` feature gate.
8323       * The `return` keyword may be used in closures.
8324       * Types that can be copied via a memcpy implement the `Pod` kind.
8325       * The `cfg` attribute can now be used on struct fields and enum variants.
8326
8327    * Libraries
8328       * std: The `option` and `result` API's have been overhauled to make them
8329         simpler, more consistent, and more composable.
8330       * std: The entire `std::io` module has been replaced with one that is
8331         more comprehensive and that properly interfaces with the underlying
8332         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8333         implemented.
8334       * std: `io::util` contains a number of useful implementations of
8335         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8336         `ZeroReader`, `TeeReader`.
8337       * std: The reference counted pointer type `extra::rc` moved into std.
8338       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8339         just a wrapper around it).
8340       * std: The `Either` type has been removed.
8341       * std: `fmt::Default` can be implemented for any type to provide default
8342         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8343       * std: The `rand` API continues to be tweaked.
8344       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8345         on failure in gdb, is now named `rust_fail`.
8346       * std: The `each_key` and `each_value` methods on `HashMap` have been
8347         replaced by the `keys` and `values` iterators.
8348       * std: Functions dealing with type size and alignment have moved from the
8349         `sys` module to the `mem` module.
8350       * std: The `path` module was written and API changed.
8351       * std: `str::from_utf8` has been changed to cast instead of allocate.
8352       * std: `starts_with` and `ends_with` methods added to vectors via the
8353         `ImmutableEqVector` trait, which is in the prelude.
8354       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8355         if the index is out of bounds.
8356       * std: Task failure no longer propagates between tasks, as the model was
8357         complex, expensive, and incompatible with thread-based tasks.
8358       * std: The `Any` type can be used for dynamic typing.
8359       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8360         `task::try`.
8361       * std: Methods that produce iterators generally do not have an `_iter`
8362         suffix now.
8363       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8364         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8365       * std: `util::ignore` renamed to `prelude::drop`.
8366       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8367         trait.
8368       * std: `vec::raw` has seen a lot of cleanup and API changes.
8369       * std: The standard library no longer includes any C++ code, and very
8370         minimal C, eliminating the dependency on libstdc++.
8371       * std: Runtime scheduling and I/O functionality has been factored out into
8372         extensible interfaces and is now implemented by two different crates:
8373         libnative, for native threading and I/O; and libgreen, for green threading
8374         and I/O. This paves the way for using the standard library in more limited
8375         embedded environments.
8376       * std: The `comm` module has been rewritten to be much faster, have a
8377         simpler, more consistent API, and to work for both native and green
8378         threading.
8379       * std: All libuv dependencies have been moved into the rustuv crate.
8380       * native: New implementations of runtime scheduling on top of OS threads.
8381       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8382         and other I/O.
8383       * green: The green thread scheduler and message passing types are almost
8384         entirely lock-free.
8385       * extra: The `flatpipes` module had bitrotted and was removed.
8386       * extra: All crypto functions have been removed and Rust now has a policy of
8387         not reimplementing crypto in the standard library. In the future crypto
8388         will be provided by external crates with bindings to established libraries.
8389       * extra: `c_vec` has been modernized.
8390       * extra: The `sort` module has been removed. Use the `sort` method on
8391         mutable slices.
8392
8393    * Tooling
8394       * The `rust` and `rusti` commands have been removed, due to lack of
8395         maintenance.
8396       * `rustdoc` was completely rewritten.
8397       * `rustdoc` can test code examples in documentation.
8398       * `rustpkg` can test packages with the argument, 'test'.
8399       * `rustpkg` supports arbitrary dependencies, including C libraries.
8400       * `rustc`'s support for generating debug info is improved again.
8401       * `rustc` has better error reporting for unbalanced delimiters.
8402       * `rustc`'s JIT support was removed due to bitrot.
8403       * Executables and static libraries can be built with LTO (-Z lto)
8404       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8405         build tools.
8406
8407
8408 Version 0.8 (2013-09-26)
8409 ============================
8410
8411    * ~2200 changes, numerous bugfixes
8412
8413    * Language
8414       * The `for` loop syntax has changed to work with the `Iterator` trait.
8415       * At long last, unwinding works on Windows.
8416       * Default methods are ready for use.
8417       * Many trait inheritance bugs fixed.
8418       * Owned and borrowed trait objects work more reliably.
8419       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8420       * rustc can omit emission of code for the `debug!` macro if it is passed
8421         `--cfg ndebug`
8422       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8423         for foo.rs, then foo/mod.rs, and will generate an error when both are
8424         present.
8425       * Strings no longer contain trailing nulls. The new `std::c_str` module
8426         provides new mechanisms for converting to C strings.
8427       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8428       * The FFI has been overhauled such that foreign functions are called directly,
8429         instead of through a stack-switching wrapper.
8430       * Calling a foreign function must be done through a Rust function with the
8431         `#[fixed_stack_segment]` attribute.
8432       * The `externfn!` macro can be used to declare both a foreign function and
8433         a `#[fixed_stack_segment]` wrapper at once.
8434       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8435       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8436       * `priv` is disallowed everywhere except for struct fields and enum variants.
8437       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8438       * `ref` bindings in irrefutable patterns work correctly now.
8439       * `char` is now prevented from containing invalid code points.
8440       * Casting to `bool` is no longer allowed.
8441       * `\0` is now accepted as an escape in chars and strings.
8442       * `yield` is a reserved keyword.
8443       * `typeof` is a reserved keyword.
8444       * Crates may be imported by URL with `extern mod foo = "url";`.
8445       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8446       * Static vectors can be initialized with repeating elements,
8447         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8448       * Static structs can be initialized with functional record update,
8449         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8450       * `cfg!` can be used to conditionally execute code based on the crate
8451         configuration, similarly to `#[cfg(...)]`.
8452       * The `unnecessary_qualification` lint detects unneeded module
8453         prefixes (default: allow).
8454       * Arithmetic operations have been implemented on the SIMD types in
8455         `std::unstable::simd`.
8456       * Exchange allocation headers were removed, reducing memory usage.
8457       * `format!` implements a completely new, extensible, and higher-performance
8458         string formatting system. It will replace `fmt!`.
8459       * `print!` and `println!` write formatted strings (using the `format!`
8460         extension) to stdout.
8461       * `write!` and `writeln!` write formatted strings (using the `format!`
8462         extension) to the new Writers in `std::rt::io`.
8463       * The library section in which a function or static is placed may
8464         be specified with `#[link_section = "..."]`.
8465       * The `proto!` syntax extension for defining bounded message protocols
8466         was removed.
8467       * `macro_rules!` is hygienic for `let` declarations.
8468       * The `#[export_name]` attribute specifies the name of a symbol.
8469       * `unreachable!` can be used to indicate unreachable code, and fails
8470         if executed.
8471
8472    * Libraries
8473       * std: Transitioned to the new runtime, written in Rust.
8474       * std: Added an experimental I/O library, `rt::io`, based on the new
8475         runtime.
8476       * std: A new generic `range` function was added to the prelude, replacing
8477         `uint::range` and friends.
8478       * std: `range_rev` no longer exists. Since range is an iterator it can be
8479         reversed with `range(lo, hi).invert()`.
8480       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8481         renamed to `unwrap_or`.
8482       * std: The `iterator` module was renamed to `iter`.
8483       * std: Integral types now support the `checked_add`, `checked_sub`, and
8484         `checked_mul` operations for detecting overflow.
8485       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8486         consistency.
8487       * std: Methods are standardizing on conventions for casting methods:
8488         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8489         and cheap casts.
8490       * std: The `CString` type in `c_str` provides new ways to convert to and
8491         from C strings.
8492       * std: `DoubleEndedIterator` can yield elements in two directions.
8493       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8494         two splices.
8495       * std: `str::from_bytes` renamed to `str::from_utf8`.
8496       * std: `pop_opt` and `shift_opt` methods added to vectors.
8497       * std: The task-local data interface no longer uses @, and keys are
8498         no longer function pointers.
8499       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8500       * std: Added `SharedPort` to `comm`.
8501       * std: `Eq` has a default method for `ne`; only `eq` is required
8502         in implementations.
8503       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8504         is required in implementations.
8505       * std: `is_utf8` performance is improved, impacting many string functions.
8506       * std: `os::MemoryMap` provides cross-platform mmap.
8507       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8508         are not 'in-bounds' are considered undefined.
8509       * std: Many freestanding functions in `vec` removed in favor of methods.
8510       * std: Many freestanding functions on scalar types removed in favor of
8511         methods.
8512       * std: Many options to task builders were removed since they don't make
8513         sense in the new scheduler design.
8514       * std: More containers implement `FromIterator` so can be created by the
8515         `collect` method.
8516       * std: More complete atomic types in `unstable::atomics`.
8517       * std: `comm::PortSet` removed.
8518       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8519         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8520         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8521         default implementations.
8522       * std: Various `from_str` functions were removed in favor of a generic
8523         `from_str` which is available in the prelude.
8524       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8525       * extra: `dlist`, the doubly-linked list was modernized.
8526       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8527       * extra: Added `glob` module, replacing `std::os::glob`.
8528       * extra: `rope` was removed.
8529       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8530       * extra: `net`, and `timer` were removed. The experimental replacements
8531         are `std::rt::io::net` and `std::rt::io::timer`.
8532       * extra: Iterators implemented for `SmallIntMap`.
8533       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8534       * extra: `SmallIntSet` removed. Use `BitvSet`.
8535       * extra: Performance of JSON parsing greatly improved.
8536       * extra: `semver` updated to SemVer 2.0.0.
8537       * extra: `term` handles more terminals correctly.
8538       * extra: `dbg` module removed.
8539       * extra: `par` module removed.
8540       * extra: `future` was cleaned up, with some method renames.
8541       * extra: Most free functions in `getopts` were converted to methods.
8542
8543    * Other
8544       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8545       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8546         similarly to gcc's `--march` flag.
8547       * rustc's performance compiling small crates is much better.
8548       * rustpkg has received many improvements.
8549       * rustpkg supports git tags as package IDs.
8550       * rustpkg builds into target-specific directories so it can be used for
8551         cross-compiling.
8552       * The number of concurrent test tasks is controlled by the environment
8553         variable RUST_TEST_TASKS.
8554       * The test harness can now report metrics for benchmarks.
8555       * All tools have man pages.
8556       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8557       * The runtime uses jemalloc for allocations.
8558       * Segmented stacks are temporarily disabled as part of the transition to
8559         the new runtime. Stack overflows are possible!
8560       * A new documentation backend, rustdoc_ng, is available for use. It is
8561         still invoked through the normal `rustdoc` command.
8562
8563
8564 Version 0.7 (2013-07-03)
8565 =======================
8566
8567    * ~2000 changes, numerous bugfixes
8568
8569    * Language
8570       * `impl`s no longer accept a visibility qualifier. Put them on methods
8571         instead.
8572       * The borrow checker has been rewritten with flow-sensitivity, fixing
8573         many bugs and inconveniences.
8574       * The `self` parameter no longer implicitly means `&'self self`,
8575         and can be explicitly marked with a lifetime.
8576       * Overloadable compound operators (`+=`, etc.) have been temporarily
8577         removed due to bugs.
8578       * The `for` loop protocol now requires `for`-iterators to return `bool`
8579         so they compose better.
8580       * The `Durable` trait is replaced with the `'static` bounds.
8581       * Trait default methods work more often.
8582       * Structs with the `#[packed]` attribute have byte alignment and
8583         no padding between fields.
8584       * Type parameters bound by `Copy` must now be copied explicitly with
8585         the `copy` keyword.
8586       * It is now illegal to move out of a dereferenced unsafe pointer.
8587       * `Option<~T>` is now represented as a nullable pointer.
8588       * `@mut` does dynamic borrow checks correctly.
8589       * The `main` function is only detected at the topmost level of the crate.
8590         The `#[main]` attribute is still valid anywhere.
8591       * Struct fields may no longer be mutable. Use inherited mutability.
8592       * The `#[no_send]` attribute makes a type that would otherwise be
8593         `Send`, not.
8594       * The `#[no_freeze]` attribute makes a type that would otherwise be
8595         `Freeze`, not.
8596       * Unbounded recursion will abort the process after reaching the limit
8597         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8598       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8599         are never implicitly copyable.
8600       * `#[static_assert]` makes compile-time assertions about static bools.
8601       * At long last, 'argument modes' no longer exist.
8602       * The rarely used `use mod` statement no longer exists.
8603
8604    * Syntax extensions
8605       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8606         argument list.
8607       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8608         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8609         `#[deriving(...)]`.
8610       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8611         and unsuffixed integer literals.
8612
8613    * Libraries
8614       * The `core` crate was renamed to `std`.
8615       * The `std` crate was renamed to `extra`.
8616       * More and improved documentation.
8617       * std: `iterator` module for external iterator objects.
8618       * Many old-style (internal, higher-order function) iterators replaced by
8619         implementations of `Iterator`.
8620       * std: Many old internal vector and string iterators,
8621         incl. `any`, `all`. removed.
8622       * std: The `finalize` method of `Drop` renamed to `drop`.
8623       * std: The `drop` method now takes `&mut self` instead of `&self`.
8624       * std: The prelude no longer re-exports any modules, only types and traits.
8625       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8626         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8627       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8628         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8629       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8630         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8631       * std: Many types implement `Clone`.
8632       * std: `path` type renamed to `Path`.
8633       * std: `mut` module and `Mut` type removed.
8634       * std: Many standalone functions removed in favor of methods and iterators
8635         in `vec`, `str`. In the future methods will also work as functions.
8636       * std: `reinterpret_cast` removed. Use `transmute`.
8637       * std: ascii string handling in `std::ascii`.
8638       * std: `Rand` is implemented for ~/@.
8639       * std: `run` module for spawning processes overhauled.
8640       * std: Various atomic types added to `unstable::atomic`.
8641       * std: Various types implement `Zero`.
8642       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8643       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8644       * std: Added `os::mkdir_recursive`.
8645       * std: Added `os::glob` function performs filesystems globs.
8646       * std: `FuzzyEq` renamed to `ApproxEq`.
8647       * std: `Map` now defines `pop` and `swap` methods.
8648       * std: `Cell` constructors converted to static methods.
8649       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8650       * extra: `flate` module moved from `std` to `extra`.
8651       * extra: `fileinput` module for iterating over a series of files.
8652       * extra: `Complex` number type and `complex` module.
8653       * extra: `Rational` number type and `rational` module.
8654       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8655       * extra: `term` uses terminfo now, is more correct.
8656       * extra: `arc` functions converted to methods.
8657       * extra: Implementation of fixed output size variations of SHA-2.
8658
8659    * Tooling
8660       * `unused_variables` lint mode for unused variables (default: warn).
8661       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8662         (default: warn).
8663       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8664         (default: warn).
8665       * `dead_assignment` lint mode for unread variables (default: warn).
8666       * `unnecessary_allocation` lint mode detects some heap allocations that are
8667         immediately borrowed so could be written without allocating (default: warn).
8668       * `missing_doc` lint mode (default: allow).
8669       * `unreachable_code` lint mode (default: warn).
8670       * The `rusti` command has been rewritten and a number of bugs addressed.
8671       * rustc outputs in color on more terminals.
8672       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8673       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8674       * Compiling with `-g` will make the binary record information about
8675         dynamic borrowcheck failures for debugging.
8676       * rustdoc has a nicer stylesheet.
8677       * Various improvements to rustdoc.
8678       * Improvements to rustpkg (see the detailed release notes).
8679
8680
8681 Version 0.6 (2013-04-03)
8682 ========================
8683
8684    * ~2100 changes, numerous bugfixes
8685
8686    * Syntax changes
8687       * The self type parameter in traits is now spelled `Self`
8688       * The `self` parameter in trait and impl methods must now be explicitly
8689         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8690       * Static methods no longer require the `static` keyword and instead
8691         are distinguished by the lack of a `self` parameter
8692       * Replaced the `Durable` trait with the `'static` lifetime
8693       * The old closure type syntax with the trailing sigil has been
8694         removed in favor of the more consistent leading sigil
8695       * `super` is a keyword, and may be prefixed to paths
8696       * Trait bounds are separated with `+` instead of whitespace
8697       * Traits are implemented with `impl Trait for Type`
8698         instead of `impl Type: Trait`
8699       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8700       * The `export` keyword has finally been removed
8701       * The `move` keyword has been removed (see "Semantic changes")
8702       * The interior mutability qualifier on vectors, `[mut T]`, has been
8703         removed. Use `&mut [T]`, etc.
8704       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8705       * `fail` is no longer a keyword. Use `fail!()`
8706       * `assert` is no longer a keyword. Use `assert!()`
8707       * `log` is no longer a keyword. use `debug!`, etc.
8708       * 1-tuples may be represented as `(T,)`
8709       * Struct fields may no longer be `mut`. Use inherited mutability,
8710         `@mut T`, `core::mut` or `core::cell`
8711       * `extern mod { ... }` is no longer valid syntax for foreign
8712         function modules. Use extern blocks: `extern { ... }`
8713       * Newtype enums removed. Use tuple-structs.
8714       * Trait implementations no longer support visibility modifiers
8715       * Pattern matching over vectors improved and expanded
8716       * `const` renamed to `static` to correspond to lifetime name,
8717         and make room for future `static mut` unsafe mutable globals.
8718       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8719       * `Clone` implementations can be automatically generated with
8720         `#[deriving(Clone)]`
8721       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8722         instead of `foo as Bar`.
8723       * Fixed length vector types are now written as `[int, .. 3]`
8724         instead of `[int * 3]`.
8725       * Fixed length vector types can express the length as a constant
8726         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8727
8728    * Semantic changes
8729       * Types with owned pointers or custom destructors move by default,
8730         eliminating the `move` keyword
8731       * All foreign functions are considered unsafe
8732       * &mut is now unaliasable
8733       * Writes to borrowed @mut pointers are prevented dynamically
8734       * () has size 0
8735       * The name of the main function can be customized using #[main]
8736       * The default type of an inferred closure is &fn instead of @fn
8737       * `use` statements may no longer be "chained" - they cannot import
8738         identifiers imported by previous `use` statements
8739       * `use` statements are crate relative, importing from the "top"
8740         of the crate by default. Paths may be prefixed with `super::`
8741         or `self::` to change the search behavior.
8742       * Method visibility is inherited from the implementation declaration
8743       * Structural records have been removed
8744       * Many more types can be used in static items, including enums
8745         'static-lifetime pointers and vectors
8746       * Pattern matching over vectors improved and expanded
8747       * Typechecking of closure types has been overhauled to
8748         improve inference and eliminate unsoundness
8749       * Macros leave scope at the end of modules, unless that module is
8750         tagged with #[macro_escape]
8751
8752    * Libraries
8753       * Added big integers to `std::bigint`
8754       * Removed `core::oldcomm` module
8755       * Added pipe-based `core::comm` module
8756       * Numeric traits have been reorganized under `core::num`
8757       * `vec::slice` finally returns a slice
8758       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8759       * Containers reorganized around traits in `core::container`
8760       * `core::dvec` removed, `~[T]` is a drop-in replacement
8761       * `core::send_map` renamed to `core::hashmap`
8762       * `std::map` removed; replaced with `core::hashmap`
8763       * `std::treemap` reimplemented as an owned balanced tree
8764       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8765       * `core::trie` added as a fast ordered map for integer keys
8766       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8767       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8768         overload the comparison operators, whereas `TotalOrd` is used
8769         by certain container types
8770
8771    * Other
8772       * Replaced the 'cargo' package manager with 'rustpkg'
8773       * Added all-purpose 'rust' tool
8774       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8775       * rustc now *attempts* to offer spelling suggestions
8776       * Improved support for ARM and Android
8777       * Preliminary MIPS backend
8778       * Improved foreign function ABI implementation for x86, x86_64
8779       * Various memory usage improvements
8780       * Rust code may be embedded in foreign code under limited circumstances
8781       * Inline assembler supported by new asm!() syntax extension.
8782
8783
8784 Version 0.5 (2012-12-21)
8785 ===========================
8786
8787    * ~900 changes, numerous bugfixes
8788
8789    * Syntax changes
8790       * Removed `<-` move operator
8791       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8792       * Removed old fixed length vector syntax - `[T]/N`
8793       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8794       * Macros may now expand to items and statements
8795       * `a.b()` is always parsed as a method call, never as a field projection
8796       * `Eq` and `IterBytes` implementations can be automatically generated
8797         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8798       * Removed the special crate language for `.rc` files
8799       * Function arguments may consist of any irrefutable pattern
8800
8801    * Semantic changes
8802       * `&` and `~` pointers may point to objects
8803       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8804       * Enum variants may be structs
8805       * Destructors can be added to all nominal types with the Drop trait
8806       * Structs and nullary enum variants may be constants
8807       * Values that cannot be implicitly copied are now automatically moved
8808         without writing `move` explicitly
8809       * `&T` may now be coerced to `*T`
8810       * Coercions happen in `let` statements as well as function calls
8811       * `use` statements now take crate-relative paths
8812       * The module and type namespaces have been merged so that static
8813         method names can be resolved under the trait in which they are
8814         declared
8815
8816    * Improved support for language features
8817       * Trait inheritance works in many scenarios
8818       * More support for explicit self arguments in methods - `self`, `&self`
8819         `@self`, and `~self` all generally work as expected
8820       * Static methods work in more situations
8821       * Experimental: Traits may declare default methods for the implementations
8822         to use
8823
8824    * Libraries
8825       * New condition handling system in `core::condition`
8826       * Timsort added to `std::sort`
8827       * New priority queue, `std::priority_queue`
8828       * Pipes for serializable types, `std::flatpipes'
8829       * Serialization overhauled to be trait-based
8830       * Expanded `getopts` definitions
8831       * Moved futures to `std`
8832       * More functions are pure now
8833       * `core::comm` renamed to `oldcomm`. Still deprecated
8834       * `rustdoc` and `cargo` are libraries now
8835
8836    * Misc
8837       * Added a preliminary REPL, `rusti`
8838       * License changed from MIT to dual MIT/APL2
8839
8840
8841 Version 0.4 (2012-10-15)
8842 ==========================
8843
8844    * ~2000 changes, numerous bugfixes
8845
8846    * Syntax
8847       * All keywords are now strict and may not be used as identifiers anywhere
8848       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8849         'of', 'with', 'to', 'class'.
8850       * Classes are replaced with simpler structs
8851       * Explicit method self types
8852       * `ret` became `return` and `alt` became `match`
8853       * `import` is now `use`; `use is now `extern mod`
8854       * `extern mod { ... }` is now `extern { ... }`
8855       * `use mod` is the recommended way to import modules
8856       * `pub` and `priv` replace deprecated export lists
8857       * The syntax of `match` pattern arms now uses fat arrow (=>)
8858       * `main` no longer accepts an args vector; use `os::args` instead
8859
8860    * Semantics
8861       * Trait implementations are now coherent, ala Haskell typeclasses
8862       * Trait methods may be static
8863       * Argument modes are deprecated
8864       * Borrowed pointers are much more mature and recommended for use
8865       * Strings and vectors in the static region are stored in constant memory
8866       * Typestate was removed
8867       * Resolution rewritten to be more reliable
8868       * Support for 'dual-mode' data structures (freezing and thawing)
8869
8870    * Libraries
8871       * Most binary operators can now be overloaded via the traits in
8872         `core::ops'
8873       * `std::net::url` for representing URLs
8874       * Sendable hash maps in `core::send_map`
8875       * `core::task' gained a (currently unsafe) task-local storage API
8876
8877    * Concurrency
8878       * An efficient new intertask communication primitive called the pipe,
8879         along with a number of higher-level channel types, in `core::pipes`
8880       * `std::arc`, an atomically reference counted, immutable, shared memory
8881         type
8882       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8883       * Futures are now based on pipes and sendable
8884       * More robust linked task failure
8885       * Improved task builder API
8886
8887    * Other
8888       * Improved error reporting
8889       * Preliminary JIT support
8890       * Preliminary work on precise GC
8891       * Extensive architectural improvements to rustc
8892       * Begun a transition away from buggy C++-based reflection (shape) code to
8893         Rust-based (visitor) code
8894       * All hash functions and tables converted to secure, randomized SipHash
8895
8896
8897 Version 0.3  (2012-07-12)
8898 ========================
8899
8900    * ~1900 changes, numerous bugfixes
8901
8902    * New coding conveniences
8903       * Integer-literal suffix inference
8904       * Per-item control over warnings, errors
8905       * #[cfg(windows)] and #[cfg(unix)] attributes
8906       * Documentation comments
8907       * More compact closure syntax
8908       * 'do' expressions for treating higher-order functions as
8909         control structures
8910       * *-patterns (wildcard extended to all constructor fields)
8911
8912    * Semantic cleanup
8913       * Name resolution pass and exhaustiveness checker rewritten
8914       * Region pointers and borrow checking supersede alias
8915         analysis
8916       * Init-ness checking is now provided by a region-based liveness
8917         pass instead of the typestate pass; same for last-use analysis
8918       * Extensive work on region pointers
8919
8920    * Experimental new language features
8921       * Slices and fixed-size, interior-allocated vectors
8922       * #!-comments for lang versioning, shell execution
8923       * Destructors and iface implementation for classes;
8924         type-parameterized classes and class methods
8925       * 'const' type kind for types that can be used to implement
8926         shared-memory concurrency patterns
8927
8928    * Type reflection
8929
8930    * Removal of various obsolete features
8931       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8932                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8933
8934       * Constructs: do-while loops ('do' repurposed), fn binding,
8935                     resources (replaced by destructors)
8936
8937    * Compiler reorganization
8938       * Syntax-layer of compiler split into separate crate
8939       * Clang (from LLVM project) integrated into build
8940       * Typechecker split into sub-modules
8941
8942    * New library code
8943       * New time functions
8944       * Extension methods for many built-in types
8945       * Arc: atomic-refcount read-only / exclusive-use shared cells
8946       * Par: parallel map and search routines
8947       * Extensive work on libuv interface
8948       * Much vector code moved to libraries
8949       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8950         #include, #include_str, #include_bin
8951
8952    * Tool improvements
8953       * Cargo automatically resolves dependencies
8954
8955
8956 Version 0.2  (2012-03-29)
8957 =========================
8958
8959    * >1500 changes, numerous bugfixes
8960
8961    * New docs and doc tooling
8962
8963    * New port: FreeBSD x86_64
8964
8965    * Compilation model enhancements
8966       * Generics now specialized, multiply instantiated
8967       * Functions now inlined across separate crates
8968
8969    * Scheduling, stack and threading fixes
8970       * Noticeably improved message-passing performance
8971       * Explicit schedulers
8972       * Callbacks from C
8973       * Helgrind clean
8974
8975    * Experimental new language features
8976       * Operator overloading
8977       * Region pointers
8978       * Classes
8979
8980    * Various language extensions
8981       * C-callback function types: 'crust fn ...'
8982       * Infinite-loop construct: 'loop { ... }'
8983       * Shorten 'mutable' to 'mut'
8984       * Required mutable-local qualifier: 'let mut ...'
8985       * Basic glob-exporting: 'export foo::*;'
8986       * Alt now exhaustive, 'alt check' for runtime-checked
8987       * Block-function form of 'for' loop, with 'break' and 'ret'.
8988
8989    * New library code
8990       * AST quasi-quote syntax extension
8991       * Revived libuv interface
8992       * New modules: core::{future, iter}, std::arena
8993       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8994       * Extensive cleanup, regularization in libstd, libcore
8995
8996
8997 Version 0.1  (2012-01-20)
8998 ===============================
8999
9000    * Most language features work, including:
9001       * Unique pointers, unique closures, move semantics
9002       * Interface-constrained generics
9003       * Static interface dispatch
9004       * Stack growth
9005       * Multithread task scheduling
9006       * Typestate predicates
9007       * Failure unwinding, destructors
9008       * Pattern matching and destructuring assignment
9009       * Lightweight block-lambda syntax
9010       * Preliminary macro-by-example
9011
9012    * Compiler works with the following configurations:
9013       * Linux: x86 and x86_64 hosts and targets
9014       * macOS: x86 and x86_64 hosts and targets
9015       * Windows: x86 hosts and targets
9016
9017    * Cross compilation / multi-target configuration supported.
9018
9019    * Preliminary API-documentation and package-management tools included.
9020
9021 Known issues:
9022
9023    * Documentation is incomplete.
9024
9025    * Performance is below intended target.
9026
9027    * Standard library APIs are subject to extensive change, reorganization.
9028
9029    * Language-level versioning is not yet operational - future code will
9030      break unexpectedly.