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 as 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 Misc
  86 ----
  87 - [Rustdoc now supports strikethrough text in Markdown.][71928] E.g.
  88   `~~outdated information~~` becomes "~~outdated information~~".
  89 - [Added an emoji to Rustdoc's deprecated API message.][72014]
  90
  91 Compatibility Notes
  92 -------------------
  93 - [Trying to self initialize a static value (that is creating a value using
  94   itself) is unsound and now causes a compile error.][71140]
  95 - [`{f32, f64}::powi` now returns a slightly different value on Windows.][73420]
  96   This is due to changes in LLVM's intrinsics which `{f32, f64}::powi` uses.
  97 - [Rustdoc's CLI's extra error exit codes have been removed.][71900] These were
  98   previously undocumented and not intended for public use. Rustdoc still provides
  99   a non-zero exit code on errors.
 100
 101 Internals Only
 102 --------------
 103 - [Make clippy a git subtree instead of a git submodule][70655]
 104 - [Unify the undo log of all snapshot types][69464]
 105
 106 [73420]: https://github.com/rust-lang/rust/issues/73420/
 107 [72324]: https://github.com/rust-lang/rust/pull/72324/
 108 [71843]: https://github.com/rust-lang/rust/pull/71843/
 109 [71886]: https://github.com/rust-lang/rust/pull/71886/
 110 [72234]: https://github.com/rust-lang/rust/pull/72234/
 111 [72239]: https://github.com/rust-lang/rust/pull/72239/
 112 [72397]: https://github.com/rust-lang/rust/pull/72397/
 113 [72413]: https://github.com/rust-lang/rust/pull/72413/
 114 [72014]: https://github.com/rust-lang/rust/pull/72014/
 115 [72062]: https://github.com/rust-lang/rust/pull/72062/
 116 [72094]: https://github.com/rust-lang/rust/pull/72094/
 117 [72133]: https://github.com/rust-lang/rust/pull/72133/
 118 [71900]: https://github.com/rust-lang/rust/pull/71900/
 119 [71928]: https://github.com/rust-lang/rust/pull/71928/
 120 [71662]: https://github.com/rust-lang/rust/pull/71662/
 121 [71716]: https://github.com/rust-lang/rust/pull/71716/
 122 [71447]: https://github.com/rust-lang/rust/pull/71447/
 123 [71269]: https://github.com/rust-lang/rust/pull/71269/
 124 [71095]: https://github.com/rust-lang/rust/pull/71095/
 125 [71140]: https://github.com/rust-lang/rust/pull/71140/
 126 [70655]: https://github.com/rust-lang/rust/pull/70655/
 127 [70705]: https://github.com/rust-lang/rust/pull/70705/
 128 [69984]: https://github.com/rust-lang/rust/pull/69984/
 129 [69813]: https://github.com/rust-lang/rust/pull/69813/
 130 [69464]: https://github.com/rust-lang/rust/pull/69464/
 131 [68717]: https://github.com/rust-lang/rust/pull/68717/
 132 [`Arc::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Arc.html#method.as_ptr
 133 [`BTreeMap::remove_entry`]: https://doc.rust-lang.org/stable/std/collections/struct.BTreeMap.html#method.remove_entry
 134 [`Rc::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Rc.html#method.as_ptr
 135 [`rc::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.as_ptr
 136 [`rc::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.from_raw
 137 [`rc::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/rc/struct.Weak.html#method.into_raw
 138 [`sync::Weak::as_ptr`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.as_ptr
 139 [`sync::Weak::from_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.from_raw
 140 [`sync::Weak::into_raw`]: https://doc.rust-lang.org/stable/std/sync/struct.Weak.html#method.into_raw
 141 [`str::strip_prefix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_prefix
 142 [`str::strip_suffix`]: https://doc.rust-lang.org/stable/std/primitive.str.html#method.strip_suffix
 143 [`char::UNICODE_VERSION`]: https://doc.rust-lang.org/stable/std/char/constant.UNICODE_VERSION.html
 144 [`Span::resolved_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.resolved_at
 145 [`Span::located_at`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.located_at
 146 [`Span::mixed_site`]: https://doc.rust-lang.org/stable/proc_macro/struct.Span.html#method.mixed_site
 147 [`unix::process::CommandExt::arg0`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.arg0
 148
 149
 150 Version 1.44.1 (2020-06-18)
 151 ===========================
 152
 153 * [rustfmt accepts rustfmt_skip in cfg_attr again.][73078]
 154 * [Don't hash executable filenames on apple platforms, fixing backtraces.][cargo/8329]
 155 * [Fix crashes when finding backtrace on macOS.][71397]
 156 * [Clippy applies lint levels into different files.][clippy/5356]
 157
 158 [71397]: https://github.com/rust-lang/rust/issues/71397
 159 [73078]: https://github.com/rust-lang/rust/issues/73078
 160 [cargo/8329]: https://github.com/rust-lang/cargo/pull/8329
 161 [clippy/5356]: https://github.com/rust-lang/rust-clippy/issues/5356
 162
 163
 164 Version 1.44.0 (2020-06-04)
 165 ==========================
 166
 167 Language
 168 --------
 169 - [You can now use `async/.await` with `#[no_std]` enabled.][69033]
 170 - [Added the `unused_braces` lint.][70081]
 171
 172 **Syntax-only changes**
 173
 174 - [Expansion-driven outline module parsing][69838]
 175 ```rust
 176 #[cfg(FALSE)]
 177 mod foo {
 178     mod bar {
 179         mod baz; // `foo/bar/baz.rs` doesn't exist, but no error!
 180     }
 181 }
 182 ```
 183
 184 These are still rejected semantically, so you will likely receive an error but
 185 these changes can be seen and parsed by macros and conditional compilation.
 186
 187 Compiler
 188 --------
 189 - [Rustc now respects the `-C codegen-units` flag in incremental mode.][70156]
 190   Additionally when in incremental mode rustc defaults to 256 codegen units.
 191 - [Refactored `catch_unwind` to have zero-cost, unless unwinding is enabled and
 192   a panic is thrown.][67502]
 193 - [Added tier 3\* support for the `aarch64-unknown-none` and
 194   `aarch64-unknown-none-softfloat` targets.][68334]
 195 - [Added tier 3 support for `arm64-apple-tvos` and
 196   `x86_64-apple-tvos` targets.][68191]
 197
 198
 199 Libraries
 200 ---------
 201 - [Special cased `vec![]` to map directly to `Vec::new()`.][70632] This allows
 202   `vec![]` to be able to be used in `const` contexts.
 203 - [`convert::Infallible` now implements `Hash`.][70281]
 204 - [`OsString` now implements `DerefMut` and `IndexMut` returning
 205   a `&mut OsStr`.][70048]
 206 - [Unicode 13 is now supported.][69929]
 207 - [`String` now implements `From<&mut str>`.][69661]
 208 - [`IoSlice` now implements `Copy`.][69403]
 209 - [`Vec<T>` now implements `From<[T; N]>`.][68692] Where `N` is at most 32.
 210 - [`proc_macro::LexError` now implements `fmt::Display` and `Error`.][68899]
 211 - [`from_le_bytes`, `to_le_bytes`, `from_be_bytes`, `to_be_bytes`,
 212   `from_ne_bytes`, and `to_ne_bytes` methods are now `const` for all
 213   integer types.][69373]
 214
 215 Stabilized APIs
 216 ---------------
 217 - [`PathBuf::with_capacity`]
 218 - [`PathBuf::capacity`]
 219 - [`PathBuf::clear`]
 220 - [`PathBuf::reserve`]
 221 - [`PathBuf::reserve_exact`]
 222 - [`PathBuf::shrink_to_fit`]
 223 - [`f32::to_int_unchecked`]
 224 - [`f64::to_int_unchecked`]
 225 - [`Layout::align_to`]
 226 - [`Layout::pad_to_align`]
 227 - [`Layout::array`]
 228 - [`Layout::extend`]
 229
 230 Cargo
 231 -----
 232 - [Added the `cargo tree` command which will print a tree graph of
 233   your dependencies.][cargo/8062] E.g.
 234   ```
 235     mdbook v0.3.2 (/Users/src/rust/mdbook)
 236   ├── ammonia v3.0.0
 237   │   ├── html5ever v0.24.0
 238   │   │   ├── log v0.4.8
 239   │   │   │   └── cfg-if v0.1.9
 240   │   │   ├── mac v0.1.1
 241   │   │   └── markup5ever v0.9.0
 242   │   │       ├── log v0.4.8 (*)
 243   │   │       ├── phf v0.7.24
 244   │   │       │   └── phf_shared v0.7.24
 245   │   │       │       ├── siphasher v0.2.3
 246   │   │       │       └── unicase v1.4.2
 247   │   │       │           [build-dependencies]
 248   │   │       │           └── version_check v0.1.5
 249   ...
 250   ```
 251   You can also display dependencies on multiple versions of the same crate with
 252   `cargo tree -d` (short for `cargo tree --duplicates`).
 253
 254 Misc
 255 ----
 256 - [Rustdoc now allows you to specify `--crate-version` to have rustdoc include
 257   the version in the sidebar.][69494]
 258
 259 Compatibility Notes
 260 -------------------
 261 - [Rustc now correctly generates static libraries on Windows GNU targets with
 262   the `.a` extension, rather than the previous `.lib`.][70937]
 263 - [Removed the `-C no_integrated_as` flag from rustc.][70345]
 264 - [The `file_name` property in JSON output of macro errors now points the actual
 265   source file rather than the previous format of `<NAME macros>`.][70969]
 266   **Note:** this may not point to a file that actually exists on the user's system.
 267 - [The minimum required external LLVM version has been bumped to LLVM 8.][71147]
 268 - [`mem::{zeroed, uninitialised}` will now panic when used with types that do
 269   not allow zero initialization such as `NonZeroU8`.][66059] This was
 270   previously a warning.
 271 - [In 1.45.0 (the next release) converting a `f64` to `u32` using the `as`
 272   operator has been defined as a saturating operation.][71269] This was previously
 273   undefined behaviour, but you can use the `{f64, f32}::to_int_unchecked` methods to
 274   continue using the current behaviour, which may be desirable in rare performance
 275   sensitive situations.
 276
 277 Internal Only
 278 -------------
 279 These changes provide no direct user facing benefits, but represent significant
 280 improvements to the internals and overall performance of rustc and
 281 related tools.
 282
 283 - [dep_graph Avoid allocating a set on when the number reads are small.][69778]
 284 - [Replace big JS dict with JSON parsing.][71250]
 285
 286 [69373]: https://github.com/rust-lang/rust/pull/69373/
 287 [66059]: https://github.com/rust-lang/rust/pull/66059/
 288 [68191]: https://github.com/rust-lang/rust/pull/68191/
 289 [68899]: https://github.com/rust-lang/rust/pull/68899/
 290 [71147]: https://github.com/rust-lang/rust/pull/71147/
 291 [71250]: https://github.com/rust-lang/rust/pull/71250/
 292 [70937]: https://github.com/rust-lang/rust/pull/70937/
 293 [70969]: https://github.com/rust-lang/rust/pull/70969/
 294 [70632]: https://github.com/rust-lang/rust/pull/70632/
 295 [70281]: https://github.com/rust-lang/rust/pull/70281/
 296 [70345]: https://github.com/rust-lang/rust/pull/70345/
 297 [70048]: https://github.com/rust-lang/rust/pull/70048/
 298 [70081]: https://github.com/rust-lang/rust/pull/70081/
 299 [70156]: https://github.com/rust-lang/rust/pull/70156/
 300 [71269]: https://github.com/rust-lang/rust/pull/71269/
 301 [69838]: https://github.com/rust-lang/rust/pull/69838/
 302 [69929]: https://github.com/rust-lang/rust/pull/69929/
 303 [69661]: https://github.com/rust-lang/rust/pull/69661/
 304 [69778]: https://github.com/rust-lang/rust/pull/69778/
 305 [69494]: https://github.com/rust-lang/rust/pull/69494/
 306 [69403]: https://github.com/rust-lang/rust/pull/69403/
 307 [69033]: https://github.com/rust-lang/rust/pull/69033/
 308 [68692]: https://github.com/rust-lang/rust/pull/68692/
 309 [68334]: https://github.com/rust-lang/rust/pull/68334/
 310 [67502]: https://github.com/rust-lang/rust/pull/67502/
 311 [cargo/8062]: https://github.com/rust-lang/cargo/pull/8062/
 312 [`PathBuf::with_capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.with_capacity
 313 [`PathBuf::capacity`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.capacity
 314 [`PathBuf::clear`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.clear
 315 [`PathBuf::reserve`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve
 316 [`PathBuf::reserve_exact`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.reserve_exact
 317 [`PathBuf::shrink_to_fit`]: https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.shrink_to_fit
 318 [`f32::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_int_unchecked
 319 [`f64::to_int_unchecked`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_int_unchecked
 320 [`Layout::align_to`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.align_to
 321 [`Layout::pad_to_align`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.pad_to_align
 322 [`Layout::array`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.array
 323 [`Layout::extend`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html#method.extend
 324
 325
 326 Version 1.43.1 (2020-05-07)
 327 ===========================
 328
 329 * [Updated openssl-src to 1.1.1g for CVE-2020-1967.][71430]
 330 * [Fixed the stabilization of AVX-512 features.][71473]
 331 * [Fixed `cargo package --list` not working with unpublished dependencies.][cargo/8151]
 332
 333 [71430]: https://github.com/rust-lang/rust/pull/71430
 334 [71473]: https://github.com/rust-lang/rust/issues/71473
 335 [cargo/8151]: https://github.com/rust-lang/cargo/issues/8151
 336
 337
 338 Version 1.43.0 (2020-04-23)
 339 ==========================
 340
 341 Language
 342 --------
 343 - [Fixed using binary operations with `&{number}` (e.g. `&1.0`) not having
 344   the type inferred correctly.][68129]
 345 - [Attributes such as `#[cfg()]` can now be used on `if` expressions.][69201]
 346
 347 **Syntax only changes**
 348 - [Allow `type Foo: Ord` syntactically.][69361]
 349 - [Fuse associated and extern items up to defaultness.][69194]
 350 - [Syntactically allow `self` in all `fn` contexts.][68764]
 351 - [Merge `fn` syntax + cleanup item parsing.][68728]
 352 - [`item` macro fragments can be interpolated into `trait`s, `impl`s, and `extern` blocks.][69366]
 353   For example, you may now write:
 354   ```rust
 355   macro_rules! mac_trait {
 356       ($i:item) => {
 357           trait T { $i }
 358       }
 359   }
 360   mac_trait! {
 361       fn foo() {}
 362   }
 363   ```
 364
 365 These are still rejected *semantically*, so you will likely receive an error but
 366 these changes can be seen and parsed by macros and
 367 conditional compilation.
 368
 369
 370 Compiler
 371 --------
 372 - [You can now pass multiple lint flags to rustc to override the previous
 373   flags.][67885] For example; `rustc -D unused -A unused-variables` denies
 374   everything in the `unused` lint group except `unused-variables` which
 375   is explicitly allowed. However, passing `rustc -A unused-variables -D unused` denies
 376   everything in the `unused` lint group **including** `unused-variables` since
 377   the allow flag is specified before the deny flag (and therefore overridden).
 378 - [rustc will now prefer your system MinGW libraries over its bundled libraries
 379   if they are available on `windows-gnu`.][67429]
 380 - [rustc now buffers errors/warnings printed in JSON.][69227]
 381
 382 Libraries
 383 ---------
 384 - [`Arc<[T; N]>`, `Box<[T; N]>`, and `Rc<[T; N]>`, now implement
 385   `TryFrom<Arc<[T]>>`,`TryFrom<Box<[T]>>`, and `TryFrom<Rc<[T]>>`
 386   respectively.][69538] **Note** These conversions are only available when `N`
 387   is `0..=32`.
 388 - [You can now use associated constants on floats and integers directly, rather
 389   than having to import the module.][68952] e.g. You can now write `u32::MAX` or
 390   `f32::NAN` with no imports.
 391 - [`u8::is_ascii` is now `const`.][68984]
 392 - [`String` now implements `AsMut<str>`.][68742]
 393 - [Added the `primitive` module to `std` and `core`.][67637] This module
 394   reexports Rust's primitive types. This is mainly useful in macros
 395   where you want avoid these types being shadowed.
 396 - [Relaxed some of the trait bounds on `HashMap` and `HashSet`.][67642]
 397 - [`string::FromUtf8Error` now implements `Clone + Eq`.][68738]
 398
 399 Stabilized APIs
 400 ---------------
 401 - [`Once::is_completed`]
 402 - [`f32::LOG10_2`]
 403 - [`f32::LOG2_10`]
 404 - [`f64::LOG10_2`]
 405 - [`f64::LOG2_10`]
 406 - [`iter::once_with`]
 407
 408 Cargo
 409 -----
 410 - [You can now set config `[profile]`s in your `.cargo/config`, or through
 411   your environment.][cargo/7823]
 412 - [Cargo will now set `CARGO_BIN_EXE_<name>` pointing to a binary's
 413   executable path when running integration tests or benchmarks.][cargo/7697]
 414   `<name>` is the name of your binary as-is e.g. If you wanted the executable
 415   path for a binary named `my-program`you would use `env!("CARGO_BIN_EXE_my-program")`.
 416
 417 Misc
 418 ----
 419 - [Certain checks in the `const_err` lint were deemed unrelated to const
 420   evaluation][69185], and have been moved to the `unconditional_panic` and
 421   `arithmetic_overflow` lints.
 422
 423 Compatibility Notes
 424 -------------------
 425
 426 - [Having trailing syntax in the `assert!` macro is now a hard error.][69548] This
 427   has been a warning since 1.36.0.
 428 - [Fixed `Self` not having the correctly inferred type.][69340] This incorrectly
 429   led to some instances being accepted, and now correctly emits a hard error.
 430
 431 [69340]: https://github.com/rust-lang/rust/pull/69340
 432
 433 Internal Only
 434 -------------
 435 These changes provide no direct user facing benefits, but represent significant
 436 improvements to the internals and overall performance of `rustc` and
 437 related tools.
 438
 439 - [All components are now built with `opt-level=3` instead of `2`.][67878]
 440 - [Improved how rustc generates drop code.][67332]
 441 - [Improved performance from `#[inline]`-ing certain hot functions.][69256]
 442 - [traits: preallocate 2 Vecs of known initial size][69022]
 443 - [Avoid exponential behaviour when relating types][68772]
 444 - [Skip `Drop` terminators for enum variants without drop glue][68943]
 445 - [Improve performance of coherence checks][68966]
 446 - [Deduplicate types in the generator witness][68672]
 447 - [Invert control in struct_lint_level.][68725]
 448
 449 [67332]: https://github.com/rust-lang/rust/pull/67332/
 450 [67429]: https://github.com/rust-lang/rust/pull/67429/
 451 [67637]: https://github.com/rust-lang/rust/pull/67637/
 452 [67642]: https://github.com/rust-lang/rust/pull/67642/
 453 [67878]: https://github.com/rust-lang/rust/pull/67878/
 454 [67885]: https://github.com/rust-lang/rust/pull/67885/
 455 [68129]: https://github.com/rust-lang/rust/pull/68129/
 456 [68672]: https://github.com/rust-lang/rust/pull/68672/
 457 [68725]: https://github.com/rust-lang/rust/pull/68725/
 458 [68728]: https://github.com/rust-lang/rust/pull/68728/
 459 [68738]: https://github.com/rust-lang/rust/pull/68738/
 460 [68742]: https://github.com/rust-lang/rust/pull/68742/
 461 [68764]: https://github.com/rust-lang/rust/pull/68764/
 462 [68772]: https://github.com/rust-lang/rust/pull/68772/
 463 [68943]: https://github.com/rust-lang/rust/pull/68943/
 464 [68952]: https://github.com/rust-lang/rust/pull/68952/
 465 [68966]: https://github.com/rust-lang/rust/pull/68966/
 466 [68984]: https://github.com/rust-lang/rust/pull/68984/
 467 [69022]: https://github.com/rust-lang/rust/pull/69022/
 468 [69185]: https://github.com/rust-lang/rust/pull/69185/
 469 [69194]: https://github.com/rust-lang/rust/pull/69194/
 470 [69201]: https://github.com/rust-lang/rust/pull/69201/
 471 [69227]: https://github.com/rust-lang/rust/pull/69227/
 472 [69548]: https://github.com/rust-lang/rust/pull/69548/
 473 [69256]: https://github.com/rust-lang/rust/pull/69256/
 474 [69361]: https://github.com/rust-lang/rust/pull/69361/
 475 [69366]: https://github.com/rust-lang/rust/pull/69366/
 476 [69538]: https://github.com/rust-lang/rust/pull/69538/
 477 [cargo/7823]: https://github.com/rust-lang/cargo/pull/7823
 478 [cargo/7697]: https://github.com/rust-lang/cargo/pull/7697
 479 [`Once::is_completed`]: https://doc.rust-lang.org/std/sync/struct.Once.html#method.is_completed
 480 [`f32::LOG10_2`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG10_2.html
 481 [`f32::LOG2_10`]: https://doc.rust-lang.org/std/f32/consts/constant.LOG2_10.html
 482 [`f64::LOG10_2`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG10_2.html
 483 [`f64::LOG2_10`]: https://doc.rust-lang.org/std/f64/consts/constant.LOG2_10.html
 484 [`iter::once_with`]: https://doc.rust-lang.org/std/iter/fn.once_with.html
 485
 486
 487 Version 1.42.0 (2020-03-12)
 488 ==========================
 489
 490 Language
 491 --------
 492 - [You can now use the slice pattern syntax with subslices.][67712] e.g.
 493   ```rust
 494   fn foo(words: &[&str]) {
 495       match words {
 496           ["Hello", "World", "!", ..] => println!("Hello World!"),
 497           ["Foo", "Bar", ..] => println!("Baz"),
 498           rest => println!("{:?}", rest),
 499       }
 500   }
 501   ```
 502 - [You can now use `#[repr(transparent)]` on univariant `enum`s.][68122] Meaning
 503   that you can create an enum that has the exact layout and ABI of the type
 504   it contains.
 505 - [There are some *syntax-only* changes:][67131]
 506    - `default` is syntactically allowed before items in `trait` definitions.
 507    - Items in `impl`s (i.e. `const`s, `type`s, and `fn`s) may syntactically
 508      leave out their bodies in favor of `;`.
 509    - Bounds on associated types in `impl`s are now syntactically allowed
 510      (e.g. `type Foo: Ord;`).
 511    - `...` (the C-variadic type) may occur syntactically directly as the type of
 512       any function parameter.
 513
 514   These are still rejected *semantically*, so you will likely receive an error
 515   but these changes can be seen and parsed by procedural macros and
 516   conditional compilation.
 517
 518 Compiler
 519 --------
 520 - [Added tier 2\* support for `armv7a-none-eabi`.][68253]
 521 - [Added tier 2 support for `riscv64gc-unknown-linux-gnu`.][68339]
 522 - [`Option::{expect,unwrap}` and
 523    `Result::{expect, expect_err, unwrap, unwrap_err}` now produce panic messages
 524    pointing to the location where they were called, rather than
 525    `core`'s internals. ][67887]
 526
 527 \* Refer to Rust's [platform support page][forge-platform-support] for more
 528 information on Rust's tiered platform support.
 529
 530 Libraries
 531 ---------
 532 - [`iter::Empty<T>` now implements `Send` and `Sync` for any `T`.][68348]
 533 - [`Pin::{map_unchecked, map_unchecked_mut}` no longer require the return type
 534    to implement `Sized`.][67935]
 535 - [`io::Cursor` now derives `PartialEq` and `Eq`.][67233]
 536 - [`Layout::new` is now `const`.][66254]
 537 - [Added Standard Library support for `riscv64gc-unknown-linux-gnu`.][66899]
 538
 539
 540 Stabilized APIs
 541 ---------------
 542 - [`CondVar::wait_while`]
 543 - [`CondVar::wait_timeout_while`]
 544 - [`DebugMap::key`]
 545 - [`DebugMap::value`]
 546 - [`ManuallyDrop::take`]
 547 - [`matches!`]
 548 - [`ptr::slice_from_raw_parts_mut`]
 549 - [`ptr::slice_from_raw_parts`]
 550
 551 Cargo
 552 -----
 553 - [You no longer need to include `extern crate proc_macro;` to be able to
 554   `use proc_macro;` in the `2018` edition.][cargo/7700]
 555
 556 Compatibility Notes
 557 -------------------
 558 - [`Error::description` has been deprecated, and its use will now produce a
 559   warning.][66919] It's recommended to use `Display`/`to_string` instead.
 560
 561 [68253]: https://github.com/rust-lang/rust/pull/68253/
 562 [68348]: https://github.com/rust-lang/rust/pull/68348/
 563 [67935]: https://github.com/rust-lang/rust/pull/67935/
 564 [68339]: https://github.com/rust-lang/rust/pull/68339/
 565 [68122]: https://github.com/rust-lang/rust/pull/68122/
 566 [67712]: https://github.com/rust-lang/rust/pull/67712/
 567 [67887]: https://github.com/rust-lang/rust/pull/67887/
 568 [67131]: https://github.com/rust-lang/rust/pull/67131/
 569 [67233]: https://github.com/rust-lang/rust/pull/67233/
 570 [66899]: https://github.com/rust-lang/rust/pull/66899/
 571 [66919]: https://github.com/rust-lang/rust/pull/66919/
 572 [66254]: https://github.com/rust-lang/rust/pull/66254/
 573 [cargo/7700]: https://github.com/rust-lang/cargo/pull/7700
 574 [`DebugMap::key`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.key
 575 [`DebugMap::value`]: https://doc.rust-lang.org/stable/std/fmt/struct.DebugMap.html#method.value
 576 [`ManuallyDrop::take`]: https://doc.rust-lang.org/stable/std/mem/struct.ManuallyDrop.html#method.take
 577 [`matches!`]: https://doc.rust-lang.org/stable/std/macro.matches.html
 578 [`ptr::slice_from_raw_parts_mut`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts_mut.html
 579 [`ptr::slice_from_raw_parts`]: https://doc.rust-lang.org/stable/std/ptr/fn.slice_from_raw_parts.html
 580 [`CondVar::wait_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_while
 581 [`CondVar::wait_timeout_while`]: https://doc.rust-lang.org/stable/std/sync/struct.Condvar.html#method.wait_timeout_while
 582
 583
 584 Version 1.41.1 (2020-02-27)
 585 ===========================
 586
 587 * [Always check types of static items][69145]
 588 * [Always check lifetime bounds of `Copy` impls][69145]
 589 * [Fix miscompilation in callers of `Layout::repeat`][69225]
 590
 591 [69225]: https://github.com/rust-lang/rust/issues/69225
 592 [69145]: https://github.com/rust-lang/rust/pull/69145
 593
 594
 595 Version 1.41.0 (2020-01-30)
 596 ===========================
 597
 598 Language
 599 --------
 600
 601 - [You can now pass type parameters to foreign items when implementing
 602   traits.][65879] E.g. You can now write `impl<T> From<Foo> for Vec<T> {}`.
 603 - [You can now arbitrarily nest receiver types in the `self` position.][64325] E.g. you can
 604   now write `fn foo(self: Box<Box<Self>>) {}`. Previously only `Self`, `&Self`,
 605   `&mut Self`, `Arc<Self>`, `Rc<Self>`, and `Box<Self>` were allowed.
 606 - [You can now use any valid identifier in a `format_args` macro.][66847]
 607   Previously identifiers starting with an underscore were not allowed.
 608 - [Visibility modifiers (e.g. `pub`) are now syntactically allowed on trait items and
 609   enum variants.][66183] These are still rejected semantically, but
 610   can be seen and parsed by procedural macros and conditional compilation.
 611
 612 Compiler
 613 --------
 614
 615 - [Rustc will now warn if you have unused loop `'label`s.][66325]
 616 - [Removed support for the `i686-unknown-dragonfly` target.][67255]
 617 - [Added tier 3 support\* for the `riscv64gc-unknown-linux-gnu` target.][66661]
 618 - [You can now pass an arguments file passing the `@path` syntax
 619   to rustc.][66172] Note that the format differs somewhat from what is
 620   found in other tooling; please see [the documentation][argfile-docs] for
 621   more information.
 622 - [You can now provide `--extern` flag without a path, indicating that it is
 623   available from the search path or specified with an `-L` flag.][64882]
 624
 625 \* Refer to Rust's [platform support page][forge-platform-support] for more
 626 information on Rust's tiered platform support.
 627
 628 [argfile-docs]: https://doc.rust-lang.org/nightly/rustc/command-line-arguments.html#path-load-command-line-flags-from-a-path
 629
 630 Libraries
 631 ---------
 632
 633 - [The `core::panic` module is now stable.][66771] It was already stable
 634   through `std`.
 635 - [`NonZero*` numerics now implement `From<NonZero*>` if it's a smaller integer
 636   width.][66277] E.g. `NonZeroU16` now implements `From<NonZeroU8>`.
 637 - [`MaybeUninit<T>` now implements `fmt::Debug`.][65013]
 638
 639 Stabilized APIs
 640 ---------------
 641
 642 - [`Result::map_or`]
 643 - [`Result::map_or_else`]
 644 - [`std::rc::Weak::weak_count`]
 645 - [`std::rc::Weak::strong_count`]
 646 - [`std::sync::Weak::weak_count`]
 647 - [`std::sync::Weak::strong_count`]
 648
 649 Cargo
 650 -----
 651
 652 - [Cargo will now document all the private items for binary crates
 653   by default.][cargo/7593]
 654 - [`cargo-install` will now reinstall the package if it detects that it is out
 655   of date.][cargo/7560]
 656 - [Cargo.lock now uses a more git friendly format that should help to reduce
 657   merge conflicts.][cargo/7579]
 658 - [You can now override specific dependencies's build settings][cargo/7591] E.g.
 659   `[profile.dev.package.image] opt-level = 2` sets the `image` crate's
 660   optimisation level to `2` for debug builds. You can also use
 661   `[profile.<profile>.build-override]` to override build scripts and
 662   their dependencies.
 663
 664 Misc
 665 ----
 666
 667 - [You can now specify `edition` in documentation code blocks to compile the block
 668   for that edition.][66238] E.g. `edition2018` tells rustdoc that the code sample
 669   should be compiled the 2018 edition of Rust.
 670 - [You can now provide custom themes to rustdoc with `--theme`, and check the
 671   current theme with `--check-theme`.][54733]
 672 - [You can use `#[cfg(doc)]` to compile an item when building documentation.][61351]
 673
 674 Compatibility Notes
 675 -------------------
 676
 677 - [As previously announced 1.41.0 will be the last tier 1 release for 32-bit
 678   Apple targets.][apple-32bit-drop] This means that the source code is still
 679   available to build, but the targets are no longer being tested and release
 680   binaries for those platforms will no longer be distributed by the Rust project.
 681   Please refer to the linked blog post for more information.
 682
 683 [54733]: https://github.com/rust-lang/rust/pull/54733/
 684 [61351]: https://github.com/rust-lang/rust/pull/61351/
 685 [67255]: https://github.com/rust-lang/rust/pull/67255/
 686 [66661]: https://github.com/rust-lang/rust/pull/66661/
 687 [66771]: https://github.com/rust-lang/rust/pull/66771/
 688 [66847]: https://github.com/rust-lang/rust/pull/66847/
 689 [66238]: https://github.com/rust-lang/rust/pull/66238/
 690 [66277]: https://github.com/rust-lang/rust/pull/66277/
 691 [66325]: https://github.com/rust-lang/rust/pull/66325/
 692 [66172]: https://github.com/rust-lang/rust/pull/66172/
 693 [66183]: https://github.com/rust-lang/rust/pull/66183/
 694 [65879]: https://github.com/rust-lang/rust/pull/65879/
 695 [65013]: https://github.com/rust-lang/rust/pull/65013/
 696 [64882]: https://github.com/rust-lang/rust/pull/64882/
 697 [64325]: https://github.com/rust-lang/rust/pull/64325/
 698 [cargo/7560]: https://github.com/rust-lang/cargo/pull/7560/
 699 [cargo/7579]: https://github.com/rust-lang/cargo/pull/7579/
 700 [cargo/7591]: https://github.com/rust-lang/cargo/pull/7591/
 701 [cargo/7593]: https://github.com/rust-lang/cargo/pull/7593/
 702 [`Result::map_or_else`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or_else
 703 [`Result::map_or`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.map_or
 704 [`std::rc::Weak::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.weak_count
 705 [`std::rc::Weak::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Weak.html#method.strong_count
 706 [`std::sync::Weak::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.weak_count
 707 [`std::sync::Weak::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Weak.html#method.strong_count
 708 [apple-32bit-drop]: https://blog.rust-lang.org/2020/01/03/reducing-support-for-32-bit-apple-targets.html
 709
 710 Version 1.40.0 (2019-12-19)
 711 ===========================
 712
 713 Language
 714 --------
 715 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
 716   `const` contexts.][65188] e.g.
 717
 718   ```rust
 719   pub struct Point(i32, i32);
 720
 721   const ORIGIN: Point = {
 722       let constructor = Point;
 723
 724       constructor(0, 0)
 725   };
 726   ```
 727
 728 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
 729   indicate that there may be variants or fields added in the future.][64639]
 730   For example this requires adding a wild-card branch (`_ => {}`) to any match
 731   statements on a non-exhaustive `enum`. [(RFC 2008)]
 732 - [You can now use function-like procedural macros in `extern` blocks and in
 733   type positions.][63931] e.g. `type Generated = macro!();`
 734 - [Function-like and attribute procedural macros can now emit
 735   `macro_rules!` items, so you can now have your macros generate macros.][64035]
 736 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
 737   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
 738   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
 739
 740 Compiler
 741 --------
 742 - [Added tier 3 support\* for the
 743   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
 744 - [Added tier 3 support for the
 745   `aarch64-unknown-none-softfloat` target.][64589]
 746 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
 747   `mips64el-unknown-linux-muslabi64` targets.][65843]
 748
 749 \* Refer to Rust's [platform support page][forge-platform-support] for more
 750   information on Rust's tiered platform support.
 751
 752 Libraries
 753 ---------
 754 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
 755
 756 Stabilized APIs
 757 ---------------
 758 - [`BTreeMap::get_key_value`]
 759 - [`HashMap::get_key_value`]
 760 - [`Option::as_deref_mut`]
 761 - [`Option::as_deref`]
 762 - [`Option::flatten`]
 763 - [`UdpSocket::peer_addr`]
 764 - [`f32::to_be_bytes`]
 765 - [`f32::to_le_bytes`]
 766 - [`f32::to_ne_bytes`]
 767 - [`f64::to_be_bytes`]
 768 - [`f64::to_le_bytes`]
 769 - [`f64::to_ne_bytes`]
 770 - [`f32::from_be_bytes`]
 771 - [`f32::from_le_bytes`]
 772 - [`f32::from_ne_bytes`]
 773 - [`f64::from_be_bytes`]
 774 - [`f64::from_le_bytes`]
 775 - [`f64::from_ne_bytes`]
 776 - [`mem::take`]
 777 - [`slice::repeat`]
 778 - [`todo!`]
 779
 780 Cargo
 781 -----
 782 - [Cargo will now always display warnings, rather than only on
 783   fresh builds.][cargo/7450]
 784 - [Feature flags (except `--all-features`) passed to a virtual workspace will
 785   now produce an error.][cargo/7507] Previously these flags were ignored.
 786 - [You can now publish `dev-dependencies` without including
 787   a `version`.][cargo/7333]
 788
 789 Misc
 790 ----
 791 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
 792   when running documentation tests with `rustdoc`.][63803]
 793
 794 Compatibility Notes
 795 -------------------
 796 - [As previously announced, any previous NLL warnings in the 2015 edition are
 797   now hard errors.][64221]
 798 - [The `include!` macro will now warn if it failed to include the
 799   entire file.][64284] The `include!` macro unintentionally only includes the
 800   first _expression_ in a file, and this can be unintuitive. This will become
 801   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
 802 - [Using `#[inline]` on function prototypes and consts now emits a warning under
 803   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
 804   or `extern` blocks now correctly emits a hard error.
 805
 806 [65294]: https://github.com/rust-lang/rust/pull/65294/
 807 [66103]: https://github.com/rust-lang/rust/pull/66103/
 808 [65843]: https://github.com/rust-lang/rust/pull/65843/
 809 [65188]: https://github.com/rust-lang/rust/pull/65188/
 810 [65092]: https://github.com/rust-lang/rust/pull/65092/
 811 [64589]: https://github.com/rust-lang/rust/pull/64589/
 812 [64639]: https://github.com/rust-lang/rust/pull/64639/
 813 [64221]: https://github.com/rust-lang/rust/pull/64221/
 814 [64284]: https://github.com/rust-lang/rust/pull/64284/
 815 [63931]: https://github.com/rust-lang/rust/pull/63931/
 816 [64035]: https://github.com/rust-lang/rust/pull/64035/
 817 [63674]: https://github.com/rust-lang/rust/pull/63674/
 818 [63803]: https://github.com/rust-lang/rust/pull/63803/
 819 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
 820 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
 821 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
 822 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
 823 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
 824 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
 825 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
 826 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
 827 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
 828 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
 829 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
 830 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
 831 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
 832 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
 833 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
 834 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
 835 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
 836 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
 837 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
 838 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
 839 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
 840 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
 841 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
 842 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
 843 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
 844 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
 845
 846
 847 Version 1.39.0 (2019-11-07)
 848 ===========================
 849
 850 Language
 851 --------
 852 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
 853   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
 854 - [You can now use certain attributes on function, closure, and function pointer
 855   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
 856   `deny`, `forbid` as well as inert helper attributes used by procedural macro
 857   attributes applied to items. e.g.
 858   ```rust
 859   fn len(
 860       #[cfg(windows)] slice: &[u16],
 861       #[cfg(not(windows))] slice: &[u8],
 862   ) -> usize {
 863       slice.len()
 864   }
 865   ```
 866 - [You can now take shared references to bind-by-move patterns in the `if` guards
 867   of `match` arms.][63118] e.g.
 868   ```rust
 869   fn main() {
 870       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
 871
 872       match array {
 873           nums
 874   //      ---- `nums` is bound by move.
 875               if nums.iter().sum::<u8>() == 10
 876   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
 877           => {
 878               drop(nums);
 879   //          ----------- Legal as `nums` was bound by move and so we have ownership.
 880           }
 881           _ => unreachable!(),
 882       }
 883   }
 884   ```
 885
 886
 887
 888 Compiler
 889 --------
 890 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
 891 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
 892 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
 893   **Note** Cargo currently doesn't use this feature. Refer to
 894   [cargo#7315][cargo/7315] to track this feature's progress.
 895 - [You can now pass `--show-output` argument to test binaries to print the
 896   output of successful tests.][62600]
 897
 898
 899 \* Refer to Rust's [platform support page][forge-platform-support] for more
 900 information on Rust's tiered platform support.
 901
 902 Libraries
 903 ---------
 904 - [`Vec::new` and `String::new` are now `const` functions.][64028]
 905 - [`LinkedList::new` is now a `const` function.][63684]
 906 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
 907 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
 908   now `const`.][63786]
 909
 910 Stabilized APIs
 911 ---------------
 912 - [`Pin::into_inner`]
 913 - [`Instant::checked_duration_since`]
 914 - [`Instant::saturating_duration_since`]
 915
 916 Cargo
 917 -----
 918 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
 919 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
 920   `--all` is now deprecated.
 921
 922 Misc
 923 ----
 924 - [You can now pass `-Clinker` to rustdoc to control the linker used
 925   for compiling doctests.][63834]
 926
 927 Compatibility Notes
 928 -------------------
 929 - [Code that was previously accepted by the old borrow checker, but rejected by
 930   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
 931   previously a warning, and will also become a hard error in the Rust 2015
 932   edition in the 1.40.0 release.
 933 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
 934   run tests.][63827] This should improve performance when running a large
 935   amount of doctests.
 936 - [The `try!` macro will now issue a deprecation warning.][62672] It is
 937   recommended to use the `?` operator instead.
 938 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
 939   returned `0.0`.
 940
 941 [62600]: https://github.com/rust-lang/rust/pull/62600/
 942 [62672]: https://github.com/rust-lang/rust/pull/62672/
 943 [63118]: https://github.com/rust-lang/rust/pull/63118/
 944 [63209]: https://github.com/rust-lang/rust/pull/63209/
 945 [63402]: https://github.com/rust-lang/rust/pull/63402/
 946 [63565]: https://github.com/rust-lang/rust/pull/63565/
 947 [63595]: https://github.com/rust-lang/rust/pull/63595/
 948 [63684]: https://github.com/rust-lang/rust/pull/63684/
 949 [63698]: https://github.com/rust-lang/rust/pull/63698/
 950 [63770]: https://github.com/rust-lang/rust/pull/63770/
 951 [63786]: https://github.com/rust-lang/rust/pull/63786/
 952 [63827]: https://github.com/rust-lang/rust/pull/63827/
 953 [63834]: https://github.com/rust-lang/rust/pull/63834/
 954 [63927]: https://github.com/rust-lang/rust/pull/63927/
 955 [63933]: https://github.com/rust-lang/rust/pull/63933/
 956 [63934]: https://github.com/rust-lang/rust/pull/63934/
 957 [63938]: https://github.com/rust-lang/rust/pull/63938/
 958 [63940]: https://github.com/rust-lang/rust/pull/63940/
 959 [63941]: https://github.com/rust-lang/rust/pull/63941/
 960 [63945]: https://github.com/rust-lang/rust/pull/63945/
 961 [64010]: https://github.com/rust-lang/rust/pull/64010/
 962 [64028]: https://github.com/rust-lang/rust/pull/64028/
 963 [64334]: https://github.com/rust-lang/rust/pull/64334/
 964 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
 965 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
 966 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
 967 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
 968 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
 969 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
 970
 971 Version 1.38.0 (2019-09-26)
 972 ==========================
 973
 974 Language
 975 --------
 976 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
 977 - [The `#[deprecated]` attribute can now be used on macros.][62042]
 978
 979 Compiler
 980 --------
 981 - [Added pipelined compilation support to `rustc`.][62766] This will
 982   improve compilation times in some cases. For further information please refer
 983   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
 984 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
 985   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
 986   `x86_64-uwp-windows-msvc` targets.][60260]
 987 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
 988   `armv7-unknown-linux-musleabi` targets.][63107]
 989 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
 990 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
 991
 992 \* Refer to Rust's [platform support page][forge-platform-support] for more
 993 information on Rust's tiered platform support.
 994
 995 Libraries
 996 ---------
 997 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
 998 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
 999   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
1000   is available at `std::clone::Clone`). This also makes all built-in macros
1001   available in `std`/`core` root. e.g. `std::include_bytes!`.
1002 - [`str::Chars` now implements `Debug`.][63000]
1003 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
1004 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
1005 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
1006 - [Added euclidean remainder and division operations (`div_euclid`,
1007   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
1008   `overflowing`, and `wrapping` versions are available for all
1009   integer primitives.
1010 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
1011   `PartialEq`.][61491]
1012 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
1013
1014 Stabilized APIs
1015 ---------------
1016 - [`<*const T>::cast`]
1017 - [`<*mut T>::cast`]
1018 - [`Duration::as_secs_f32`]
1019 - [`Duration::as_secs_f64`]
1020 - [`Duration::div_f32`]
1021 - [`Duration::div_f64`]
1022 - [`Duration::from_secs_f32`]
1023 - [`Duration::from_secs_f64`]
1024 - [`Duration::mul_f32`]
1025 - [`Duration::mul_f64`]
1026 - [`any::type_name`]
1027
1028 Cargo
1029 -----
1030 - [Added pipelined compilation support to `cargo`.][cargo/7143]
1031 - [You can now pass the `--features` option multiple times to enable
1032   multiple features.][cargo/7084]
1033
1034 Misc
1035 ----
1036 - [`rustc` will now warn about some incorrect uses of
1037   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
1038
1039 Compatibility Notes
1040 -------------------
1041 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
1042   1.38.0.
1043 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
1044   issues][62896] with certain crates such as libc.
1045
1046 [60260]: https://github.com/rust-lang/rust/pull/60260/
1047 [61457]: https://github.com/rust-lang/rust/pull/61457/
1048 [61491]: https://github.com/rust-lang/rust/pull/61491/
1049 [61884]: https://github.com/rust-lang/rust/pull/61884/
1050 [61953]: https://github.com/rust-lang/rust/pull/61953/
1051 [62042]: https://github.com/rust-lang/rust/pull/62042/
1052 [62528]: https://github.com/rust-lang/rust/pull/62528/
1053 [62583]: https://github.com/rust-lang/rust/pull/62583/
1054 [62735]: https://github.com/rust-lang/rust/pull/62735/
1055 [62766]: https://github.com/rust-lang/rust/pull/62766/
1056 [62784]: https://github.com/rust-lang/rust/pull/62784/
1057 [62785]: https://github.com/rust-lang/rust/issues/62785/
1058 [62814]: https://github.com/rust-lang/rust/pull/62814/
1059 [62896]: https://github.com/rust-lang/rust/issues/62896/
1060 [63000]: https://github.com/rust-lang/rust/pull/63000/
1061 [63056]: https://github.com/rust-lang/rust/pull/63056/
1062 [63107]: https://github.com/rust-lang/rust/pull/63107/
1063 [63346]: https://github.com/rust-lang/rust/pull/63346/
1064 [63421]: https://github.com/rust-lang/rust/pull/63421/
1065 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
1066 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
1067 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1068 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
1069 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
1070 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
1071 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
1072 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
1073 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
1074 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
1075 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
1076 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
1077 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
1078 [forge-platform-support]: https://forge.rust-lang.org/release/platform-support.html
1079 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
1080
1081 Version 1.37.0 (2019-08-15)
1082 ==========================
1083
1084 Language
1085 --------
1086 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
1087   [`Box`][62228], or an [array][62235] and unused.
1088 - [You can now use the `cfg` and `cfg_attr` attributes on
1089   generic parameters.][61547]
1090 - [You can now use enum variants through type alias.][61682] e.g. You can
1091   write the following:
1092   ```rust
1093   type MyOption = Option<u8>;
1094
1095   fn increment_or_zero(x: MyOption) -> u8 {
1096       match x {
1097           MyOption::Some(y) => y + 1,
1098           MyOption::None => 0,
1099       }
1100   }
1101   ```
1102 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
1103   `const _: u32 = 5;`.
1104 - [You can now use `#[repr(align(X)]` on enums.][61229]
1105 - [The  `?` Kleene macro operator is now available in the
1106   2015 edition.][60932]
1107
1108 Compiler
1109 --------
1110 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
1111   and `-C profile-use` flags.][61268] For more information on how to use profile
1112   guided optimization, please refer to the [rustc book][rustc-book-pgo].
1113 - [The `rust-lldb` wrapper script should now work again.][61827]
1114
1115 Libraries
1116 ---------
1117 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
1118
1119 Stabilized APIs
1120 ---------------
1121 - [`BufReader::buffer`]
1122 - [`BufWriter::buffer`]
1123 - [`Cell::from_mut`]
1124 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
1125 - [`DoubleEndedIterator::nth_back`]
1126 - [`Option::xor`]
1127 - [`Wrapping::reverse_bits`]
1128 - [`i128::reverse_bits`]
1129 - [`i16::reverse_bits`]
1130 - [`i32::reverse_bits`]
1131 - [`i64::reverse_bits`]
1132 - [`i8::reverse_bits`]
1133 - [`isize::reverse_bits`]
1134 - [`slice::copy_within`]
1135 - [`u128::reverse_bits`]
1136 - [`u16::reverse_bits`]
1137 - [`u32::reverse_bits`]
1138 - [`u64::reverse_bits`]
1139 - [`u8::reverse_bits`]
1140 - [`usize::reverse_bits`]
1141
1142 Cargo
1143 -----
1144 - [`Cargo.lock` files are now included by default when publishing executable crates
1145   with executables.][cargo/7026]
1146 - [You can now specify `default-run="foo"` in `[package]` to specify the
1147   default executable to use for `cargo run`.][cargo/7056]
1148
1149 Misc
1150 ----
1151
1152 Compatibility Notes
1153 -------------------
1154 - [Using `...` for inclusive range patterns will now warn by default.][61342]
1155   Please transition your code to using the `..=` syntax for inclusive
1156   ranges instead.
1157 - [Using a trait object without the `dyn` will now warn by default.][61203]
1158   Please transition your code to use `dyn Trait` for trait objects instead.
1159
1160 [62228]: https://github.com/rust-lang/rust/pull/62228/
1161 [62235]: https://github.com/rust-lang/rust/pull/62235/
1162 [61802]: https://github.com/rust-lang/rust/pull/61802/
1163 [61827]: https://github.com/rust-lang/rust/pull/61827/
1164 [61547]: https://github.com/rust-lang/rust/pull/61547/
1165 [61682]: https://github.com/rust-lang/rust/pull/61682/
1166 [61268]: https://github.com/rust-lang/rust/pull/61268/
1167 [61342]: https://github.com/rust-lang/rust/pull/61342/
1168 [61347]: https://github.com/rust-lang/rust/pull/61347/
1169 [61100]: https://github.com/rust-lang/rust/pull/61100/
1170 [61203]: https://github.com/rust-lang/rust/pull/61203/
1171 [61229]: https://github.com/rust-lang/rust/pull/61229/
1172 [60932]: https://github.com/rust-lang/rust/pull/60932/
1173 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
1174 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
1175 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
1176 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
1177 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
1178 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
1179 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
1180 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
1181 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
1182 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
1183 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
1184 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
1185 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
1186 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
1187 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
1188 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
1189 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
1190 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
1191 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
1192 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
1193 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
1194 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
1195 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
1196 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
1197
1198
1199 Version 1.36.0 (2019-07-04)
1200 ==========================
1201
1202 Language
1203 --------
1204 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
1205 - [The order of traits in trait objects no longer affects the semantics of that
1206   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
1207   `dyn fmt::Debug + Send`, where this was previously not the case.
1208
1209 Libraries
1210 ---------
1211 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
1212 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
1213 - [`mem::needs_drop` is now available as a const fn.][60364]
1214 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
1215 - [`String` now implements `BorrowMut<str>`.][60404]
1216 - [`io::Cursor` now implements `Default`.][60234]
1217 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
1218 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
1219   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
1220   environment has access to heap memory allocation.
1221 - [`String` now implements `From<&String>`.][59825]
1222 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
1223   return a tuple of each argument when there is multiple arguments.
1224 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
1225   not used.][59648]
1226
1227 Stabilized APIs
1228 ---------------
1229 - [`VecDeque::rotate_left`]
1230 - [`VecDeque::rotate_right`]
1231 - [`Iterator::copied`]
1232 - [`io::IoSlice`]
1233 - [`io::IoSliceMut`]
1234 - [`Read::read_vectored`]
1235 - [`Write::write_vectored`]
1236 - [`str::as_mut_ptr`]
1237 - [`mem::MaybeUninit`]
1238 - [`pointer::align_offset`]
1239 - [`future::Future`]
1240 - [`task::Context`]
1241 - [`task::RawWaker`]
1242 - [`task::RawWakerVTable`]
1243 - [`task::Waker`]
1244 - [`task::Poll`]
1245
1246 Cargo
1247 -----
1248 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
1249 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
1250
1251 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
1252
1253 Clippy
1254 ------
1255 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
1256
1257 Misc
1258 ----
1259
1260 Compatibility Notes
1261 -------------------
1262 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
1263   longer recommended, and will be deprecated in 1.39.0.
1264
1265 [60318]: https://github.com/rust-lang/rust/pull/60318/
1266 [60364]: https://github.com/rust-lang/rust/pull/60364/
1267 [60370]: https://github.com/rust-lang/rust/pull/60370/
1268 [60404]: https://github.com/rust-lang/rust/pull/60404/
1269 [60234]: https://github.com/rust-lang/rust/pull/60234/
1270 [60244]: https://github.com/rust-lang/rust/pull/60244/
1271 [58623]: https://github.com/rust-lang/rust/pull/58623/
1272 [59648]: https://github.com/rust-lang/rust/pull/59648/
1273 [59675]: https://github.com/rust-lang/rust/pull/59675/
1274 [59825]: https://github.com/rust-lang/rust/pull/59825/
1275 [59826]: https://github.com/rust-lang/rust/pull/59826/
1276 [59445]: https://github.com/rust-lang/rust/pull/59445/
1277 [59114]: https://github.com/rust-lang/rust/pull/59114/
1278 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
1279 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
1280 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
1281 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
1282 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
1283 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
1284 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
1285 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
1286 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
1287 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
1288 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
1289 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
1290 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
1291 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
1292 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
1293 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
1294 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
1295 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
1296 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
1297 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
1298
1299
1300 Version 1.35.0 (2019-05-23)
1301 ==========================
1302
1303 Language
1304 --------
1305 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
1306   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
1307 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
1308   ```rust
1309   unsafe fn call_unsafe(func: unsafe fn()) {
1310       func()
1311   }
1312
1313   pub fn main() {
1314       unsafe { call_unsafe(|| {}); }
1315   }
1316   ```
1317
1318
1319 Compiler
1320 --------
1321 - [Added the `armv6-unknown-freebsd-gnueabihf` and
1322   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
1323 - [Added the `wasm32-unknown-wasi` target.][59464]
1324
1325
1326 Libraries
1327 ---------
1328 - [`Thread` will now show its ID in `Debug` output.][59460]
1329 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
1330 - [`alloc::System` now implements `Default`.][59451]
1331 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
1332   last field.][59076]
1333 - [`char::{ToLowercase, ToUppercase}` now
1334   implement `ExactSizeIterator`.][58778]
1335 - [All `NonZero` numeric types now implement `FromStr`.][58717]
1336 - [Removed the `Read` trait bounds
1337   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
1338 - [You can now call the `dbg!` macro without any parameters to print the file
1339   and line where it is called.][57847]
1340 - [In place ASCII case conversions are now up to 4× faster.][59283]
1341   e.g. `str::make_ascii_lowercase`
1342 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
1343   and `Send`.][58369]
1344
1345 Stabilized APIs
1346 ---------------
1347 - [`f32::copysign`]
1348 - [`f64::copysign`]
1349 - [`RefCell::replace_with`]
1350 - [`RefCell::map_split`]
1351 - [`ptr::hash`]
1352 - [`Range::contains`]
1353 - [`RangeFrom::contains`]
1354 - [`RangeTo::contains`]
1355 - [`RangeInclusive::contains`]
1356 - [`RangeToInclusive::contains`]
1357 - [`Option::copied`]
1358
1359 Cargo
1360 -----
1361 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
1362   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
1363   platform specific.
1364
1365 Misc
1366 ----
1367 - [The Rust toolchain is now available natively for musl based distros.][58575]
1368
1369 [59460]: https://github.com/rust-lang/rust/pull/59460/
1370 [59464]: https://github.com/rust-lang/rust/pull/59464/
1371 [59500]: https://github.com/rust-lang/rust/pull/59500/
1372 [59512]: https://github.com/rust-lang/rust/pull/59512/
1373 [59580]: https://github.com/rust-lang/rust/pull/59580/
1374 [59283]: https://github.com/rust-lang/rust/pull/59283/
1375 [59451]: https://github.com/rust-lang/rust/pull/59451/
1376 [59076]: https://github.com/rust-lang/rust/pull/59076/
1377 [58778]: https://github.com/rust-lang/rust/pull/58778/
1378 [58717]: https://github.com/rust-lang/rust/pull/58717/
1379 [58369]: https://github.com/rust-lang/rust/pull/58369/
1380 [58423]: https://github.com/rust-lang/rust/pull/58423/
1381 [58080]: https://github.com/rust-lang/rust/pull/58080/
1382 [57847]: https://github.com/rust-lang/rust/pull/57847/
1383 [58575]: https://github.com/rust-lang/rust/pull/58575
1384 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
1385 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
1386 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
1387 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
1388 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
1389 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
1390 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
1391 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
1392 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
1393 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
1394 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
1395 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
1396
1397 Version 1.34.2 (2019-05-14)
1398 ===========================
1399
1400 * [Destabilize the `Error::type_id` function due to a security
1401    vulnerability][60785] ([CVE-2019-12083])
1402
1403 [60785]: https://github.com/rust-lang/rust/pull/60785
1404 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
1405
1406 Version 1.34.1 (2019-04-25)
1407 ===========================
1408
1409 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
1410 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
1411 * [Fix Clippy panic when checking some macros][clippy/3805]
1412
1413 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
1414 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
1415 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
1416
1417 Version 1.34.0 (2019-04-11)
1418 ==========================
1419
1420 Language
1421 --------
1422 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
1423   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
1424   but had no effect.
1425 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
1426   `#[attr{}]` procedural macros.][57367]
1427 - [You can now write `extern crate self as foo;`][57407] to import your
1428   crate's root into the extern prelude.
1429
1430
1431 Compiler
1432 --------
1433 - [You can now target `riscv64imac-unknown-none-elf` and
1434   `riscv64gc-unknown-none-elf`.][58406]
1435 - [You can now enable linker plugin LTO optimisations with
1436   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
1437   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
1438   boundaries.
1439 - [You can now target `powerpc64-unknown-freebsd`.][57809]
1440
1441
1442 Libraries
1443 ---------
1444 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
1445   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
1446   the `Hash` trait to create an iterator.
1447 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
1448   methods.][58421] Most notably you no longer require the `Ord` trait to create
1449   an iterator.
1450 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
1451   for all numeric types.][58044]
1452 - [Indexing a `str` is now generic over all types that
1453   implement `SliceIndex<str>`.][57604]
1454 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
1455   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
1456   produce a warning if their returning type is unused.
1457 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
1458   `overflowing_pow` are now available for all numeric types.][57873] These are
1459   equivalent to methods such as `wrapping_add` for the `pow` operation.
1460
1461
1462 Stabilized APIs
1463 ---------------
1464
1465 #### std & core
1466 * [`Any::type_id`]
1467 * [`Error::type_id`]
1468 * [`atomic::AtomicI16`]
1469 * [`atomic::AtomicI32`]
1470 * [`atomic::AtomicI64`]
1471 * [`atomic::AtomicI8`]
1472 * [`atomic::AtomicU16`]
1473 * [`atomic::AtomicU32`]
1474 * [`atomic::AtomicU64`]
1475 * [`atomic::AtomicU8`]
1476 * [`convert::Infallible`]
1477 * [`convert::TryFrom`]
1478 * [`convert::TryInto`]
1479 * [`iter::from_fn`]
1480 * [`iter::successors`]
1481 * [`num::NonZeroI128`]
1482 * [`num::NonZeroI16`]
1483 * [`num::NonZeroI32`]
1484 * [`num::NonZeroI64`]
1485 * [`num::NonZeroI8`]
1486 * [`num::NonZeroIsize`]
1487 * [`slice::sort_by_cached_key`]
1488 * [`str::escape_debug`]
1489 * [`str::escape_default`]
1490 * [`str::escape_unicode`]
1491 * [`str::split_ascii_whitespace`]
1492
1493 #### std
1494 * [`Instant::checked_add`]
1495 * [`Instant::checked_sub`]
1496 * [`SystemTime::checked_add`]
1497 * [`SystemTime::checked_sub`]
1498
1499 Cargo
1500 -----
1501 - [You can now use alternative registries to crates.io.][cargo/6654]
1502
1503 Misc
1504 ----
1505 - [You can now use the `?` operator in your documentation tests without manually
1506   adding `fn main() -> Result<(), _> {}`.][56470]
1507
1508 Compatibility Notes
1509 -------------------
1510 - [`Command::before_exec` is being replaced by the unsafe method
1511   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
1512 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
1513   can now use `const` functions in `static` variables.
1514
1515 [58370]: https://github.com/rust-lang/rust/pull/58370/
1516 [58406]: https://github.com/rust-lang/rust/pull/58406/
1517 [58421]: https://github.com/rust-lang/rust/pull/58421/
1518 [58166]: https://github.com/rust-lang/rust/pull/58166/
1519 [58044]: https://github.com/rust-lang/rust/pull/58044/
1520 [58057]: https://github.com/rust-lang/rust/pull/58057/
1521 [58059]: https://github.com/rust-lang/rust/pull/58059/
1522 [57809]: https://github.com/rust-lang/rust/pull/57809/
1523 [57873]: https://github.com/rust-lang/rust/pull/57873/
1524 [57604]: https://github.com/rust-lang/rust/pull/57604/
1525 [57367]: https://github.com/rust-lang/rust/pull/57367/
1526 [57407]: https://github.com/rust-lang/rust/pull/57407/
1527 [57425]: https://github.com/rust-lang/rust/pull/57425/
1528 [57106]: https://github.com/rust-lang/rust/pull/57106/
1529 [56470]: https://github.com/rust-lang/rust/pull/56470/
1530 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
1531 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
1532 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
1533 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
1534 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
1535 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
1536 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
1537 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
1538 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
1539 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
1540 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
1541 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
1542 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
1543 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
1544 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
1545 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
1546 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
1547 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
1548 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
1549 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
1550 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
1551 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
1552 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
1553 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
1554 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
1555 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
1556 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
1557 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
1558 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
1559 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
1560 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
1561
1562
1563 Version 1.33.0 (2019-02-28)
1564 ==========================
1565
1566 Language
1567 --------
1568 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
1569   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
1570 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
1571   E.g. You can have match statement on a `u8` that covers `0..=255` and
1572   you would no longer be required to have a `_ => unreachable!()` case.
1573 - [You can now have multiple patterns in `if let` and `while let`
1574   expressions.][57532] You can do this with the same syntax as a `match`
1575   expression. E.g.
1576   ```rust
1577   enum Creature {
1578       Crab(String),
1579       Lobster(String),
1580       Person(String),
1581   }
1582
1583   fn main() {
1584       let state = Creature::Crab("Ferris");
1585
1586       if let Creature::Crab(name) | Creature::Person(name) = state {
1587           println!("This creature's name is: {}", name);
1588       }
1589   }
1590   ```
1591 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
1592   this feature will by default produce a warning as this behaviour can be
1593   unintuitive. E.g. `if let _ = 5 {}`
1594 - [You can now use `let` bindings, assignments, expression statements,
1595   and irrefutable pattern destructuring in const functions.][57175]
1596 - [You can now call unsafe const functions.][57067] E.g.
1597   ```rust
1598   const unsafe fn foo() -> i32 { 5 }
1599   const fn bar() -> i32 {
1600       unsafe { foo() }
1601   }
1602   ```
1603 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
1604   E.g. `#[cfg_attr(all(), must_use, optimize)]`
1605 - [You can now specify a specific alignment with the `#[repr(packed)]`
1606   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
1607   with an alignment of 2 bytes and a size of 6 bytes.
1608 - [You can now import an item from a module as an `_`.][56303] This allows you to
1609   import a trait's impls, and not have the name in the namespace. E.g.
1610   ```rust
1611   use std::io::Read as _;
1612
1613   // Allowed as there is only one `Read` in the module.
1614   pub trait Read {}
1615   ```
1616 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
1617
1618 Compiler
1619 --------
1620 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
1621   command line argument.][56351]
1622 - [The minimum required LLVM version has been bumped to 6.0.][56642]
1623 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
1624 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
1625   tier 2 support.][57130] Visit the [platform support][platform-support] page for
1626   information on Rust's platform support.
1627 - [Added support for the `thumbv7neon-linux-androideabi` and
1628   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
1629 - [Added support for the `x86_64-unknown-uefi` target.][56769]
1630
1631 Libraries
1632 ---------
1633 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
1634   functions for all numeric types.][57566]
1635 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
1636   are now `const` functions for all numeric types.][57105]
1637 - [The methods `is_positive` and `is_negative` are now `const` functions for
1638   all signed numeric types.][57105]
1639 - [The `get` method for all `NonZero` types is now `const`.][57167]
1640 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
1641   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
1642   numeric types.][57234]
1643 - [`Ipv4Addr::new` is now a `const` function][57234]
1644
1645 Stabilized APIs
1646 ---------------
1647 - [`unix::FileExt::read_exact_at`]
1648 - [`unix::FileExt::write_all_at`]
1649 - [`Option::transpose`]
1650 - [`Result::transpose`]
1651 - [`convert::identity`]
1652 - [`pin::Pin`]
1653 - [`marker::Unpin`]
1654 - [`marker::PhantomPinned`]
1655 - [`Vec::resize_with`]
1656 - [`VecDeque::resize_with`]
1657 - [`Duration::as_millis`]
1658 - [`Duration::as_micros`]
1659 - [`Duration::as_nanos`]
1660
1661
1662 Cargo
1663 -----
1664 - [You can now publish crates that require a feature flag to compile with
1665   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
1666 - [Cargo should now rebuild a crate if a file was modified during the initial
1667   build.][cargo/6484]
1668
1669 Compatibility Notes
1670 -------------------
1671 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
1672   are now deprecated in the standard library, and their usage will now produce a warning.
1673   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
1674   methods instead.
1675 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
1676   downcasting.
1677 - [Libtest no longer creates a new thread for each test when
1678   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
1679
1680 [55982]: https://github.com/rust-lang/rust/pull/55982/
1681 [56243]: https://github.com/rust-lang/rust/pull/56243
1682 [56303]: https://github.com/rust-lang/rust/pull/56303/
1683 [56351]: https://github.com/rust-lang/rust/pull/56351/
1684 [56362]: https://github.com/rust-lang/rust/pull/56362
1685 [56642]: https://github.com/rust-lang/rust/pull/56642/
1686 [56769]: https://github.com/rust-lang/rust/pull/56769/
1687 [56805]: https://github.com/rust-lang/rust/pull/56805
1688 [56947]: https://github.com/rust-lang/rust/pull/56947/
1689 [57049]: https://github.com/rust-lang/rust/pull/57049/
1690 [57067]: https://github.com/rust-lang/rust/pull/57067/
1691 [57105]: https://github.com/rust-lang/rust/pull/57105
1692 [57130]: https://github.com/rust-lang/rust/pull/57130/
1693 [57167]: https://github.com/rust-lang/rust/pull/57167/
1694 [57175]: https://github.com/rust-lang/rust/pull/57175/
1695 [57234]: https://github.com/rust-lang/rust/pull/57234/
1696 [57332]: https://github.com/rust-lang/rust/pull/57332/
1697 [57465]: https://github.com/rust-lang/rust/pull/57465/
1698 [57532]: https://github.com/rust-lang/rust/pull/57532/
1699 [57535]: https://github.com/rust-lang/rust/pull/57535/
1700 [57566]: https://github.com/rust-lang/rust/pull/57566/
1701 [57615]: https://github.com/rust-lang/rust/pull/57615/
1702 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
1703 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
1704 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
1705 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
1706 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
1707 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
1708 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1709 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1710 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1711 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1712 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1713 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1714 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1715 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1716 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1717 [platform-support]: https://forge.rust-lang.org/platform-support.html
1718
1719 Version 1.32.0 (2019-01-17)
1720 ==========================
1721
1722 Language
1723 --------
1724 #### 2018 edition
1725 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1726   operator allows you to specify zero or one repetitions similar to the `*` and
1727   `+` operators.
1728 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1729   now always resolve to the item (`enum`, `struct`, etc.) available in the
1730   module if present, before resolving to a external crate or an item the prelude.][56759]
1731   E.g.
1732   ```rust
1733   enum Color { Red, Green, Blue }
1734
1735   use Color::*;
1736   ```
1737
1738 #### All editions
1739 - [You can now match against `PhantomData<T>` types.][55837]
1740 - [You can now match against literals in macros with the `literal`
1741   specifier.][56072] This will match against a literal of any type.
1742   E.g. `1`, `'A'`, `"Hello World"`
1743 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1744   ```rust
1745   struct Point(i32, i32);
1746
1747   impl Point {
1748       pub fn new(x: i32, y: i32) -> Self {
1749           Self(x, y)
1750       }
1751
1752       pub fn is_origin(&self) -> bool {
1753           match self {
1754               Self(0, 0) => true,
1755               _ => false,
1756           }
1757       }
1758   }
1759   ```
1760 - [Self can also now be used in type definitions.][56366] E.g.
1761   ```rust
1762   enum List<T>
1763   where
1764       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1765   {
1766       Nil,
1767       Cons(T, Box<Self>) // likewise here
1768   }
1769   ```
1770 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1771   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1772
1773 Compiler
1774 --------
1775 - [The default allocator has changed from jemalloc to the default allocator on
1776   your system.][55238] The compiler itself on Linux & macOS will still use
1777   jemalloc, but programs compiled with it will use the system allocator.
1778 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1779
1780 Libraries
1781 ---------
1782 - [`PathBuf` now implements `FromStr`.][55148]
1783 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1784 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1785   easily debug expressions in your rust program. E.g.
1786   ```rust
1787   let a = 2;
1788   let b = dbg!(a * 2) + 1;
1789   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1790   assert_eq!(b, 5);
1791   ```
1792
1793 The following APIs are now `const` functions and can be used in a
1794 `const` context.
1795
1796 - [`Cell::as_ptr`]
1797 - [`UnsafeCell::get`]
1798 - [`char::is_ascii`]
1799 - [`iter::empty`]
1800 - [`ManuallyDrop::new`]
1801 - [`ManuallyDrop::into_inner`]
1802 - [`RangeInclusive::start`]
1803 - [`RangeInclusive::end`]
1804 - [`NonNull::as_ptr`]
1805 - [`slice::as_ptr`]
1806 - [`str::as_ptr`]
1807 - [`Duration::as_secs`]
1808 - [`Duration::subsec_millis`]
1809 - [`Duration::subsec_micros`]
1810 - [`Duration::subsec_nanos`]
1811 - [`CStr::as_ptr`]
1812 - [`Ipv4Addr::is_unspecified`]
1813 - [`Ipv6Addr::new`]
1814 - [`Ipv6Addr::octets`]
1815
1816 Stabilized APIs
1817 ---------------
1818 - [`i8::to_be_bytes`]
1819 - [`i8::to_le_bytes`]
1820 - [`i8::to_ne_bytes`]
1821 - [`i8::from_be_bytes`]
1822 - [`i8::from_le_bytes`]
1823 - [`i8::from_ne_bytes`]
1824 - [`i16::to_be_bytes`]
1825 - [`i16::to_le_bytes`]
1826 - [`i16::to_ne_bytes`]
1827 - [`i16::from_be_bytes`]
1828 - [`i16::from_le_bytes`]
1829 - [`i16::from_ne_bytes`]
1830 - [`i32::to_be_bytes`]
1831 - [`i32::to_le_bytes`]
1832 - [`i32::to_ne_bytes`]
1833 - [`i32::from_be_bytes`]
1834 - [`i32::from_le_bytes`]
1835 - [`i32::from_ne_bytes`]
1836 - [`i64::to_be_bytes`]
1837 - [`i64::to_le_bytes`]
1838 - [`i64::to_ne_bytes`]
1839 - [`i64::from_be_bytes`]
1840 - [`i64::from_le_bytes`]
1841 - [`i64::from_ne_bytes`]
1842 - [`i128::to_be_bytes`]
1843 - [`i128::to_le_bytes`]
1844 - [`i128::to_ne_bytes`]
1845 - [`i128::from_be_bytes`]
1846 - [`i128::from_le_bytes`]
1847 - [`i128::from_ne_bytes`]
1848 - [`isize::to_be_bytes`]
1849 - [`isize::to_le_bytes`]
1850 - [`isize::to_ne_bytes`]
1851 - [`isize::from_be_bytes`]
1852 - [`isize::from_le_bytes`]
1853 - [`isize::from_ne_bytes`]
1854 - [`u8::to_be_bytes`]
1855 - [`u8::to_le_bytes`]
1856 - [`u8::to_ne_bytes`]
1857 - [`u8::from_be_bytes`]
1858 - [`u8::from_le_bytes`]
1859 - [`u8::from_ne_bytes`]
1860 - [`u16::to_be_bytes`]
1861 - [`u16::to_le_bytes`]
1862 - [`u16::to_ne_bytes`]
1863 - [`u16::from_be_bytes`]
1864 - [`u16::from_le_bytes`]
1865 - [`u16::from_ne_bytes`]
1866 - [`u32::to_be_bytes`]
1867 - [`u32::to_le_bytes`]
1868 - [`u32::to_ne_bytes`]
1869 - [`u32::from_be_bytes`]
1870 - [`u32::from_le_bytes`]
1871 - [`u32::from_ne_bytes`]
1872 - [`u64::to_be_bytes`]
1873 - [`u64::to_le_bytes`]
1874 - [`u64::to_ne_bytes`]
1875 - [`u64::from_be_bytes`]
1876 - [`u64::from_le_bytes`]
1877 - [`u64::from_ne_bytes`]
1878 - [`u128::to_be_bytes`]
1879 - [`u128::to_le_bytes`]
1880 - [`u128::to_ne_bytes`]
1881 - [`u128::from_be_bytes`]
1882 - [`u128::from_le_bytes`]
1883 - [`u128::from_ne_bytes`]
1884 - [`usize::to_be_bytes`]
1885 - [`usize::to_le_bytes`]
1886 - [`usize::to_ne_bytes`]
1887 - [`usize::from_be_bytes`]
1888 - [`usize::from_le_bytes`]
1889 - [`usize::from_ne_bytes`]
1890
1891 Cargo
1892 -----
1893 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1894 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1895
1896 Misc
1897 ----
1898 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1899
1900 Compatibility Notes
1901 -------------------
1902 - [The argument types for AVX's
1903   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1904   been changed from `*const` to `*mut` as the previous implementation
1905   was unsound.
1906
1907
1908 [55148]: https://github.com/rust-lang/rust/pull/55148/
1909 [55238]: https://github.com/rust-lang/rust/pull/55238/
1910 [55280]: https://github.com/rust-lang/rust/pull/55280/
1911 [55610]: https://github.com/rust-lang/rust/pull/55610/
1912 [55663]: https://github.com/rust-lang/rust/pull/55663/
1913 [55702]: https://github.com/rust-lang/rust/pull/55702/
1914 [55837]: https://github.com/rust-lang/rust/pull/55837/
1915 [55843]: https://github.com/rust-lang/rust/pull/55843/
1916 [56072]: https://github.com/rust-lang/rust/pull/56072/
1917 [56245]: https://github.com/rust-lang/rust/pull/56245/
1918 [56365]: https://github.com/rust-lang/rust/pull/56365/
1919 [56366]: https://github.com/rust-lang/rust/pull/56366/
1920 [56395]: https://github.com/rust-lang/rust/pull/56395/
1921 [56759]: https://github.com/rust-lang/rust/pull/56759/
1922 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1923 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1924 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1925 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1926 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1927 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1928 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1929 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1930 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1931 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1932 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1933 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1934 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1935 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1936 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1937 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1938 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1939 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1940 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1941 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1942 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1943 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1944 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1945 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1946 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1947 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1948 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1949 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1950 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1951 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1952 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1953 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1954 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1955 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1956 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1957 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1958 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1959 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1960 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1961 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1962 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1963 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1964 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1965 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1966 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1967 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1968 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1969 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1970 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1971 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1972 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1973 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1974 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1975 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1976 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1977 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1978 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1979 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1980 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1981 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1982 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1983 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1984 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1985 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1986 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1987 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1988 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1989 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1990 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1991 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1992 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1993 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1994 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1995 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1996 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1997 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1998 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1999 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
2000 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
2001 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
2002 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
2003 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
2004 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
2005 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
2006 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
2007 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
2008 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
2009 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
2010 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
2011 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
2012 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
2013 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
2014 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
2015
2016
2017 Version 1.31.1 (2018-12-20)
2018 ===========================
2019
2020 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
2021 - [Fix broken go-to-definition in RLS][rls/1171]
2022 - [Fix infinite loop on hover in RLS][rls/1170]
2023
2024 [56562]: https://github.com/rust-lang/rust/pull/56562
2025 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
2026 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
2027
2028 Version 1.31.0 (2018-12-06)
2029 ==========================
2030
2031 Language
2032 --------
2033 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
2034 - [New lifetime elision rules now allow for eliding lifetimes in functions and
2035   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
2036   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
2037   in structs.
2038 - [You can now define and use `const` functions.][54835] These are currently
2039   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
2040   [language reference][const-reference] for what exactly is available.
2041 - [You can now use tool lints, which allow you to scope lints from external
2042   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
2043 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
2044   a crate, not just in exported functions.][54451]
2045 - [You can now use parentheses in pattern matches.][54497]
2046
2047 Compiler
2048 --------
2049 - [Updated musl to 1.1.20][54430]
2050
2051 Libraries
2052 ---------
2053 - [You can now convert `num::NonZero*` types to their raw equivalents using the
2054   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
2055 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
2056   into `Option<&mut T>` using the `From` trait.][53218]
2057 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
2058
2059
2060 Stabilized APIs
2061 ---------------
2062 - [`slice::align_to`]
2063 - [`slice::align_to_mut`]
2064 - [`slice::chunks_exact`]
2065 - [`slice::chunks_exact_mut`]
2066 - [`slice::rchunks`]
2067 - [`slice::rchunks_mut`]
2068 - [`slice::rchunks_exact`]
2069 - [`slice::rchunks_exact_mut`]
2070 - [`Option::replace`]
2071
2072 Cargo
2073 -----
2074 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
2075 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
2076   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
2077
2078 [52813]: https://github.com/rust-lang/rust/pull/52813/
2079 [53218]: https://github.com/rust-lang/rust/pull/53218/
2080 [53555]: https://github.com/rust-lang/rust/issues/53555/
2081 [54057]: https://github.com/rust-lang/rust/pull/54057/
2082 [54240]: https://github.com/rust-lang/rust/pull/54240/
2083 [54430]: https://github.com/rust-lang/rust/pull/54430/
2084 [54451]: https://github.com/rust-lang/rust/pull/54451/
2085 [54497]: https://github.com/rust-lang/rust/pull/54497/
2086 [54778]: https://github.com/rust-lang/rust/pull/54778/
2087 [54835]: https://github.com/rust-lang/rust/pull/54835/
2088 [54870]: https://github.com/rust-lang/rust/pull/54870/
2089 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
2090 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
2091 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
2092 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
2093 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
2094 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
2095 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2096 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
2097 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
2098 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
2099 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
2100 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
2101 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
2102 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
2103
2104 Version 1.30.1 (2018-11-08)
2105 ===========================
2106
2107 - [Fixed overflow ICE in rustdoc][54199]
2108 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
2109
2110 [54199]: https://github.com/rust-lang/rust/pull/54199
2111 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
2112
2113 Version 1.30.0 (2018-10-25)
2114 ==========================
2115
2116 Language
2117 --------
2118 - [Procedural macros are now available.][52081] These kinds of macros allow for
2119   more powerful code generation. There is a [new chapter available][proc-macros]
2120   in the Rust Programming Language book that goes further in depth.
2121 - [You can now use keywords as identifiers using the raw identifiers
2122   syntax (`r#`),][53236] e.g. `let r#for = true;`
2123 - [Using anonymous parameters in traits is now deprecated with a warning and
2124   will be a hard error in the 2018 edition.][53272]
2125 - [You can now use `crate` in paths.][54404] This allows you to refer to the
2126   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
2127 - [Using a external crate no longer requires being prefixed with `::`.][54404]
2128   Previously, using a external crate in a module without a use statement
2129   required `let json = ::serde_json::from_str(foo);` but can now be written
2130   as `let json = serde_json::from_str(foo);`.
2131 - [You can now apply the `#[used]` attribute to static items to prevent the
2132   compiler from optimising them away, even if they appear to be unused,][51363]
2133   e.g. `#[used] static FOO: u32 = 1;`
2134 - [You can now import and reexport macros from other crates with the `use`
2135   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
2136   the root module of the crate. If your macro relies on calling other local
2137   macros, it is recommended to export with the
2138   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
2139   those macros.
2140 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
2141   using the `vis` specifier.][53370]
2142 - [Non-macro attributes now allow all forms of literals, not just
2143   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
2144   write `#[attr(true)]`.
2145 - [You can now specify a function to handle a panic in the Rust runtime with the
2146   `#[panic_handler]` attribute.][51366]
2147
2148 Compiler
2149 --------
2150 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
2151 - [Added the `aarch64-unknown-netbsd` target][53165]
2152
2153 Libraries
2154 ---------
2155 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
2156
2157 Stabilized APIs
2158 ---------------
2159 - [`Ipv4Addr::BROADCAST`]
2160 - [`Ipv4Addr::LOCALHOST`]
2161 - [`Ipv4Addr::UNSPECIFIED`]
2162 - [`Ipv6Addr::LOCALHOST`]
2163 - [`Ipv6Addr::UNSPECIFIED`]
2164 - [`Iterator::find_map`]
2165
2166   The following methods are replacement methods for `trim_left`, `trim_right`,
2167   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
2168   in 1.33.0:
2169 - [`str::trim_end_matches`]
2170 - [`str::trim_end`]
2171 - [`str::trim_start_matches`]
2172 - [`str::trim_start`]
2173
2174 Cargo
2175 ----
2176 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
2177 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
2178   equivalent to calling `rustdoc --error-format=json`.
2179 - [Cargo will now provide a progress bar for builds.][cargo/5995]
2180
2181 Misc
2182 ----
2183 - [`rustdoc` allows you to specify what edition to treat your code as with the
2184   `--edition` option.][54057]
2185 - [`rustdoc` now has the `--color` (specify whether to output color) and
2186   `--error-format` (specify error format, e.g. `json`) options.][53003]
2187 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
2188   debug symbols.][53774]
2189 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
2190   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
2191
2192 [50911]: https://github.com/rust-lang/rust/pull/50911/
2193 [51363]: https://github.com/rust-lang/rust/pull/51363/
2194 [51366]: https://github.com/rust-lang/rust/pull/51366/
2195 [52081]: https://github.com/rust-lang/rust/pull/52081/
2196 [53003]: https://github.com/rust-lang/rust/pull/53003/
2197 [53033]: https://github.com/rust-lang/rust/pull/53033/
2198 [53044]: https://github.com/rust-lang/rust/pull/53044/
2199 [53165]: https://github.com/rust-lang/rust/pull/53165/
2200 [53213]: https://github.com/rust-lang/rust/pull/53213/
2201 [53236]: https://github.com/rust-lang/rust/pull/53236/
2202 [53272]: https://github.com/rust-lang/rust/pull/53272/
2203 [53370]: https://github.com/rust-lang/rust/pull/53370/
2204 [53459]: https://github.com/rust-lang/rust/pull/53459/
2205 [53774]: https://github.com/rust-lang/rust/pull/53774/
2206 [53822]: https://github.com/rust-lang/rust/pull/53822/
2207 [54057]: https://github.com/rust-lang/rust/pull/54057/
2208 [54146]: https://github.com/rust-lang/rust/pull/54146/
2209 [54404]: https://github.com/rust-lang/rust/pull/54404/
2210 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
2211 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
2212 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
2213 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
2214
2215 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
2216 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
2217 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
2218 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
2219 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
2220 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
2221 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
2222 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
2223 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
2224 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
2225
2226
2227 Version 1.29.2 (2018-10-11)
2228 ===========================
2229
2230 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
2231 - The `rls-preview` component on the windows-gnu targets has been restored.
2232
2233 [54639]: https://github.com/rust-lang/rust/pull/54639
2234
2235
2236 Version 1.29.1 (2018-09-25)
2237 ===========================
2238
2239 Security Notes
2240 --------------
2241
2242 - The standard library's `str::repeat` function contained an out of bounds write
2243   caused by an integer overflow. This has been fixed by deterministically
2244   panicking when an overflow happens.
2245
2246   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
2247   us.
2248
2249
2250 Version 1.29.0 (2018-09-13)
2251 ==========================
2252
2253 Compiler
2254 --------
2255 - [Bumped minimum LLVM version to 5.0.][51899]
2256 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
2257 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
2258
2259 Libraries
2260 ---------
2261 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
2262 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
2263 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
2264 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
2265   for `&str`.][51178]
2266 - [`Cell<T>` now allows `T` to be unsized.][50494]
2267 - [`SocketAddr` is now stable on Redox.][52656]
2268
2269 Stabilized APIs
2270 ---------------
2271 - [`Arc::downcast`]
2272 - [`Iterator::flatten`]
2273 - [`Rc::downcast`]
2274
2275 Cargo
2276 -----
2277 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
2278   `--locked` to disable this behavior.
2279 - [`cargo-install` will now allow you to cross compile an install
2280   using `--target`.][cargo/5614]
2281 - [Added the `cargo-fix` subcommand to automatically move project code from
2282   2015 edition to 2018.][cargo/5723]
2283 - [`cargo doc` can now optionally document private types using the
2284   `--document-private-items` flag.][cargo/5543]
2285
2286 Misc
2287 ----
2288 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
2289   the specified level to that level.][52354] For example `--cap-lints warn`
2290   will demote `deny` and `forbid` lints to `warn`.
2291 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
2292   fails and `101` if there is a panic.][52197]
2293 - [A preview of clippy has been made available through rustup.][51122]
2294   You can install the preview with `rustup component add clippy-preview`.
2295
2296 Compatibility Notes
2297 -------------------
2298 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
2299   Use `str::get_unchecked(begin..end)` instead.
2300 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
2301   Consider using the `home_dir` function from
2302   https://crates.io/crates/dirs instead.
2303 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
2304 - [`cfg` attributes and `--cfg` command line flags are now more
2305   strictly validated.][53893]
2306
2307 [53893]: https://github.com/rust-lang/rust/pull/53893/
2308 [52861]: https://github.com/rust-lang/rust/pull/52861/
2309 [52656]: https://github.com/rust-lang/rust/pull/52656/
2310 [52239]: https://github.com/rust-lang/rust/pull/52239/
2311 [52330]: https://github.com/rust-lang/rust/pull/52330/
2312 [52354]: https://github.com/rust-lang/rust/pull/52354/
2313 [52402]: https://github.com/rust-lang/rust/pull/52402/
2314 [52103]: https://github.com/rust-lang/rust/pull/52103/
2315 [52197]: https://github.com/rust-lang/rust/pull/52197/
2316 [51807]: https://github.com/rust-lang/rust/pull/51807/
2317 [51899]: https://github.com/rust-lang/rust/pull/51899/
2318 [51912]: https://github.com/rust-lang/rust/pull/51912/
2319 [51511]: https://github.com/rust-lang/rust/pull/51511/
2320 [51619]: https://github.com/rust-lang/rust/pull/51619/
2321 [51656]: https://github.com/rust-lang/rust/pull/51656/
2322 [51178]: https://github.com/rust-lang/rust/pull/51178/
2323 [51122]: https://github.com/rust-lang/rust/pull/51122
2324 [50494]: https://github.com/rust-lang/rust/pull/50494/
2325 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
2326 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
2327 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
2328 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
2329 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
2330 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
2331 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
2332
2333
2334 Version 1.28.0 (2018-08-02)
2335 ===========================
2336
2337 Language
2338 --------
2339 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
2340   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
2341   the inner type across Foreign Function Interface (FFI) boundaries.
2342 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
2343   and can now be used as identifiers.][51196]
2344 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
2345   stable.][51241] This will allow users to specify a global allocator for
2346   their program.
2347 - [Unit test functions marked with the `#[test]` attribute can now return
2348   `Result<(), E: Debug>` in addition to `()`.][51298]
2349 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
2350   allows macros to easily target lifetimes.
2351
2352 Compiler
2353 --------
2354 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
2355   prioritise making smaller binary sizes. `z` is the same as `s` with the
2356   exception that it does not vectorise loops, which typically results in an even
2357   smaller binary.
2358 - [The short error format is now stable.][49546] Specified with
2359   `--error-format=short` this option will provide a more compressed output of
2360   rust error messages.
2361 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
2362 - [Reduced the number of allocations in the macro parser.][50855] This can
2363   improve compile times of macro heavy crates on average by 5%.
2364
2365 Libraries
2366 ---------
2367 - [Implemented `Default` for `&mut str`.][51306]
2368 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
2369 - [Implemented `Extend` for `()`.][50234]
2370 - [The `Debug` implementation of `time::Duration` should now be more easily
2371   human readable.][50364] Previously a `Duration` of one second would printed as
2372   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
2373 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
2374   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
2375   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
2376   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
2377   for `PathBuf`.][50170]
2378 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
2379   and `Wrapping<i128>`.][50465]
2380 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
2381   possible.][51050] This can provide up to a 40% speed increase.
2382 - [Improved error messages when using `format!`.][50610]
2383
2384 Stabilized APIs
2385 ---------------
2386 - [`Iterator::step_by`]
2387 - [`Path::ancestors`]
2388 - [`SystemTime::UNIX_EPOCH`]
2389 - [`alloc::GlobalAlloc`]
2390 - [`alloc::Layout`]
2391 - [`alloc::LayoutErr`]
2392 - [`alloc::System`]
2393 - [`alloc::alloc`]
2394 - [`alloc::alloc_zeroed`]
2395 - [`alloc::dealloc`]
2396 - [`alloc::realloc`]
2397 - [`alloc::handle_alloc_error`]
2398 - [`btree_map::Entry::or_default`]
2399 - [`fmt::Alignment`]
2400 - [`hash_map::Entry::or_default`]
2401 - [`iter::repeat_with`]
2402 - [`num::NonZeroUsize`]
2403 - [`num::NonZeroU128`]
2404 - [`num::NonZeroU16`]
2405 - [`num::NonZeroU32`]
2406 - [`num::NonZeroU64`]
2407 - [`num::NonZeroU8`]
2408 - [`ops::RangeBounds`]
2409 - [`slice::SliceIndex`]
2410 - [`slice::from_mut`]
2411 - [`slice::from_ref`]
2412 - [`{Any + Send + Sync}::downcast_mut`]
2413 - [`{Any + Send + Sync}::downcast_ref`]
2414 - [`{Any + Send + Sync}::is`]
2415
2416 Cargo
2417 -----
2418 - [Cargo will now no longer allow you to publish crates with build scripts that
2419   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
2420   considered to be immutable.
2421
2422 Misc
2423 ----
2424 - [The `suggestion_applicability` field in `rustc`'s json output is now
2425   stable.][50486] This will allow dev tools to check whether a code suggestion
2426   would apply to them.
2427
2428 Compatibility Notes
2429 -------------------
2430 - [Rust will consider trait objects with duplicated constraints to be the same
2431   type as without the duplicated constraint.][51276] For example the below code will
2432   now fail to compile.
2433   ```rust
2434   trait Trait {}
2435
2436   impl Trait + Send {
2437       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
2438   }
2439
2440   impl Trait + Send + Send {
2441       fn test(&self) { println!("two"); }
2442   }
2443   ```
2444
2445 [49546]: https://github.com/rust-lang/rust/pull/49546/
2446 [50143]: https://github.com/rust-lang/rust/pull/50143/
2447 [50170]: https://github.com/rust-lang/rust/pull/50170/
2448 [50234]: https://github.com/rust-lang/rust/pull/50234/
2449 [50265]: https://github.com/rust-lang/rust/pull/50265/
2450 [50364]: https://github.com/rust-lang/rust/pull/50364/
2451 [50385]: https://github.com/rust-lang/rust/pull/50385/
2452 [50465]: https://github.com/rust-lang/rust/pull/50465/
2453 [50486]: https://github.com/rust-lang/rust/pull/50486/
2454 [50554]: https://github.com/rust-lang/rust/pull/50554/
2455 [50610]: https://github.com/rust-lang/rust/pull/50610/
2456 [50855]: https://github.com/rust-lang/rust/pull/50855/
2457 [51050]: https://github.com/rust-lang/rust/pull/51050/
2458 [51196]: https://github.com/rust-lang/rust/pull/51196/
2459 [51200]: https://github.com/rust-lang/rust/pull/51200/
2460 [51241]: https://github.com/rust-lang/rust/pull/51241/
2461 [51276]: https://github.com/rust-lang/rust/pull/51276/
2462 [51298]: https://github.com/rust-lang/rust/pull/51298/
2463 [51306]: https://github.com/rust-lang/rust/pull/51306/
2464 [51562]: https://github.com/rust-lang/rust/pull/51562/
2465 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
2466 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
2467 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
2468 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
2469 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
2470 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
2471 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
2472 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
2473 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
2474 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
2475 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
2476 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
2477 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
2478 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
2479 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
2480 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
2481 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
2482 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
2483 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
2484 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
2485 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
2486 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
2487 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
2488 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
2489 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
2490 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
2491 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
2492 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
2493 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
2494 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
2495
2496 Version 1.27.2 (2018-07-20)
2497 ===========================
2498
2499 Compatibility Notes
2500 -------------------
2501
2502 - The borrow checker was fixed to avoid potential unsoundness when using
2503   match ergonomics: [#52213][52213].
2504
2505 [52213]: https://github.com/rust-lang/rust/issues/52213
2506
2507 Version 1.27.1 (2018-07-10)
2508 ===========================
2509
2510 Security Notes
2511 --------------
2512
2513 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
2514   when running, which enabled executing code as some other user on a
2515   given machine. This release fixes that vulnerability; you can read
2516   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
2517
2518   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
2519
2520 Compatibility Notes
2521 -------------------
2522
2523 - The borrow checker was fixed to avoid an additional potential unsoundness when using
2524   match ergonomics: [#51415][51415], [#49534][49534].
2525
2526 [51415]: https://github.com/rust-lang/rust/issues/51415
2527 [49534]: https://github.com/rust-lang/rust/issues/49534
2528 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
2529 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
2530
2531 Version 1.27.0 (2018-06-21)
2532 ==========================
2533
2534 Language
2535 --------
2536 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
2537   be used as an identifier.
2538 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
2539   bare `Trait` syntax, and should make it clearer when being used in tandem with
2540   `impl Trait` because it is equivalent to the following syntax:
2541   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
2542   `Box<Trait> == Box<dyn Trait>`.
2543 - [Attributes on generic parameters such as types and lifetimes are
2544   now stable.][48851] e.g.
2545   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
2546 - [The `#[must_use]` attribute can now also be used on functions as well as
2547   types.][48925] It provides a lint that by default warns users when the
2548   value returned by a function has not been used.
2549
2550 Compiler
2551 --------
2552 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
2553
2554 Libraries
2555 ---------
2556 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
2557   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
2558   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
2559   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
2560   the `cfg` attribute.
2561 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
2562   std are now available in core.][49896]
2563 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
2564   to `Self`.][49630]
2565 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
2566   that the operation isn't done in place.
2567 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
2568   the `#[must_use]` attribute][49533] to warn about unused potentially
2569   expensive allocations.
2570
2571 Stabilized APIs
2572 ---------------
2573 - [`DoubleEndedIterator::rfind`]
2574 - [`DoubleEndedIterator::rfold`]
2575 - [`DoubleEndedIterator::try_rfold`]
2576 - [`Duration::from_micros`]
2577 - [`Duration::from_nanos`]
2578 - [`Duration::subsec_micros`]
2579 - [`Duration::subsec_millis`]
2580 - [`HashMap::remove_entry`]
2581 - [`Iterator::try_fold`]
2582 - [`Iterator::try_for_each`]
2583 - [`NonNull::cast`]
2584 - [`Option::filter`]
2585 - [`String::replace_range`]
2586 - [`Take::set_limit`]
2587 - [`hint::unreachable_unchecked`]
2588 - [`os::unix::process::parent_id`]
2589 - [`ptr::swap_nonoverlapping`]
2590 - [`slice::rsplit_mut`]
2591 - [`slice::rsplit`]
2592 - [`slice::swap_with_slice`]
2593
2594 Cargo
2595 -----
2596 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
2597   `readme`, and `repository` fields.][cargo/5386]
2598 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
2599 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
2600   a different directory than `target` for placing compilation artifacts.
2601 - [Cargo will be adding automatic target inference for binaries, benchmarks,
2602   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
2603   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
2604   where cargo would infer a binary, Cargo will produce a warning. You can
2605   disable this feature ahead of time by setting any of the following to false:
2606   `autobins`, `autobenches`, `autoexamples`, `autotests`.
2607 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
2608   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
2609
2610 Misc
2611 ----
2612 - [Added “The Rustc book” into the official documentation.][49707]
2613   [“The Rustc book”] documents and teaches how to use the rustc compiler.
2614 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
2615
2616 Compatibility Notes
2617 -------------------
2618 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
2619   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
2620   compile, `"".is_empty()` will still compile.
2621 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
2622   will only print the inner type.][48553] E.g.
2623   `print!("{:?}", AtomicBool::new(true))` will print `true`,
2624   not `AtomicBool(true)`.
2625 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
2626   could enter higher numbers but they were not supported by LLVM. Up to 512MB
2627   alignment should cover all use cases.
2628 - The `.description()` method on the `std::error::Error` trait
2629   [has been soft-deprecated][50163]. It is no longer required to implement it.
2630
2631 [48553]: https://github.com/rust-lang/rust/pull/48553/
2632 [48851]: https://github.com/rust-lang/rust/pull/48851/
2633 [48925]: https://github.com/rust-lang/rust/pull/48925/
2634 [49533]: https://github.com/rust-lang/rust/pull/49533/
2635 [49623]: https://github.com/rust-lang/rust/pull/49623/
2636 [49630]: https://github.com/rust-lang/rust/pull/49630/
2637 [49664]: https://github.com/rust-lang/rust/pull/49664/
2638 [49699]: https://github.com/rust-lang/rust/pull/49699/
2639 [49707]: https://github.com/rust-lang/rust/pull/49707/
2640 [49719]: https://github.com/rust-lang/rust/pull/49719/
2641 [49896]: https://github.com/rust-lang/rust/pull/49896/
2642 [49968]: https://github.com/rust-lang/rust/pull/49968/
2643 [50163]: https://github.com/rust-lang/rust/pull/50163
2644 [50177]: https://github.com/rust-lang/rust/pull/50177/
2645 [50378]: https://github.com/rust-lang/rust/pull/50378/
2646 [50398]: https://github.com/rust-lang/rust/pull/50398/
2647 [50423]: https://github.com/rust-lang/rust/pull/50423/
2648 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
2649 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
2650 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
2651 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
2652 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
2653 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
2654 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
2655 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
2656 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
2657 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
2658 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
2659 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
2660 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
2661 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
2662 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
2663 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
2664 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
2665 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
2666 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
2667 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
2668 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
2669 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
2670 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2671 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
2672 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
2673 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
2674 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
2675 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
2676 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
2677 [“The Rustc book”]: https://doc.rust-lang.org/rustc
2678
2679
2680 Version 1.26.2 (2018-06-05)
2681 ==========================
2682
2683 Compatibility Notes
2684 -------------------
2685
2686 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
2687
2688 [51117]: https://github.com/rust-lang/rust/issues/51117
2689
2690
2691 Version 1.26.1 (2018-05-29)
2692 ==========================
2693
2694 Tools
2695 -----
2696
2697 - [RLS now works on Windows.][50646]
2698 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
2699
2700
2701 Compatibility Notes
2702 --------
2703
2704 - [`fn main() -> impl Trait` no longer works for non-Termination
2705   trait.][50656]
2706   This reverts an accidental stabilization.
2707 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
2708 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2709
2710 [50646]: https://github.com/rust-lang/rust/issues/50646
2711 [50656]: https://github.com/rust-lang/rust/pull/50656
2712 [50812]: https://github.com/rust-lang/rust/pull/50812
2713 [50950]: https://github.com/rust-lang/rust/issues/50950
2714 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2715
2716 Version 1.26.0 (2018-05-10)
2717 ==========================
2718
2719 Language
2720 --------
2721 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2722   implement either or both traits.][49299]
2723 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2724 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2725   lifetime can be elided.][49458]
2726 - [`impl Trait` is now stable allowing you to have abstract types in returns
2727    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2728   `fn open(path: impl AsRef<Path>)`.
2729 - [Pattern matching will now automatically apply dereferences.][49394]
2730 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2731 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2732 - [A lot of operations are now available in a const context.][46882] E.g. You
2733   can now index into constant arrays, reference and dereference into constants,
2734   and use tuple struct constructors.
2735 - [Fixed entry slice patterns are now stable.][48516] E.g.
2736   ```rust
2737   let points = [1, 2, 3, 4];
2738   match points {
2739       [1, 2, 3, 4] => println!("All points were sequential."),
2740       _ => println!("Not all points were sequential."),
2741   }
2742   ```
2743
2744
2745 Compiler
2746 --------
2747 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2748 - [Fixed exponential projection complexity on nested types.][48296]
2749   This can provide up to a ~12% reduction in compile times for certain crates.
2750 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2751   to remap path prefixes outputted by the compiler.
2752 - [Added `powerpc-unknown-netbsd` target.][48281]
2753
2754 Libraries
2755 ---------
2756 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2757 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2758   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2759 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2760 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2761 - [`ascii::escape_default` is now available in libcore.][48735]
2762 - [Trailing commas are now supported in std and core macros.][48056]
2763 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2764 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2765
2766 Stabilized APIs
2767 ---------------
2768 - [`*const T::add`]
2769 - [`*const T::copy_to_nonoverlapping`]
2770 - [`*const T::copy_to`]
2771 - [`*const T::read_unaligned`]
2772 - [`*const T::read_volatile`]
2773 - [`*const T::read`]
2774 - [`*const T::sub`]
2775 - [`*const T::wrapping_add`]
2776 - [`*const T::wrapping_sub`]
2777 - [`*mut T::add`]
2778 - [`*mut T::copy_to_nonoverlapping`]
2779 - [`*mut T::copy_to`]
2780 - [`*mut T::read_unaligned`]
2781 - [`*mut T::read_volatile`]
2782 - [`*mut T::read`]
2783 - [`*mut T::replace`]
2784 - [`*mut T::sub`]
2785 - [`*mut T::swap`]
2786 - [`*mut T::wrapping_add`]
2787 - [`*mut T::wrapping_sub`]
2788 - [`*mut T::write_bytes`]
2789 - [`*mut T::write_unaligned`]
2790 - [`*mut T::write_volatile`]
2791 - [`*mut T::write`]
2792 - [`Box::leak`]
2793 - [`FromUtf8Error::as_bytes`]
2794 - [`LocalKey::try_with`]
2795 - [`Option::cloned`]
2796 - [`btree_map::Entry::and_modify`]
2797 - [`fs::read_to_string`]
2798 - [`fs::read`]
2799 - [`fs::write`]
2800 - [`hash_map::Entry::and_modify`]
2801 - [`iter::FusedIterator`]
2802 - [`ops::RangeInclusive`]
2803 - [`ops::RangeToInclusive`]
2804 - [`process::id`]
2805 - [`slice::rotate_left`]
2806 - [`slice::rotate_right`]
2807 - [`String::retain`]
2808
2809
2810 Cargo
2811 -----
2812 - [Cargo will now output path to custom commands when `-v` is
2813   passed with `--list`][cargo/5041]
2814 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2815
2816 Misc
2817 ----
2818 - [The second edition of "The Rust Programming Language" book is now recommended
2819   over the first.][48404]
2820
2821 Compatibility Notes
2822 -------------------
2823
2824 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2825   syntax is now invalid.
2826   ```
2827   use std::ops::Fn as dyn;
2828   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2829   ```
2830 - [The result of dereferences are no longer promoted to `'static`.][47408]
2831   e.g.
2832   ```rust
2833   fn main() {
2834       const PAIR: &(i32, i32) = &(0, 1);
2835       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2836   }
2837   ```
2838 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2839 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2840   an error.][48235]
2841 - [Removed hoedown from rustdoc.][48274]
2842 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2843
2844 [46882]: https://github.com/rust-lang/rust/pull/46882
2845 [47379]: https://github.com/rust-lang/rust/pull/47379
2846 [47408]: https://github.com/rust-lang/rust/pull/47408
2847 [47813]: https://github.com/rust-lang/rust/pull/47813
2848 [48056]: https://github.com/rust-lang/rust/pull/48056
2849 [48125]: https://github.com/rust-lang/rust/pull/48125
2850 [48166]: https://github.com/rust-lang/rust/pull/48166
2851 [48235]: https://github.com/rust-lang/rust/pull/48235
2852 [48274]: https://github.com/rust-lang/rust/pull/48274
2853 [48281]: https://github.com/rust-lang/rust/pull/48281
2854 [48296]: https://github.com/rust-lang/rust/pull/48296
2855 [48326]: https://github.com/rust-lang/rust/pull/48326
2856 [48359]: https://github.com/rust-lang/rust/pull/48359
2857 [48404]: https://github.com/rust-lang/rust/pull/48404
2858 [48481]: https://github.com/rust-lang/rust/pull/48481
2859 [48516]: https://github.com/rust-lang/rust/pull/48516
2860 [48628]: https://github.com/rust-lang/rust/pull/48628
2861 [48629]: https://github.com/rust-lang/rust/pull/48629
2862 [48657]: https://github.com/rust-lang/rust/pull/48657
2863 [48735]: https://github.com/rust-lang/rust/pull/48735
2864 [48978]: https://github.com/rust-lang/rust/pull/48978
2865 [49101]: https://github.com/rust-lang/rust/pull/49101
2866 [49109]: https://github.com/rust-lang/rust/pull/49109
2867 [49121]: https://github.com/rust-lang/rust/pull/49121
2868 [49162]: https://github.com/rust-lang/rust/pull/49162
2869 [49184]: https://github.com/rust-lang/rust/pull/49184
2870 [49234]: https://github.com/rust-lang/rust/pull/49234
2871 [49255]: https://github.com/rust-lang/rust/pull/49255
2872 [49299]: https://github.com/rust-lang/rust/pull/49299
2873 [49305]: https://github.com/rust-lang/rust/pull/49305
2874 [49394]: https://github.com/rust-lang/rust/pull/49394
2875 [49458]: https://github.com/rust-lang/rust/pull/49458
2876 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2877 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2878 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2879 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2880 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2881 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2882 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2883 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2884 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2885 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2886 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2887 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2888 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2889 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2890 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2891 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2892 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2893 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2894 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2895 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2896 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2897 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2898 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2899 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2900 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2901 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2902 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2903 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2904 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2905 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2906 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2907 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2908 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2909 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2910 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2911 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2912 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2913 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2914 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2915 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2916 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2917 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2918
2919
2920 Version 1.25.0 (2018-03-29)
2921 ==========================
2922
2923 Language
2924 --------
2925 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2926 - [You can now use nested groups of imports.][47948]
2927   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2928 - [You can now have `|` at the start of a match arm.][47947] e.g.
2929 ```rust
2930 enum Foo { A, B, C }
2931
2932 fn main() {
2933     let x = Foo::A;
2934     match x {
2935         | Foo::A
2936         | Foo::B => println!("AB"),
2937         | Foo::C => println!("C"),
2938     }
2939 }
2940 ```
2941
2942 Compiler
2943 --------
2944 - [Upgraded to LLVM 6.][47828]
2945 - [Added `-C lto=val` option.][47521]
2946 - [Added `i586-unknown-linux-musl` target][47282]
2947
2948 Libraries
2949 ---------
2950 - [Impl Send for `process::Command` on Unix.][47760]
2951 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2952 - [`UnsafeCell::into_inner` is now safe.][47204]
2953 - [Implement libstd for CloudABI.][47268]
2954 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2955 - [Implement `AsRef<Path>` for Component][46985]
2956 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2957 - [Moved `Duration` to libcore.][46666]
2958
2959 Stabilized APIs
2960 ---------------
2961 - [`Location::column`]
2962 - [`ptr::NonNull`]
2963
2964 The following functions can now be used in a constant expression.
2965 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2966 - [`Duration::new`][47300]
2967 - [`Duration::from_secs`][47300]
2968 - [`Duration::from_millis`][47300]
2969
2970 Cargo
2971 -----
2972 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2973 - [`cargo new` now defaults to creating a binary crate, instead of a
2974   library crate.][cargo/5029]
2975
2976 Misc
2977 ----
2978 - [Rust by example is now shipped with new releases][46196]
2979
2980 Compatibility Notes
2981 -------------------
2982 - [Deprecated `net::lookup_host`.][47510]
2983 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2984 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2985   around indexing operations (see [#47349][47349]). This has been fixed (which also
2986   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2987 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2988
2989 [33903]: https://github.com/rust-lang/rust/pull/33903
2990 [47947]: https://github.com/rust-lang/rust/pull/47947
2991 [47948]: https://github.com/rust-lang/rust/pull/47948
2992 [47760]: https://github.com/rust-lang/rust/pull/47760
2993 [47790]: https://github.com/rust-lang/rust/pull/47790
2994 [47828]: https://github.com/rust-lang/rust/pull/47828
2995 [47398]: https://github.com/rust-lang/rust/pull/47398
2996 [47510]: https://github.com/rust-lang/rust/pull/47510
2997 [47521]: https://github.com/rust-lang/rust/pull/47521
2998 [47204]: https://github.com/rust-lang/rust/pull/47204
2999 [47251]: https://github.com/rust-lang/rust/pull/47251
3000 [47268]: https://github.com/rust-lang/rust/pull/47268
3001 [47282]: https://github.com/rust-lang/rust/pull/47282
3002 [47300]: https://github.com/rust-lang/rust/pull/47300
3003 [47349]: https://github.com/rust-lang/rust/pull/47349
3004 [46931]: https://github.com/rust-lang/rust/pull/46931
3005 [46985]: https://github.com/rust-lang/rust/pull/46985
3006 [47006]: https://github.com/rust-lang/rust/pull/47006
3007 [46830]: https://github.com/rust-lang/rust/pull/46830
3008 [46095]: https://github.com/rust-lang/rust/pull/46095
3009 [46666]: https://github.com/rust-lang/rust/pull/46666
3010 [46196]: https://github.com/rust-lang/rust/pull/46196
3011 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
3012 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
3013 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
3014 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
3015 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
3016
3017
3018 Version 1.24.1 (2018-03-01)
3019 ==========================
3020
3021  - [Do not abort when unwinding through FFI][48251]
3022  - [Emit UTF-16 files for linker arguments on Windows][48318]
3023  - [Make the error index generator work again][48308]
3024  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
3025
3026 [48251]: https://github.com/rust-lang/rust/issues/48251
3027 [48308]: https://github.com/rust-lang/rust/issues/48308
3028 [48318]: https://github.com/rust-lang/rust/issues/48318
3029 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
3030
3031
3032 Version 1.24.0 (2018-02-15)
3033 ==========================
3034
3035 Language
3036 --------
3037 - [External `sysv64` ffi is now available.][46528]
3038   eg. `extern "sysv64" fn foo () {}`
3039
3040 Compiler
3041 --------
3042 - [rustc now uses 16 codegen units by default for release builds.][46910]
3043   For the fastest builds, utilize `codegen-units=1`.
3044 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
3045 - [Add `aarch64-unknown-openbsd` support][46760]
3046
3047 Libraries
3048 ---------
3049 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
3050   improvement in performance in the majority of cases.
3051 - [`OsStr`'s `Debug` implementation is now lossless and consistent
3052   with Windows.][46798]
3053 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
3054 - [impl `From<bool>` for `AtomicBool`][46293]
3055 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
3056 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
3057 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
3058 - [float::from_bits now just uses transmute.][46012] This provides
3059   some optimisations from LLVM.
3060 - [Copied `AsciiExt` methods onto `char`][46077]
3061 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
3062 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
3063 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
3064 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
3065
3066 Stabilized APIs
3067 ---------------
3068 - [`RefCell::replace`]
3069 - [`RefCell::swap`]
3070 - [`atomic::spin_loop_hint`]
3071
3072 The following functions can now be used in a constant expression.
3073 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
3074
3075 - [`AtomicBool::new`][46287]
3076 - [`AtomicUsize::new`][46287]
3077 - [`AtomicIsize::new`][46287]
3078 - [`AtomicPtr::new`][46287]
3079 - [`Cell::new`][46287]
3080 - [`{integer}::min_value`][46287]
3081 - [`{integer}::max_value`][46287]
3082 - [`mem::size_of`][46287]
3083 - [`mem::align_of`][46287]
3084 - [`ptr::null`][46287]
3085 - [`ptr::null_mut`][46287]
3086 - [`RefCell::new`][46287]
3087 - [`UnsafeCell::new`][46287]
3088
3089 Cargo
3090 -----
3091 - [Added a `workspace.default-members` config that
3092   overrides implied `--all` in virtual workspaces.][cargo/4743]
3093 - [Enable incremental by default on development builds.][cargo/4817] Also added
3094   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
3095   per-project or global basis respectively.
3096
3097 Misc
3098 ----
3099
3100 Compatibility Notes
3101 -------------------
3102 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
3103 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
3104   in accordance with IETF RFC 4291 §2.2.
3105 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
3106 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
3107   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
3108 - [Leading zeros in tuple struct members is now an error][47084]
3109 - [`column!()` macro is one-based instead of zero-based][46977]
3110 - [`fmt::Arguments` can no longer be shared across threads][45198]
3111 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
3112 - [Cargo sets a different working directory for the compiler][cargo/4788]
3113
3114 [44884]: https://github.com/rust-lang/rust/pull/44884
3115 [45198]: https://github.com/rust-lang/rust/pull/45198
3116 [45506]: https://github.com/rust-lang/rust/pull/45506
3117 [45904]: https://github.com/rust-lang/rust/pull/45904
3118 [45990]: https://github.com/rust-lang/rust/pull/45990
3119 [46012]: https://github.com/rust-lang/rust/pull/46012
3120 [46077]: https://github.com/rust-lang/rust/pull/46077
3121 [46094]: https://github.com/rust-lang/rust/pull/46094
3122 [46284]: https://github.com/rust-lang/rust/pull/46284
3123 [46287]: https://github.com/rust-lang/rust/pull/46287
3124 [46293]: https://github.com/rust-lang/rust/pull/46293
3125 [46528]: https://github.com/rust-lang/rust/pull/46528
3126 [46671]: https://github.com/rust-lang/rust/pull/46671
3127 [46713]: https://github.com/rust-lang/rust/pull/46713
3128 [46735]: https://github.com/rust-lang/rust/pull/46735
3129 [46749]: https://github.com/rust-lang/rust/pull/46749
3130 [46760]: https://github.com/rust-lang/rust/pull/46760
3131 [46798]: https://github.com/rust-lang/rust/pull/46798
3132 [46828]: https://github.com/rust-lang/rust/pull/46828
3133 [46831]: https://github.com/rust-lang/rust/pull/46831
3134 [46833]: https://github.com/rust-lang/rust/pull/46833
3135 [46910]: https://github.com/rust-lang/rust/pull/46910
3136 [46977]: https://github.com/rust-lang/rust/pull/46977
3137 [47018]: https://github.com/rust-lang/rust/pull/47018
3138 [47080]: https://github.com/rust-lang/rust/pull/47080
3139 [47084]: https://github.com/rust-lang/rust/pull/47084
3140 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
3141 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
3142 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
3143 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
3144 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
3145 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
3146
3147
3148 Version 1.23.0 (2018-01-04)
3149 ==========================
3150
3151 Language
3152 --------
3153 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
3154 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
3155   Which should fix some confusing errors in some operations.
3156
3157 Compiler
3158 --------
3159 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
3160   undefined behavior.][45920]
3161 - [rustc now suggests renaming import if names clash.][45660]
3162 - [Display errors/warnings correctly when there are zero-width or
3163   wide characters.][45711]
3164 - [rustc now avoids unnecessary copies of arguments that are
3165   simple bindings][45380] This should improve memory usage on average by 5-10%.
3166 - [Updated musl used to build musl rustc to 1.1.17][45393]
3167
3168 Libraries
3169 ---------
3170 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
3171 - [Implement Hash for raw pointers to unsized types][45483]
3172 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
3173 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
3174 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
3175 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
3176   and `<*mut T>::as_mut`][44932]
3177 - [Optimized `Thread::{park, unpark}` implementation][45524]
3178 - [Improved `SliceExt::binary_search` performance.][45333]
3179 - [impl `FromIterator<()>` for `()`][45379]
3180 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
3181   is now deprecated.
3182
3183 Stabilized APIs
3184 ---------------
3185
3186 Cargo
3187 -----
3188 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
3189   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
3190 - [Added unit test checking to `cargo check`][cargo/4592]
3191 - [Cargo now lets you install a specific version
3192   using `cargo install --version`][cargo/4637]
3193
3194 Misc
3195 ----
3196 - [Releases now ship with the Cargo book documentation.][45692]
3197 - [rustdoc now prints rendering warnings on every run.][45324]
3198
3199 Compatibility Notes
3200 -------------------
3201 - [Changes have been made to type equality to make it more correct,
3202   in rare cases this could break some code.][45853] [Tracking issue for
3203   further information][45852]
3204 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
3205 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
3206   Android 9, the minimum supported version is Android 14.
3207 - [Bumped the minimum LLVM to 3.9][45326]
3208
3209 [44042]: https://github.com/rust-lang/rust/pull/44042
3210 [44932]: https://github.com/rust-lang/rust/pull/44932
3211 [45267]: https://github.com/rust-lang/rust/pull/45267
3212 [45324]: https://github.com/rust-lang/rust/pull/45324
3213 [45326]: https://github.com/rust-lang/rust/pull/45326
3214 [45333]: https://github.com/rust-lang/rust/pull/45333
3215 [45379]: https://github.com/rust-lang/rust/pull/45379
3216 [45380]: https://github.com/rust-lang/rust/pull/45380
3217 [45393]: https://github.com/rust-lang/rust/pull/45393
3218 [45435]: https://github.com/rust-lang/rust/pull/45435
3219 [45483]: https://github.com/rust-lang/rust/pull/45483
3220 [45524]: https://github.com/rust-lang/rust/pull/45524
3221 [45571]: https://github.com/rust-lang/rust/pull/45571
3222 [45580]: https://github.com/rust-lang/rust/pull/45580
3223 [45610]: https://github.com/rust-lang/rust/pull/45610
3224 [45660]: https://github.com/rust-lang/rust/pull/45660
3225 [45692]: https://github.com/rust-lang/rust/pull/45692
3226 [45711]: https://github.com/rust-lang/rust/pull/45711
3227 [45772]: https://github.com/rust-lang/rust/pull/45772
3228 [45852]: https://github.com/rust-lang/rust/issues/45852
3229 [45853]: https://github.com/rust-lang/rust/pull/45853
3230 [45887]: https://github.com/rust-lang/rust/pull/45887
3231 [45920]: https://github.com/rust-lang/rust/pull/45920
3232 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
3233 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
3234 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
3235
3236
3237 Version 1.22.1 (2017-11-22)
3238 ==========================
3239
3240 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
3241
3242 [46183]: https://github.com/rust-lang/rust/pull/46183
3243
3244 Version 1.22.0 (2017-11-22)
3245 ==========================
3246
3247 Language
3248 --------
3249 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
3250 - [Now accepts underscores in unicode escapes][43716]
3251 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
3252 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
3253
3254 Compiler
3255 --------
3256 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
3257 - [rustc will no longer inline in codegen units when compiling for debug][45075]
3258   This should decrease compile times for debug builds.
3259 - [strict memory alignment now enabled on ARMv6][45094]
3260 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
3261
3262 Libraries
3263 ---------
3264 - [Allow atomic operations up to 32 bits
3265   on `armv5te_unknown_linux_gnueabi`][44978]
3266 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
3267 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
3268 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
3269 - [Properly detect overflow in `Instant += Duration`.][44220]
3270 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
3271 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
3272 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
3273
3274 Stabilized APIs
3275 ---------------
3276
3277 Cargo
3278 -----
3279 - [Cargo will now build multi file examples in subdirectories of the `examples`
3280   folder that have a `main.rs` file.][cargo/4496]
3281 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
3282   the old format will continue to work and can be updated with `cargo update`.
3283 - [Now supports vendoring git repositories][cargo/3992]
3284
3285 Misc
3286 ----
3287 - [`libbacktrace` is now available on Apple platforms.][44251]
3288 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
3289   This now lets you specify that a given code example will fail to compile.
3290
3291 Compatibility Notes
3292 -------------------
3293 - [The minimum Android version that rustc can build for has been bumped
3294   to `4.0` from `2.3`][45656]
3295 - [Allowing `T op= &T` for numeric types has broken some type
3296   inference cases][45480]
3297
3298
3299 [42526]: https://github.com/rust-lang/rust/pull/42526
3300 [43017]: https://github.com/rust-lang/rust/pull/43017
3301 [43716]: https://github.com/rust-lang/rust/pull/43716
3302 [43949]: https://github.com/rust-lang/rust/pull/43949
3303 [44015]: https://github.com/rust-lang/rust/pull/44015
3304 [44220]: https://github.com/rust-lang/rust/pull/44220
3305 [44251]: https://github.com/rust-lang/rust/pull/44251
3306 [44287]: https://github.com/rust-lang/rust/pull/44287
3307 [44303]: https://github.com/rust-lang/rust/pull/44303
3308 [44456]: https://github.com/rust-lang/rust/pull/44456
3309 [44466]: https://github.com/rust-lang/rust/pull/44466
3310 [44895]: https://github.com/rust-lang/rust/pull/44895
3311 [44966]: https://github.com/rust-lang/rust/pull/44966
3312 [44978]: https://github.com/rust-lang/rust/pull/44978
3313 [45041]: https://github.com/rust-lang/rust/pull/45041
3314 [45064]: https://github.com/rust-lang/rust/pull/45064
3315 [45075]: https://github.com/rust-lang/rust/pull/45075
3316 [45094]: https://github.com/rust-lang/rust/pull/45094
3317 [45095]: https://github.com/rust-lang/rust/pull/45095
3318 [45480]: https://github.com/rust-lang/rust/issues/45480
3319 [45656]: https://github.com/rust-lang/rust/pull/45656
3320 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
3321 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
3322 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
3323
3324
3325
3326
3327
3328
3329 Version 1.21.0 (2017-10-12)
3330 ==========================
3331
3332 Language
3333 --------
3334 - [You can now use static references for literals.][43838]
3335   Example:
3336   ```rust
3337   fn main() {
3338       let x: &'static u32 = &0;
3339   }
3340   ```
3341 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
3342   Example:
3343   ```rust
3344   my_macro!(Vec<i32>::new); // Always worked
3345   my_macro!(Vec::<i32>::new); // Now works
3346   ```
3347
3348 Compiler
3349 --------
3350 - [Upgraded jemalloc to 4.5.0][43911]
3351 - [Enabled unwinding panics on Redox][43917]
3352 - [Now runs LLVM in parallel during translation phase.][43506]
3353   This should reduce peak memory usage.
3354
3355 Libraries
3356 ---------
3357 - [Generate builtin impls for `Clone` for all arrays and tuples that
3358   are `T: Clone`][43690]
3359 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
3360 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
3361   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
3362
3363 Stabilized APIs
3364 ---------------
3365
3366 [`std::mem::discriminant`]
3367
3368 Cargo
3369 -----
3370 - [You can now call `cargo install` with multiple package names][cargo/4216]
3371 - [Cargo commands inside a virtual workspace will now implicitly
3372   pass `--all`][cargo/4335]
3373 - [Added a `[patch]` section to `Cargo.toml` to handle
3374   prepublication dependencies][cargo/4123] [RFC 1969]
3375 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
3376   like patterns][cargo/4270]
3377 - [Added the `--all-targets` option][cargo/4400]
3378 - [Using required dependencies as a feature is now deprecated and emits
3379   a warning][cargo/4364]
3380
3381
3382 Misc
3383 ----
3384 - [Cargo docs are moving][43916]
3385   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
3386 - [The rustdoc book is now available][43863]
3387   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
3388 - [Added a preview of RLS has been made available through rustup][44204]
3389   Install with `rustup component add rls-preview`
3390 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
3391   Previously only showed `std::os::unix`.
3392
3393 Compatibility Notes
3394 -------------------
3395 - [Changes in method matching against higher-ranked types][43880] This may cause
3396   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
3397 - [rustc's JSON error output's byte position start at top of file.][42973]
3398   Was previously relative to the rustc's internal `CodeMap` struct which
3399   required the unstable library `libsyntax` to correctly use.
3400 - [`unused_results` lint no longer ignores booleans][43728]
3401
3402 [42565]: https://github.com/rust-lang/rust/pull/42565
3403 [42973]: https://github.com/rust-lang/rust/pull/42973
3404 [43348]: https://github.com/rust-lang/rust/pull/43348
3405 [43459]: https://github.com/rust-lang/rust/pull/43459
3406 [43506]: https://github.com/rust-lang/rust/pull/43506
3407 [43540]: https://github.com/rust-lang/rust/pull/43540
3408 [43690]: https://github.com/rust-lang/rust/pull/43690
3409 [43728]: https://github.com/rust-lang/rust/pull/43728
3410 [43838]: https://github.com/rust-lang/rust/pull/43838
3411 [43863]: https://github.com/rust-lang/rust/pull/43863
3412 [43880]: https://github.com/rust-lang/rust/pull/43880
3413 [43911]: https://github.com/rust-lang/rust/pull/43911
3414 [43916]: https://github.com/rust-lang/rust/pull/43916
3415 [43917]: https://github.com/rust-lang/rust/pull/43917
3416 [44204]: https://github.com/rust-lang/rust/pull/44204
3417 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
3418 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
3419 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3420 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
3421 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
3422 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
3423 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
3424 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
3425 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
3426
3427 Version 1.20.0 (2017-08-31)
3428 ===========================
3429
3430 Language
3431 --------
3432 - [Associated constants are now stabilised.][42809]
3433 - [A lot of macro bugs are now fixed.][42913]
3434
3435 Compiler
3436 --------
3437
3438 - [Struct fields are now properly coerced to the expected field type.][42807]
3439 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
3440   `wasm32-experimental-emscripten` target.
3441 - [Changed some of the error messages to be more helpful.][42033]
3442 - [Add support for RELRO(RELocation Read-Only) for platforms that support
3443   it.][43170]
3444 - [rustc now reports the total number of errors on compilation failure][43015]
3445   previously this was only the number of errors in the pass that failed.
3446 - [Expansion in rustc has been sped up 29x.][42533]
3447 - [added `msp430-none-elf` target.][43099]
3448 - [rustc will now suggest one-argument enum variant to fix type mismatch when
3449   applicable][43178]
3450 - [Fixes backtraces on Redox][43228]
3451 - [rustc now identifies different versions of same crate when absolute paths of
3452   different types match in an error message.][42826]
3453
3454 Libraries
3455 ---------
3456
3457
3458 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
3459 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
3460   tuples.][43011]
3461 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
3462   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
3463 - [Impl `Clone` for `DefaultHasher`.][42799]
3464 - [Impl `Sync` for `SyncSender`.][42397]
3465 - [Impl `FromStr` for `char`][42271]
3466 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
3467   NaN.][42431]
3468 - [allow messages in the `unimplemented!()` macro.][42155]
3469   ie. `unimplemented!("Waiting for 1.21 to be stable")`
3470 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
3471 - [Upgrade to Unicode 10.0.0][42999]
3472 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
3473 - [Skip the main thread's manual stack guard on Linux][43072]
3474 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
3475 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
3476   previously 2^15.
3477 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
3478
3479 Stabilized APIs
3480 ---------------
3481
3482 - [`CStr::into_c_string`]
3483 - [`CString::as_c_str`]
3484 - [`CString::into_boxed_c_str`]
3485 - [`Chain::get_mut`]
3486 - [`Chain::get_ref`]
3487 - [`Chain::into_inner`]
3488 - [`Option::get_or_insert_with`]
3489 - [`Option::get_or_insert`]
3490 - [`OsStr::into_os_string`]
3491 - [`OsString::into_boxed_os_str`]
3492 - [`Take::get_mut`]
3493 - [`Take::get_ref`]
3494 - [`Utf8Error::error_len`]
3495 - [`char::EscapeDebug`]
3496 - [`char::escape_debug`]
3497 - [`compile_error!`]
3498 - [`f32::from_bits`]
3499 - [`f32::to_bits`]
3500 - [`f64::from_bits`]
3501 - [`f64::to_bits`]
3502 - [`mem::ManuallyDrop`]
3503 - [`slice::sort_unstable_by_key`]
3504 - [`slice::sort_unstable_by`]
3505 - [`slice::sort_unstable`]
3506 - [`str::from_boxed_utf8_unchecked`]
3507 - [`str::as_bytes_mut`]
3508 - [`str::as_bytes_mut`]
3509 - [`str::from_utf8_mut`]
3510 - [`str::from_utf8_unchecked_mut`]
3511 - [`str::get_mut`]
3512 - [`str::get_unchecked_mut`]
3513 - [`str::get_unchecked`]
3514 - [`str::get`]
3515 - [`str::into_boxed_bytes`]
3516
3517
3518 Cargo
3519 -----
3520 - [Cargo API token location moved from `~/.cargo/config` to
3521   `~/.cargo/credentials`.][cargo/3978]
3522 - [Cargo will now build `main.rs` binaries that are in sub-directories of
3523   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
3524   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
3525 - [You can now specify version of a binary when installed through
3526   `cargo install` using `--vers`.][cargo/4229]
3527 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
3528   failure.][cargo/4248]
3529 - [Changed the convention around which file is the crate root.][cargo/4259]
3530 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
3531   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
3532
3533 Compatibility Notes
3534 -------------------
3535
3536 - [Functions with `'static` in their return types will now not be as usable as
3537   if they were using lifetime parameters instead.][42417]
3538 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
3539   takes the sign of NaN into account where previously didn't.][42430]
3540
3541 [42033]: https://github.com/rust-lang/rust/pull/42033
3542 [42155]: https://github.com/rust-lang/rust/pull/42155
3543 [42271]: https://github.com/rust-lang/rust/pull/42271
3544 [42397]: https://github.com/rust-lang/rust/pull/42397
3545 [42417]: https://github.com/rust-lang/rust/pull/42417
3546 [42430]: https://github.com/rust-lang/rust/pull/42430
3547 [42431]: https://github.com/rust-lang/rust/pull/42431
3548 [42533]: https://github.com/rust-lang/rust/pull/42533
3549 [42571]: https://github.com/rust-lang/rust/pull/42571
3550 [42613]: https://github.com/rust-lang/rust/pull/42613
3551 [42799]: https://github.com/rust-lang/rust/pull/42799
3552 [42807]: https://github.com/rust-lang/rust/pull/42807
3553 [42809]: https://github.com/rust-lang/rust/pull/42809
3554 [42822]: https://github.com/rust-lang/rust/pull/42822
3555 [42826]: https://github.com/rust-lang/rust/pull/42826
3556 [42854]: https://github.com/rust-lang/rust/pull/42854
3557 [42913]: https://github.com/rust-lang/rust/pull/42913
3558 [42999]: https://github.com/rust-lang/rust/pull/42999
3559 [43011]: https://github.com/rust-lang/rust/pull/43011
3560 [43015]: https://github.com/rust-lang/rust/pull/43015
3561 [43072]: https://github.com/rust-lang/rust/pull/43072
3562 [43077]: https://github.com/rust-lang/rust/pull/43077
3563 [43097]: https://github.com/rust-lang/rust/pull/43097
3564 [43099]: https://github.com/rust-lang/rust/pull/43099
3565 [43170]: https://github.com/rust-lang/rust/pull/43170
3566 [43178]: https://github.com/rust-lang/rust/pull/43178
3567 [43185]: https://github.com/rust-lang/rust/pull/43185
3568 [43228]: https://github.com/rust-lang/rust/pull/43228
3569 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
3570 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
3571 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
3572 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
3573 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
3574 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
3575 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
3576 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
3577 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
3578 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
3579 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
3580 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
3581 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
3582 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
3583 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
3584 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
3585 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
3586 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
3587 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
3588 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
3589 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
3590 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
3591 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
3592 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
3593 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
3594 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
3595 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
3596 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
3597 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
3598 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
3599 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
3600 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
3601 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
3602 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
3603 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
3604 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
3605 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
3606 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
3607 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
3608
3609
3610 Version 1.19.0 (2017-07-20)
3611 ===========================
3612
3613 Language
3614 --------
3615
3616 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
3617   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
3618 - [Macro recursion limit increased to 1024 from 64.][41676]
3619 - [Added lint for detecting unused macros.][41907]
3620 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
3621   For example: `let x = loop { break 7; };`
3622 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
3623   contain `Copy` types and cannot have a `Drop` implementation.
3624   Example: `union Foo { bar: u8, baz: usize }`
3625 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
3626   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
3627
3628 Compiler
3629 --------
3630
3631 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
3632 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
3633   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
3634   you should use `--target armv7-linux-androideabi`.
3635 - [Fixed ICE when removing a source file between compilation sessions.][41873]
3636 - [Minor optimisation of string operations.][42037]
3637 - [Compiler error message is now `aborting due to previous error(s)` instead of
3638   `aborting due to N previous errors`][42150] This was previously inaccurate and
3639   would only count certain kinds of errors.
3640 - [The compiler now supports Visual Studio 2017][42225]
3641 - [The compiler is now built against LLVM 4.0.1 by default][42948]
3642 - [Added a lot][42264] of [new error codes][42302]
3643 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
3644   libraries with C Run-time Libraries(CRT) to be statically linked.
3645 - [Fixed various ARM codegen bugs][42740]
3646
3647 Libraries
3648 ---------
3649
3650 - [`String` now implements `FromIterator<Cow<'a, str>>` and
3651   `Extend<Cow<'a, str>>`][41449]
3652 - [`Vec` now implements `From<&mut [T]>`][41530]
3653 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
3654 - [`SplitWhitespace` now implements `Clone`][41659]
3655 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
3656   1.5x faster][41764]
3657 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
3658   macros, but for printing to stderr.
3659
3660 Stabilized APIs
3661 ---------------
3662
3663 - [`OsString::shrink_to_fit`]
3664 - [`cmp::Reverse`]
3665 - [`Command::envs`]
3666 - [`thread::ThreadId`]
3667
3668 Cargo
3669 -----
3670
3671 - [Build scripts can now add environment variables to the environment
3672   the crate is being compiled in.
3673   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
3674 - [Subcommands now replace the current process rather than spawning a new
3675   child process][cargo/3970]
3676 - [Workspace members can now accept glob file patterns][cargo/3979]
3677 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
3678   the members in a given workspace.][cargo/3988]
3679 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
3680 - [Target directory path is now in the cargo metadata][cargo/4022]
3681 - [Cargo no longer checks out a local working directory for the
3682   crates.io index][cargo/4026] This should provide smaller file size for the
3683   registry, and improve cloning times, especially on Windows machines.
3684 - [Added an `--exclude` option for excluding certain packages when using the
3685   `--all` option][cargo/4031]
3686 - [Cargo will now automatically retry when receiving a 5xx error
3687   from crates.io][cargo/4032]
3688 - [The `--features` option now accepts multiple comma or space
3689   delimited values.][cargo/4084]
3690 - [Added support for custom target specific runners][cargo/3954]
3691
3692 Misc
3693 ----
3694
3695 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
3696   Windows Debugger.
3697 - [Rust will now release XZ compressed packages][rust-installer/57]
3698 - [rustup will now prefer to download rust packages with
3699   XZ compression][rustup/1100] over GZip packages.
3700 - [Added the ability to escape `#` in rust documentation][41785] By adding
3701   additional `#`'s ie. `##` is now `#`
3702
3703 Compatibility Notes
3704 -------------------
3705
3706 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
3707 - [`-Z` flags are now no longer allowed to be used on the stable
3708   compiler.][41751] This has been a warning for a year previous to this.
3709 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3710   longer works][42844]. Users should migrate to the built-in `check`
3711   command, which has been available since 1.16.
3712 - [Ending a float literal with `._` is now a hard error.
3713   Example: `42._` .][41946]
3714 - [Any use of a private `extern crate` outside of its module is now a
3715   hard error.][36886] This was previously a warning.
3716 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3717   relative while the `::` prefix makes a path absolute, but was ignored and the
3718   path was relative regardless.
3719 - [Floating point constants in match patterns is now a hard error][36890]
3720   This was previously a warning.
3721 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3722   match patterns is now a hard error][36891] This was previously a warning.
3723 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3724   a warning.
3725 - [From the pound escape, lines consisting of multiple `#`s are
3726   now visible][41785]
3727 - [It is an error to re-export private enum variants][42460]. This is
3728   known to break a number of crates that depend on an older version of
3729   mustache.
3730 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3731   to use it to find the linker, and the build will fail where it did
3732   not previously][42607]
3733
3734 [36886]: https://github.com/rust-lang/rust/issues/36886
3735 [36888]: https://github.com/rust-lang/rust/issues/36888
3736 [36890]: https://github.com/rust-lang/rust/issues/36890
3737 [36891]: https://github.com/rust-lang/rust/issues/36891
3738 [36892]: https://github.com/rust-lang/rust/issues/36892
3739 [37406]: https://github.com/rust-lang/rust/issues/37406
3740 [39983]: https://github.com/rust-lang/rust/pull/39983
3741 [41145]: https://github.com/rust-lang/rust/pull/41145
3742 [41192]: https://github.com/rust-lang/rust/pull/41192
3743 [41258]: https://github.com/rust-lang/rust/pull/41258
3744 [41370]: https://github.com/rust-lang/rust/pull/41370
3745 [41449]: https://github.com/rust-lang/rust/pull/41449
3746 [41530]: https://github.com/rust-lang/rust/pull/41530
3747 [41624]: https://github.com/rust-lang/rust/pull/41624
3748 [41656]: https://github.com/rust-lang/rust/pull/41656
3749 [41659]: https://github.com/rust-lang/rust/pull/41659
3750 [41676]: https://github.com/rust-lang/rust/pull/41676
3751 [41751]: https://github.com/rust-lang/rust/pull/41751
3752 [41764]: https://github.com/rust-lang/rust/pull/41764
3753 [41785]: https://github.com/rust-lang/rust/pull/41785
3754 [41873]: https://github.com/rust-lang/rust/pull/41873
3755 [41907]: https://github.com/rust-lang/rust/pull/41907
3756 [41946]: https://github.com/rust-lang/rust/pull/41946
3757 [42016]: https://github.com/rust-lang/rust/pull/42016
3758 [42037]: https://github.com/rust-lang/rust/pull/42037
3759 [42068]: https://github.com/rust-lang/rust/pull/42068
3760 [42150]: https://github.com/rust-lang/rust/pull/42150
3761 [42162]: https://github.com/rust-lang/rust/pull/42162
3762 [42225]: https://github.com/rust-lang/rust/pull/42225
3763 [42264]: https://github.com/rust-lang/rust/pull/42264
3764 [42302]: https://github.com/rust-lang/rust/pull/42302
3765 [42460]: https://github.com/rust-lang/rust/issues/42460
3766 [42607]: https://github.com/rust-lang/rust/issues/42607
3767 [42740]: https://github.com/rust-lang/rust/pull/42740
3768 [42844]: https://github.com/rust-lang/rust/issues/42844
3769 [42948]: https://github.com/rust-lang/rust/pull/42948
3770 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3771 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3772 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3773 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3774 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3775 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3776 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3777 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3778 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3779 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3780 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3781 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3782 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3783 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3784 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3785 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3786 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3787 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3788 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3789 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3790 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3791 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3792
3793
3794 Version 1.18.0 (2017-06-08)
3795 ===========================
3796
3797 Language
3798 --------
3799
3800 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3801   make the item visible to just that module tree. Also accepts the keyword
3802   `crate` to make something public to the whole crate but not users of the
3803   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3804 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3805   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3806 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3807   types like `Write + Send`, trailing `+` are now supported in trait objects,
3808   and better error reporting for trait objects starting with `?Sized`.
3809 - [0e+10 is now a valid floating point literal][40589]
3810 - [Now warns if you bind a lifetime parameter to 'static][40734]
3811 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3812   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3813   representation in some cases.][40377]
3814
3815 Compiler
3816 --------
3817
3818 - [rustc can now emit mir with `--emit mir`][39891]
3819 - [Improved LLVM IR for trivial functions][40367]
3820 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3821 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3822   opportunities found through profiling
3823 - [Improved backtrace formatting when panicking][38165]
3824
3825 Libraries
3826 ---------
3827
3828 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3829   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3830   iteration or reallocation.
3831 - [Simplified HashMap Bucket interface][40561] provides performance
3832   improvements for iterating and cloning.
3833 - [Specialize Vec::from_elem to use calloc][40409]
3834 - [Fixed Race condition in fs::create_dir_all][39799]
3835 - [No longer caching stdio on Windows][40516]
3836 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3837   2.50%~ faster and in one case now 12.50% faster.
3838 - [Optimized `AtomicBool::fetch_nand`][41143]
3839
3840 Stabilized APIs
3841 ---------------
3842
3843 - [`Child::try_wait`]
3844 - [`HashMap::retain`]
3845 - [`HashSet::retain`]
3846 - [`PeekMut::pop`]
3847 - [`TcpStream::peek`]
3848 - [`UdpSocket::peek`]
3849 - [`UdpSocket::peek_from`]
3850
3851 Cargo
3852 -----
3853
3854 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3855   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3856 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3857 - [Added Android build support][cargo/3885]
3858 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3859   of a certain type, for example `cargo build --bins` will build all
3860   binaries.
3861 - [Added support for haiku][cargo/3952]
3862
3863 Misc
3864 ----
3865
3866 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3867 - [Added rust-windbg script for better debugging on Windows][39983]
3868 - [Rust now uses the official cross compiler for NetBSD][40612]
3869 - [rustdoc now accepts `#` at the start of files][40828]
3870 - [Fixed jemalloc support for musl][41168]
3871
3872 Compatibility Notes
3873 -------------------
3874
3875 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3876   always placed after the sign if it exists and before the digits. With the `#`
3877   flag the zeroes are placed after the prefix and before the digits.
3878 - [Due to the struct field optimisation][40377], using `transmute` on structs
3879   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3880   always been undefined behavior, but is now more likely to break in practice.
3881 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3882   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3883   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3884 - [Overlapping inherent `impl`s are now a hard error][40728]
3885 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3886 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3887   `out.asm` and `out.ll` instead of only one of the filetypes.
3888 - [ calling a function that returns `Self` will no longer work][41805] when
3889   the size of `Self` cannot be statically determined.
3890 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3891   this has caused a few regressions namely:
3892
3893   - Changed the link order of local static/dynamic libraries (respecting the
3894     order on given rather than having the compiler reorder).
3895   - Changed how MinGW is linked, native code linked to dynamic libraries
3896     may require manually linking to the gcc support library (for the native
3897     code itself)
3898
3899 [38165]: https://github.com/rust-lang/rust/pull/38165
3900 [39799]: https://github.com/rust-lang/rust/pull/39799
3901 [39891]: https://github.com/rust-lang/rust/pull/39891
3902 [39983]: https://github.com/rust-lang/rust/pull/39983
3903 [40043]: https://github.com/rust-lang/rust/pull/40043
3904 [40241]: https://github.com/rust-lang/rust/pull/40241
3905 [40338]: https://github.com/rust-lang/rust/pull/40338
3906 [40367]: https://github.com/rust-lang/rust/pull/40367
3907 [40377]: https://github.com/rust-lang/rust/pull/40377
3908 [40409]: https://github.com/rust-lang/rust/pull/40409
3909 [40516]: https://github.com/rust-lang/rust/pull/40516
3910 [40556]: https://github.com/rust-lang/rust/pull/40556
3911 [40561]: https://github.com/rust-lang/rust/pull/40561
3912 [40589]: https://github.com/rust-lang/rust/pull/40589
3913 [40612]: https://github.com/rust-lang/rust/pull/40612
3914 [40723]: https://github.com/rust-lang/rust/pull/40723
3915 [40728]: https://github.com/rust-lang/rust/pull/40728
3916 [40731]: https://github.com/rust-lang/rust/pull/40731
3917 [40734]: https://github.com/rust-lang/rust/pull/40734
3918 [40805]: https://github.com/rust-lang/rust/pull/40805
3919 [40807]: https://github.com/rust-lang/rust/pull/40807
3920 [40828]: https://github.com/rust-lang/rust/pull/40828
3921 [40870]: https://github.com/rust-lang/rust/pull/40870
3922 [41085]: https://github.com/rust-lang/rust/pull/41085
3923 [41143]: https://github.com/rust-lang/rust/pull/41143
3924 [41168]: https://github.com/rust-lang/rust/pull/41168
3925 [41270]: https://github.com/rust-lang/rust/issues/41270
3926 [41469]: https://github.com/rust-lang/rust/pull/41469
3927 [41805]: https://github.com/rust-lang/rust/issues/41805
3928 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3929 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3930 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3931 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3932 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3933 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3934 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3935 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3936 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3937 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3938 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3939 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3940 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3941 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3942
3943
3944 Version 1.17.0 (2017-04-27)
3945 ===========================
3946
3947 Language
3948 --------
3949
3950 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3951 * [Fields of structs may be initialized without duplicating the field/variable
3952   names][39761]. [RFC 1682]
3953 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3954 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3955   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3956   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3957   `'b`. Soundness fix.
3958 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3959 * [Static variables may contain references to other statics][40027]
3960
3961 Compiler
3962 --------
3963
3964 * [Exit quickly on only `--emit dep-info`][40336]
3965 * [Make `-C relocation-model` more correctly determine whether the linker
3966   creates a position-independent executable][40245]
3967 * [Add `-C overflow-checks` to directly control whether integer overflow
3968   panics][40037]
3969 * [The rustc type checker now checks items on demand instead of in a single
3970   in-order pass][40008]. This is mostly an internal refactoring in support of
3971   future work, including incremental type checking, but also resolves [RFC
3972   1647], allowing `Self` to appear in `impl` `where` clauses.
3973 * [Optimize vtable loads][39995]
3974 * [Turn off vectorization for Emscripten targets][39990]
3975 * [Provide suggestions for unknown macros imported with `use`][39953]
3976 * [Fix ICEs in path resolution][39939]
3977 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3978 * [Add clearer error message using `&str + &str`][39116]
3979
3980 Stabilized APIs
3981 ---------------
3982
3983 * [`Arc::into_raw`]
3984 * [`Arc::from_raw`]
3985 * [`Arc::ptr_eq`]
3986 * [`Rc::into_raw`]
3987 * [`Rc::from_raw`]
3988 * [`Rc::ptr_eq`]
3989 * [`Ordering::then`]
3990 * [`Ordering::then_with`]
3991 * [`BTreeMap::range`]
3992 * [`BTreeMap::range_mut`]
3993 * [`collections::Bound`]
3994 * [`process::abort`]
3995 * [`ptr::read_unaligned`]
3996 * [`ptr::write_unaligned`]
3997 * [`Result::expect_err`]
3998 * [`Cell::swap`]
3999 * [`Cell::replace`]
4000 * [`Cell::into_inner`]
4001 * [`Cell::take`]
4002
4003 Libraries
4004 ---------
4005
4006 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
4007 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
4008 * [`String` implements `FromIterator<&char>`][40028]
4009 * `Box` [implements][40009] a number of new conversions:
4010   `From<Box<str>> for String`,
4011   `From<Box<[T]>> for Vec<T>`,
4012   `From<Box<CStr>> for CString`,
4013   `From<Box<OsStr>> for OsString`,
4014   `From<Box<Path>> for PathBuf`,
4015   `Into<Box<str>> for String`,
4016   `Into<Box<[T]>> for Vec<T>`,
4017   `Into<Box<CStr>> for CString`,
4018   `Into<Box<OsStr>> for OsString`,
4019   `Into<Box<Path>> for PathBuf`,
4020   `Default for Box<str>`,
4021   `Default for Box<CStr>`,
4022   `Default for Box<OsStr>`,
4023   `From<&CStr> for Box<CStr>`,
4024   `From<&OsStr> for Box<OsStr>`,
4025   `From<&Path> for Box<Path>`
4026 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
4027 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
4028 * [Slightly optimize `slice::sort`][39538]
4029 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
4030 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
4031   `Box<str>` implements `From<&str>`][39438]
4032 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
4033   `From<(I, u16)> where I: Into<IpAddr>`][39372]
4034 * [`format!` estimates the needed capacity before writing a string][39356]
4035 * [Support unprivileged symlink creation in Windows][38921]
4036 * [`PathBuf` implements `Default`][38764]
4037 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
4038 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
4039   and poor hash functions.
4040
4041 Cargo
4042 -----
4043
4044 * [Add `cargo check --all`][cargo/3731]
4045 * [Add an option to ignore SSL revocation checking][cargo/3699]
4046 * [Add `cargo run --package`][cargo/3691]
4047 * [Add `required_features`][cargo/3667]
4048 * [Assume `build.rs` is a build script][cargo/3664]
4049 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
4050
4051 Misc
4052 ----
4053
4054 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
4055   `rustbook`][39633]
4056 * [The "Unstable Book" documents nightly-only features][ubook]
4057 * [Improve the style of the sidebar in rustdoc output][40265]
4058 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
4059 * [Fix MSP430 breakage due to `i128`][40257]
4060 * [Preliminary Solaris/SPARCv9 support][39903]
4061 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
4062   run without installing the MSVC runtime.
4063 * [`rustdoc --test` includes file names in test names][39788]
4064 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
4065   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
4066 * [Initial support for `aarch64-unknown-freebsd`][39491]
4067 * [Initial support for `i686-unknown-netbsd`][39426]
4068 * [This release no longer includes the old makefile build system][39431]. Rust
4069   is built with a custom build system, written in Rust, and with Cargo.
4070 * [Add Debug implementations for libcollection structs][39002]
4071 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
4072 * [`--test-threads=0` produces an error][38945]
4073 * [`rustup` installs documentation by default][40526]
4074 * [The Rust source includes NatVis visualizations][39843]. These can be used by
4075   WinDbg and Visual Studio to improve the debugging experience.
4076
4077 Compatibility Notes
4078 -------------------
4079
4080 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
4081   workaround, either use MSVC 2015 or run vcvars.bat.
4082 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
4083   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
4084   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
4085   fix.
4086 * [`format!` and `Display::to_string` panic if an underlying formatting
4087   implementation returns an error][40117]. Previously the error was silently
4088   ignored. It is incorrect for `write_fmt` to return an error when writing
4089   to a string.
4090 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
4091   crates were marked stable and could be accessed from the stable toolchain.
4092 * [Rust git source no longer includes vendored crates][39728]. Those that need
4093   to build with vendored crates should build from release tarballs.
4094 * [Fix inert attributes from `proc_macro_derives`][39572]
4095 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
4096   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
4097   build system.
4098 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
4099   existing code generally ignores the type of dead-code unless a type-hint is
4100   provided; this can cause surprising inference interactions particularly around
4101   defaulting. The new code uniformly ignores the result type of dead-code.
4102 * [Tuple-struct constructors with private fields are no longer visible][38932]
4103 * [Lifetime parameters that do not appear in the arguments are now considered
4104   early-bound][38897], resolving a soundness bug (#[32330]). The
4105   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
4106   April of 2016.
4107 * [rustdoc: fix doctests with non-feature crate attributes][38161]
4108 * [Make transmuting from fn item types to pointer-sized types a hard
4109   error][34198]
4110
4111 [27787]: https://github.com/rust-lang/rust/issues/27787
4112 [32330]: https://github.com/rust-lang/rust/issues/32330
4113 [34198]: https://github.com/rust-lang/rust/pull/34198
4114 [38161]: https://github.com/rust-lang/rust/pull/38161
4115 [38368]: https://github.com/rust-lang/rust/pull/38368
4116 [38584]: https://github.com/rust-lang/rust/issues/38584
4117 [38661]: https://github.com/rust-lang/rust/pull/38661
4118 [38764]: https://github.com/rust-lang/rust/pull/38764
4119 [38864]: https://github.com/rust-lang/rust/issues/38864
4120 [38897]: https://github.com/rust-lang/rust/pull/38897
4121 [38921]: https://github.com/rust-lang/rust/pull/38921
4122 [38932]: https://github.com/rust-lang/rust/pull/38932
4123 [38945]: https://github.com/rust-lang/rust/pull/38945
4124 [38981]: https://github.com/rust-lang/rust/pull/38981
4125 [39002]: https://github.com/rust-lang/rust/pull/39002
4126 [39116]: https://github.com/rust-lang/rust/pull/39116
4127 [39193]: https://github.com/rust-lang/rust/pull/39193
4128 [39265]: https://github.com/rust-lang/rust/pull/39265
4129 [39356]: https://github.com/rust-lang/rust/pull/39356
4130 [39372]: https://github.com/rust-lang/rust/pull/39372
4131 [39426]: https://github.com/rust-lang/rust/pull/39426
4132 [39431]: https://github.com/rust-lang/rust/pull/39431
4133 [39438]: https://github.com/rust-lang/rust/pull/39438
4134 [39440]: https://github.com/rust-lang/rust/pull/39440
4135 [39485]: https://github.com/rust-lang/rust/pull/39485
4136 [39491]: https://github.com/rust-lang/rust/pull/39491
4137 [39518]: https://github.com/rust-lang/rust/pull/39518
4138 [39538]: https://github.com/rust-lang/rust/pull/39538
4139 [39572]: https://github.com/rust-lang/rust/pull/39572
4140 [39633]: https://github.com/rust-lang/rust/pull/39633
4141 [39642]: https://github.com/rust-lang/rust/pull/39642
4142 [39728]: https://github.com/rust-lang/rust/pull/39728
4143 [39761]: https://github.com/rust-lang/rust/pull/39761
4144 [39788]: https://github.com/rust-lang/rust/pull/39788
4145 [39793]: https://github.com/rust-lang/rust/pull/39793
4146 [39837]: https://github.com/rust-lang/rust/pull/39837
4147 [39843]: https://github.com/rust-lang/rust/pull/39843
4148 [39851]: https://github.com/rust-lang/rust/pull/39851
4149 [39903]: https://github.com/rust-lang/rust/pull/39903
4150 [39939]: https://github.com/rust-lang/rust/pull/39939
4151 [39953]: https://github.com/rust-lang/rust/pull/39953
4152 [39960]: https://github.com/rust-lang/rust/pull/39960
4153 [39990]: https://github.com/rust-lang/rust/pull/39990
4154 [39995]: https://github.com/rust-lang/rust/pull/39995
4155 [40008]: https://github.com/rust-lang/rust/pull/40008
4156 [40009]: https://github.com/rust-lang/rust/pull/40009
4157 [40027]: https://github.com/rust-lang/rust/pull/40027
4158 [40028]: https://github.com/rust-lang/rust/pull/40028
4159 [40037]: https://github.com/rust-lang/rust/pull/40037
4160 [40117]: https://github.com/rust-lang/rust/pull/40117
4161 [40166]: https://github.com/rust-lang/rust/pull/40166
4162 [40245]: https://github.com/rust-lang/rust/pull/40245
4163 [40257]: https://github.com/rust-lang/rust/pull/40257
4164 [40261]: https://github.com/rust-lang/rust/pull/40261
4165 [40265]: https://github.com/rust-lang/rust/pull/40265
4166 [40319]: https://github.com/rust-lang/rust/pull/40319
4167 [40336]: https://github.com/rust-lang/rust/pull/40336
4168 [40526]: https://github.com/rust-lang/rust/pull/40526
4169 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4170 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
4171 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
4172 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
4173 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
4174 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
4175 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
4176 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
4177 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
4178 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
4179 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
4180 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
4181 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
4182 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
4183 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
4184 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
4185 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
4186 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
4187 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
4188 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
4189 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
4190 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
4191 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
4192 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
4193 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
4194 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
4195 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
4196 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
4197 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
4198 [mdbook]: https://crates.io/crates/mdbook
4199 [ubook]: https://doc.rust-lang.org/unstable-book/
4200
4201
4202 Version 1.16.0 (2017-03-16)
4203 ===========================
4204
4205 Language
4206 --------
4207
4208 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4209 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4210   match patterns][38069]
4211 * [Clean up semantics of `self` in an import list][38313]
4212 * [`Self` may appear in `impl` headers][38920]
4213 * [`Self` may appear in struct expressions][39282]
4214
4215 Compiler
4216 --------
4217
4218 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
4219   a `.rmeta` file containing only crate metadata][38571]. This can be
4220   used by tools like the Rust Language Service to perform
4221   metadata-only builds.
4222 * [Levenshtein based typo suggestions now work in most places, while
4223   previously they worked only for fields and sometimes for local
4224   variables][38927]. Together with the overhaul of "no
4225   resolution"/"unexpected resolution" errors (#[38154]) they result in
4226   large and systematic improvement in resolution diagnostics.
4227 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
4228   `U`][38670]
4229 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
4230 * [`rustc` no longer attempts to provide "consider using an explicit
4231   lifetime" suggestions][37057]. They were inaccurate.
4232
4233 Stabilized APIs
4234 ---------------
4235
4236 * [`VecDeque::truncate`]
4237 * [`VecDeque::resize`]
4238 * [`String::insert_str`]
4239 * [`Duration::checked_add`]
4240 * [`Duration::checked_sub`]
4241 * [`Duration::checked_div`]
4242 * [`Duration::checked_mul`]
4243 * [`str::replacen`]
4244 * [`str::repeat`]
4245 * [`SocketAddr::is_ipv4`]
4246 * [`SocketAddr::is_ipv6`]
4247 * [`IpAddr::is_ipv4`]
4248 * [`IpAddr::is_ipv6`]
4249 * [`Vec::dedup_by`]
4250 * [`Vec::dedup_by_key`]
4251 * [`Result::unwrap_or_default`]
4252 * [`<*const T>::wrapping_offset`]
4253 * [`<*mut T>::wrapping_offset`]
4254 * `CommandExt::creation_flags`
4255 * [`File::set_permissions`]
4256 * [`String::split_off`]
4257
4258 Libraries
4259 ---------
4260
4261 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
4262   their argument by `Borrow` parameter][37761]
4263 * [All public types in std implement `Debug`][38006]
4264 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
4265 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
4266 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4267   Windows][38274]
4268 * [std: Fix partial writes in `LineWriter`][38062]
4269 * [std: Clamp max read/write sizes on Unix][38062]
4270 * [Use more specific panic message for `&str` slicing errors][38066]
4271 * [`TcpListener::set_only_v6` is deprecated][38304]. This
4272   functionality cannot be achieved in std currently.
4273 * [`writeln!`, like `println!`, now accepts a form with no string
4274   or formatting arguments, to just print a newline][38469]
4275 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
4276 * [Reduce the size of static data in `std_unicode::tables`][38781]
4277 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
4278   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
4279   `Display`][38909]
4280 * [`Duration` implements `Sum`][38712]
4281 * [`String` implements `ToSocketAddrs`][39048]
4282
4283 Cargo
4284 -----
4285
4286 * [The `cargo check` command does a type check of a project without
4287   building it][cargo/3296]
4288 * [crates.io will display CI badges from Travis and AppVeyor, if
4289   specified in Cargo.toml][cargo/3546]
4290 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
4291 * [Compilation profiles accept integer values for `debug`, in addition
4292   to `true` and `false`. These are passed to `rustc` as the value to
4293   `-C debuginfo`][cargo/3534]
4294 * [Implement `cargo --version --verbose`][cargo/3604]
4295 * [All builds now output 'dep-info' build dependencies compatible with
4296   make and ninja][cargo/3557]
4297 * [Build all workspace members with `build --all`][cargo/3511]
4298 * [Document all workspace members with `doc --all`][cargo/3515]
4299 * [Path deps outside workspace are not members][cargo/3443]
4300
4301 Misc
4302 ----
4303
4304 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
4305   the path to the Rust implementation][38589]
4306 * [The `armv7-linux-androideabi` target no longer enables NEON
4307   extensions, per Google's ABI guide][38413]
4308 * [The stock standard library can be compiled for Redox OS][38401]
4309 * [Rust has initial SPARC support][38726]. Tier 3. No builds
4310   available.
4311 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
4312   builds available.
4313 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
4314
4315 Compatibility Notes
4316 -------------------
4317
4318 * [Uninhabitable enums (those without any variants) no longer permit wildcard
4319   match patterns][38069]
4320 * In this release, references to uninhabited types can not be
4321   pattern-matched. This was accidentally allowed in 1.15.
4322 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
4323 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
4324   Windows][38274]
4325 * [Clean up semantics of `self` in an import list][38313]
4326 * Reimplemented lifetime elision. This change was almost entirely compatible
4327   with existing code, but it did close a number of small bugs and loopholes,
4328   as well as being more accepting in some other [cases][41105].
4329
4330 [37057]: https://github.com/rust-lang/rust/pull/37057
4331 [37761]: https://github.com/rust-lang/rust/pull/37761
4332 [38006]: https://github.com/rust-lang/rust/pull/38006
4333 [38051]: https://github.com/rust-lang/rust/pull/38051
4334 [38062]: https://github.com/rust-lang/rust/pull/38062
4335 [38062]: https://github.com/rust-lang/rust/pull/38622
4336 [38066]: https://github.com/rust-lang/rust/pull/38066
4337 [38069]: https://github.com/rust-lang/rust/pull/38069
4338 [38131]: https://github.com/rust-lang/rust/pull/38131
4339 [38154]: https://github.com/rust-lang/rust/pull/38154
4340 [38274]: https://github.com/rust-lang/rust/pull/38274
4341 [38304]: https://github.com/rust-lang/rust/pull/38304
4342 [38313]: https://github.com/rust-lang/rust/pull/38313
4343 [38314]: https://github.com/rust-lang/rust/pull/38314
4344 [38327]: https://github.com/rust-lang/rust/pull/38327
4345 [38401]: https://github.com/rust-lang/rust/pull/38401
4346 [38413]: https://github.com/rust-lang/rust/pull/38413
4347 [38469]: https://github.com/rust-lang/rust/pull/38469
4348 [38559]: https://github.com/rust-lang/rust/pull/38559
4349 [38571]: https://github.com/rust-lang/rust/pull/38571
4350 [38580]: https://github.com/rust-lang/rust/pull/38580
4351 [38589]: https://github.com/rust-lang/rust/pull/38589
4352 [38670]: https://github.com/rust-lang/rust/pull/38670
4353 [38712]: https://github.com/rust-lang/rust/pull/38712
4354 [38726]: https://github.com/rust-lang/rust/pull/38726
4355 [38781]: https://github.com/rust-lang/rust/pull/38781
4356 [38798]: https://github.com/rust-lang/rust/pull/38798
4357 [38909]: https://github.com/rust-lang/rust/pull/38909
4358 [38920]: https://github.com/rust-lang/rust/pull/38920
4359 [38927]: https://github.com/rust-lang/rust/pull/38927
4360 [39048]: https://github.com/rust-lang/rust/pull/39048
4361 [39282]: https://github.com/rust-lang/rust/pull/39282
4362 [39379]: https://github.com/rust-lang/rust/pull/39379
4363 [41105]: https://github.com/rust-lang/rust/issues/41105
4364 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4365 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
4366 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
4367 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
4368 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
4369 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
4370 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
4371 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
4372 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
4373 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
4374 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
4375 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
4376 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
4377 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
4378 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
4379 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
4380 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
4381 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
4382 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
4383 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
4384 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
4385 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
4386 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
4387 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
4388 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
4389 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
4390 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
4391 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
4392 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
4393 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
4394
4395
4396 Version 1.15.1 (2017-02-09)
4397 ===========================
4398
4399 * [Fix IntoIter::as_mut_slice's signature][39466]
4400 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
4401
4402 [39466]: https://github.com/rust-lang/rust/pull/39466
4403 [39523]: https://github.com/rust-lang/rust/pull/39523
4404
4405
4406 Version 1.15.0 (2017-02-02)
4407 ===========================
4408
4409 Language
4410 --------
4411
4412 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
4413   stable. This allows popular code-generating crates like Serde and Diesel to
4414   work ergonomically. [RFC 1681].
4415 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
4416   with curly braces][36868]. Part of [RFC 1506].
4417 * [A number of minor changes to name resolution have been activated][37127].
4418   They add up to more consistent semantics, allowing for future evolution of
4419   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4420   details of what is different. The breaking changes here have been transitioned
4421   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4422 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
4423   bounds][38279]
4424 * [`?Sized` can be used in `where` clauses][37791]
4425 * [There is now a limit on the size of monomorphized types and it can be
4426   modified with the `#![type_size_limit]` crate attribute, similarly to
4427   the `#![recursion_limit]` attribute][37789]
4428
4429 Compiler
4430 --------
4431
4432 * [On Windows, the compiler will apply dllimport attributes when linking to
4433   extern functions][37973]. Additional attributes and flags can control which
4434   library kind is linked and its name. [RFC 1717].
4435 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4436 * [The `--test` flag works with procedural macro crates][38107]
4437 * [Fix `extern "aapcs" fn` ABI][37814]
4438 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
4439 * [The `format!` expander recognizes incorrect `printf` and shell-style
4440   formatting directives and suggests the correct format][37613].
4441 * [Only report one error for all unused imports in an import list][37456]
4442
4443 Compiler Performance
4444 --------------------
4445
4446 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
4447 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
4448 * [Don't clone in `UnificationTable::probe`][37848]
4449 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
4450 * [Use small vectors in type walker][37760]
4451 * [Macro expansion performance was improved][37701]
4452 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
4453 * [Replace FNV with a faster hash function][37229]
4454
4455 Stabilized APIs
4456 ---------------
4457
4458 * [`std::iter::Iterator::min_by`]
4459 * [`std::iter::Iterator::max_by`]
4460 * [`std::os::*::fs::FileExt`]
4461 * [`std::sync::atomic::Atomic*::get_mut`]
4462 * [`std::sync::atomic::Atomic*::into_inner`]
4463 * [`std::vec::IntoIter::as_slice`]
4464 * [`std::vec::IntoIter::as_mut_slice`]
4465 * [`std::sync::mpsc::Receiver::try_iter`]
4466 * [`std::os::unix::process::CommandExt::before_exec`]
4467 * [`std::rc::Rc::strong_count`]
4468 * [`std::rc::Rc::weak_count`]
4469 * [`std::sync::Arc::strong_count`]
4470 * [`std::sync::Arc::weak_count`]
4471 * [`std::char::encode_utf8`]
4472 * [`std::char::encode_utf16`]
4473 * [`std::cell::Ref::clone`]
4474 * [`std::io::Take::into_inner`]
4475
4476 Libraries
4477 ---------
4478
4479 * [The standard sorting algorithm has been rewritten for dramatic performance
4480   improvements][38192]. It is a hybrid merge sort, drawing influences from
4481   Timsort. Previously it was a naive merge sort.
4482 * [`Iterator::nth` no longer has a `Sized` bound][38134]
4483 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
4484   performance.
4485 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
4486   and `char_indices().last()`][37882]
4487 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
4488 * [Chinese characters display correctly in `fmt::Debug`][37855]
4489 * [Derive `Default` for `Duration`][37699]
4490 * [Support creation of anonymous pipes on WinXP/2k][37677]
4491 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
4492 * [Don't pass overlapped handles to processes][38835]
4493
4494 Cargo
4495 -----
4496
4497 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4498   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4499   should instead check the variable at runtime with `std::env`. That the value
4500   was set at build time was a bug, and incorrect when cross-compiling. This
4501   change is known to cause breakage.
4502 * [Add `--all` flag to `cargo test`][cargo/3221]
4503 * [Compile statically against the MSVC CRT][cargo/3363]
4504 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
4505 * [Link OpenSSL statically on OSX][cargo/3311]
4506 * [Apply new fingerprinting to build dir outputs][cargo/3310]
4507 * [Test for bad path overrides with summaries][cargo/3336]
4508 * [Require `cargo install --vers` to take a semver version][cargo/3338]
4509 * [Fix retrying crate downloads for network errors][cargo/3348]
4510 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
4511 * [Emit more info on --message-format=json][cargo/3319]
4512 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
4513 * [Don't ignore errors in workspace manifest][cargo/3409]
4514 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
4515
4516 Tooling
4517 -------
4518
4519 * [Test runners (binaries built with `--test`) now support a `--list` argument
4520   that lists the tests it contains][38185]
4521 * [Test runners now support a `--exact` argument that makes the test filter
4522   match exactly, instead of matching only a substring of the test name][38181]
4523 * [rustdoc supports a `--playground-url` flag][37763]
4524 * [rustdoc provides more details about `#[should_panic]` errors][37749]
4525
4526 Misc
4527 ----
4528
4529 * [The Rust build system is now written in Rust][37817]. The Makefiles may
4530   continue to be used in this release by passing `--disable-rustbuild` to the
4531   configure script, but they will be deleted soon. Note that the new build
4532   system uses a different on-disk layout that will likely affect any scripts
4533   building Rust.
4534 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
4535   releases.
4536 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
4537 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
4538   releases.
4539
4540 Compatibility Notes
4541 -------------------
4542
4543 * [A number of minor changes to name resolution have been activated][37127].
4544   They add up to more consistent semantics, allowing for future evolution of
4545   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
4546   details of what is different. The breaking changes here have been transitioned
4547   through the [`legacy_imports`] lint since 1.14, with no known regressions.
4548 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
4549   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
4550   should instead check the variable at runtime with `std::env`. That the value
4551   was set at build time was a bug, and incorrect when cross-compiling. This
4552   change is known to cause breakage.
4553 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
4554   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
4555   1.10 and is now an error by default. It will become a hard error in the near
4556   future.
4557 * [The semantics relating modules to file system directories are changing in
4558   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
4559   lint, which is a warning in this release, and will become a hard error in the
4560   future.
4561 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
4562 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
4563   the underlying iterator][37834]
4564
4565 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
4566 [33685]: https://github.com/rust-lang/rust/issues/33685
4567 [36868]: https://github.com/rust-lang/rust/pull/36868
4568 [37127]: https://github.com/rust-lang/rust/pull/37127
4569 [37229]: https://github.com/rust-lang/rust/pull/37229
4570 [37456]: https://github.com/rust-lang/rust/pull/37456
4571 [37527]: https://github.com/rust-lang/rust/pull/37527
4572 [37602]: https://github.com/rust-lang/rust/pull/37602
4573 [37613]: https://github.com/rust-lang/rust/pull/37613
4574 [37615]: https://github.com/rust-lang/rust/pull/37615
4575 [37636]: https://github.com/rust-lang/rust/pull/37636
4576 [37627]: https://github.com/rust-lang/rust/pull/37627
4577 [37642]: https://github.com/rust-lang/rust/pull/37642
4578 [37677]: https://github.com/rust-lang/rust/pull/37677
4579 [37699]: https://github.com/rust-lang/rust/pull/37699
4580 [37701]: https://github.com/rust-lang/rust/pull/37701
4581 [37705]: https://github.com/rust-lang/rust/pull/37705
4582 [37749]: https://github.com/rust-lang/rust/pull/37749
4583 [37760]: https://github.com/rust-lang/rust/pull/37760
4584 [37763]: https://github.com/rust-lang/rust/pull/37763
4585 [37764]: https://github.com/rust-lang/rust/pull/37764
4586 [37789]: https://github.com/rust-lang/rust/pull/37789
4587 [37791]: https://github.com/rust-lang/rust/pull/37791
4588 [37814]: https://github.com/rust-lang/rust/pull/37814
4589 [37817]: https://github.com/rust-lang/rust/pull/37817
4590 [37834]: https://github.com/rust-lang/rust/pull/37834
4591 [37848]: https://github.com/rust-lang/rust/pull/37848
4592 [37855]: https://github.com/rust-lang/rust/pull/37855
4593 [37882]: https://github.com/rust-lang/rust/pull/37882
4594 [37888]: https://github.com/rust-lang/rust/pull/37888
4595 [37973]: https://github.com/rust-lang/rust/pull/37973
4596 [37979]: https://github.com/rust-lang/rust/pull/37979
4597 [38086]: https://github.com/rust-lang/rust/pull/38086
4598 [38107]: https://github.com/rust-lang/rust/pull/38107
4599 [38117]: https://github.com/rust-lang/rust/pull/38117
4600 [38134]: https://github.com/rust-lang/rust/pull/38134
4601 [38146]: https://github.com/rust-lang/rust/pull/38146
4602 [38181]: https://github.com/rust-lang/rust/pull/38181
4603 [38182]: https://github.com/rust-lang/rust/pull/38182
4604 [38185]: https://github.com/rust-lang/rust/pull/38185
4605 [38192]: https://github.com/rust-lang/rust/pull/38192
4606 [38279]: https://github.com/rust-lang/rust/pull/38279
4607 [38835]: https://github.com/rust-lang/rust/pull/38835
4608 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4609 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4610 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
4611 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
4612 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
4613 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
4614 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
4615 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
4616 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
4617 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
4618 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
4619 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
4620 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
4621 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
4622 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
4623 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
4624 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
4625 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
4626 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
4627 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
4628 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
4629 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
4630 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
4631 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
4632 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
4633 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
4634 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
4635 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
4636 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
4637 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
4638 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
4639 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
4640 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
4641 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
4642 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
4643 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
4644 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
4645 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
4646
4647
4648 Version 1.14.0 (2016-12-22)
4649 ===========================
4650
4651 Language
4652 --------
4653
4654 * [`..` matches multiple tuple fields in enum variants, structs
4655   and tuples][36843]. [RFC 1492].
4656 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
4657 * [`use *` and `use ::*` both glob-import from the crate root][37367]
4658 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
4659   dereferencing][36822]
4660
4661 Compiler
4662 --------
4663
4664 * [Mark enums with non-zero discriminant as non-zero][37224]
4665 * [Lower-case `static mut` names are linted like other
4666   statics and consts][37162]
4667 * [Fix ICE on some macros in const integer positions
4668    (e.g. `[u8; m!()]`)][36819]
4669 * [Improve error message and snippet for "did you mean `x`"][36798]
4670 * [Add a panic-strategy field to the target specification][36794]
4671 * [Include LLVM version in `--version --verbose`][37200]
4672
4673 Compile-time Optimizations
4674 --------------------------
4675
4676 * [Improve macro expansion performance][37569]
4677 * [Shrink `Expr_::ExprInlineAsm`][37445]
4678 * [Replace all uses of SHA-256 with BLAKE2b][37439]
4679 * [Reduce the number of bytes hashed by `IchHasher`][37427]
4680 * [Avoid more allocations when compiling html5ever][37373]
4681 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
4682 * [Avoid some allocations in the macro parser][37318]
4683 * [Use a faster deflate setting][37298]
4684 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
4685   during interning of slices][37270]
4686 * [Optimize `write_metadata`][37267]
4687 * [Don't process obligation forest cycles when stalled][37231]
4688 * [Avoid many `CrateConfig` clones][37161]
4689 * [Optimize `Substs::super_fold_with`][37108]
4690 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
4691 * [Speed up `plug_leaks`][36917]
4692
4693 Libraries
4694 ---------
4695
4696 * [`println!()`, with no arguments, prints newline][36825].
4697   Previously, an empty string was required to achieve the same.
4698 * [`Wrapping` impls standard binary and unary operators, as well as
4699    the `Sum` and `Product` iterators][37356]
4700 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
4701   Vec<T>`][37326]
4702 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
4703   `VecDeque` iterators][37315]
4704 * [Improve `SipHasher` performance on small values][37312]
4705 * [Add Iterator trait TrustedLen to enable better FromIterator /
4706   Extend][37306]
4707 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
4708 * [`ReadDir` implements `Debug`][37221]
4709 * [Implement `RefUnwindSafe` for atomic types][37178]
4710 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4711 * [Avoid allocations in `Decoder::read_str`][37064]
4712 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4713 * [Impl `Debug` for raw pointers to unsized data][36880]
4714 * [Don't reuse `HashMap` random seeds][37470]
4715 * [The internal memory layout of `HashMap` is more cache-friendly, for
4716   significant improvements in some operations][36692]
4717 * [`HashMap` uses less memory on 32-bit architectures][36595]
4718 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4719
4720 Cargo
4721 -----
4722
4723 * [Expose rustc cfg values to build scripts][cargo/3243]
4724 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4725 * [Fix passing --features when testing multiple packages][cargo/3280]
4726 * [Use a single profile set per workspace][cargo/3249]
4727 * [Load `replace` sections from lock files][cargo/3220]
4728 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4729
4730 Tooling
4731 -------
4732
4733 * [rustup is the recommended Rust installation method][1.14rustup]
4734 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4735   S390x. These are [tier 2] platforms and may have major defects. Follow the
4736   instructions on the website to install, or add the targets to an existing
4737   installation with `rustup target add`. The new target triples are:
4738   - `mips-unknown-linux-gnu`
4739   - `mipsel-unknown-linux-gnu`
4740   - `mips64-unknown-linux-gnuabi64`
4741   - `mips64el-unknown-linux-gnuabi64 `
4742   - `powerpc-unknown-linux-gnu`
4743   - `powerpc64-unknown-linux-gnu`
4744   - `powerpc64le-unknown-linux-gnu`
4745   - `s390x-unknown-linux-gnu `
4746 * This release includes target (std) builds for ARM Linux running MUSL
4747   libc. These are [tier 2] platforms and may have major defects. Add the
4748   following triples to an existing rustup installation with `rustup target add`:
4749   - `arm-unknown-linux-musleabi`
4750   - `arm-unknown-linux-musleabihf`
4751   - `armv7-unknown-linux-musleabihf`
4752 * This release includes [experimental support for WebAssembly][1.14wasm], via
4753   the `wasm32-unknown-emscripten` target. This target is known to have major
4754   defects. Please test, report, and fix.
4755 * rustup no longer installs documentation by default. Run `rustup
4756   component add rust-docs` to install.
4757 * [Fix line stepping in debugger][37310]
4758 * [Enable line number debuginfo in releases][37280]
4759
4760 Misc
4761 ----
4762
4763 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4764 * [Add support for Fuchsia OS][37313]
4765 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4766
4767 Compatibility Notes
4768 -------------------
4769
4770 * [A number of forward-compatibility lints used by the compiler
4771   to gradually introduce language changes have been converted
4772   to deny by default][36894]:
4773   - ["use of inaccessible extern crate erroneously allowed"][36886]
4774   - ["type parameter default erroneously allowed in invalid location"][36887]
4775   - ["detects super or self keywords at the beginning of global path"][36888]
4776   - ["two overlapping inherent impls define an item with the same name
4777     were erroneously allowed"][36889]
4778   - ["floating-point constants cannot be used in patterns"][36890]
4779   - ["constants of struct or enum type can only be used in a pattern if
4780      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4781   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4782 * [Prohibit patterns in trait methods without bodies][37378]
4783 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4784 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4785 * [The `$crate` macro variable is accepted in fewer locations][37213]
4786 * [Impls specifying extra region requirements beyond the trait
4787   they implement are rejected][37167]
4788 * [Enums may not be unsized][37111]. Unsized enums are intended to
4789   work but never have. For now they are forbidden.
4790 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4791
4792 [tier 2]: https://forge.rust-lang.org/platform-support.html
4793 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4794 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4795 [36430]: https://github.com/rust-lang/rust/pull/36430
4796 [36595]: https://github.com/rust-lang/rust/pull/36595
4797 [36595]: https://github.com/rust-lang/rust/pull/36595
4798 [36692]: https://github.com/rust-lang/rust/pull/36692
4799 [36767]: https://github.com/rust-lang/rust/pull/36767
4800 [36794]: https://github.com/rust-lang/rust/pull/36794
4801 [36798]: https://github.com/rust-lang/rust/pull/36798
4802 [36819]: https://github.com/rust-lang/rust/pull/36819
4803 [36822]: https://github.com/rust-lang/rust/pull/36822
4804 [36825]: https://github.com/rust-lang/rust/pull/36825
4805 [36843]: https://github.com/rust-lang/rust/pull/36843
4806 [36880]: https://github.com/rust-lang/rust/pull/36880
4807 [36886]: https://github.com/rust-lang/rust/issues/36886
4808 [36887]: https://github.com/rust-lang/rust/issues/36887
4809 [36888]: https://github.com/rust-lang/rust/issues/36888
4810 [36889]: https://github.com/rust-lang/rust/issues/36889
4811 [36890]: https://github.com/rust-lang/rust/issues/36890
4812 [36891]: https://github.com/rust-lang/rust/issues/36891
4813 [36892]: https://github.com/rust-lang/rust/issues/36892
4814 [36894]: https://github.com/rust-lang/rust/pull/36894
4815 [36917]: https://github.com/rust-lang/rust/pull/36917
4816 [36993]: https://github.com/rust-lang/rust/pull/36993
4817 [37037]: https://github.com/rust-lang/rust/pull/37037
4818 [37064]: https://github.com/rust-lang/rust/pull/37064
4819 [37094]: https://github.com/rust-lang/rust/pull/37094
4820 [37108]: https://github.com/rust-lang/rust/pull/37108
4821 [37111]: https://github.com/rust-lang/rust/pull/37111
4822 [37161]: https://github.com/rust-lang/rust/pull/37161
4823 [37162]: https://github.com/rust-lang/rust/pull/37162
4824 [37167]: https://github.com/rust-lang/rust/pull/37167
4825 [37178]: https://github.com/rust-lang/rust/pull/37178
4826 [37200]: https://github.com/rust-lang/rust/pull/37200
4827 [37213]: https://github.com/rust-lang/rust/pull/37213
4828 [37221]: https://github.com/rust-lang/rust/pull/37221
4829 [37224]: https://github.com/rust-lang/rust/pull/37224
4830 [37230]: https://github.com/rust-lang/rust/pull/37230
4831 [37231]: https://github.com/rust-lang/rust/pull/37231
4832 [37247]: https://github.com/rust-lang/rust/pull/37247
4833 [37267]: https://github.com/rust-lang/rust/pull/37267
4834 [37270]: https://github.com/rust-lang/rust/pull/37270
4835 [37273]: https://github.com/rust-lang/rust/pull/37273
4836 [37280]: https://github.com/rust-lang/rust/pull/37280
4837 [37298]: https://github.com/rust-lang/rust/pull/37298
4838 [37306]: https://github.com/rust-lang/rust/pull/37306
4839 [37310]: https://github.com/rust-lang/rust/pull/37310
4840 [37312]: https://github.com/rust-lang/rust/pull/37312
4841 [37313]: https://github.com/rust-lang/rust/pull/37313
4842 [37315]: https://github.com/rust-lang/rust/pull/37315
4843 [37318]: https://github.com/rust-lang/rust/pull/37318
4844 [37322]: https://github.com/rust-lang/rust/pull/37322
4845 [37326]: https://github.com/rust-lang/rust/pull/37326
4846 [37351]: https://github.com/rust-lang/rust/pull/37351
4847 [37356]: https://github.com/rust-lang/rust/pull/37356
4848 [37367]: https://github.com/rust-lang/rust/pull/37367
4849 [37373]: https://github.com/rust-lang/rust/pull/37373
4850 [37378]: https://github.com/rust-lang/rust/pull/37378
4851 [37389]: https://github.com/rust-lang/rust/pull/37389
4852 [37392]: https://github.com/rust-lang/rust/pull/37392
4853 [37427]: https://github.com/rust-lang/rust/pull/37427
4854 [37439]: https://github.com/rust-lang/rust/pull/37439
4855 [37445]: https://github.com/rust-lang/rust/pull/37445
4856 [37470]: https://github.com/rust-lang/rust/pull/37470
4857 [37569]: https://github.com/rust-lang/rust/pull/37569
4858 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4859 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4860 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4861 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4862 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4863 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4864 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4865
4866
4867 Version 1.13.0 (2016-11-10)
4868 ===========================
4869
4870 Language
4871 --------
4872
4873 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4874   errors, like the `try!` macro, described in [RFC 0243].
4875 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4876 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4877 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4878 * [Fix lifetime rules for 'if' conditions][36029]
4879 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4880
4881 Compiler
4882 --------
4883
4884 * [Add the `-C link-arg` argument][36574]
4885 * [Remove the old AST-based backend from rustc_trans][35764]
4886 * [Don't enable NEON by default on armv7 Linux][35814]
4887 * [Fix debug line number info for macro expansions][35238]
4888 * [Do not emit "class method" debuginfo for types that are not
4889   DICompositeType][36008]
4890 * [Warn about multiple conflicting #[repr] hints][34623]
4891 * [When sizing DST, don't double-count nested struct prefixes][36351]
4892 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4893 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4894 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4895 * [Expand macros without recursing to avoid stack overflows][36214]
4896
4897 Diagnostics
4898 -----------
4899
4900 * [Replace macro backtraces with labeled local uses][35702]
4901 * [Improve error message for misplaced doc comments][33922]
4902 * [Buffer unix and lock windows to prevent message interleaving][35975]
4903 * [Update lifetime errors to specifically note temporaries][36171]
4904 * [Special case a few colors for Windows][36178]
4905 * [Suggest `use self` when such an import resolves][36289]
4906 * [Be more specific when type parameter shadows primitive type][36338]
4907 * Many minor improvements
4908
4909 Compile-time Optimizations
4910 --------------------------
4911
4912 * [Compute and cache HIR hashes at beginning][35854]
4913 * [Don't hash types in loan paths][36004]
4914 * [Cache projections in trans][35761]
4915 * [Optimize the parser's last token handling][36527]
4916 * [Only instantiate #[inline] functions in codegen units referencing
4917   them][36524]. This leads to big improvements in cases where crates export
4918   define many inline functions without using them directly.
4919 * [Lazily allocate TypedArena's first chunk][36592]
4920 * [Don't allocate during default HashSet creation][36734]
4921
4922 Stabilized APIs
4923 ---------------
4924
4925 * [`checked_abs`]
4926 * [`wrapping_abs`]
4927 * [`overflowing_abs`]
4928 * [`RefCell::try_borrow`]
4929 * [`RefCell::try_borrow_mut`]
4930
4931 Libraries
4932 ---------
4933
4934 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4935 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4936   covariant][35354]
4937 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4938 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4939 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4940 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4941 * [Use arc4rand on FreeBSD][35884]
4942 * [memrchr: Correct aligned offset computation][35969]
4943 * [Improve Demangling of Rust Symbols][36059]
4944 * [Use monotonic time in condition variables][35048]
4945 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4946 * [Implement conversion traits for `char`][35755]
4947 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4948 * [Zero first byte of CString on drop][36264]
4949 * [Inherit overflow checks for sum and product][36372]
4950 * [Add missing Eq implementations][36423]
4951 * [Implement `Debug` for `DirEntry`][36631]
4952 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4953   `errno`][36754]
4954 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4955 * [Implement more traits for `std::io::ErrorKind`][35911]
4956 * [Optimize BinaryHeap bounds checking][36072]
4957 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4958   `extend_with_element`][36355]
4959 * [Fix overflow checking in unsigned pow()][34942]
4960
4961 Cargo
4962 -----
4963
4964 * This release includes security fixes to both curl and OpenSSL.
4965 * [Fix transitive doctests when panic=abort][cargo/3021]
4966 * [Add --all-features flag to cargo][cargo/3038]
4967 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4968 * [Don't parse the home directory more than once][cargo/3078]
4969 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4970 * [Update OpenSSL to 1.0.2j][cargo/3121]
4971 * [Add license and license_file to cargo metadata output][cargo/3110]
4972 * [Make crates-io registry URL optional in config; ignore all changes to
4973   source.crates-io][cargo/3089]
4974 * [Don't download dependencies from other platforms][cargo/3123]
4975 * [Build transitive dev-dependencies when needed][cargo/3125]
4976 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4977 * [Avoid updating registry when adding existing deps][cargo/3144]
4978 * [Warn about path overrides that won't work][cargo/3136]
4979 * [Use workspaces during `cargo install`][cargo/3146]
4980 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4981 * [Add --message-format flag][cargo/3000]
4982 * [Pass target environment for rustdoc][cargo/3205]
4983 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4984 * [Update curl and curl-sys][cargo/3241]
4985 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4986
4987 Tooling
4988 -------
4989
4990 * [rustdoc: Add the `--sysroot` argument][36586]
4991 * [rustdoc: Fix a couple of issues with the search results][35655]
4992 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4993 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4994 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4995
4996 Misc
4997 ----
4998
4999 * [Remove unmaintained style guide][35124]
5000 * [Add s390x support][36369]
5001 * [Initial work at Haiku OS support][36727]
5002 * [Add mips-uclibc targets][35734]
5003 * [Crate-ify compiler-rt into compiler-builtins][35021]
5004 * [Add rustc version info (git hash + date) to dist tarball][36213]
5005 * Many documentation improvements
5006
5007 Compatibility Notes
5008 -------------------
5009
5010 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
5011 * [Deny (by default) transmuting from fn item types to pointer-sized
5012   types][34923]. Continuing the long transition to zero-sized fn items,
5013   per [RFC 401].
5014 * [Fix `#[derive]` for empty tuple structs/variants][35728].
5015   Part of [RFC 1506].
5016 * [Issue deprecation warnings for safe accesses to extern statics][36173]
5017 * [Fix lifetime rules for 'if' conditions][36029].
5018 * [Inherit overflow checks for sum and product][36372].
5019 * [Forbid user-defined macros named "macro_rules"][36730].
5020
5021 [33922]: https://github.com/rust-lang/rust/pull/33922
5022 [34623]: https://github.com/rust-lang/rust/pull/34623
5023 [34923]: https://github.com/rust-lang/rust/pull/34923
5024 [34942]: https://github.com/rust-lang/rust/pull/34942
5025 [34982]: https://github.com/rust-lang/rust/pull/34982
5026 [35021]: https://github.com/rust-lang/rust/pull/35021
5027 [35048]: https://github.com/rust-lang/rust/pull/35048
5028 [35074]: https://github.com/rust-lang/rust/pull/35074
5029 [35124]: https://github.com/rust-lang/rust/pull/35124
5030 [35234]: https://github.com/rust-lang/rust/pull/35234
5031 [35238]: https://github.com/rust-lang/rust/pull/35238
5032 [35354]: https://github.com/rust-lang/rust/pull/35354
5033 [35559]: https://github.com/rust-lang/rust/pull/35559
5034 [35585]: https://github.com/rust-lang/rust/pull/35585
5035 [35627]: https://github.com/rust-lang/rust/pull/35627
5036 [35655]: https://github.com/rust-lang/rust/pull/35655
5037 [35702]: https://github.com/rust-lang/rust/pull/35702
5038 [35707]: https://github.com/rust-lang/rust/pull/35707
5039 [35728]: https://github.com/rust-lang/rust/pull/35728
5040 [35734]: https://github.com/rust-lang/rust/pull/35734
5041 [35755]: https://github.com/rust-lang/rust/pull/35755
5042 [35761]: https://github.com/rust-lang/rust/pull/35761
5043 [35764]: https://github.com/rust-lang/rust/pull/35764
5044 [35814]: https://github.com/rust-lang/rust/pull/35814
5045 [35854]: https://github.com/rust-lang/rust/pull/35854
5046 [35871]: https://github.com/rust-lang/rust/pull/35871
5047 [35884]: https://github.com/rust-lang/rust/pull/35884
5048 [35911]: https://github.com/rust-lang/rust/pull/35911
5049 [35969]: https://github.com/rust-lang/rust/pull/35969
5050 [35975]: https://github.com/rust-lang/rust/pull/35975
5051 [36004]: https://github.com/rust-lang/rust/pull/36004
5052 [36008]: https://github.com/rust-lang/rust/pull/36008
5053 [36014]: https://github.com/rust-lang/rust/pull/36014
5054 [36029]: https://github.com/rust-lang/rust/pull/36029
5055 [36059]: https://github.com/rust-lang/rust/pull/36059
5056 [36072]: https://github.com/rust-lang/rust/pull/36072
5057 [36101]: https://github.com/rust-lang/rust/pull/36101
5058 [36104]: https://github.com/rust-lang/rust/pull/36104
5059 [36171]: https://github.com/rust-lang/rust/pull/36171
5060 [36173]: https://github.com/rust-lang/rust/pull/36173
5061 [36178]: https://github.com/rust-lang/rust/pull/36178
5062 [36213]: https://github.com/rust-lang/rust/pull/36213
5063 [36214]: https://github.com/rust-lang/rust/pull/36214
5064 [36264]: https://github.com/rust-lang/rust/pull/36264
5065 [36266]: https://github.com/rust-lang/rust/pull/36266
5066 [36289]: https://github.com/rust-lang/rust/pull/36289
5067 [36338]: https://github.com/rust-lang/rust/pull/36338
5068 [36351]: https://github.com/rust-lang/rust/pull/36351
5069 [36355]: https://github.com/rust-lang/rust/pull/36355
5070 [36369]: https://github.com/rust-lang/rust/pull/36369
5071 [36372]: https://github.com/rust-lang/rust/pull/36372
5072 [36423]: https://github.com/rust-lang/rust/pull/36423
5073 [36482]: https://github.com/rust-lang/rust/pull/36482
5074 [36505]: https://github.com/rust-lang/rust/pull/36505
5075 [36524]: https://github.com/rust-lang/rust/pull/36524
5076 [36527]: https://github.com/rust-lang/rust/pull/36527
5077 [36551]: https://github.com/rust-lang/rust/pull/36551
5078 [36574]: https://github.com/rust-lang/rust/pull/36574
5079 [36586]: https://github.com/rust-lang/rust/pull/36586
5080 [36592]: https://github.com/rust-lang/rust/pull/36592
5081 [36631]: https://github.com/rust-lang/rust/pull/36631
5082 [36639]: https://github.com/rust-lang/rust/pull/36639
5083 [36721]: https://github.com/rust-lang/rust/pull/36721
5084 [36727]: https://github.com/rust-lang/rust/pull/36727
5085 [36730]: https://github.com/rust-lang/rust/pull/36730
5086 [36734]: https://github.com/rust-lang/rust/pull/36734
5087 [36754]: https://github.com/rust-lang/rust/pull/36754
5088 [36995]: https://github.com/rust-lang/rust/pull/36995
5089 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
5090 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
5091 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
5092 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
5093 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
5094 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
5095 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
5096 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
5097 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
5098 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
5099 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
5100 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
5101 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
5102 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
5103 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
5104 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
5105 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
5106 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
5107 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
5108 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
5109 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
5110 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
5111 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
5112 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
5113 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
5114 [rustup]: https://www.rustup.rs
5115 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
5116 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
5117 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
5118 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
5119 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
5120 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
5121 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
5122
5123
5124 Version 1.12.1 (2016-10-20)
5125 ===========================
5126
5127 Regression Fixes
5128 ----------------
5129
5130 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
5131 * [Confusion with double negation and booleans][36856]
5132 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
5133 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
5134 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
5135 * [Corrupted memory after updated to 1.12][36936]
5136 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
5137 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
5138 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
5139
5140 [36381]: https://github.com/rust-lang/rust/issues/36381
5141 [36856]: https://github.com/rust-lang/rust/issues/36856
5142 [36875]: https://github.com/rust-lang/rust/issues/36875
5143 [36924]: https://github.com/rust-lang/rust/issues/36924
5144 [36926]: https://github.com/rust-lang/rust/issues/36926
5145 [36936]: https://github.com/rust-lang/rust/issues/36936
5146 [37026]: https://github.com/rust-lang/rust/issues/37026
5147 [37112]: https://github.com/rust-lang/rust/issues/37112
5148 [37153]: https://github.com/rust-lang/rust/issues/37153
5149
5150
5151 Version 1.12.0 (2016-09-29)
5152 ===========================
5153
5154 Highlights
5155 ----------
5156
5157 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5158   This translation pass is far simpler than the previous AST->LLVM pass, and
5159   creates opportunities to perform new optimizations directly on the MIR. It
5160   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5161 * [`rustc` presents a new, more readable error format, along with
5162   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5163   Most common editors supporting Rust have been updated to work with it. It was
5164   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5165
5166 Compiler
5167 --------
5168
5169 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
5170   This translation pass is far simpler than the previous AST->LLVM pass, and
5171   creates opportunities to perform new optimizations directly on the MIR. It
5172   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
5173 * [Print the Rust target name, not the LLVM target name, with
5174   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
5175 * [The computation of `TypeId` is correct in some cases where it was previously
5176   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
5177 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
5178 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
5179   `--print relocation-models`, and `--print code-models` print the available
5180   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
5181   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
5182 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
5183   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
5184   These targets produce statically-linked binaries. There are no binary release
5185   builds yet though.
5186
5187 Diagnostics
5188 -----------
5189
5190 * [`rustc` presents a new, more readable error format, along with
5191   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
5192   Most common editors supporting Rust have been updated to work with it. It was
5193   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
5194 * [In error descriptions, references are now described in plain English,
5195   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
5196 * [In error type descriptions, unknown numeric types are named `{integer}` or
5197   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
5198 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
5199
5200 Language
5201 --------
5202
5203 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
5204 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
5205 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
5206   useful](https://github.com/rust-lang/rust/pull/34908)
5207 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
5208   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
5209 * [Semicolons are properly required as statement delimiters inside
5210   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
5211 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
5212
5213 Stabilized APIs
5214 ---------------
5215
5216 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
5217 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
5218 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
5219 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
5220 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
5221 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
5222 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
5223 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
5224 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
5225 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
5226   Both on Unix and Windows.
5227 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
5228 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
5229 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
5230 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
5231 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
5232 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
5233 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
5234 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
5235
5236 Libraries
5237 ---------
5238
5239 * [The `format!` macro and friends now allow a single argument to be formatted
5240   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
5241 * [The lifetime bounds on `[T]::binary_search_by` and
5242   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
5243 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
5244 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
5245 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
5246 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
5247 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
5248 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
5249 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
5250 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
5251   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
5252 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
5253   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
5254 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
5255 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
5256   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
5257 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
5258 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
5259 * [`mpsc::sync_channel` `Receiver`s return any available message before
5260   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
5261 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
5262 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
5263
5264 Cargo
5265 -----
5266
5267 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
5268 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
5269 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
5270 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
5271 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
5272 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
5273 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
5274 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
5275 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
5276 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
5277 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
5278 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
5279 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
5280 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
5281 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
5282 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
5283
5284 Performance
5285 -----------
5286
5287 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
5288 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
5289
5290 Tooling
5291 -------
5292
5293 * [Test binaries now support a `--test-threads` argument to specify the number
5294   of threads used to run tests, and which acts the same as the
5295   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
5296 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
5297 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
5298 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5299 * [Rust releases now come with source packages that can be installed by rustup
5300   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
5301   The resulting source code can be used by tools and IDES, located in the
5302   sysroot under `lib/rustlib/src`.
5303
5304 Misc
5305 ----
5306
5307 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
5308 * Many minor improvements to the documentation.
5309 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
5310
5311 Compatibility Notes
5312 -------------------
5313
5314 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
5315   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
5316 * [When formatting strings, if "precision" is specified, the "fill",
5317   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
5318 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
5319
5320
5321 Version 1.11.0 (2016-08-18)
5322 ===========================
5323
5324 Language
5325 --------
5326
5327 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
5328 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
5329 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
5330 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
5331
5332 Stabilized APIs
5333 ---------------
5334
5335 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
5336 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
5337 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
5338 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
5339 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
5340 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
5341   (in libcore - previously stabilized in libstd)
5342 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
5343   (in libcore - previously stabilized in libstd)
5344 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
5345   (in libcore - previously stabilized in libstd)
5346 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
5347   (in libcore - previously stabilized in libstd)
5348 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5349 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
5350 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
5351 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
5352
5353 Libraries
5354 ---------
5355
5356 * [The `thread_local!` macro supports multiple definitions in a single
5357    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
5358 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
5359 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
5360   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
5361 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
5362 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
5363 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
5364 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
5365
5366 Cargo
5367 -----
5368
5369 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
5370 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
5371 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
5372 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
5373 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
5374   and `-vv` prints warnings for all crates.
5375 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
5376 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
5377   This provides room for expansion by arbitrary tools.
5378 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
5379 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
5380 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
5381 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
5382 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
5383 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
5384 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
5385
5386 Performance
5387 -----------
5388
5389 * [Caching projections speeds up type check dramatically for some
5390   workloads](https://github.com/rust-lang/rust/pull/33816)
5391 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
5392   This hasher is faster, but is believed to provide sufficient
5393   protection from collision attacks.
5394 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
5395
5396 Rustdoc
5397 -------
5398
5399 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
5400 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
5401 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
5402 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
5403 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
5404
5405 Tooling
5406 -------
5407
5408 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
5409 * [When emitting debug info, rustc emits frame pointers for closures,
5410   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
5411 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
5412 * Many more errors have been given error codes and extended
5413   explanations
5414 * API documentation continues to be improved, with many new examples
5415
5416 Misc
5417 ----
5418
5419 * [rustc no longer hangs when dependencies recursively re-export
5420   submodules](https://github.com/rust-lang/rust/pull/34542)
5421 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
5422 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
5423   rewritten](https://github.com/rust-lang/rust/pull/33895)
5424 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
5425   No targets use this yet, but it works toward AVR support.
5426
5427 Compatibility Notes
5428 -------------------
5429
5430 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
5431 * [The new follow-set rules that place restrictions on `macro_rules!`
5432   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
5433   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
5434   and has been a warning since 1.10.
5435 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
5436   This causes breakage in some corner cases.
5437
5438
5439 Version 1.10.0 (2016-07-07)
5440 ===========================
5441
5442 Language
5443 --------
5444
5445 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
5446   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
5447 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
5448 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
5449 * [`panic!` can be converted to a runtime abort with the
5450   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
5451   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5452 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
5453   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
5454   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
5455   Note that Cargo does not yet directly support cdylibs.
5456
5457 Stabilized APIs
5458 ---------------
5459
5460 * `os::windows::fs::OpenOptionsExt::access_mode`
5461 * `os::windows::fs::OpenOptionsExt::share_mode`
5462 * `os::windows::fs::OpenOptionsExt::custom_flags`
5463 * `os::windows::fs::OpenOptionsExt::attributes`
5464 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
5465 * `os::unix::fs::OpenOptionsExt::custom_flags`
5466 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
5467 * `Default for sync::Weak`
5468 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
5469 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
5470 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
5471 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
5472 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
5473 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
5474 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
5475 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
5476 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
5477 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
5478 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
5479 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
5480 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
5481 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
5482 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
5483 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
5484 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
5485 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
5486 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
5487 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
5488 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
5489 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
5490 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
5491 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
5492 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
5493 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5494 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5495 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
5496 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
5497 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
5498 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
5499 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
5500 * Read/Write/RawFd impls for `UnixStream`
5501 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
5502 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
5503 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
5504 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
5505 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
5506 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
5507 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
5508 * RawFd impls for `UnixListener`
5509 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
5510 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
5511 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
5512 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
5513 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
5514 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
5515 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
5516 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
5517 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
5518 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
5519 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
5520 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
5521 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
5522 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
5523 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
5524 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
5525 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
5526 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
5527 * RawFd impls for `UnixDatagram`
5528 * `{BTree,Hash}Map::values_mut`
5529 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
5530
5531 Libraries
5532 ---------
5533
5534 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
5535   The semantics of this minor method are subtle and probably not what
5536   most people want.
5537 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
5538 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
5539   will fall back to `/dev/urandom` temporarily to avoid blocking
5540   during early boot](https://github.com/rust-lang/rust/pull/33086).
5541 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
5542 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
5543 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
5544 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
5545 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
5546 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
5547   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
5548
5549 Cargo
5550 -----
5551 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
5552   This controls the runtime behavior of the `panic!` macro
5553   and can be either "unwind" (the default), or "abort".
5554   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
5555 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
5556 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
5557 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
5558   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
5559 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
5560 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
5561 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
5562   By default they are retried twice, which can be customized with the
5563   `net.retry` value in `.cargo/config`.
5564 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
5565 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
5566 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
5567 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
5568   Makes it possible to install multiple crates in parallel.
5569 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
5570 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
5571 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
5572 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
5573 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
5574 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
5575
5576 Performance
5577 -----------
5578
5579 * [rustc memory usage was reduced by refactoring the context used for
5580   type checking](https://github.com/rust-lang/rust/pull/33425).
5581 * [Speed up creation of `HashMap`s by caching the random keys used
5582   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
5583 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
5584 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
5585 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
5586   10x faster than the previous lookup tables.
5587 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
5588
5589 Usability
5590 ---------
5591
5592 * Many incremental improvements to documentation and rustdoc.
5593 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
5594 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
5595 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
5596 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
5597 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
5598 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
5599 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
5600
5601 Misc
5602 ----
5603
5604 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
5605 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
5606 * [`std` no longer prints backtraces on platforms where the running
5607   module must be loaded with `env::current_exe`, which can't be relied
5608   on](https://github.com/rust-lang/rust/pull/33554).
5609 * This release includes std binaries for the i586-unknown-linux-gnu,
5610   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
5611   i586 target is for old x86 hardware without SSE2, and the armv7
5612   target is for Android running on modern ARM architectures.
5613 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
5614   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
5615 * [On Unix the runtime aborts by calling `libc::abort` instead of
5616   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
5617 * [Rust is now bootstrapped from the previous release of Rust,
5618   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
5619
5620 Compatibility Notes
5621 -------------------
5622
5623 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
5624 * [`target_env` for Linux ARM targets is just `gnu`, not
5625   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
5626 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
5627 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
5628 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
5629   Affects how macros are parsed.
5630 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
5631 * [Feature-gated attributes on macro-generated macro invocations are
5632   now rejected](https://github.com/rust-lang/rust/pull/32791).
5633 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
5634   This caused some minor changes to type inference.
5635
5636
5637 Version 1.9.0 (2016-05-26)
5638 ==========================
5639
5640 Language
5641 --------
5642
5643 * The `#[deprecated]` attribute when applied to an API will generate
5644   warnings when used. The warnings may be suppressed with
5645   `#[allow(deprecated)]`. [RFC 1270].
5646 * [`fn` item types are zero sized, and each `fn` names a unique
5647   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5648   `transmute` on a `fn` type will generate a warning for a few cycles,
5649   then will be converted to an error.
5650 * [Field and method resolution understand visibility, so private
5651   fields and methods cannot prevent the proper use of public fields
5652   and methods][1.9fv].
5653 * [The parser considers unicode codepoints in the
5654   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
5655
5656 Stabilized APIs
5657 ---------------
5658
5659 * [`std::panic`]
5660 * [`std::panic::catch_unwind`] (renamed from `recover`)
5661 * [`std::panic::resume_unwind`] (renamed from `propagate`)
5662 * [`std::panic::AssertUnwindSafe`] (renamed from `AssertRecoverSafe`)
5663 * [`std::panic::UnwindSafe`] (renamed from `RecoverSafe`)
5664 * [`str::is_char_boundary`]
5665 * [`<*const T>::as_ref`]
5666 * [`<*mut T>::as_ref`]
5667 * [`<*mut T>::as_mut`]
5668 * [`AsciiExt::make_ascii_uppercase`]
5669 * [`AsciiExt::make_ascii_lowercase`]
5670 * [`char::decode_utf16`]
5671 * [`char::DecodeUtf16`]
5672 * [`char::DecodeUtf16Error`]
5673 * [`char::DecodeUtf16Error::unpaired_surrogate`]
5674 * [`BTreeSet::take`]
5675 * [`BTreeSet::replace`]
5676 * [`BTreeSet::get`]
5677 * [`HashSet::take`]
5678 * [`HashSet::replace`]
5679 * [`HashSet::get`]
5680 * [`OsString::with_capacity`]
5681 * [`OsString::clear`]
5682 * [`OsString::capacity`]
5683 * [`OsString::reserve`]
5684 * [`OsString::reserve_exact`]
5685 * [`OsStr::is_empty`]
5686 * [`OsStr::len`]
5687 * [`std::os::unix::thread`]
5688 * [`RawPthread`]
5689 * [`JoinHandleExt`]
5690 * [`JoinHandleExt::as_pthread_t`]
5691 * [`JoinHandleExt::into_pthread_t`]
5692 * [`HashSet::hasher`]
5693 * [`HashMap::hasher`]
5694 * [`CommandExt::exec`]
5695 * [`File::try_clone`]
5696 * [`SocketAddr::set_ip`]
5697 * [`SocketAddr::set_port`]
5698 * [`SocketAddrV4::set_ip`]
5699 * [`SocketAddrV4::set_port`]
5700 * [`SocketAddrV6::set_ip`]
5701 * [`SocketAddrV6::set_port`]
5702 * [`SocketAddrV6::set_flowinfo`]
5703 * [`SocketAddrV6::set_scope_id`]
5704 * [`slice::copy_from_slice`]
5705 * [`ptr::read_volatile`]
5706 * [`ptr::write_volatile`]
5707 * [`OpenOptions::create_new`]
5708 * [`TcpStream::set_nodelay`]
5709 * [`TcpStream::nodelay`]
5710 * [`TcpStream::set_ttl`]
5711 * [`TcpStream::ttl`]
5712 * [`TcpStream::set_only_v6`]
5713 * [`TcpStream::only_v6`]
5714 * [`TcpStream::take_error`]
5715 * [`TcpStream::set_nonblocking`]
5716 * [`TcpListener::set_ttl`]
5717 * [`TcpListener::ttl`]
5718 * [`TcpListener::set_only_v6`]
5719 * [`TcpListener::only_v6`]
5720 * [`TcpListener::take_error`]
5721 * [`TcpListener::set_nonblocking`]
5722 * [`UdpSocket::set_broadcast`]
5723 * [`UdpSocket::broadcast`]
5724 * [`UdpSocket::set_multicast_loop_v4`]
5725 * [`UdpSocket::multicast_loop_v4`]
5726 * [`UdpSocket::set_multicast_ttl_v4`]
5727 * [`UdpSocket::multicast_ttl_v4`]
5728 * [`UdpSocket::set_multicast_loop_v6`]
5729 * [`UdpSocket::multicast_loop_v6`]
5730 * [`UdpSocket::set_multicast_ttl_v6`]
5731 * [`UdpSocket::multicast_ttl_v6`]
5732 * [`UdpSocket::set_ttl`]
5733 * [`UdpSocket::ttl`]
5734 * [`UdpSocket::set_only_v6`]
5735 * [`UdpSocket::only_v6`]
5736 * [`UdpSocket::join_multicast_v4`]
5737 * [`UdpSocket::join_multicast_v6`]
5738 * [`UdpSocket::leave_multicast_v4`]
5739 * [`UdpSocket::leave_multicast_v6`]
5740 * [`UdpSocket::take_error`]
5741 * [`UdpSocket::connect`]
5742 * [`UdpSocket::send`]
5743 * [`UdpSocket::recv`]
5744 * [`UdpSocket::set_nonblocking`]
5745
5746 Libraries
5747 ---------
5748
5749 * [`std::sync::Once` is poisoned if its initialization function
5750   fails][1.9o].
5751 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5752 * [Most types implement `fmt::Debug`][1.9db].
5753 * [The default buffer size used by `BufReader` and `BufWriter` was
5754   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5755   used by other languages.
5756 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5757   `Duration` additionally implements `*=` and `/=`][1.9ta].
5758 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5759 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5760 * [`Chain` implements `BufRead`][1.9ch].
5761 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5762
5763 Cargo
5764 -----
5765
5766 * [Cargo can now run concurrently][1.9cc].
5767 * [Top-level overrides allow specific revisions of crates to be
5768   overridden through the entire crate graph][1.9ct].  This is intended
5769   to make upgrades easier for large projects, by allowing crates to be
5770   forked temporarily until they've been upgraded and republished.
5771 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5772 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5773   on the commandline][1.9cf]. `rustc` arguments can also be specified
5774   in the `build.rustflags` configuration key.
5775
5776 Performance
5777 -----------
5778
5779 * [The time complexity of comparing variables for equivalence during type
5780   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5781   to major compilation time improvement in some scenarios.
5782 * [`ToString` is specialized for `str`, giving it the same performance
5783   as `to_owned`][1.9ts].
5784 * [Spawning processes with `Command::output` no longer creates extra
5785   threads][1.9sp].
5786 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5787   for C-like enums][1.9cl].
5788
5789 Misc
5790 ----
5791
5792 * [Passing the `--quiet` flag to a test runner will produce
5793   much-abbreviated output][1.9q].
5794 * The Rust Project now publishes std binaries for the
5795   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5796   `i586-pc-windows-msvc` targets.
5797
5798 Compatibility Notes
5799 -------------------
5800
5801 * [`std::sync::Once` is poisoned if its initialization function
5802   fails][1.9o].
5803 * [It is illegal to define methods with the same name in overlapping
5804   inherent `impl` blocks][1.9sn].
5805 * [`fn` item types are zero sized, and each `fn` names a unique
5806   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5807   `transmute` on a `fn` type will generate a warning for a few cycles,
5808   then will be converted to an error.
5809 * [Improvements to const evaluation may trigger new errors when integer
5810   literals are out of range][1.9ce].
5811
5812
5813 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5814 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5815 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5816 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5817 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5818 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5819 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5820 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5821 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5822 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5823 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5824 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5825 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5826 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5827 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5828 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5829 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5830 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5831 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5832 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5833 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5834 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5835 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5836 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5837 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5838 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5839 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5840 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5841 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5842 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5843 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5844 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5845 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5846 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5847 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5848 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5849 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5850 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5851 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5852 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5853 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5854 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5855 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5856 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5857 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5858 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5859 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5860 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5861 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5862 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5863 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5864 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5865 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5866 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5867 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5868 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5869 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5870 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5871 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5872 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5873 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5874 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5875 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5876 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5877 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5878 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5879 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5880 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5881 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5882 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5883 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5884 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5885 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5886 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5887 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5888 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5889 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5890 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5891 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5892 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5893 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5894 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5895 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5896 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5897 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5898 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5899 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5900 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5901 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5902 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5903 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5904 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5905 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5906 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5907 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5908 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5909 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5910 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5911 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5912 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5913 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5914 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5915 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5916 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5917 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5918 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5919 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5920 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5921 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5922 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5923
5924
5925 Version 1.8.0 (2016-04-14)
5926 ==========================
5927
5928 Language
5929 --------
5930
5931 * Rust supports overloading of compound assignment statements like
5932   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5933   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5934   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5935   traits. [RFC 953].
5936 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5937   addition to the non-braced form, `struct Foo;`. [RFC 218].
5938
5939 Libraries
5940 ---------
5941
5942 * Stabilized APIs:
5943   * [`str::encode_utf16`] (renamed from `utf16_units`)
5944   * [`str::EncodeUtf16`] (renamed from `Utf16Units`)
5945   * [`Ref::map`]
5946   * [`RefMut::map`]
5947   * [`ptr::drop_in_place`]
5948   * [`time::Instant`]
5949   * [`time::SystemTime`]
5950   * [`Instant::now`]
5951   * [`Instant::duration_since`] (renamed from `duration_from_earlier`)
5952   * [`Instant::elapsed`]
5953   * [`SystemTime::now`]
5954   * [`SystemTime::duration_since`] (renamed from `duration_from_earlier`)
5955   * [`SystemTime::elapsed`]
5956   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5957   * [`SystemTimeError`]
5958   * [`SystemTimeError::duration`]
5959   * Various impls for `SystemTimeError`
5960   * [`UNIX_EPOCH`]
5961   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5962     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5963     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5964 * [The `write!` and `writeln!` macros correctly emit errors if any of
5965   their arguments can't be formatted][1.8w].
5966 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5967 * [The Unix-specific `raw` modules, which contain a number of
5968   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5969   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5970   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5971   across platforms was making it difficult to implement `std`
5972   correctly. Those that need these definitions should use the `libc`
5973   crate. [RFC 1415].
5974 * The Unix-specific `MetadataExt` traits, including
5975   `os::unix::fs::MetadataExt`, which expose values such as inode
5976   numbers [no longer return platform-specific types][1.8r], but
5977   instead return widened integers. [RFC 1415].
5978 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5979 * [Atomic loads and stores are not volatile][1.8a].
5980 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5981
5982 Performance
5983 -----------
5984
5985 * [Inlining hash functions lead to a 3% compile-time improvement in
5986   some workloads][1.8h].
5987 * When using jemalloc, its symbols are [unprefixed so that it
5988   overrides the libc malloc implementation][1.8h]. This means that for
5989   rustc, LLVM is now using jemalloc, which results in a 6%
5990   compile-time improvement on a specific workload.
5991 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5992
5993 Misc
5994 ----
5995
5996 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5997   i686-pc-windows-msvc is now considered a tier-1 platform.
5998 * [The `--print targets` flag prints a list of supported targets][1.8t].
5999 * [The `--print cfg` flag prints the `cfg`s defined for the current
6000   target][1.8cf].
6001 * [`rustc` can be built with an new Cargo-based build system, written
6002   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
6003   build system. To enable it configure with `configure --rustbuild`.
6004 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
6005   variants while also indicating the total number of missing variants
6006   if more than 3][1.8m].
6007 * [Executable stacks are disabled on Linux and BSD][1.8nx].
6008 * The Rust Project now publishes binary releases of the standard
6009   library for a number of tier-2 targets:
6010   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
6011   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
6012   `x86_64-rumprun-netbsd`. These can be installed with
6013   tools such as [multirust][1.8mr].
6014
6015 Cargo
6016 -----
6017
6018 * [`cargo init` creates a new Cargo project in the current
6019   directory][1.8ci].  It is otherwise like `cargo new`.
6020 * [Cargo has configuration keys for `-v` and
6021   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
6022   `[term]` section of `.cargo/config`.
6023 * [Configuration keys that evaluate to strings or integers can be set
6024   via environment variables][1.8ce]. For example the `build.jobs` key
6025   can be set via `CARGO_BUILD_JOBS`. Environment variables take
6026   precedence over config files.
6027 * [Target-specific dependencies support Rust `cfg` syntax for
6028   describing targets][1.8cfg] so that dependencies for multiple
6029   targets can be specified together. [RFC 1361].
6030 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
6031   `RUSTDOC` take precedence over the `build.target-dir`,
6032   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
6033 * [The child process tree is killed on Windows when Cargo is
6034   killed][1.8ck].
6035 * [The `build.target` configuration value sets the target platform,
6036   like `--target`][1.8ct].
6037
6038 Compatibility Notes
6039 -------------------
6040
6041 * [Unstable compiler flags have been further restricted][1.8u]. Since
6042   1.0 `-Z` flags have been considered unstable, and other flags that
6043   were considered unstable additionally required passing `-Z
6044   unstable-options` to access. Unlike unstable language and library
6045   features though, these options have been accessible on the stable
6046   release channel. Going forward, *new unstable flags will not be
6047   available on the stable release channel*, and old unstable flags
6048   will warn about their usage. In the future, all unstable flags will
6049   be unavailable on the stable release channel.
6050 * [It is no longer possible to `match` on empty enum variants using
6051   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
6052 * The Unix-specific `MetadataExt` traits, including
6053   `os::unix::fs::MetadataExt`, which expose values such as inode
6054   numbers [no longer return platform-specific types][1.8r], but
6055   instead return widened integers. [RFC 1415].
6056 * [Modules sourced from the filesystem cannot appear within arbitrary
6057   blocks, but only within other modules][1.8mf].
6058 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
6059 * On Unix, [stack overflow triggers a runtime abort instead of a
6060   SIGSEGV][1.8so].
6061 * [`Command::spawn` and its equivalents return an error if any of
6062   its command-line arguments contain interior `NUL`s][1.8n].
6063 * [Tuple and unit enum variants from other crates are in the type
6064   namespace][1.8tn].
6065 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
6066   type instead of `.a` files][1.8st]. Additionally, for the MSVC
6067   toolchain, `rustc` emits import libraries named `foo.dll.lib`
6068   instead of `foo.lib`.
6069
6070
6071 [1.8a]: https://github.com/rust-lang/rust/pull/30962
6072 [1.8b]: https://github.com/rust-lang/rust/pull/31123
6073 [1.8c]: https://github.com/rust-lang/rust/pull/31530
6074 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
6075 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
6076 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
6077 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
6078 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
6079 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
6080 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
6081 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
6082 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
6083 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
6084 [1.8h]: https://github.com/rust-lang/rust/pull/31460
6085 [1.8l]: https://github.com/rust-lang/rust/pull/31668
6086 [1.8m]: https://github.com/rust-lang/rust/pull/31020
6087 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
6088 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
6089 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
6090 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
6091 [1.8n]: https://github.com/rust-lang/rust/pull/31056
6092 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
6093 [1.8r]: https://github.com/rust-lang/rust/pull/31551
6094 [1.8so]: https://github.com/rust-lang/rust/pull/31333
6095 [1.8st]: https://github.com/rust-lang/rust/pull/29520
6096 [1.8t]: https://github.com/rust-lang/rust/pull/31358
6097 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
6098 [1.8u]: https://github.com/rust-lang/rust/pull/31793
6099 [1.8v]: https://github.com/rust-lang/rust/pull/31757
6100 [1.8w]: https://github.com/rust-lang/rust/pull/31904
6101 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
6102 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
6103 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
6104 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
6105 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
6106 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
6107 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
6108 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
6109 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
6110 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
6111 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
6112 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
6113 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
6114 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
6115 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
6116 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
6117 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
6118 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
6119 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
6120 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
6121 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
6122 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
6123 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
6124 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
6125 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
6126 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
6127 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
6128 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
6129 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
6130 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
6131
6132
6133 Version 1.7.0 (2016-03-03)
6134 ==========================
6135
6136 Libraries
6137 ---------
6138
6139 * Stabilized APIs
6140   * `Path`
6141     * [`Path::strip_prefix`] (renamed from relative_from)
6142     * [`path::StripPrefixError`] (new error type returned from strip_prefix)
6143   * `Ipv4Addr`
6144     * [`Ipv4Addr::is_loopback`]
6145     * [`Ipv4Addr::is_private`]
6146     * [`Ipv4Addr::is_link_local`]
6147     * [`Ipv4Addr::is_multicast`]
6148     * [`Ipv4Addr::is_broadcast`]
6149     * [`Ipv4Addr::is_documentation`]
6150   * `Ipv6Addr`
6151     * [`Ipv6Addr::is_unspecified`]
6152     * [`Ipv6Addr::is_loopback`]
6153     * [`Ipv6Addr::is_multicast`]
6154   * `Vec`
6155     * [`Vec::as_slice`]
6156     * [`Vec::as_mut_slice`]
6157   * `String`
6158     * [`String::as_str`]
6159     * [`String::as_mut_str`]
6160   * Slices
6161     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
6162     be the same length
6163     * `<[T]>::`[`sort_by_key`]
6164   * checked, saturated, and overflowing operations
6165     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
6166     * [`i32::saturating_mul`]
6167     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
6168     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
6169     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
6170     * [`u32::saturating_mul`]
6171     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
6172     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
6173     * and checked, saturated, and overflowing operations for other primitive types
6174   * FFI
6175     * [`ffi::IntoStringError`]
6176     * [`CString::into_string`]
6177     * [`CString::into_bytes`]
6178     * [`CString::into_bytes_with_nul`]
6179     * `From<CString> for Vec<u8>`
6180   * `IntoStringError`
6181     * [`IntoStringError::into_cstring`]
6182     * [`IntoStringError::utf8_error`]
6183     * `Error for IntoStringError`
6184   * Hashing
6185     * [`std::hash::BuildHasher`]
6186     * [`BuildHasher::Hasher`]
6187     * [`BuildHasher::build_hasher`]
6188     * [`std::hash::BuildHasherDefault`]
6189     * [`HashMap::with_hasher`]
6190     * [`HashMap::with_capacity_and_hasher`]
6191     * [`HashSet::with_hasher`]
6192     * [`HashSet::with_capacity_and_hasher`]
6193     * [`std::collections::hash_map::RandomState`]
6194     * [`RandomState::new`]
6195 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
6196   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
6197   from bytes is faster.
6198 * [The performance of `LineWriter` (and thus `io::stdout`) was
6199   improved by using `memchr` to search for newlines][1.7m].
6200 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
6201   `f64` variants were stabilized previously.
6202 * [`BTreeMap` was rewritten to use less memory and improve the performance
6203   of insertion and iteration, the latter by as much as 5x][1.7bm].
6204 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
6205   covariant over their contained type][1.7bt].
6206 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
6207   over their contained type][1.7ll].
6208 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
6209   searching methods.
6210 * [`Any` is implemented for unsized types][1.7a].
6211 * [`Hash` is implemented for `Duration`][1.7h].
6212
6213 Misc
6214 ----
6215
6216 * [When running tests with `--test`, rustdoc will pass `--cfg`
6217   arguments to the compiler][1.7dt].
6218 * [The compiler is built with RPATH information by default][1.7rpa].
6219   This means that it will be possible to run `rustc` when installed in
6220   unusual configurations without configuring the dynamic linker search
6221   path explicitly.
6222 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
6223   any RPATH entries (emitted with `-C rpath`) *not* take precedence
6224   over `LD_LIBRARY_PATH`.
6225
6226 Cargo
6227 -----
6228
6229 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
6230   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
6231 * [The `rerun-if-changed` build script directive no longer causes the
6232   build script to incorrectly run twice in certain scenarios][1.7rr].
6233
6234 Compatibility Notes
6235 -------------------
6236
6237 * Soundness fixes to the interactions between associated types and
6238   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
6239   code that violates the new rules. This is a significant change that
6240   is known to break existing code, so it has emitted warnings for the
6241   new error cases since 1.4 to give crate authors time to adapt. The
6242   details of what is changing are subtle; read the RFC for more.
6243 * [Several bugs in the compiler's visibility calculations were
6244   fixed][1.7v]. Since this was found to break significant amounts of
6245   code, the new errors will be emitted as warnings for several release
6246   cycles, under the `private_in_public` lint.
6247 * Defaulted type parameters were accidentally accepted in positions
6248   that were not intended. In this release, [defaulted type parameters
6249   appearing outside of type definitions will generate a
6250   warning][1.7d], which will become an error in future releases.
6251 * [Parsing "." as a float results in an error instead of 0][1.7p].
6252   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
6253 * [Borrows of closure parameters may not outlive the closure][1.7bc].
6254
6255 [1.7a]: https://github.com/rust-lang/rust/pull/30928
6256 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
6257 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
6258 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
6259 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
6260 [1.7d]: https://github.com/rust-lang/rust/pull/30724
6261 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
6262 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
6263 [1.7f]: https://github.com/rust-lang/rust/pull/30672
6264 [1.7h]: https://github.com/rust-lang/rust/pull/30818
6265 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
6266 [1.7m]: https://github.com/rust-lang/rust/pull/30381
6267 [1.7p]: https://github.com/rust-lang/rust/pull/30681
6268 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
6269 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
6270 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
6271 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
6272 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
6273 [1.7v]: https://github.com/rust-lang/rust/pull/29973
6274 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6275 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6276 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
6277 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
6278 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
6279 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
6280 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
6281 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
6282 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
6283 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
6284 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
6285 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
6286 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
6287 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
6288 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
6289 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
6290 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
6291 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
6292 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
6293 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
6294 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
6295 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
6296 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
6297 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
6298 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
6299 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
6300 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
6301 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
6302 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
6303 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
6304 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
6305 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
6306 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
6307 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
6308 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
6309 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
6310 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
6311 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
6312 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
6313 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
6314 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
6315 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
6316 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
6317 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
6318 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
6319 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
6320 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
6321 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6322 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
6323 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
6324 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
6325 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
6326 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
6327 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
6328 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
6329 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
6330 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
6331 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
6332 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
6333 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
6334
6335
6336 Version 1.6.0 (2016-01-21)
6337 ==========================
6338
6339 Language
6340 --------
6341
6342 * The `#![no_std]` attribute causes a crate to not be linked to the
6343   standard library, but only the [core library][1.6co], as described
6344   in [RFC 1184]. The core library defines common types and traits but
6345   has no platform dependencies whatsoever, and is the basis for Rust
6346   software in environments that cannot support a full port of the
6347   standard library, such as operating systems. Most of the core
6348   library is now stable.
6349
6350 Libraries
6351 ---------
6352
6353 * Stabilized APIs:
6354   [`Read::read_exact`],
6355   [`ErrorKind::UnexpectedEof`] (renamed from `UnexpectedEOF`),
6356   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
6357   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
6358   [`os::unix::fs::DirBuilderExt`],
6359   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
6360   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
6361   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
6362   [`collections::hash_map::Drain`],
6363   [`collections::hash_map::HashMap::drain`],
6364   [`collections::hash_set::Drain`],
6365   [`collections::hash_set::HashSet::drain`],
6366   [`collections::binary_heap::Drain`],
6367   [`collections::binary_heap::BinaryHeap::drain`],
6368   [`Vec::extend_from_slice`] (renamed from `push_all`),
6369   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
6370   [`RwLock::into_inner`],
6371   [`Iterator::min_by_key`] (renamed from `min_by`),
6372   [`Iterator::max_by_key`] (renamed from `max_by`).
6373 * The [core library][1.6co] is stable, as are most of its APIs.
6374 * [The `assert_eq!` macro supports arguments that don't implement
6375   `Sized`][1.6ae], such as arrays. In this way it behaves more like
6376   `assert!`.
6377 * Several timer functions that take duration in milliseconds [are
6378   deprecated in favor of those that take `Duration`][1.6ms]. These
6379   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
6380   `thread::park_timeout_ms`.
6381 * The algorithm by which `Vec` reserves additional elements was
6382   [tweaked to not allocate excessive space][1.6a] while still growing
6383   exponentially.
6384 * `From` conversions are [implemented from integers to floats][1.6f]
6385   in cases where the conversion is lossless. Thus they are not
6386   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
6387   or `f64`. They are also not implemented for `isize` and `usize`
6388   because the implementations would be platform-specific. `From` is
6389   also implemented from `f32` to `f64`.
6390 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
6391 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
6392 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
6393 * [`BinaryHeap` was refactored][1.6bh] for modest performance
6394   improvements.
6395 * Sorting slices that are already sorted [is 50% faster in some
6396   cases][1.6s].
6397
6398 Cargo
6399 -----
6400
6401 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
6402 * Cargo build scripts can specify their dependencies by emitting the
6403   [`rerun-if-changed`][1.6rr] key.
6404 * crates.io will reject publication of crates with dependencies that
6405   have a wildcard version constraint. Crates with wildcard
6406   dependencies were seen to cause a variety of problems, as described
6407   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
6408   warning.
6409 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
6410   release folder.  A variety of artifacts that Cargo failed to clean
6411   are now correctly deleted.
6412
6413 Misc
6414 ----
6415
6416 * The `unreachable_code` lint [warns when a function call's argument
6417   diverges][1.6dv].
6418 * The parser indicates [failures that may be caused by
6419   confusingly-similar Unicode characters][1.6uc]
6420 * Certain macro errors [are reported at definition time][1.6m], not
6421   expansion.
6422
6423 Compatibility Notes
6424 -------------------
6425
6426 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
6427   environment variable when locating crates. This was a pre-cargo
6428   feature for integrating with the package manager that was
6429   accidentally never removed.
6430 * [A number of bugs were fixed in the privacy checker][1.6p] that
6431   could cause previously-accepted code to break.
6432 * [Modules and unit/tuple structs may not share the same name][1.6ts].
6433 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
6434   struct pattern syntax (`Foo(..)`) can no longer be used to match
6435   unit structs. This is a warning now, but will become an error in
6436   future releases. Patterns that share the same name as a const are
6437   now an error.
6438 * A bug was fixed that causes [rustc not to apply default type
6439   parameters][1.6xc] when resolving certain method implementations of
6440   traits defined in other crates.
6441
6442 [1.6a]: https://github.com/rust-lang/rust/pull/29454
6443 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
6444 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
6445 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
6446 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
6447 [1.6co]: http://doc.rust-lang.org/core/index.html
6448 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
6449 [1.6f]: https://github.com/rust-lang/rust/pull/29129
6450 [1.6m]: https://github.com/rust-lang/rust/pull/29828
6451 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
6452 [1.6p]: https://github.com/rust-lang/rust/pull/29726
6453 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
6454 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
6455 [1.6s]: https://github.com/rust-lang/rust/pull/29675
6456 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
6457 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
6458 [1.6us]: https://github.com/rust-lang/rust/pull/29383
6459 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
6460 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
6461 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6462 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
6463 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
6464 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
6465 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
6466 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
6467 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
6468 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
6469 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
6470 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
6471 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
6472 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
6473 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
6474 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
6475 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
6476 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
6477 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
6478 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
6479 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
6480 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
6481 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
6482 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
6483 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
6484 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
6485 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
6486 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
6487 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
6488 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
6489
6490
6491 Version 1.5.0 (2015-12-10)
6492 ==========================
6493
6494 * ~700 changes, numerous bugfixes
6495
6496 Highlights
6497 ----------
6498
6499 * Stabilized APIs:
6500   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
6501   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
6502   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
6503   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
6504   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
6505   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
6506   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
6507   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
6508   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
6509   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
6510   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
6511   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
6512   [`Path::read_link`], [`Path::symlink_metadata`],
6513   [`Utf8Error::valid_up_to`], [`Vec::resize`],
6514   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
6515   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
6516   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
6517   [`slice::split_first_mut`], [`slice::split_first`],
6518   [`slice::split_last_mut`], [`slice::split_last`],
6519   [`char::from_u32_unchecked`], [`fs::canonicalize`],
6520   [`str::MatchIndices`], [`str::RMatchIndices`],
6521   [`str::match_indices`], [`str::rmatch_indices`],
6522   [`str::slice_mut_unchecked`], [`string::ParseError`].
6523 * Rust applications hosted on crates.io can be installed locally to
6524   `~/.cargo/bin` with the [`cargo install`] command. Among other
6525   things this makes it easier to augment Cargo with new subcommands:
6526   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
6527   invoked as `cargo foo`.
6528 * Crates with wildcard (`*`) dependencies will [emit warnings when
6529   published][1.5w]. In 1.6 it will no longer be possible to publish
6530   crates with wildcard dependencies.
6531
6532 Breaking Changes
6533 ----------------
6534
6535 * The rules determining when a particular lifetime must outlive
6536   a particular value (known as '[dropck]') have been [modified
6537   to not rely on parametricity][1.5p].
6538 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
6539   and `Arc`][1.5a]. Because these smart pointer types implement
6540   `Deref`, this causes breakage in cases where the interior type
6541   contains methods of the same name.
6542 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
6543   that they could drop their content. Soundness fix.
6544 * All method invocations are [properly checked][1.5wf1] for
6545   [well-formedness][1.5wf2]. Soundness fix.
6546 * Traits whose supertraits contain `Self` are [not object
6547   safe][1.5o]. Soundness fix.
6548 * Target specifications support a [`no_default_libraries`][1.5nd]
6549   setting that controls whether `-nodefaultlibs` is passed to the
6550   linker, and in turn the `is_like_windows` setting no longer affects
6551   the `-nodefaultlibs` flag.
6552 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
6553 * The `#[inline]` and `#[repr]` attributes [can only appear
6554   in valid locations][1.5at].
6555 * Native libraries linked from the local crate are [passed to
6556   the linker before native libraries from upstream crates][1.5nl].
6557 * Two rarely-used attributes, `#[no_debug]` and
6558   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
6559 * Negation of unsigned integers, which has been a warning for
6560   several releases, [is now behind a feature gate and will
6561   generate errors][1.5nu].
6562 * The parser accidentally accepted visibility modifiers on
6563   enum variants, a bug [which has been fixed][1.5ev].
6564 * [A bug was fixed that allowed `use` statements to import unstable
6565   features][1.5use].
6566
6567 Language
6568 --------
6569
6570 * When evaluating expressions at compile-time that are not
6571   compile-time constants (const-evaluating expressions in non-const
6572   contexts), incorrect code such as overlong bitshifts and arithmetic
6573   overflow will [generate a warning instead of an error][1.5ce],
6574   delaying the error until runtime. This will allow the
6575   const-evaluator to be expanded in the future backwards-compatibly.
6576 * The `improper_ctypes` lint [no longer warns about using `isize` and
6577   `usize` in FFI][1.5ict].
6578
6579 Libraries
6580 ---------
6581
6582 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
6583   invariant][1.5c].
6584 * `Default` is [implemented for mutable slices][1.5d].
6585 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
6586 * There are now `From` conversions [between floating point
6587   types][1.5f] where the conversions are lossless.
6588 * There are now `From` conversions [between integer types][1.5i] where
6589   the conversions are lossless.
6590 * [`fs::Metadata` implements `Clone`][1.5fs].
6591 * The `parse` method [accepts a leading "+" when parsing
6592   integers][1.5pi].
6593 * [`AsMut` is implemented for `Vec`][1.5am].
6594 * The `clone_from` implementations for `String` and `BinaryHeap` [have
6595   been optimized][1.5cf] and no longer rely on the default impl.
6596 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
6597   `unsafe extern "C"` function types now [implement `Clone`,
6598   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
6599   `fmt::Debug` for up to 12 arguments][1.5fp].
6600 * [Dropping `Vec`s is much faster in unoptimized builds when the
6601   element types don't implement `Drop`][1.5dv].
6602 * A bug that caused in incorrect behavior when [combining `VecDeque`
6603   with zero-sized types][1.5vdz] was resolved.
6604 * [`PartialOrd` for slices is faster][1.5po].
6605
6606 Miscellaneous
6607 -------------
6608
6609 * [Crate metadata size was reduced by 20%][1.5md].
6610 * [Improvements to code generation reduced the size of libcore by 3.3
6611   MB and rustc's memory usage by 18MB][1.5m].
6612 * [Improvements to deref translation increased performance in
6613   unoptimized builds][1.5dr].
6614 * Various errors in trait resolution [are deduplicated to only be
6615   reported once][1.5te].
6616 * Rust has preliminary [support for rumprun kernels][1.5rr].
6617 * Rust has preliminary [support for NetBSD on amd64][1.5na].
6618
6619 [1.5use]: https://github.com/rust-lang/rust/pull/28364
6620 [1.5po]: https://github.com/rust-lang/rust/pull/28436
6621 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
6622 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
6623 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
6624 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
6625 [1.5md]: https://github.com/rust-lang/rust/pull/28521
6626 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
6627 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
6628 [1.5na]: https://github.com/rust-lang/rust/pull/28543
6629 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
6630 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
6631 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
6632 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
6633 [1.5te]: https://github.com/rust-lang/rust/pull/28645
6634 [1.5at]: https://github.com/rust-lang/rust/pull/28650
6635 [1.5am]: https://github.com/rust-lang/rust/pull/28663
6636 [1.5m]: https://github.com/rust-lang/rust/pull/28778
6637 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
6638 [1.5a]: https://github.com/rust-lang/rust/pull/28811
6639 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
6640 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
6641 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
6642 [1.5i]: https://github.com/rust-lang/rust/pull/28921
6643 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
6644 [1.5f]: https://github.com/rust-lang/rust/pull/29129
6645 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
6646 [1.5s]: https://github.com/rust-lang/rust/pull/29190
6647 [1.5d]: https://github.com/rust-lang/rust/pull/29245
6648 [1.5o]: https://github.com/rust-lang/rust/pull/29259
6649 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
6650 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6651 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
6652 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
6653 [1.5c]: https://github.com/rust-lang/rust/pull/29110
6654 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
6655 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
6656 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
6657 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
6658 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
6659 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
6660 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
6661 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
6662 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
6663 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
6664 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
6665 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
6666 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
6667 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
6668 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
6669 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
6670 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
6671 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
6672 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
6673 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
6674 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
6675 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
6676 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
6677 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
6678 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
6679 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
6680 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
6681 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
6682 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
6683 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
6684 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
6685 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
6686 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
6687 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
6688 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
6689 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
6690 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
6691 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
6692 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
6693 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
6694 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
6695 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
6696 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
6697 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
6698 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
6699 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
6700 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
6701 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
6702 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
6703 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
6704 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
6705 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6706 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6707 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6708
6709 Version 1.4.0 (2015-10-29)
6710 ==========================
6711
6712 * ~1200 changes, numerous bugfixes
6713
6714 Highlights
6715 ----------
6716
6717 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6718   GNU) are now supported and recommended for use.
6719
6720 Breaking Changes
6721 ----------------
6722
6723 * [Several changes have been made to fix type soundness and improve
6724   the behavior of associated types][sound]. See [RFC 1214]. Although
6725   we have mostly introduced these changes as warnings this release, to
6726   become errors next release, there are still some scenarios that will
6727   see immediate breakage.
6728 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6729   line breaks in addition to `\n`][crlf].
6730 * [Loans of `'static` lifetime extend to the end of a function][stat].
6731 * [`str::parse` no longer introduces avoidable rounding error when
6732   parsing floating point numbers. Together with earlier changes to
6733   float formatting/output, "round trips" like f.to_string().parse()
6734   now preserve the value of f exactly. Additionally, leading plus
6735   signs are now accepted][fp3].
6736
6737
6738 Language
6739 --------
6740
6741 * `use` statements that import multiple items [can now rename
6742   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6743 * [Binops work correctly on fat pointers][binfat].
6744 * `pub extern crate`, which does not behave as expected, [issues a
6745   warning][pec] until a better solution is found.
6746
6747 Libraries
6748 ---------
6749
6750 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6751   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6752   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6753   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6754   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6755   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6756   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6757   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6758   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6759   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6760   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6761   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6762   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6763   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6764   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6765   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6766   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6767   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6768   [`thread::sleep`].
6769 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6770   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6771   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6772   `f64::from_str_radix`.
6773 * [Reverse-searching strings is faster with the 'two-way'
6774   algorithm][s].
6775 * [`std::io::copy` allows `?Sized` arguments][cc].
6776 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6777   [override `count`, `nth` and `last` with an O(1)
6778   implementation][it].
6779 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6780 * [`IntoRawFd` has been added to the Unix-specific prelude,
6781   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6782   prelude][pr].
6783 * [`Extend<String>` and `FromIterator<String` are both implemented for
6784   `String`][es].
6785 * [`IntoIterator` is implemented for references to `Option` and
6786   `Result`][into2].
6787 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6788   Copy`][ext] as part of [RFC 839]. This will cause type inference
6789   breakage in rare situations.
6790 * [`BinaryHeap` implements `Debug`][bh2].
6791 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6792   arrays][bm].
6793 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6794   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6795 * [String comparison is faster][faststr].
6796 * `&mut T` where `T: std::fmt::Write` [also implements
6797   `std::fmt::Write`][mutw].
6798 * [A stable regression in `VecDeque::push_back` and other
6799   capacity-altering methods that caused panics for zero-sized types
6800   was fixed][vd].
6801 * [Function pointers implement traits for up to 12 parameters][fp2].
6802
6803 Miscellaneous
6804 -------------
6805
6806 * The compiler [no longer uses the 'morestack' feature to prevent
6807   stack overflow][mm]. Instead it uses guard pages and stack
6808   probes (though stack probes are not yet implemented on any platform
6809   but Windows).
6810 * [The compiler matches traits faster when projections are involved][p].
6811 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6812   `usize`][ffi].
6813 * [Cargo now displays useful information about what its doing during
6814   `cargo update`][cu].
6815
6816 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6817 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6818 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6819 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6820 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6821 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6822 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6823 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6824 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6825 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6826 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6827 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6828 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6829 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6830 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6831 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6832 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6833 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6834 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6835 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6836 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6837 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6838 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6839 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6840 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6841 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6842 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6843 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6844 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6845 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6846 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6847 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6848 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6849 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6850 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6851 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6852 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6853 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6854 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6855 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6856 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6857 [bh2]: https://github.com/rust-lang/rust/pull/28156
6858 [binfat]: https://github.com/rust-lang/rust/pull/28270
6859 [bm]: https://github.com/rust-lang/rust/pull/28197
6860 [cc]: https://github.com/rust-lang/rust/pull/27531
6861 [crlf]: https://github.com/rust-lang/rust/pull/28034
6862 [cu]: https://github.com/rust-lang/cargo/pull/1931
6863 [d]: https://github.com/rust-lang/rust/pull/27825
6864 [dep]: https://github.com/rust-lang/rust/pull/28339
6865 [es]: https://github.com/rust-lang/rust/pull/27956
6866 [ext]: https://github.com/rust-lang/rust/pull/28094
6867 [faststr]: https://github.com/rust-lang/rust/pull/28338
6868 [ffi]: https://github.com/rust-lang/rust/pull/28779
6869 [fp]: https://github.com/rust-lang/rust/pull/28268
6870 [fp2]: https://github.com/rust-lang/rust/pull/28560
6871 [fp3]: https://github.com/rust-lang/rust/pull/27307
6872 [i]: https://github.com/rust-lang/rust/pull/27451
6873 [into2]: https://github.com/rust-lang/rust/pull/28039
6874 [it]: https://github.com/rust-lang/rust/pull/27652
6875 [mm]: https://github.com/rust-lang/rust/pull/27338
6876 [mutw]: https://github.com/rust-lang/rust/pull/28368
6877 [sound]: https://github.com/rust-lang/rust/pull/27641
6878 [p]: https://github.com/rust-lang/rust/pull/27866
6879 [pec]: https://github.com/rust-lang/rust/pull/28486
6880 [pr]: https://github.com/rust-lang/rust/pull/27896
6881 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6882 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6883 [s]: https://github.com/rust-lang/rust/pull/27474
6884 [stab]: https://github.com/rust-lang/rust/pull/28339
6885 [stat]: https://github.com/rust-lang/rust/pull/28321
6886 [vd]: https://github.com/rust-lang/rust/pull/28494
6887
6888 Version 1.3.0 (2015-09-17)
6889 ==============================
6890
6891 * ~900 changes, numerous bugfixes
6892
6893 Highlights
6894 ----------
6895
6896 * The [new object lifetime defaults][nold] have been [turned
6897   on][nold2] after a cycle of warnings about the change. Now types
6898   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6899   being interpreted as `&'a Box<Trait+'a>` to `&'a
6900   Box<Trait+'static>`.
6901 * [The Rustonomicon][nom] is a new book in the official documentation
6902   that dives into writing unsafe Rust.
6903 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6904   timekeeping is employed by other std APIs, as well as out-of-tree
6905   time crates.
6906
6907 Breaking Changes
6908 ----------------
6909
6910 * The [new object lifetime defaults][nold] have been [turned
6911   on][nold2] after a cycle of warnings about the change.
6912 * There is a known [regression][lr] in how object lifetime elision is
6913   interpreted, the proper solution for which is undetermined.
6914 * The `#[prelude_import]` attribute, an internal implementation
6915   detail, was accidentally stabilized previously. [It has been put
6916   behind the `prelude_import` feature gate][pi]. This change is
6917   believed to break no existing code.
6918 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6919   [more sane for dynamically sized types][dst3]. Code that relied on
6920   the previous behavior is thought to be broken.
6921 * The `dropck` rules, which checks that destructors can't access
6922   destroyed values, [have been updated][dropck] to match the
6923   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6924   cause some previously-compiling code to no longer build.
6925
6926 Language
6927 --------
6928
6929 * The [new object lifetime defaults][nold] have been [turned
6930   on][nold2] after a cycle of warnings about the change.
6931 * Semicolons may [now follow types and paths in
6932   macros](https://github.com/rust-lang/rust/pull/27000).
6933 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6934   [more sane for dynamically sized types][dst3]. Code that relied on
6935   the previous behavior is not known to exist, and suspected to be
6936   broken.
6937 * `'static` variables [may now be recursive][st].
6938 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6939   implementations correctly.
6940 * The `dropck` rules, which checks that destructors can't access
6941   destroyed values, [have been updated][dropck] to match the
6942   [RFC][dropckrfc].
6943
6944 Libraries
6945 ---------
6946
6947 * The [`Duration`] API, [has been stabilized][ds], as well as the
6948   `std::time` module, which presently contains only `Duration`.
6949 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6950 * The owned C string, [`CString`], implements [`Borrow`] and the
6951   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6952   these allow C strings to be borrowed and cloned in generic code.
6953 * [`CStr`] implements [`Debug`].
6954 * [`AtomicPtr`] implements [`Debug`].
6955 * [`Error`] trait objects [can be downcast to their concrete types][e]
6956   in many common configurations, using the [`is`], [`downcast`],
6957   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6958   [`Any`] trait.
6959 * Searching for substrings now [employs the two-way algorithm][search]
6960   instead of doing a naive search. This gives major speedups to a
6961   number of methods, including [`contains`][sc], [`find`][sf],
6962   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6963   [`ends_with`][sew] are also faster.
6964 * The performance of `PartialEq` for slices is [much faster][ps].
6965 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6966   is overridden and optimized by the implementations for scalars.
6967 * The [`Hasher`] trait now has a number of specialized `write_*`
6968   methods for primitive types, for efficiency.
6969 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6970   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6971   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6972   of [`std::error::Error::cause`][iec] also delegates to the inner
6973   error.
6974 * [`process::Child`][pc] gained the [`id`] method, which returns a
6975   `u32` representing the platform-specific process identifier.
6976 * The [`connect`] method on slices is deprecated, replaced by the new
6977   [`join`] method (note that both of these are on the *unstable*
6978   [`SliceConcatExt`] trait, but through the magic of the prelude are
6979   available to stable code anyway).
6980 * The [`Div`] operator is implemented for [`Wrapping`] types.
6981 * [`DerefMut` is implemented for `String`][dms].
6982 * Performance of SipHash (the default hasher for `HashMap`) is
6983   [better for long data][sh].
6984 * [`AtomicPtr`] implements [`Send`].
6985 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6986   are now [specialized to use uninitialized buffers for increased
6987   performance][rte].
6988 * Lifetime parameters of foreign functions [are now resolved
6989   properly][f].
6990
6991 Misc
6992 ----
6993
6994 * Rust can now, with some coercion, [produce programs that run on
6995   Windows XP][xp], though XP is not considered a supported platform.
6996 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6997   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6998   recommended for use in 1.3, though should be fully-functional
6999   in the [64-bit 1.4 beta][b14].
7000 * On Fedora-based systems installation will [properly configure the
7001   dynamic linker][fl].
7002 * The compiler gained many new extended error descriptions, which can
7003   be accessed with the `--explain` flag.
7004 * The `dropck` pass, which checks that destructors can't access
7005   destroyed values, [has been rewritten][dropck]. This fixes some
7006   soundness holes, and as such will cause some previously-compiling
7007   code to no longer build.
7008 * `rustc` now uses [LLVM to write archive files where possible][ar].
7009   Eventually this will eliminate the compiler's dependency on the ar
7010   utility.
7011 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
7012   supported FreeBSD on x86_64).
7013 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
7014   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
7015   more strict.
7016 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
7017   will kill the process instead of leaking][nlp].
7018
7019 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
7020 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
7021 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
7022 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
7023 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
7024 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7025 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7026 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
7027 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
7028 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
7029 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
7030 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
7031 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
7032 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
7033 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
7034 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
7035 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
7036 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
7037 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7038 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
7039 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
7040 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
7041 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
7042 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7043 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
7044 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
7045 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
7046 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
7047 [ar]: https://github.com/rust-lang/rust/pull/26926
7048 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
7049 [dms]: https://github.com/rust-lang/rust/pull/26241
7050 [dropck]: https://github.com/rust-lang/rust/pull/27261
7051 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7052 [ds]: https://github.com/rust-lang/rust/pull/26818
7053 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
7054 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
7055 [dst3]: https://github.com/rust-lang/rust/pull/27351
7056 [e]: https://github.com/rust-lang/rust/pull/24793
7057 [f]: https://github.com/rust-lang/rust/pull/26588
7058 [fb]: https://github.com/rust-lang/rust/pull/26959
7059 [fl]: https://github.com/rust-lang/rust-installer/pull/41
7060 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
7061 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
7062 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
7063 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
7064 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
7065 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
7066 [lic]: https://github.com/rust-lang/rust/pull/26583
7067 [lnu]: https://github.com/rust-lang/rust/pull/27026
7068 [lr]: https://github.com/rust-lang/rust/issues/27248
7069 [lum]: https://github.com/rust-lang/rust/pull/26378
7070 [lur]: https://github.com/rust-lang/rust/pull/26783
7071 [nlp]: https://github.com/rust-lang/rust/pull/27176
7072 [nold2]: https://github.com/rust-lang/rust/pull/27045
7073 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
7074 [nom]: http://doc.rust-lang.org/nightly/nomicon/
7075 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
7076 [pi]: https://github.com/rust-lang/rust/pull/26699
7077 [ps]: https://github.com/rust-lang/rust/pull/26884
7078 [rte]: https://github.com/rust-lang/rust/pull/26950
7079 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
7080 [search]: https://github.com/rust-lang/rust/pull/26327
7081 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
7082 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
7083 [sh]: https://github.com/rust-lang/rust/pull/27280
7084 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
7085 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
7086 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
7087 [st]: https://github.com/rust-lang/rust/pull/26630
7088 [win1]: https://github.com/rust-lang/rust/pull/26569
7089 [win2]: https://github.com/rust-lang/rust/pull/26741
7090 [win3]: https://github.com/rust-lang/rust/pull/26741
7091 [win4]: https://github.com/rust-lang/rust/pull/27210
7092 [xp]: https://github.com/rust-lang/rust/pull/26569
7093
7094 Version 1.2.0 (2015-08-07)
7095 ==========================
7096
7097 * ~1200 changes, numerous bugfixes
7098
7099 Highlights
7100 ----------
7101
7102 * [Dynamically-sized-type coercions][dst] allow smart pointer types
7103   like `Rc` to contain types without a fixed size, arrays and trait
7104   objects, finally enabling use of `Rc<[T]>` and completing the
7105   implementation of DST.
7106 * [Parallel codegen][parcodegen] is now working again, which can
7107   substantially speed up large builds in debug mode; It also gets
7108   another ~33% speedup when bootstrapping on a 4 core machine (using 8
7109   jobs). It's not enabled by default, but will be "in the near
7110   future". It can be activated with the `-C codegen-units=N` flag to
7111   `rustc`.
7112 * This is the first release with [experimental support for linking
7113   with the MSVC linker and lib C on Windows (instead of using the GNU
7114   variants via MinGW)][win]. It is yet recommended only for the most
7115   intrepid Rustaceans.
7116 * Benchmark compilations are showing a 30% improvement in
7117   bootstrapping over 1.1.
7118
7119 Breaking Changes
7120 ----------------
7121
7122 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
7123   unicode case mapping, which is a previously-planned change in
7124   behavior and considered a bugfix.
7125 * [`mem::align_of`] now specifies [the *minimum alignment* for
7126   T][align], which is usually the alignment programs are interested
7127   in, and the same value reported by clang's
7128   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
7129   break real code.
7130 * [The `#[packed]` attribute is no longer silently accepted by the
7131   compiler][packed]. This attribute did nothing and code that
7132   mentioned it likely did not work as intended.
7133 * Associated type defaults are [now behind the
7134   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
7135   defaults *did not work*, but could be mentioned syntactically. As
7136   such this breakage has minimal impact.
7137
7138 Language
7139 --------
7140
7141 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
7142   matching against dereferenceable values.
7143
7144 Libraries
7145 ---------
7146
7147 * The [`Extend`] trait, which grows a collection from an iterator, is
7148   implemented over iterators of references, for `String`, `Vec`,
7149   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
7150   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
7151 * The [`iter::once`] function returns an iterator that yields a single
7152   element, and [`iter::empty`] returns an iterator that yields no
7153   elements.
7154 * The [`matches`] and [`rmatches`] methods on `str` return iterators
7155   over substring matches.
7156 * [`Cell`] and [`RefCell`] both implement `Eq`.
7157 * A number of methods for wrapping arithmetic are added to the
7158   integral types, [`wrapping_div`], [`wrapping_rem`],
7159   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
7160   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
7161   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
7162   type.. It is illegal for the default arithmetic operations in Rust
7163   to overflow; the desire to wrap must be explicit.
7164 * The `{:#?}` formatting specifier [displays the alternate,
7165   pretty-printed][debugfmt] form of the `Debug` formatter. This
7166   feature was actually introduced prior to 1.0 with little
7167   fanfare.
7168 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
7169   for writing data to formatted strings, similar to [`io::Write`].
7170 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
7171   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
7172   are used by code generators to emit implementations of [`Debug`].
7173 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
7174   methods that convert case, following Unicode case mapping.
7175 * It is now easier to handle poisoned locks. The [`PoisonError`]
7176   type, returned by failing lock operations, exposes `into_inner`,
7177   `get_ref`, and `get_mut`, which all give access to the inner lock
7178   guard, and allow the poisoned lock to continue to operate. The
7179   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
7180   poisoned lock without attempting to take the lock.
7181 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
7182   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
7183   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
7184   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
7185   `ChildStderr`.
7186 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
7187   malformed input.
7188
7189 Misc
7190 ----
7191
7192 * `rustc` employs smarter heuristics for guessing at [typos].
7193 * `rustc` emits more efficient code for [no-op conversions between
7194   unsafe pointers][nop].
7195 * Fat pointers are now [passed in pairs of immediate arguments][fat],
7196   resulting in faster compile times and smaller code.
7197
7198 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
7199 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
7200 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
7201 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
7202 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
7203 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
7204 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
7205 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
7206 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
7207 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
7208 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
7209 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
7210 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
7211 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
7212 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
7213 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
7214 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
7215 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
7216 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
7217 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
7218 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
7219 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
7220 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
7221 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
7222 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
7223 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
7224 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
7225 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
7226 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
7227 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
7228 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
7229 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
7230 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
7231 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7232 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7233 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
7234 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
7235 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
7236 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
7237 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
7238 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
7239 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
7240 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
7241 [align]: https://github.com/rust-lang/rust/pull/25646
7242 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
7243 [typos]: https://github.com/rust-lang/rust/pull/26087
7244 [nop]: https://github.com/rust-lang/rust/pull/26336
7245 [fat]: https://github.com/rust-lang/rust/pull/26411
7246 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
7247 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
7248 [packed]: https://github.com/rust-lang/rust/pull/25541
7249 [ad]: https://github.com/rust-lang/rust/pull/27382
7250 [win]: https://github.com/rust-lang/rust/pull/25350
7251
7252 Version 1.1.0 (2015-06-25)
7253 =========================
7254
7255 * ~850 changes, numerous bugfixes
7256
7257 Highlights
7258 ----------
7259
7260 * The [`std::fs` module has been expanded][fs] to expand the set of
7261   functionality exposed:
7262   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
7263     don't incur a syscall on some platforms.
7264   * A `symlink_metadata` function has been added.
7265   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
7266     access to all underlying information.
7267 * The compiler now contains extended explanations of many errors. When an error
7268   with an explanation occurs the compiler suggests using the `--explain` flag
7269   to read the explanation. Error explanations are also [available online][err-index].
7270 * Thanks to multiple [improvements][sk] to [type checking][pre], as
7271   well as other work, the time to bootstrap the compiler decreased by
7272   32%.
7273
7274 Libraries
7275 ---------
7276
7277 * The [`str::split_whitespace`] method splits a string on unicode
7278   whitespace boundaries.
7279 * On both Windows and Unix, new extension traits provide conversion of
7280   I/O types to and from the underlying system handles. On Unix, these
7281   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
7282   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
7283   `TcpListener`, and `UpdSocket`. Further implementations for
7284   `std::process` will be stabilized later.
7285 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
7286   Windows, symlinks can be created with
7287   `std::os::windows::symlink_dir` and
7288   `std::os::windows::symlink_file`.
7289 * The `mpsc::Receiver` type can now be converted into an iterator with
7290   `into_iter` on the [`IntoIterator`] trait.
7291 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
7292   implementation of the [`From`] trait.
7293 * The `Debug` implementation for `RangeFull` [creates output that is
7294   more consistent with other implementations][rf].
7295 * [`Debug` is implemented for `File`][file].
7296 * The `Default` implementation for `Arc` [no longer requires `Sync +
7297   Send`][arc].
7298 * [The `Iterator` methods `count`, `nth`, and `last` have been
7299   overridden for slices to have O(1) performance instead of O(n)][si].
7300 * Incorrect handling of paths on Windows has been improved in both the
7301   compiler and the standard library.
7302 * [`AtomicPtr` gained a `Default` implementation][ap].
7303 * In accordance with Rust's policy on arithmetic overflow `abs` now
7304   [panics on overflow when debug assertions are enabled][abs].
7305 * The [`Cloned`] iterator, which was accidentally left unstable for
7306   1.0 [has been stabilized][c].
7307 * The [`Incoming`] iterator, which iterates over incoming TCP
7308   connections, and which was accidentally unnamable in 1.0, [is now
7309   properly exported][inc].
7310 * [`BinaryHeap`] no longer corrupts itself [when functions called by
7311   `sift_up` or `sift_down` panic][bh].
7312 * The [`split_off`] method of `LinkedList` [no longer corrupts
7313   the list in certain scenarios][ll].
7314
7315 Misc
7316 ----
7317
7318 * Type checking performance [has improved notably][sk] with
7319   [multiple improvements][pre].
7320 * The compiler [suggests code changes][ch] for more errors.
7321 * rustc and it's build system have experimental support for [building
7322   toolchains against MUSL][m] instead of glibc on Linux.
7323 * The compiler defines the `target_env` cfg value, which is used for
7324   distinguishing toolchains that are otherwise for the same
7325   platform. Presently this is set to `gnu` for common GNU Linux
7326   targets and for MinGW targets, and `musl` for MUSL Linux targets.
7327 * The [`cargo rustc`][crc] command invokes a build with custom flags
7328   to rustc.
7329 * [Android executables are always position independent][pie].
7330 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
7331   with `Drop`][drop].
7332
7333 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
7334 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
7335 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
7336 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
7337 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
7338 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
7339 [rf]: https://github.com/rust-lang/rust/pull/24491
7340 [err-index]: https://doc.rust-lang.org/error-index.html
7341 [sk]: https://github.com/rust-lang/rust/pull/24615
7342 [pre]: https://github.com/rust-lang/rust/pull/25323
7343 [file]: https://github.com/rust-lang/rust/pull/24598
7344 [ch]: https://github.com/rust-lang/rust/pull/24683
7345 [arc]: https://github.com/rust-lang/rust/pull/24695
7346 [si]: https://github.com/rust-lang/rust/pull/24701
7347 [ap]: https://github.com/rust-lang/rust/pull/24834
7348 [m]: https://github.com/rust-lang/rust/pull/24777
7349 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
7350 [crc]: https://github.com/rust-lang/cargo/pull/1568
7351 [pie]: https://github.com/rust-lang/rust/pull/24953
7352 [abs]: https://github.com/rust-lang/rust/pull/25441
7353 [c]: https://github.com/rust-lang/rust/pull/25496
7354 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
7355 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
7356 [inc]: https://github.com/rust-lang/rust/pull/25522
7357 [bh]: https://github.com/rust-lang/rust/pull/25856
7358 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
7359 [ll]: https://github.com/rust-lang/rust/pull/26022
7360 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
7361 [drop]: https://github.com/rust-lang/rust/pull/24935
7362
7363 Version 1.0.0 (2015-05-15)
7364 ========================
7365
7366 * ~1500 changes, numerous bugfixes
7367
7368 Highlights
7369 ----------
7370
7371 * The vast majority of the standard library is now `#[stable]`. It is
7372   no longer possible to use unstable features with a stable build of
7373   the compiler.
7374 * Many popular crates on [crates.io] now work on the stable release
7375   channel.
7376 * Arithmetic on basic integer types now [checks for overflow in debug
7377   builds][overflow].
7378
7379 Language
7380 --------
7381
7382 * Several [restrictions have been added to trait coherence][coh] in
7383   order to make it easier for upstream authors to change traits
7384   without breaking downstream code.
7385 * Digits of binary and octal literals are [lexed more eagerly][lex] to
7386   improve error messages and macro behavior. For example, `0b1234` is
7387   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
7388 * Trait bounds [are always invariant][inv], eliminating the need for
7389   the `PhantomFn` and `MarkerTrait` lang items, which have been
7390   removed.
7391 * ["-" is no longer a valid character in crate names][cr], the `extern crate
7392   "foo" as bar` syntax has been replaced with `extern crate foo as
7393   bar`, and Cargo now automatically translates "-" in *package* names
7394   to underscore for the crate name.
7395 * [Lifetime shadowing is an error][lt].
7396 * [`Send` no longer implies `'static`][send-rfc].
7397 * [UFCS now supports trait-less associated paths][moar-ufcs] like
7398   `MyType::default()`.
7399 * Primitive types [now have inherent methods][prim-inherent],
7400   obviating the need for extension traits like `SliceExt`.
7401 * Methods with `Self: Sized` in their `where` clause are [considered
7402   object-safe][self-sized], allowing many extension traits like
7403   `IteratorExt` to be merged into the traits they extended.
7404 * You can now [refer to associated types][assoc-where] whose
7405   corresponding trait bounds appear only in a `where` clause.
7406 * The final bits of [OIBIT landed][oibit-final], meaning that traits
7407   like `Send` and `Sync` are now library-defined.
7408 * A [Reflect trait][reflect] was introduced, which means that
7409   downcasting via the `Any` trait is effectively limited to concrete
7410   types. This helps retain the potentially-important "parametricity"
7411   property: generic code cannot behave differently for different type
7412   arguments except in minor ways.
7413 * The `unsafe_destructor` feature is now deprecated in favor of the
7414   [new `dropck`][dropck]. This change is a major reduction in unsafe
7415   code.
7416
7417 Libraries
7418 ---------
7419
7420 * The `thread_local` module [has been renamed to `std::thread`][th].
7421 * The methods of `IteratorExt` [have been moved to the `Iterator`
7422   trait itself][ie].
7423 * Several traits that implement Rust's conventions for type
7424   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
7425   [centralized in the `std::convert` module][con].
7426 * The `FromError` trait [was removed in favor of `From`][fe].
7427 * The basic sleep function [has moved to
7428   `std::thread::sleep_ms`][slp].
7429 * The `splitn` function now takes an `n` parameter that represents the
7430   number of items yielded by the returned iterator [instead of the
7431   number of 'splits'][spl].
7432 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
7433 * [Derived implementations of `PartialOrd` now order enums according
7434   to their explicitly-assigned discriminants][po].
7435 * [Methods for searching strings are generic over `Pattern`s][pat],
7436   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
7437   some others.
7438 * [In method resolution, object methods are resolved before inherent
7439   methods][meth].
7440 * [`String::from_str` has been deprecated in favor of the `From` impl,
7441   `String::from`][sf].
7442 * [`io::Error` implements `Sync`][ios].
7443 * [The `words` method on `&str` has been replaced with
7444   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
7445   a word?'
7446 * The new path and IO modules are complete and `#[stable]`. This
7447   was the major library focus for this cycle.
7448 * The path API was [revised][path-normalize] to normalize `.`,
7449   adjusting the tradeoffs in favor of the most common usage.
7450 * A large number of remaining APIs in `std` were also stabilized
7451   during this cycle; about 75% of the non-deprecated API surface
7452   is now stable.
7453 * The new [string pattern API][string-pattern] landed, which makes
7454   the string slice API much more internally consistent and flexible.
7455 * A new set of [generic conversion traits][conversion] replaced
7456   many existing ad hoc traits.
7457 * Generic numeric traits were [completely removed][num-traits]. This
7458   was made possible thanks to inherent methods for primitive types,
7459   and the removal gives maximal flexibility for designing a numeric
7460   hierarchy in the future.
7461 * The `Fn` traits are now related via [inheritance][fn-inherit]
7462   and provide ergonomic [blanket implementations][fn-blanket].
7463 * The `Index` and `IndexMut` traits were changed to
7464   [take the index by value][index-value], enabling code like
7465   `hash_map["string"]` to work.
7466 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
7467   `Copy` data is known to be `Clone` as well.
7468
7469 Misc
7470 ----
7471
7472 * Many errors now have extended explanations that can be accessed with
7473   the `--explain` flag to `rustc`.
7474 * Many new examples have been added to the standard library
7475   documentation.
7476 * rustdoc has received a number of improvements focused on completion
7477   and polish.
7478 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
7479 * Much headway was made on ecosystem-wide CI, making it possible
7480   to [compare builds for breakage][ci-compare].
7481
7482
7483 [crates.io]: http://crates.io
7484 [clo]: https://github.com/rust-lang/rust/pull/24034
7485 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
7486 [con]: https://github.com/rust-lang/rust/pull/23875
7487 [cr]: https://github.com/rust-lang/rust/pull/23419
7488 [fe]: https://github.com/rust-lang/rust/pull/23879
7489 [ie]: https://github.com/rust-lang/rust/pull/23300
7490 [inv]: https://github.com/rust-lang/rust/pull/23938
7491 [ios]: https://github.com/rust-lang/rust/pull/24133
7492 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
7493 [lt]: https://github.com/rust-lang/rust/pull/24057
7494 [meth]: https://github.com/rust-lang/rust/pull/24056
7495 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
7496 [po]: https://github.com/rust-lang/rust/pull/24270
7497 [sf]: https://github.com/rust-lang/rust/pull/24517
7498 [slp]: https://github.com/rust-lang/rust/pull/23949
7499 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
7500 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
7501 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
7502 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
7503 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
7504 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
7505 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
7506 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
7507 [self-sized]: https://github.com/rust-lang/rust/pull/22301
7508 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
7509 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
7510 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
7511 [reflect]: https://github.com/rust-lang/rust/pull/23712
7512 [conversion]: https://github.com/rust-lang/rfcs/pull/529
7513 [num-traits]: https://github.com/rust-lang/rust/pull/23549
7514 [index-value]: https://github.com/rust-lang/rust/pull/23601
7515 [dropck]: https://github.com/rust-lang/rfcs/pull/769
7516 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
7517 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
7518 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
7519 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
7520 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
7521
7522
7523 Version 1.0.0-alpha.2 (2015-02-20)
7524 =====================================
7525
7526 * ~1300 changes, numerous bugfixes
7527
7528 * Highlights
7529
7530     * The various I/O modules were [overhauled][io-rfc] to reduce
7531       unnecessary abstractions and provide better interoperation with
7532       the underlying platform. The old `io` module remains temporarily
7533       at `std::old_io`.
7534     * The standard library now [participates in feature gating][feat],
7535       so use of unstable libraries now requires a `#![feature(...)]`
7536       attribute. The impact of this change is [described on the
7537       forum][feat-forum]. [RFC][feat-rfc].
7538
7539 * Language
7540
7541     * `for` loops [now operate on the `IntoIterator` trait][into],
7542       which eliminates the need to call `.iter()`, etc. to iterate
7543       over collections. There are some new subtleties to remember
7544       though regarding what sort of iterators various types yield, in
7545       particular that `for foo in bar { }` yields values from a move
7546       iterator, destroying the original collection. [RFC][into-rfc].
7547     * Objects now have [default lifetime bounds][obj], so you don't
7548       have to write `Box<Trait+'static>` when you don't care about
7549       storing references. [RFC][obj-rfc].
7550     * In types that implement `Drop`, [lifetimes must outlive the
7551       value][drop]. This will soon make it possible to safely
7552       implement `Drop` for types where `#[unsafe_destructor]` is now
7553       required. Read the [gorgeous RFC][drop-rfc] for details.
7554     * The fully qualified <T as Trait>::X syntax lets you set the Self
7555       type for a trait method or associated type. [RFC][ufcs-rfc].
7556     * References to types that implement `Deref<U>` now [automatically
7557       coerce to references][deref] to the dereferenced type `U`,
7558       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
7559       should eliminate many unsightly uses of `&*`, as when converting
7560       from references to vectors into references to
7561       slices. [RFC][deref-rfc].
7562     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
7563       `|:|`) is obsolete and closure kind is inferred from context.
7564     * [`Self` is a keyword][Self].
7565
7566 * Libraries
7567
7568     * The `Show` and `String` formatting traits [have been
7569       renamed][fmt] to `Debug` and `Display` to more clearly reflect
7570       their related purposes. Automatically getting a string
7571       conversion to use with `format!("{:?}", something_to_debug)` is
7572       now written `#[derive(Debug)]`.
7573     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
7574       OsStr}`, provide strings in platform-specific encodings for easier
7575       interop with system APIs. [RFC][osstr-rfc].
7576     * The `boxed::into_raw` and `Box::from_raw` functions [convert
7577       between `Box<T>` and `*mut T`][boxraw], a common pattern for
7578       creating raw pointers.
7579
7580 * Tooling
7581
7582     * Certain long error messages of the form 'expected foo found bar'
7583       are now [split neatly across multiple
7584       lines][multiline]. Examples in the PR.
7585     * On Unix Rust can be [uninstalled][un] by running
7586       `/usr/local/lib/rustlib/uninstall.sh`.
7587     * The `#[rustc_on_unimplemented]` attribute, requiring the
7588       'on_unimplemented' feature, lets rustc [display custom error
7589       messages when a trait is expected to be implemented for a type
7590       but is not][onun].
7591
7592 * Misc
7593
7594     * Rust is tested against a [LALR grammar][lalr], which parses
7595       almost all the Rust files that rustc does.
7596
7597 [boxraw]: https://github.com/rust-lang/rust/pull/21318
7598 [close]: https://github.com/rust-lang/rust/pull/21843
7599 [deref]: https://github.com/rust-lang/rust/pull/21351
7600 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
7601 [drop]: https://github.com/rust-lang/rust/pull/21972
7602 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
7603 [feat]: https://github.com/rust-lang/rust/pull/21248
7604 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
7605 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
7606 [fmt]: https://github.com/rust-lang/rust/pull/21457
7607 [into]: https://github.com/rust-lang/rust/pull/20790
7608 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
7609 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7610 [lalr]: https://github.com/rust-lang/rust/pull/21452
7611 [multiline]: https://github.com/rust-lang/rust/pull/19870
7612 [obj]: https://github.com/rust-lang/rust/pull/22230
7613 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
7614 [onun]: https://github.com/rust-lang/rust/pull/20889
7615 [osstr]: https://github.com/rust-lang/rust/pull/21488
7616 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
7617 [Self]: https://github.com/rust-lang/rust/pull/22158
7618 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
7619 [un]: https://github.com/rust-lang/rust/pull/22256
7620
7621
7622 Version 1.0.0-alpha (2015-01-09)
7623 ==================================
7624
7625   * ~2400 changes, numerous bugfixes
7626
7627   * Highlights
7628
7629     * The language itself is considered feature complete for 1.0,
7630       though there will be many usability improvements and bugfixes
7631       before the final release.
7632     * Nearly 50% of the public API surface of the standard library has
7633       been declared 'stable'. Those interfaces are unlikely to change
7634       before 1.0.
7635     * The long-running debate over integer types has been
7636       [settled][ints]: Rust will ship with types named `isize` and
7637       `usize`, rather than `int` and `uint`, for pointer-sized
7638       integers. Guidelines will be rolled out during the alpha cycle.
7639     * Most crates that are not `std` have been moved out of the Rust
7640       distribution into the Cargo ecosystem so they can evolve
7641       separately and don't need to be stabilized as quickly, including
7642       'time', 'getopts', 'num', 'regex', and 'term'.
7643     * Documentation continues to be expanded with more API coverage, more
7644       examples, and more in-depth explanations. The guides have been
7645       consolidated into [The Rust Programming Language][trpl].
7646     * "[Rust By Example][rbe]" is now maintained by the Rust team.
7647     * All official Rust binary installers now come with [Cargo], the
7648       Rust package manager.
7649
7650 * Language
7651
7652     * Closures have been [completely redesigned][unboxed] to be
7653       implemented in terms of traits, can now be used as generic type
7654       bounds and thus monomorphized and inlined, or via an opaque
7655       pointer (boxed) as in the old system. The new system is often
7656       referred to as 'unboxed' closures.
7657     * Traits now support [associated types][assoc], allowing families
7658       of related types to be defined together and used generically in
7659       powerful ways.
7660     * Enum variants are [namespaced by their type names][enum].
7661     * [`where` clauses][where] provide a more versatile and attractive
7662       syntax for specifying generic bounds, though the previous syntax
7663       remains valid.
7664     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
7665       numeric types.
7666     * Rust [no longer has a runtime][rt] of any description, and only
7667       supports OS threads, not green threads.
7668     * At long last, Rust has been overhauled for 'dynamically-sized
7669       types' ([DST]), which integrates 'fat pointers' (object types,
7670       arrays, and `str`) more deeply into the type system, making it
7671       more consistent.
7672     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
7673       `..j` that produce range types and which, when combined with the
7674       `Index` operator and multidispatch, leads to a convenient slice
7675       notation, `[i..j]`.
7676     * The new range syntax revealed an ambiguity in the fixed-length
7677       array syntax, so now fixed length arrays [are written `[T;
7678       N]`][arrays].
7679     * The `Copy` trait is no longer implemented automatically. Unsafe
7680       pointers no longer implement `Sync` and `Send` so types
7681       containing them don't automatically either. `Sync` and `Send`
7682       are now 'unsafe traits' so one can "forcibly" implement them via
7683       `unsafe impl` if a type confirms to the requirements for them
7684       even though the internals do not (e.g. structs containing unsafe
7685       pointers like `Arc`). These changes are intended to prevent some
7686       footguns and are collectively known as [opt-in built-in
7687       traits][oibit] (though `Sync` and `Send` will soon become pure
7688       library types unknown to the compiler).
7689     * Operator traits now take their operands [by value][ops], and
7690       comparison traits can use multidispatch to compare one type
7691       against multiple other types, allowing e.g. `String` to be
7692       compared with `&str`.
7693     * `if let` and `while let` are no longer feature-gated.
7694     * Rust has adopted a more [uniform syntax for escaping unicode
7695       characters][unicode].
7696     * `macro_rules!` [has been declared stable][mac]. Though it is a
7697       flawed system it is sufficiently popular that it must be usable
7698       for 1.0. Effort has gone into [future-proofing][mac-future] it
7699       in ways that will allow other macro systems to be developed in
7700       parallel, and won't otherwise impact the evolution of the
7701       language.
7702     * The prelude has been [pared back significantly][prelude] such
7703       that it is the minimum necessary to support the most pervasive
7704       code patterns, and through [generalized where clauses][where]
7705       many of the prelude extension traits have been consolidated.
7706     * Rust's rudimentary reflection [has been removed][refl], as it
7707       incurred too much code generation for little benefit.
7708     * [Struct variants][structvars] are no longer feature-gated.
7709     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7710       known as 'higher-ranked trait bounds', this crucially allows
7711       unboxed closures to work.
7712     * Macros invocations surrounded by parens or square brackets and
7713       not terminated by a semicolon are [parsed as
7714       expressions][macros], which makes expressions like `vec![1i32,
7715       2, 3].len()` work as expected.
7716     * Trait objects now implement their traits automatically, and
7717       traits that can be coerced to objects now must be [object
7718       safe][objsafe].
7719     * Automatically deriving traits is now done with `#[derive(...)]`
7720       not `#[deriving(...)]` for [consistency with other naming
7721       conventions][derive].
7722     * Importing the containing module or enum at the same time as
7723       items or variants they contain is [now done with `self` instead
7724       of `mod`][self], as in use `foo::{self, bar}`
7725     * Glob imports are no longer feature-gated.
7726     * The `box` operator and `box` patterns have been feature-gated
7727       pending a redesign. For now unique boxes should be allocated
7728       like other containers, with `Box::new`.
7729
7730 * Libraries
7731
7732     * A [series][coll1] of [efforts][coll2] to establish
7733       [conventions][coll3] for collections types has resulted in API
7734       improvements throughout the standard library.
7735     * New [APIs for error handling][err] provide ergonomic interop
7736       between error types, and [new conventions][err-conv] describe
7737       more clearly the recommended error handling strategies in Rust.
7738     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7739       it is easier to discuss failure in the context of error handling
7740       without making clarifications as to whether you are referring to
7741       the 'fail' macro or failure more generally.
7742     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7743       syscall when available.
7744     * The 'serialize' crate has been renamed 'rustc-serialize' and
7745       moved out of the distribution to Cargo. Although it is widely
7746       used now, it is expected to be superseded in the near future.
7747     * The `Show` formatter, typically implemented with
7748       `#[derive(Show)]` is [now requested with the `{:?}`
7749       specifier][show] and is intended for use by all types, for uses
7750       such as `println!` debugging. The new `String` formatter must be
7751       implemented by hand, uses the `{}` specifier, and is intended
7752       for full-fidelity conversions of things that can logically be
7753       represented as strings.
7754
7755 * Tooling
7756
7757     * [Flexible target specification][flex] allows rustc's code
7758       generation to be configured to support otherwise-unsupported
7759       platforms.
7760     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7761       respective debuggers with Rust-appropriate pretty-printing.
7762     * The Windows installation of Rust is distributed with the
7763       MinGW components currently required to link binaries on that
7764       platform.
7765
7766 * Misc
7767
7768     * Nullable enum optimizations have been extended to more types so
7769       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7770       space than the inner types themselves.
7771     * Work has begun on supporting AArch64.
7772
7773 [Cargo]: https://crates.io
7774 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7775 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7776 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7777 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7778 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7779 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7780 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7781 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7782 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7783 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7784 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7785 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7786 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7787 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7788 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7789 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7790 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7791 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7792 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7793 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7794 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7795 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7796 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7797 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7798 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7799 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7800 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7801 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7802 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7803 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7804 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7805 [trpl]: https://doc.rust-lang.org/book/index.html
7806 [rbe]: http://rustbyexample.com/
7807
7808
7809 Version 0.12.0 (2014-10-09)
7810 =============================
7811
7812   * ~1900 changes, numerous bugfixes
7813
7814   * Highlights
7815
7816     * The introductory documentation (now called The Rust Guide) has
7817       been completely rewritten, as have a number of supplementary
7818       guides.
7819     * Rust's package manager, Cargo, continues to improve and is
7820       sometimes considered to be quite awesome.
7821     * Many API's in `std` have been reviewed and updated for
7822       consistency with the in-development Rust coding
7823       guidelines. The standard library documentation tracks
7824       stabilization progress.
7825     * Minor libraries have been moved out-of-tree to the rust-lang org
7826       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7827       be installed with Cargo.
7828     * Lifetime elision allows lifetime annotations to be left off of
7829       function declarations in many common scenarios.
7830     * Rust now works on 64-bit Windows.
7831
7832   * Language
7833     * Indexing can be overloaded with the `Index` and `IndexMut`
7834       traits.
7835     * The `if let` construct takes a branch only if the `let` pattern
7836       matches, currently behind the 'if_let' feature gate.
7837     * 'where clauses', a more flexible syntax for specifying trait
7838       bounds that is more aesthetic, have been added for traits and
7839       free functions. Where clauses will in the future make it
7840       possible to constrain associated types, which would be
7841       impossible with the existing syntax.
7842     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7843       the 'slicing_syntax' feature gate, and can be overloaded with
7844       the `Slice` or `SliceMut` traits.
7845     * The syntax for matching of sub-slices has been changed to use a
7846       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7847       consistency with other uses of `..` and to future-proof
7848       potential additional uses of the syntax.
7849     * The syntax for matching inclusive ranges in patterns has changed
7850       from `0..3` to `0...4` to be consistent with the exclusive range
7851       syntax for slicing.
7852     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7853       c]`) has been put behind the 'advanced_slice_patterns' feature
7854       gate and may be removed in the future.
7855     * Components of tuples and tuple structs can be extracted using
7856       the `value.0` syntax, currently behind the `tuple_indexing`
7857       feature gate.
7858     * The `#[crate_id]` attribute is no longer supported; versioning
7859       is handled by the package manager.
7860     * Renaming crate imports are now written `extern crate foo as bar`
7861       instead of `extern crate bar = foo`.
7862     * Renaming use statements are now written `use foo as bar` instead
7863       of `use bar = foo`.
7864     * `let` and `match` bindings and argument names in macros are now
7865       hygienic.
7866     * The new, more efficient, closure types ('unboxed closures') have
7867       been added under a feature gate, 'unboxed_closures'. These will
7868       soon replace the existing closure types, once higher-ranked
7869       trait lifetimes are added to the language.
7870     * `move` has been added as a keyword, for indicating closures
7871       that capture by value.
7872     * Mutation and assignment is no longer allowed in pattern guards.
7873     * Generic structs and enums can now have trait bounds.
7874     * The `Share` trait is now called `Sync` to free up the term
7875       'shared' to refer to 'shared reference' (the default reference
7876       type.
7877     * Dynamically-sized types have been mostly implemented,
7878       unifying the behavior of fat-pointer types with the rest of the
7879       type system.
7880     * As part of dynamically-sized types, the `Sized` trait has been
7881       introduced, which qualifying types implement by default, and
7882       which type parameters expect by default. To specify that a type
7883       parameter does not need to be sized, write `<Sized? T>`. Most
7884       types are `Sized`, notable exceptions being unsized arrays
7885       (`[T]`) and trait types.
7886     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7887     * Lifetime bounds can now be applied to type parameters and object
7888       types.
7889     * The old, reference counted GC type, `Gc<T>` which was once
7890       denoted by the `@` sigil, has finally been removed. GC will be
7891       revisited in the future.
7892
7893   * Libraries
7894     * Library documentation has been improved for a number of modules.
7895     * Bit-vectors, collections::bitv has been modernized.
7896     * The url crate is deprecated in favor of
7897       http://github.com/servo/rust-url, which can be installed with
7898       Cargo.
7899     * Most I/O stream types can be cloned and subsequently closed from
7900       a different thread.
7901     * A `std::time::Duration` type has been added for use in I/O
7902       methods that rely on timers, as well as in the 'time' crate's
7903       `Timespec` arithmetic.
7904     * The runtime I/O abstraction layer that enabled the green thread
7905       scheduler to do non-thread-blocking I/O has been removed, along
7906       with the libuv-based implementation employed by the green thread
7907       scheduler. This will greatly simplify the future I/O work.
7908     * `collections::btree` has been rewritten to have a more
7909       idiomatic and efficient design.
7910
7911   * Tooling
7912     * rustdoc output now indicates the stability levels of API's.
7913     * The `--crate-name` flag can specify the name of the crate
7914       being compiled, like `#[crate_name]`.
7915     * The `-C metadata` specifies additional metadata to hash into
7916       symbol names, and `-C extra-filename` specifies additional
7917       information to put into the output filename, for use by the
7918       package manager for versioning.
7919     * debug info generation has continued to improve and should be
7920       more reliable under both gdb and lldb.
7921     * rustc has experimental support for compiling in parallel
7922       using the `-C codegen-units` flag.
7923     * rustc no longer encodes rpath information into binaries by
7924       default.
7925
7926   * Misc
7927     * Stack usage has been optimized with LLVM lifetime annotations.
7928     * Official Rust binaries on Linux are more compatible with older
7929       kernels and distributions, built on CentOS 5.10.
7930
7931
7932 Version 0.11.0 (2014-07-02)
7933 ==========================
7934
7935   * ~1700 changes, numerous bugfixes
7936
7937   * Language
7938     * ~[T] has been removed from the language. This type is superseded by
7939       the Vec<T> type.
7940     * ~str has been removed from the language. This type is superseded by
7941       the String type.
7942     * ~T has been removed from the language. This type is superseded by the
7943       Box<T> type.
7944     * @T has been removed from the language. This type is superseded by the
7945       standard library's std::gc::Gc<T> type.
7946     * Struct fields are now all private by default.
7947     * Vector indices and shift amounts are both required to be a `uint`
7948       instead of any integral type.
7949     * Byte character, byte string, and raw byte string literals are now all
7950       supported by prefixing the normal literal with a `b`.
7951     * Multiple ABIs are no longer allowed in an ABI string
7952     * The syntax for lifetimes on closures/procedures has been tweaked
7953       slightly: `<'a>|A, B|: 'b + K -> T`
7954     * Floating point modulus has been removed from the language; however it
7955       is still provided by a library implementation.
7956     * Private enum variants are now disallowed.
7957     * The `priv` keyword has been removed from the language.
7958     * A closure can no longer be invoked through a &-pointer.
7959     * The `use foo, bar, baz;` syntax has been removed from the language.
7960     * The transmute intrinsic no longer works on type parameters.
7961     * Statics now allow blocks/items in their definition.
7962     * Trait bounds are separated from objects with + instead of : now.
7963     * Objects can no longer be read while they are mutably borrowed.
7964     * The address of a static is now marked as insignificant unless the
7965       #[inline(never)] attribute is placed it.
7966     * The #[unsafe_destructor] attribute is now behind a feature gate.
7967     * Struct literals are no longer allowed in ambiguous positions such as
7968       if, while, match, and for..in.
7969     * Declaration of lang items and intrinsics are now feature-gated by
7970       default.
7971     * Integral literals no longer default to `int`, and floating point
7972       literals no longer default to `f64`. Literals must be suffixed with an
7973       appropriate type if inference cannot determine the type of the
7974       literal.
7975     * The Box<T> type is no longer implicitly borrowed to &mut T.
7976     * Procedures are now required to not capture borrowed references.
7977
7978   * Libraries
7979     * The standard library is now a "facade" over a number of underlying
7980       libraries. This means that development on the standard library should
7981       be speedier due to smaller crates, as well as a clearer line between
7982       all dependencies.
7983     * A new library, libcore, lives under the standard library's facade
7984       which is Rust's "0-assumption" library, suitable for embedded and
7985       kernel development for example.
7986     * A regex crate has been added to the standard distribution. This crate
7987       includes statically compiled regular expressions.
7988     * The unwrap/unwrap_err methods on Result require a Show bound for
7989       better error messages.
7990     * The return types of the std::comm primitives have been centralized
7991       around the Result type.
7992     * A number of I/O primitives have gained the ability to time out their
7993       operations.
7994     * A number of I/O primitives have gained the ability to close their
7995       reading/writing halves to cancel pending operations.
7996     * Reverse iterator methods have been removed in favor of `rev()` on
7997       their forward-iteration counterparts.
7998     * A bitflags! macro has been added to enable easy interop with C and
7999       management of bit flags.
8000     * A debug_assert! macro is now provided which is disabled when
8001       `--cfg ndebug` is passed to the compiler.
8002     * A graphviz crate has been added for creating .dot files.
8003     * The std::cast module has been migrated into std::mem.
8004     * The std::local_data api has been migrated from freestanding functions
8005       to being based on methods.
8006     * The Pod trait has been renamed to Copy.
8007     * jemalloc has been added as the default allocator for types.
8008     * The API for allocating memory has been changed to use proper alignment
8009       and sized deallocation
8010     * Connecting a TcpStream or binding a TcpListener is now based on a
8011       string address and a u16 port. This allows connecting to a hostname as
8012       opposed to an IP.
8013     * The Reader trait now contains a core method, read_at_least(), which
8014       correctly handles many repeated 0-length reads.
8015     * The process-spawning API is now centered around a builder-style
8016       Command struct.
8017     * The :? printing qualifier has been moved from the standard library to
8018       an external libdebug crate.
8019     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
8020       have been renamed to Eq/Ord.
8021     * The select/plural methods have been removed from format!. The escapes
8022       for { and } have also changed from \{ and \} to {{ and }},
8023       respectively.
8024     * The TaskBuilder API has been re-worked to be a true builder, and
8025       extension traits for spawning native/green tasks have been added.
8026
8027   * Tooling
8028     * All breaking changes to the language or libraries now have their
8029       commit message annotated with `[breaking-change]` to allow for easy
8030       discovery of breaking changes.
8031     * The compiler will now try to suggest how to annotate lifetimes if a
8032       lifetime-related error occurs.
8033     * Debug info continues to be improved greatly with general bug fixes and
8034       better support for situations like link time optimization (LTO).
8035     * Usage of syntax extensions when cross-compiling has been fixed.
8036     * Functionality equivalent to GCC & Clang's -ffunction-sections,
8037       -fdata-sections and --gc-sections has been enabled by default
8038     * The compiler is now stricter about where it will load module files
8039       from when a module is declared via `mod foo;`.
8040     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
8041       Syntax extensions are now discovered via a "plugin registrar" type
8042       which will be extended in the future to other various plugins.
8043     * Lints have been restructured to allow for dynamically loadable lints.
8044     * A number of rustdoc improvements:
8045       * The HTML output has been visually redesigned.
8046       * Markdown is now powered by hoedown instead of sundown.
8047       * Searching heuristics have been greatly improved.
8048       * The search index has been reduced in size by a great amount.
8049       * Cross-crate documentation via `pub use` has been greatly improved.
8050       * Primitive types are now hyperlinked and documented.
8051     * Documentation has been moved from static.rust-lang.org/doc to
8052       doc.rust-lang.org
8053     * A new sandbox, play.rust-lang.org, is available for running and
8054       sharing rust code examples on-line.
8055     * Unused attributes are now more robustly warned about.
8056     * The dead_code lint now warns about unused struct fields.
8057     * Cross-compiling to iOS is now supported.
8058     * Cross-compiling to mipsel is now supported.
8059     * Stability attributes are now inherited by default and no longer apply
8060       to intra-crate usage, only inter-crate usage.
8061     * Error message related to non-exhaustive match expressions have been
8062       greatly improved.
8063
8064
8065 Version 0.10 (2014-04-03)
8066 =========================
8067
8068   * ~1500 changes, numerous bugfixes
8069
8070   * Language
8071     * A new RFC process is now in place for modifying the language.
8072     * Patterns with `@`-pointers have been removed from the language.
8073     * Patterns with unique vectors (`~[T]`) have been removed from the
8074       language.
8075     * Patterns with unique strings (`~str`) have been removed from the
8076       language.
8077     * `@str` has been removed from the language.
8078     * `@[T]` has been removed from the language.
8079     * `@self` has been removed from the language.
8080     * `@Trait` has been removed from the language.
8081     * Headers on `~` allocations which contain `@` boxes inside the type for
8082       reference counting have been removed.
8083     * The semantics around the lifetimes of temporary expressions have changed,
8084       see #3511 and #11585 for more information.
8085     * Cross-crate syntax extensions are now possible, but feature gated. See
8086       #11151 for more information. This includes both `macro_rules!` macros as
8087       well as syntax extensions such as `format!`.
8088     * New lint modes have been added, and older ones have been turned on to be
8089       warn-by-default.
8090       * Unnecessary parentheses
8091       * Uppercase statics
8092       * Camel Case types
8093       * Uppercase variables
8094       * Publicly visible private types
8095       * `#[deriving]` with raw pointers
8096     * Unsafe functions can no longer be coerced to closures.
8097     * Various obscure macros such as `log_syntax!` are now behind feature gates.
8098     * The `#[simd]` attribute is now behind a feature gate.
8099     * Visibility is no longer allowed on `extern crate` statements, and
8100       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
8101     * Trailing commas are now allowed in argument lists and tuple patterns.
8102     * The `do` keyword has been removed, it is now a reserved keyword.
8103     * Default type parameters have been implemented, but are feature gated.
8104     * Borrowed variables through captures in closures are now considered soundly.
8105     * `extern mod` is now `extern crate`
8106     * The `Freeze` trait has been removed.
8107     * The `Share` trait has been added for types that can be shared among
8108       threads.
8109     * Labels in macros are now hygienic.
8110     * Expression/statement macro invocations can be delimited with `{}` now.
8111     * Treatment of types allowed in `static mut` locations has been tweaked.
8112     * The `*` and `.` operators are now overloadable through the `Deref` and
8113       `DerefMut` traits.
8114     * `~Trait` and `proc` no longer have `Send` bounds by default.
8115     * Partial type hints are now supported with the `_` type marker.
8116     * An `Unsafe` type was introduced for interior mutability. It is now
8117       considered undefined to transmute from `&T` to `&mut T` without using the
8118       `Unsafe` type.
8119     * The #[linkage] attribute was implemented for extern statics/functions.
8120     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
8121     * `Pod` was renamed to `Copy`.
8122
8123   * Libraries
8124     * The `libextra` library has been removed. It has now been decomposed into
8125       component libraries with smaller and more focused nuggets of
8126       functionality. The full list of libraries can be found on the
8127       documentation index page.
8128     * std: `std::condition` has been removed. All I/O errors are now propagated
8129       through the `Result` type. In order to assist with error handling, a
8130       `try!` macro for unwrapping errors with an early return and a lint for
8131       unused results has been added. See #12039 for more information.
8132     * std: The `vec` module has been renamed to `slice`.
8133     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
8134       This will become the only growable vector in the future.
8135     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
8136       are now found at `std::io::BufferedReader` instead of
8137       `std::io::buffered::BufferedReader`.
8138     * std: `print` and `println` are no longer in the prelude, the `print!` and
8139       `println!` macros are intended to be used instead.
8140     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
8141       attempts to statically prevent cycles.
8142     * std: The standard distribution is adopting the policy of pushing failure
8143       to the user rather than failing in libraries. Many functions (such as
8144       `slice::last()`) now return `Option<T>` instead of `T` + failing.
8145     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
8146       deriving mode: `#[deriving(Show)]`.
8147     * std: `ToStr` is now implemented for all types implementing `Show`.
8148     * std: The formatting trait methods now take `&self` instead of `&T`
8149     * std: The `invert()` method on iterators has been renamed to `rev()`
8150     * std: `std::num` has seen a reduction in the genericity of its traits,
8151       consolidating functionality into a few core traits.
8152     * std: Backtraces are now printed on task failure if the environment
8153       variable `RUST_BACKTRACE` is present.
8154     * std: Naming conventions for iterators have been standardized. More details
8155       can be found on the wiki's style guide.
8156     * std: `eof()` has been removed from the `Reader` trait. Specific types may
8157       still implement the function.
8158     * std: Networking types are now cloneable to allow simultaneous reads/writes.
8159     * std: `assert_approx_eq!` has been removed
8160     * std: The `e` and `E` formatting specifiers for floats have been added to
8161       print them in exponential notation.
8162     * std: The `Times` trait has been removed
8163     * std: Indications of variance and opting out of builtin bounds is done
8164       through marker types in `std::kinds::marker` now
8165     * std: `hash` has been rewritten, `IterBytes` has been removed, and
8166       `#[deriving(Hash)]` is now possible.
8167     * std: `SharedChan` has been removed, `Sender` is now cloneable.
8168     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
8169     * std: `Chan::new` is now `channel()`.
8170     * std: A new synchronous channel type has been implemented.
8171     * std: A `select!` macro is now provided for selecting over `Receiver`s.
8172     * std: `hashmap` and `trie` have been moved to `libcollections`
8173     * std: `run` has been rolled into `io::process`
8174     * std: `assert_eq!` now uses `{}` instead of `{:?}`
8175     * std: The equality and comparison traits have seen some reorganization.
8176     * std: `rand` has moved to `librand`.
8177     * std: `to_{lower,upper}case` has been implemented for `char`.
8178     * std: Logging has been moved to `liblog`.
8179     * collections: `HashMap` has been rewritten for higher performance and less
8180       memory usage.
8181     * native: The default runtime is now `libnative`. If `libgreen` is desired,
8182       it can be booted manually. The runtime guide has more information and
8183       examples.
8184     * native: All I/O functionality except signals has been implemented.
8185     * green: Task spawning with `libgreen` has been optimized with stack caching
8186       and various trimming of code.
8187     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
8188     * sync: The `extra::sync` module has been updated to modern rust (and moved
8189       to the `sync` library), tweaking and improving various interfaces while
8190       dropping redundant functionality.
8191     * sync: A new `Barrier` type has been added to the `sync` library.
8192     * sync: An efficient mutex for native and green tasks has been implemented.
8193     * serialize: The `base64` module has seen some improvement. It treats
8194       newlines better, has non-string error values, and has seen general
8195       cleanup.
8196     * fourcc: A `fourcc!` macro was introduced
8197     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
8198       hexadecimal literal.
8199
8200   * Tooling
8201     * `rustpkg` has been deprecated and removed from the main repository. Its
8202       replacement, `cargo`, is under development.
8203     * Nightly builds of rust are now available
8204     * The memory usage of rustc has been improved many times throughout this
8205       release cycle.
8206     * The build process supports disabling rpath support for the rustc binary
8207       itself.
8208     * Code generation has improved in some cases, giving more information to the
8209       LLVM optimization passes to enable more extensive optimizations.
8210     * Debuginfo compatibility with lldb on OSX has been restored.
8211     * The master branch is now gated on an android bot, making building for
8212       android much more reliable.
8213     * Output flags have been centralized into one `--emit` flag.
8214     * Crate type flags have been centralized into one `--crate-type` flag.
8215     * Codegen flags have been consolidated behind a `-C` flag.
8216     * Linking against outdated crates now has improved error messages.
8217     * Error messages with lifetimes will often suggest how to annotate the
8218       function to fix the error.
8219     * Many more types are documented in the standard library, and new guides
8220       were written.
8221     * Many `rustdoc` improvements:
8222       * code blocks are syntax highlighted.
8223       * render standalone markdown files.
8224       * the --test flag tests all code blocks by default.
8225       * exported macros are displayed.
8226       * re-exported types have their documentation inlined at the location of the
8227         first re-export.
8228       * search works across crates that have been rendered to the same output
8229         directory.
8230
8231
8232 Version 0.9 (2014-01-09)
8233 ==========================
8234
8235    * ~1800 changes, numerous bugfixes
8236
8237    * Language
8238       * The `float` type has been removed. Use `f32` or `f64` instead.
8239       * A new facility for enabling experimental features (feature gating) has
8240         been added, using the crate-level `#[feature(foo)]` attribute.
8241       * Managed boxes (@) are now behind a feature gate
8242         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
8243         standard library's `Gc` or `Rc` types instead.
8244       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
8245       * Jumping back to the top of a loop is now done with `continue` instead of
8246         `loop`.
8247       * Strings can no longer be mutated through index assignment.
8248       * Raw strings can be created via the basic `r"foo"` syntax or with matched
8249         hash delimiters, as in `r###"foo"###`.
8250       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
8251         called once.
8252       * The `&fn` type is now written `|args| -> ret` to match the literal form.
8253       * `@fn`s have been removed.
8254       * `do` only works with procs in order to make it obvious what the cost
8255         of `do` is.
8256       * Single-element tuple-like structs can no longer be dereferenced to
8257         obtain the inner value. A more comprehensive solution for overloading
8258         the dereference operator will be provided in the future.
8259       * The `#[link(...)]` attribute has been replaced with
8260         `#[crate_id = "name#vers"]`.
8261       * Empty `impl`s must be terminated with empty braces and may not be
8262         terminated with a semicolon.
8263       * Keywords are no longer allowed as lifetime names; the `self` lifetime
8264         no longer has any special meaning.
8265       * The old `fmt!` string formatting macro has been removed.
8266       * `printf!` and `printfln!` (old-style formatting) removed in favor of
8267         `print!` and `println!`.
8268       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
8269       * The `extern mod foo (name = "bar")` syntax has been removed. Use
8270         `extern mod foo = "bar"` instead.
8271       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
8272       * Macros can have attributes.
8273       * Macros can expand to items with attributes.
8274       * Macros can expand to multiple items.
8275       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
8276       * Comments may be nested.
8277       * Values automatically coerce to trait objects they implement, without
8278         an explicit `as`.
8279       * Enum discriminants are no longer an entire word but as small as needed to
8280         contain all the variants. The `repr` attribute can be used to override
8281         the discriminant size, as in `#[repr(int)]` for integer-sized, and
8282         `#[repr(C)]` to match C enums.
8283       * Non-string literals are not allowed in attributes (they never worked).
8284       * The FFI now supports variadic functions.
8285       * Octal numeric literals, as in `0o7777`.
8286       * The `concat!` syntax extension performs compile-time string concatenation.
8287       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
8288         removed as Rust no longer uses segmented stacks.
8289       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
8290       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
8291         not `*`; ignoring remaining fields of a struct is also done with `..`,
8292         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
8293       * `rustc` supports the "win64" calling convention via `extern "win64"`.
8294       * `rustc` supports the "system" calling convention, which defaults to the
8295         preferred convention for the target platform, "stdcall" on 32-bit Windows,
8296         "C" elsewhere.
8297       * The `type_overflow` lint (default: warn) checks literals for overflow.
8298       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
8299       * The `attribute_usage` lint (default: warn) warns about unknown
8300         attributes.
8301       * The `unknown_features` lint (default: warn) warns about unknown
8302         feature gates.
8303       * The `dead_code` lint (default: warn) checks for dead code.
8304       * Rust libraries can be linked statically to one another
8305       * `#[link_args]` is behind the `link_args` feature gate.
8306       * Native libraries are now linked with `#[link(name = "foo")]`
8307       * Native libraries can be statically linked to a rust crate
8308         (`#[link(name = "foo", kind = "static")]`).
8309       * Native OS X frameworks are now officially supported
8310         (`#[link(name = "foo", kind = "framework")]`).
8311       * The `#[thread_local]` attribute creates thread-local (not task-local)
8312         variables. Currently behind the `thread_local` feature gate.
8313       * The `return` keyword may be used in closures.
8314       * Types that can be copied via a memcpy implement the `Pod` kind.
8315       * The `cfg` attribute can now be used on struct fields and enum variants.
8316
8317    * Libraries
8318       * std: The `option` and `result` API's have been overhauled to make them
8319         simpler, more consistent, and more composable.
8320       * std: The entire `std::io` module has been replaced with one that is
8321         more comprehensive and that properly interfaces with the underlying
8322         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
8323         implemented.
8324       * std: `io::util` contains a number of useful implementations of
8325         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
8326         `ZeroReader`, `TeeReader`.
8327       * std: The reference counted pointer type `extra::rc` moved into std.
8328       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
8329         just a wrapper around it).
8330       * std: The `Either` type has been removed.
8331       * std: `fmt::Default` can be implemented for any type to provide default
8332         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
8333       * std: The `rand` API continues to be tweaked.
8334       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
8335         on failure in gdb, is now named `rust_fail`.
8336       * std: The `each_key` and `each_value` methods on `HashMap` have been
8337         replaced by the `keys` and `values` iterators.
8338       * std: Functions dealing with type size and alignment have moved from the
8339         `sys` module to the `mem` module.
8340       * std: The `path` module was written and API changed.
8341       * std: `str::from_utf8` has been changed to cast instead of allocate.
8342       * std: `starts_with` and `ends_with` methods added to vectors via the
8343         `ImmutableEqVector` trait, which is in the prelude.
8344       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
8345         if the index is out of bounds.
8346       * std: Task failure no longer propagates between tasks, as the model was
8347         complex, expensive, and incompatible with thread-based tasks.
8348       * std: The `Any` type can be used for dynamic typing.
8349       * std: `~Any` can be passed to the `fail!` macro and retrieved via
8350         `task::try`.
8351       * std: Methods that produce iterators generally do not have an `_iter`
8352         suffix now.
8353       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
8354         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
8355       * std: `util::ignore` renamed to `prelude::drop`.
8356       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
8357         trait.
8358       * std: `vec::raw` has seen a lot of cleanup and API changes.
8359       * std: The standard library no longer includes any C++ code, and very
8360         minimal C, eliminating the dependency on libstdc++.
8361       * std: Runtime scheduling and I/O functionality has been factored out into
8362         extensible interfaces and is now implemented by two different crates:
8363         libnative, for native threading and I/O; and libgreen, for green threading
8364         and I/O. This paves the way for using the standard library in more limited
8365         embedded environments.
8366       * std: The `comm` module has been rewritten to be much faster, have a
8367         simpler, more consistent API, and to work for both native and green
8368         threading.
8369       * std: All libuv dependencies have been moved into the rustuv crate.
8370       * native: New implementations of runtime scheduling on top of OS threads.
8371       * native: New native implementations of TCP, UDP, file I/O, process spawning,
8372         and other I/O.
8373       * green: The green thread scheduler and message passing types are almost
8374         entirely lock-free.
8375       * extra: The `flatpipes` module had bitrotted and was removed.
8376       * extra: All crypto functions have been removed and Rust now has a policy of
8377         not reimplementing crypto in the standard library. In the future crypto
8378         will be provided by external crates with bindings to established libraries.
8379       * extra: `c_vec` has been modernized.
8380       * extra: The `sort` module has been removed. Use the `sort` method on
8381         mutable slices.
8382
8383    * Tooling
8384       * The `rust` and `rusti` commands have been removed, due to lack of
8385         maintenance.
8386       * `rustdoc` was completely rewritten.
8387       * `rustdoc` can test code examples in documentation.
8388       * `rustpkg` can test packages with the argument, 'test'.
8389       * `rustpkg` supports arbitrary dependencies, including C libraries.
8390       * `rustc`'s support for generating debug info is improved again.
8391       * `rustc` has better error reporting for unbalanced delimiters.
8392       * `rustc`'s JIT support was removed due to bitrot.
8393       * Executables and static libraries can be built with LTO (-Z lto)
8394       * `rustc` adds a `--dep-info` flag for communicating dependencies to
8395         build tools.
8396
8397
8398 Version 0.8 (2013-09-26)
8399 ============================
8400
8401    * ~2200 changes, numerous bugfixes
8402
8403    * Language
8404       * The `for` loop syntax has changed to work with the `Iterator` trait.
8405       * At long last, unwinding works on Windows.
8406       * Default methods are ready for use.
8407       * Many trait inheritance bugs fixed.
8408       * Owned and borrowed trait objects work more reliably.
8409       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
8410       * rustc can omit emission of code for the `debug!` macro if it is passed
8411         `--cfg ndebug`
8412       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
8413         for foo.rs, then foo/mod.rs, and will generate an error when both are
8414         present.
8415       * Strings no longer contain trailing nulls. The new `std::c_str` module
8416         provides new mechanisms for converting to C strings.
8417       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
8418       * The FFI has been overhauled such that foreign functions are called directly,
8419         instead of through a stack-switching wrapper.
8420       * Calling a foreign function must be done through a Rust function with the
8421         `#[fixed_stack_segment]` attribute.
8422       * The `externfn!` macro can be used to declare both a foreign function and
8423         a `#[fixed_stack_segment]` wrapper at once.
8424       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
8425       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
8426       * `priv` is disallowed everywhere except for struct fields and enum variants.
8427       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
8428       * `ref` bindings in irrefutable patterns work correctly now.
8429       * `char` is now prevented from containing invalid code points.
8430       * Casting to `bool` is no longer allowed.
8431       * `\0` is now accepted as an escape in chars and strings.
8432       * `yield` is a reserved keyword.
8433       * `typeof` is a reserved keyword.
8434       * Crates may be imported by URL with `extern mod foo = "url";`.
8435       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
8436       * Static vectors can be initialized with repeating elements,
8437         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
8438       * Static structs can be initialized with functional record update,
8439         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
8440       * `cfg!` can be used to conditionally execute code based on the crate
8441         configuration, similarly to `#[cfg(...)]`.
8442       * The `unnecessary_qualification` lint detects unneeded module
8443         prefixes (default: allow).
8444       * Arithmetic operations have been implemented on the SIMD types in
8445         `std::unstable::simd`.
8446       * Exchange allocation headers were removed, reducing memory usage.
8447       * `format!` implements a completely new, extensible, and higher-performance
8448         string formatting system. It will replace `fmt!`.
8449       * `print!` and `println!` write formatted strings (using the `format!`
8450         extension) to stdout.
8451       * `write!` and `writeln!` write formatted strings (using the `format!`
8452         extension) to the new Writers in `std::rt::io`.
8453       * The library section in which a function or static is placed may
8454         be specified with `#[link_section = "..."]`.
8455       * The `proto!` syntax extension for defining bounded message protocols
8456         was removed.
8457       * `macro_rules!` is hygienic for `let` declarations.
8458       * The `#[export_name]` attribute specifies the name of a symbol.
8459       * `unreachable!` can be used to indicate unreachable code, and fails
8460         if executed.
8461
8462    * Libraries
8463       * std: Transitioned to the new runtime, written in Rust.
8464       * std: Added an experimental I/O library, `rt::io`, based on the new
8465         runtime.
8466       * std: A new generic `range` function was added to the prelude, replacing
8467         `uint::range` and friends.
8468       * std: `range_rev` no longer exists. Since range is an iterator it can be
8469         reversed with `range(lo, hi).invert()`.
8470       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
8471         renamed to `unwrap_or`.
8472       * std: The `iterator` module was renamed to `iter`.
8473       * std: Integral types now support the `checked_add`, `checked_sub`, and
8474         `checked_mul` operations for detecting overflow.
8475       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
8476         consistency.
8477       * std: Methods are standardizing on conventions for casting methods:
8478         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
8479         and cheap casts.
8480       * std: The `CString` type in `c_str` provides new ways to convert to and
8481         from C strings.
8482       * std: `DoubleEndedIterator` can yield elements in two directions.
8483       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
8484         two splices.
8485       * std: `str::from_bytes` renamed to `str::from_utf8`.
8486       * std: `pop_opt` and `shift_opt` methods added to vectors.
8487       * std: The task-local data interface no longer uses @, and keys are
8488         no longer function pointers.
8489       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
8490       * std: Added `SharedPort` to `comm`.
8491       * std: `Eq` has a default method for `ne`; only `eq` is required
8492         in implementations.
8493       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
8494         is required in implementations.
8495       * std: `is_utf8` performance is improved, impacting many string functions.
8496       * std: `os::MemoryMap` provides cross-platform mmap.
8497       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
8498         are not 'in-bounds' are considered undefined.
8499       * std: Many freestanding functions in `vec` removed in favor of methods.
8500       * std: Many freestanding functions on scalar types removed in favor of
8501         methods.
8502       * std: Many options to task builders were removed since they don't make
8503         sense in the new scheduler design.
8504       * std: More containers implement `FromIterator` so can be created by the
8505         `collect` method.
8506       * std: More complete atomic types in `unstable::atomics`.
8507       * std: `comm::PortSet` removed.
8508       * std: Mutating methods in the `Set` and `Map` traits have been moved into
8509         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
8510         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
8511         default implementations.
8512       * std: Various `from_str` functions were removed in favor of a generic
8513         `from_str` which is available in the prelude.
8514       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
8515       * extra: `dlist`, the doubly-linked list was modernized.
8516       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
8517       * extra: Added `glob` module, replacing `std::os::glob`.
8518       * extra: `rope` was removed.
8519       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
8520       * extra: `net`, and `timer` were removed. The experimental replacements
8521         are `std::rt::io::net` and `std::rt::io::timer`.
8522       * extra: Iterators implemented for `SmallIntMap`.
8523       * extra: Iterators implemented for `Bitv` and `BitvSet`.
8524       * extra: `SmallIntSet` removed. Use `BitvSet`.
8525       * extra: Performance of JSON parsing greatly improved.
8526       * extra: `semver` updated to SemVer 2.0.0.
8527       * extra: `term` handles more terminals correctly.
8528       * extra: `dbg` module removed.
8529       * extra: `par` module removed.
8530       * extra: `future` was cleaned up, with some method renames.
8531       * extra: Most free functions in `getopts` were converted to methods.
8532
8533    * Other
8534       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
8535       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
8536         similarly to gcc's `--march` flag.
8537       * rustc's performance compiling small crates is much better.
8538       * rustpkg has received many improvements.
8539       * rustpkg supports git tags as package IDs.
8540       * rustpkg builds into target-specific directories so it can be used for
8541         cross-compiling.
8542       * The number of concurrent test tasks is controlled by the environment
8543         variable RUST_TEST_TASKS.
8544       * The test harness can now report metrics for benchmarks.
8545       * All tools have man pages.
8546       * Programs compiled with `--test` now support the `-h` and `--help` flags.
8547       * The runtime uses jemalloc for allocations.
8548       * Segmented stacks are temporarily disabled as part of the transition to
8549         the new runtime. Stack overflows are possible!
8550       * A new documentation backend, rustdoc_ng, is available for use. It is
8551         still invoked through the normal `rustdoc` command.
8552
8553
8554 Version 0.7 (2013-07-03)
8555 =======================
8556
8557    * ~2000 changes, numerous bugfixes
8558
8559    * Language
8560       * `impl`s no longer accept a visibility qualifier. Put them on methods
8561         instead.
8562       * The borrow checker has been rewritten with flow-sensitivity, fixing
8563         many bugs and inconveniences.
8564       * The `self` parameter no longer implicitly means `&'self self`,
8565         and can be explicitly marked with a lifetime.
8566       * Overloadable compound operators (`+=`, etc.) have been temporarily
8567         removed due to bugs.
8568       * The `for` loop protocol now requires `for`-iterators to return `bool`
8569         so they compose better.
8570       * The `Durable` trait is replaced with the `'static` bounds.
8571       * Trait default methods work more often.
8572       * Structs with the `#[packed]` attribute have byte alignment and
8573         no padding between fields.
8574       * Type parameters bound by `Copy` must now be copied explicitly with
8575         the `copy` keyword.
8576       * It is now illegal to move out of a dereferenced unsafe pointer.
8577       * `Option<~T>` is now represented as a nullable pointer.
8578       * `@mut` does dynamic borrow checks correctly.
8579       * The `main` function is only detected at the topmost level of the crate.
8580         The `#[main]` attribute is still valid anywhere.
8581       * Struct fields may no longer be mutable. Use inherited mutability.
8582       * The `#[no_send]` attribute makes a type that would otherwise be
8583         `Send`, not.
8584       * The `#[no_freeze]` attribute makes a type that would otherwise be
8585         `Freeze`, not.
8586       * Unbounded recursion will abort the process after reaching the limit
8587         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
8588       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
8589         are never implicitly copyable.
8590       * `#[static_assert]` makes compile-time assertions about static bools.
8591       * At long last, 'argument modes' no longer exist.
8592       * The rarely used `use mod` statement no longer exists.
8593
8594    * Syntax extensions
8595       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
8596         argument list.
8597       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
8598         `Rand`, `Zero` and `ToStr` can all be automatically derived with
8599         `#[deriving(...)]`.
8600       * The `bytes!` macro returns a vector of bytes for string, u8, char,
8601         and unsuffixed integer literals.
8602
8603    * Libraries
8604       * The `core` crate was renamed to `std`.
8605       * The `std` crate was renamed to `extra`.
8606       * More and improved documentation.
8607       * std: `iterator` module for external iterator objects.
8608       * Many old-style (internal, higher-order function) iterators replaced by
8609         implementations of `Iterator`.
8610       * std: Many old internal vector and string iterators,
8611         incl. `any`, `all`. removed.
8612       * std: The `finalize` method of `Drop` renamed to `drop`.
8613       * std: The `drop` method now takes `&mut self` instead of `&self`.
8614       * std: The prelude no longer re-exports any modules, only types and traits.
8615       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
8616         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
8617       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
8618         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
8619       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
8620         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
8621       * std: Many types implement `Clone`.
8622       * std: `path` type renamed to `Path`.
8623       * std: `mut` module and `Mut` type removed.
8624       * std: Many standalone functions removed in favor of methods and iterators
8625         in `vec`, `str`. In the future methods will also work as functions.
8626       * std: `reinterpret_cast` removed. Use `transmute`.
8627       * std: ascii string handling in `std::ascii`.
8628       * std: `Rand` is implemented for ~/@.
8629       * std: `run` module for spawning processes overhauled.
8630       * std: Various atomic types added to `unstable::atomic`.
8631       * std: Various types implement `Zero`.
8632       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
8633       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
8634       * std: Added `os::mkdir_recursive`.
8635       * std: Added `os::glob` function performs filesystems globs.
8636       * std: `FuzzyEq` renamed to `ApproxEq`.
8637       * std: `Map` now defines `pop` and `swap` methods.
8638       * std: `Cell` constructors converted to static methods.
8639       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
8640       * extra: `flate` module moved from `std` to `extra`.
8641       * extra: `fileinput` module for iterating over a series of files.
8642       * extra: `Complex` number type and `complex` module.
8643       * extra: `Rational` number type and `rational` module.
8644       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
8645       * extra: `term` uses terminfo now, is more correct.
8646       * extra: `arc` functions converted to methods.
8647       * extra: Implementation of fixed output size variations of SHA-2.
8648
8649    * Tooling
8650       * `unused_variables` lint mode for unused variables (default: warn).
8651       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
8652         (default: warn).
8653       * `unused_mut` lint mode for identifying unused `mut` qualifiers
8654         (default: warn).
8655       * `dead_assignment` lint mode for unread variables (default: warn).
8656       * `unnecessary_allocation` lint mode detects some heap allocations that are
8657         immediately borrowed so could be written without allocating (default: warn).
8658       * `missing_doc` lint mode (default: allow).
8659       * `unreachable_code` lint mode (default: warn).
8660       * The `rusti` command has been rewritten and a number of bugs addressed.
8661       * rustc outputs in color on more terminals.
8662       * rustc accepts a `--link-args` flag to pass arguments to the linker.
8663       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
8664       * Compiling with `-g` will make the binary record information about
8665         dynamic borrowcheck failures for debugging.
8666       * rustdoc has a nicer stylesheet.
8667       * Various improvements to rustdoc.
8668       * Improvements to rustpkg (see the detailed release notes).
8669
8670
8671 Version 0.6 (2013-04-03)
8672 ========================
8673
8674    * ~2100 changes, numerous bugfixes
8675
8676    * Syntax changes
8677       * The self type parameter in traits is now spelled `Self`
8678       * The `self` parameter in trait and impl methods must now be explicitly
8679         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
8680       * Static methods no longer require the `static` keyword and instead
8681         are distinguished by the lack of a `self` parameter
8682       * Replaced the `Durable` trait with the `'static` lifetime
8683       * The old closure type syntax with the trailing sigil has been
8684         removed in favor of the more consistent leading sigil
8685       * `super` is a keyword, and may be prefixed to paths
8686       * Trait bounds are separated with `+` instead of whitespace
8687       * Traits are implemented with `impl Trait for Type`
8688         instead of `impl Type: Trait`
8689       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
8690       * The `export` keyword has finally been removed
8691       * The `move` keyword has been removed (see "Semantic changes")
8692       * The interior mutability qualifier on vectors, `[mut T]`, has been
8693         removed. Use `&mut [T]`, etc.
8694       * `mut` is no longer valid in `~mut T`. Use inherited mutability
8695       * `fail` is no longer a keyword. Use `fail!()`
8696       * `assert` is no longer a keyword. Use `assert!()`
8697       * `log` is no longer a keyword. use `debug!`, etc.
8698       * 1-tuples may be represented as `(T,)`
8699       * Struct fields may no longer be `mut`. Use inherited mutability,
8700         `@mut T`, `core::mut` or `core::cell`
8701       * `extern mod { ... }` is no longer valid syntax for foreign
8702         function modules. Use extern blocks: `extern { ... }`
8703       * Newtype enums removed. Use tuple-structs.
8704       * Trait implementations no longer support visibility modifiers
8705       * Pattern matching over vectors improved and expanded
8706       * `const` renamed to `static` to correspond to lifetime name,
8707         and make room for future `static mut` unsafe mutable globals.
8708       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8709       * `Clone` implementations can be automatically generated with
8710         `#[deriving(Clone)]`
8711       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8712         instead of `foo as Bar`.
8713       * Fixed length vector types are now written as `[int, .. 3]`
8714         instead of `[int * 3]`.
8715       * Fixed length vector types can express the length as a constant
8716         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8717
8718    * Semantic changes
8719       * Types with owned pointers or custom destructors move by default,
8720         eliminating the `move` keyword
8721       * All foreign functions are considered unsafe
8722       * &mut is now unaliasable
8723       * Writes to borrowed @mut pointers are prevented dynamically
8724       * () has size 0
8725       * The name of the main function can be customized using #[main]
8726       * The default type of an inferred closure is &fn instead of @fn
8727       * `use` statements may no longer be "chained" - they cannot import
8728         identifiers imported by previous `use` statements
8729       * `use` statements are crate relative, importing from the "top"
8730         of the crate by default. Paths may be prefixed with `super::`
8731         or `self::` to change the search behavior.
8732       * Method visibility is inherited from the implementation declaration
8733       * Structural records have been removed
8734       * Many more types can be used in static items, including enums
8735         'static-lifetime pointers and vectors
8736       * Pattern matching over vectors improved and expanded
8737       * Typechecking of closure types has been overhauled to
8738         improve inference and eliminate unsoundness
8739       * Macros leave scope at the end of modules, unless that module is
8740         tagged with #[macro_escape]
8741
8742    * Libraries
8743       * Added big integers to `std::bigint`
8744       * Removed `core::oldcomm` module
8745       * Added pipe-based `core::comm` module
8746       * Numeric traits have been reorganized under `core::num`
8747       * `vec::slice` finally returns a slice
8748       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8749       * Containers reorganized around traits in `core::container`
8750       * `core::dvec` removed, `~[T]` is a drop-in replacement
8751       * `core::send_map` renamed to `core::hashmap`
8752       * `std::map` removed; replaced with `core::hashmap`
8753       * `std::treemap` reimplemented as an owned balanced tree
8754       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8755       * `core::trie` added as a fast ordered map for integer keys
8756       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8757       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8758         overload the comparison operators, whereas `TotalOrd` is used
8759         by certain container types
8760
8761    * Other
8762       * Replaced the 'cargo' package manager with 'rustpkg'
8763       * Added all-purpose 'rust' tool
8764       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8765       * rustc now *attempts* to offer spelling suggestions
8766       * Improved support for ARM and Android
8767       * Preliminary MIPS backend
8768       * Improved foreign function ABI implementation for x86, x86_64
8769       * Various memory usage improvements
8770       * Rust code may be embedded in foreign code under limited circumstances
8771       * Inline assembler supported by new asm!() syntax extension.
8772
8773
8774 Version 0.5 (2012-12-21)
8775 ===========================
8776
8777    * ~900 changes, numerous bugfixes
8778
8779    * Syntax changes
8780       * Removed `<-` move operator
8781       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8782       * Removed old fixed length vector syntax - `[T]/N`
8783       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8784       * Macros may now expand to items and statements
8785       * `a.b()` is always parsed as a method call, never as a field projection
8786       * `Eq` and `IterBytes` implementations can be automatically generated
8787         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8788       * Removed the special crate language for `.rc` files
8789       * Function arguments may consist of any irrefutable pattern
8790
8791    * Semantic changes
8792       * `&` and `~` pointers may point to objects
8793       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8794       * Enum variants may be structs
8795       * Destructors can be added to all nominal types with the Drop trait
8796       * Structs and nullary enum variants may be constants
8797       * Values that cannot be implicitly copied are now automatically moved
8798         without writing `move` explicitly
8799       * `&T` may now be coerced to `*T`
8800       * Coercions happen in `let` statements as well as function calls
8801       * `use` statements now take crate-relative paths
8802       * The module and type namespaces have been merged so that static
8803         method names can be resolved under the trait in which they are
8804         declared
8805
8806    * Improved support for language features
8807       * Trait inheritance works in many scenarios
8808       * More support for explicit self arguments in methods - `self`, `&self`
8809         `@self`, and `~self` all generally work as expected
8810       * Static methods work in more situations
8811       * Experimental: Traits may declare default methods for the implementations
8812         to use
8813
8814    * Libraries
8815       * New condition handling system in `core::condition`
8816       * Timsort added to `std::sort`
8817       * New priority queue, `std::priority_queue`
8818       * Pipes for serializable types, `std::flatpipes'
8819       * Serialization overhauled to be trait-based
8820       * Expanded `getopts` definitions
8821       * Moved futures to `std`
8822       * More functions are pure now
8823       * `core::comm` renamed to `oldcomm`. Still deprecated
8824       * `rustdoc` and `cargo` are libraries now
8825
8826    * Misc
8827       * Added a preliminary REPL, `rusti`
8828       * License changed from MIT to dual MIT/APL2
8829
8830
8831 Version 0.4 (2012-10-15)
8832 ==========================
8833
8834    * ~2000 changes, numerous bugfixes
8835
8836    * Syntax
8837       * All keywords are now strict and may not be used as identifiers anywhere
8838       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8839         'of', 'with', 'to', 'class'.
8840       * Classes are replaced with simpler structs
8841       * Explicit method self types
8842       * `ret` became `return` and `alt` became `match`
8843       * `import` is now `use`; `use is now `extern mod`
8844       * `extern mod { ... }` is now `extern { ... }`
8845       * `use mod` is the recommended way to import modules
8846       * `pub` and `priv` replace deprecated export lists
8847       * The syntax of `match` pattern arms now uses fat arrow (=>)
8848       * `main` no longer accepts an args vector; use `os::args` instead
8849
8850    * Semantics
8851       * Trait implementations are now coherent, ala Haskell typeclasses
8852       * Trait methods may be static
8853       * Argument modes are deprecated
8854       * Borrowed pointers are much more mature and recommended for use
8855       * Strings and vectors in the static region are stored in constant memory
8856       * Typestate was removed
8857       * Resolution rewritten to be more reliable
8858       * Support for 'dual-mode' data structures (freezing and thawing)
8859
8860    * Libraries
8861       * Most binary operators can now be overloaded via the traits in
8862         `core::ops'
8863       * `std::net::url` for representing URLs
8864       * Sendable hash maps in `core::send_map`
8865       * `core::task' gained a (currently unsafe) task-local storage API
8866
8867    * Concurrency
8868       * An efficient new intertask communication primitive called the pipe,
8869         along with a number of higher-level channel types, in `core::pipes`
8870       * `std::arc`, an atomically reference counted, immutable, shared memory
8871         type
8872       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8873       * Futures are now based on pipes and sendable
8874       * More robust linked task failure
8875       * Improved task builder API
8876
8877    * Other
8878       * Improved error reporting
8879       * Preliminary JIT support
8880       * Preliminary work on precise GC
8881       * Extensive architectural improvements to rustc
8882       * Begun a transition away from buggy C++-based reflection (shape) code to
8883         Rust-based (visitor) code
8884       * All hash functions and tables converted to secure, randomized SipHash
8885
8886
8887 Version 0.3  (2012-07-12)
8888 ========================
8889
8890    * ~1900 changes, numerous bugfixes
8891
8892    * New coding conveniences
8893       * Integer-literal suffix inference
8894       * Per-item control over warnings, errors
8895       * #[cfg(windows)] and #[cfg(unix)] attributes
8896       * Documentation comments
8897       * More compact closure syntax
8898       * 'do' expressions for treating higher-order functions as
8899         control structures
8900       * *-patterns (wildcard extended to all constructor fields)
8901
8902    * Semantic cleanup
8903       * Name resolution pass and exhaustiveness checker rewritten
8904       * Region pointers and borrow checking supersede alias
8905         analysis
8906       * Init-ness checking is now provided by a region-based liveness
8907         pass instead of the typestate pass; same for last-use analysis
8908       * Extensive work on region pointers
8909
8910    * Experimental new language features
8911       * Slices and fixed-size, interior-allocated vectors
8912       * #!-comments for lang versioning, shell execution
8913       * Destructors and iface implementation for classes;
8914         type-parameterized classes and class methods
8915       * 'const' type kind for types that can be used to implement
8916         shared-memory concurrency patterns
8917
8918    * Type reflection
8919
8920    * Removal of various obsolete features
8921       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8922                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8923
8924       * Constructs: do-while loops ('do' repurposed), fn binding,
8925                     resources (replaced by destructors)
8926
8927    * Compiler reorganization
8928       * Syntax-layer of compiler split into separate crate
8929       * Clang (from LLVM project) integrated into build
8930       * Typechecker split into sub-modules
8931
8932    * New library code
8933       * New time functions
8934       * Extension methods for many built-in types
8935       * Arc: atomic-refcount read-only / exclusive-use shared cells
8936       * Par: parallel map and search routines
8937       * Extensive work on libuv interface
8938       * Much vector code moved to libraries
8939       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8940         #include, #include_str, #include_bin
8941
8942    * Tool improvements
8943       * Cargo automatically resolves dependencies
8944
8945
8946 Version 0.2  (2012-03-29)
8947 =========================
8948
8949    * >1500 changes, numerous bugfixes
8950
8951    * New docs and doc tooling
8952
8953    * New port: FreeBSD x86_64
8954
8955    * Compilation model enhancements
8956       * Generics now specialized, multiply instantiated
8957       * Functions now inlined across separate crates
8958
8959    * Scheduling, stack and threading fixes
8960       * Noticeably improved message-passing performance
8961       * Explicit schedulers
8962       * Callbacks from C
8963       * Helgrind clean
8964
8965    * Experimental new language features
8966       * Operator overloading
8967       * Region pointers
8968       * Classes
8969
8970    * Various language extensions
8971       * C-callback function types: 'crust fn ...'
8972       * Infinite-loop construct: 'loop { ... }'
8973       * Shorten 'mutable' to 'mut'
8974       * Required mutable-local qualifier: 'let mut ...'
8975       * Basic glob-exporting: 'export foo::*;'
8976       * Alt now exhaustive, 'alt check' for runtime-checked
8977       * Block-function form of 'for' loop, with 'break' and 'ret'.
8978
8979    * New library code
8980       * AST quasi-quote syntax extension
8981       * Revived libuv interface
8982       * New modules: core::{future, iter}, std::arena
8983       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8984       * Extensive cleanup, regularization in libstd, libcore
8985
8986
8987 Version 0.1  (2012-01-20)
8988 ===============================
8989
8990    * Most language features work, including:
8991       * Unique pointers, unique closures, move semantics
8992       * Interface-constrained generics
8993       * Static interface dispatch
8994       * Stack growth
8995       * Multithread task scheduling
8996       * Typestate predicates
8997       * Failure unwinding, destructors
8998       * Pattern matching and destructuring assignment
8999       * Lightweight block-lambda syntax
9000       * Preliminary macro-by-example
9001
9002    * Compiler works with the following configurations:
9003       * Linux: x86 and x86_64 hosts and targets
9004       * macOS: x86 and x86_64 hosts and targets
9005       * Windows: x86 hosts and targets
9006
9007    * Cross compilation / multi-target configuration supported.
9008
9009    * Preliminary API-documentation and package-management tools included.
9010
9011 Known issues:
9012
9013    * Documentation is incomplete.
9014
9015    * Performance is below intended target.
9016
9017    * Standard library APIs are subject to extensive change, reorganization.
9018
9019    * Language-level versioning is not yet operational - future code will
9020      break unexpectedly.