RELEASES.md

   1 Version 1.36.0 (2019-07-04)
   2 ==========================
   3
   4 Language
   5 --------
   6 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
   7 - [The order of traits in trait objects no longer affects the semantics of that
   8   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
   9   `dyn fmt::Debug + Send`, where this was previously not the case.
  10
  11 Libraries
  12 ---------
  13 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
  14 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
  15 - [`mem::needs_drop` is now available as a const fn.][60364]
  16 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
  17 - [`String` now implements `BorrowMut<str>`.][60404]
  18 - [`io::Cursor` now implements `Default`.][60234]
  19 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
  20 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
  21   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
  22   environment has access to heap memory allocation.
  23 - [`String` now implements `From<&String>`.][59825]
  24 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
  25   return a tuple of each argument when there is multiple arguments.
  26 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
  27   not used.][59648]
  28
  29 Stabilized APIs
  30 ---------------
  31 - [`VecDeque::rotate_left`]
  32 - [`VecDeque::rotate_right`]
  33 - [`Iterator::copied`]
  34 - [`io::IoSlice`]
  35 - [`io::IoSliceMut`]
  36 - [`Read::read_vectored`]
  37 - [`Write::write_vectored`]
  38 - [`str::as_mut_ptr`]
  39 - [`mem::MaybeUninit`]
  40 - [`pointer::align_offset`]
  41 - [`future::Future`]
  42 - [`task::Context`]
  43 - [`task::RawWaker`]
  44 - [`task::RawWakerVTable`]
  45 - [`task::Waker`]
  46 - [`task::Poll`]
  47
  48 Cargo
  49 -----
  50 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
  51 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
  52
  53 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
  54
  55 Clippy
  56 ------
  57 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
  58
  59 Misc
  60 ----
  61
  62 Compatibility Notes
  63 -------------------
  64 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
  65   longer recommended, and will be deprecated in 1.39.0.
  66
  67 [60318]: https://github.com/rust-lang/rust/pull/60318/
  68 [60364]: https://github.com/rust-lang/rust/pull/60364/
  69 [60370]: https://github.com/rust-lang/rust/pull/60370/
  70 [60404]: https://github.com/rust-lang/rust/pull/60404/
  71 [60234]: https://github.com/rust-lang/rust/pull/60234/
  72 [60244]: https://github.com/rust-lang/rust/pull/60244/
  73 [58623]: https://github.com/rust-lang/rust/pull/58623/
  74 [59648]: https://github.com/rust-lang/rust/pull/59648/
  75 [59675]: https://github.com/rust-lang/rust/pull/59675/
  76 [59825]: https://github.com/rust-lang/rust/pull/59825/
  77 [59826]: https://github.com/rust-lang/rust/pull/59826/
  78 [59445]: https://github.com/rust-lang/rust/pull/59445/
  79 [59114]: https://github.com/rust-lang/rust/pull/59114/
  80 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
  81 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
  82 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
  83 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
  84 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
  85 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
  86 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
  87 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
  88 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
  89 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
  90 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
  91 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
  92 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
  93 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
  94 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
  95 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
  96 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
  97 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
  98 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
  99 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 100
 101
 102 Version 1.35.0 (2019-05-23)
 103 ==========================
 104
 105 Language
 106 --------
 107 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 108   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 109 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 110   ```rust
 111   unsafe fn call_unsafe(func: unsafe fn()) {
 112       func()
 113   }
 114
 115   pub fn main() {
 116       unsafe { call_unsafe(|| {}); }
 117   }
 118   ```
 119
 120
 121 Compiler
 122 --------
 123 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 124   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 125 - [Added the `wasm32-unknown-wasi` target.][59464]
 126
 127
 128 Libraries
 129 ---------
 130 - [`Thread` will now show its ID in `Debug` output.][59460]
 131 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
 132 - [`alloc::System` now implements `Default`.][59451]
 133 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
 134   last field.][59076]
 135 - [`char::{ToLowercase, ToUppercase}` now
 136   implement `ExactSizeIterator`.][58778]
 137 - [All `NonZero` numeric types now implement `FromStr`.][58717]
 138 - [Removed the `Read` trait bounds
 139   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
 140 - [You can now call the `dbg!` macro without any parameters to print the file
 141   and line where it is called.][57847]
 142 - [In place ASCII case conversions are now up to 4× faster.][59283]
 143   e.g. `str::make_ascii_lowercase`
 144 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
 145   and `Send`.][58369]
 146
 147 Stabilized APIs
 148 ---------------
 149 - [`f32::copysign`]
 150 - [`f64::copysign`]
 151 - [`RefCell::replace_with`]
 152 - [`RefCell::map_split`]
 153 - [`ptr::hash`]
 154 - [`Range::contains`]
 155 - [`RangeFrom::contains`]
 156 - [`RangeTo::contains`]
 157 - [`RangeInclusive::contains`]
 158 - [`RangeToInclusive::contains`]
 159 - [`Option::copied`]
 160
 161 Cargo
 162 -----
 163 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
 164   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
 165   platform specific.
 166
 167 Misc
 168 ----
 169 - [The Rust toolchain is now available natively for musl based distros.][58575]
 170
 171 [59460]: https://github.com/rust-lang/rust/pull/59460/
 172 [59464]: https://github.com/rust-lang/rust/pull/59464/
 173 [59500]: https://github.com/rust-lang/rust/pull/59500/
 174 [59512]: https://github.com/rust-lang/rust/pull/59512/
 175 [59580]: https://github.com/rust-lang/rust/pull/59580/
 176 [59283]: https://github.com/rust-lang/rust/pull/59283/
 177 [59451]: https://github.com/rust-lang/rust/pull/59451/
 178 [59076]: https://github.com/rust-lang/rust/pull/59076/
 179 [58778]: https://github.com/rust-lang/rust/pull/58778/
 180 [58717]: https://github.com/rust-lang/rust/pull/58717/
 181 [58369]: https://github.com/rust-lang/rust/pull/58369/
 182 [58423]: https://github.com/rust-lang/rust/pull/58423/
 183 [58080]: https://github.com/rust-lang/rust/pull/58080/
 184 [57847]: https://github.com/rust-lang/rust/pull/57847/
 185 [58575]: https://github.com/rust-lang/rust/pull/58575
 186 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
 187 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
 188 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
 189 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
 190 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
 191 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
 192 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
 193 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
 194 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
 195 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
 196 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
 197 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
 198
 199 Version 1.34.2 (2019-05-14)
 200 ===========================
 201
 202 * [Destabilize the `Error::type_id` function due to a security
 203    vulnerability][60785] ([CVE-2019-12083])
 204
 205 [60785]: https://github.com/rust-lang/rust/pull/60785
 206 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
 207
 208 Version 1.34.1 (2019-04-25)
 209 ===========================
 210
 211 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
 212 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
 213 * [Fix Clippy panic when checking some macros][clippy/3805]
 214
 215 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
 216 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
 217 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
 218
 219 Version 1.34.0 (2019-04-11)
 220 ==========================
 221
 222 Language
 223 --------
 224 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
 225   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
 226   but had no effect.
 227 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
 228   `#[attr{}]` procedural macros.][57367]
 229 - [You can now write `extern crate self as foo;`][57407] to import your
 230   crate's root into the extern prelude.
 231
 232
 233 Compiler
 234 --------
 235 - [You can now target `riscv64imac-unknown-none-elf` and
 236   `riscv64gc-unknown-none-elf`.][58406]
 237 - [You can now enable linker plugin LTO optimisations with
 238   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
 239   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
 240   boundaries.
 241 - [You can now target `powerpc64-unknown-freebsd`.][57809]
 242
 243
 244 Libraries
 245 ---------
 246 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
 247   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
 248   the `Hash` trait to create an iterator.
 249 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
 250   methods.][58421] Most notably you no longer require the `Ord` trait to create
 251   an iterator.
 252 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
 253   for all numeric types.][58044]
 254 - [Indexing a `str` is now generic over all types that
 255   implement `SliceIndex<str>`.][57604]
 256 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
 257   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
 258   produce a warning if their returning type is unused.
 259 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
 260   `overflowing_pow` are now available for all numeric types.][57873] These are
 261   equivalent to methods such as `wrapping_add` for the `pow` operation.
 262
 263
 264 Stabilized APIs
 265 ---------------
 266
 267 #### std & core
 268 * [`Any::type_id`]
 269 * [`Error::type_id`]
 270 * [`atomic::AtomicI16`]
 271 * [`atomic::AtomicI32`]
 272 * [`atomic::AtomicI64`]
 273 * [`atomic::AtomicI8`]
 274 * [`atomic::AtomicU16`]
 275 * [`atomic::AtomicU32`]
 276 * [`atomic::AtomicU64`]
 277 * [`atomic::AtomicU8`]
 278 * [`convert::Infallible`]
 279 * [`convert::TryFrom`]
 280 * [`convert::TryInto`]
 281 * [`iter::from_fn`]
 282 * [`iter::successors`]
 283 * [`num::NonZeroI128`]
 284 * [`num::NonZeroI16`]
 285 * [`num::NonZeroI32`]
 286 * [`num::NonZeroI64`]
 287 * [`num::NonZeroI8`]
 288 * [`num::NonZeroIsize`]
 289 * [`slice::sort_by_cached_key`]
 290 * [`str::escape_debug`]
 291 * [`str::escape_default`]
 292 * [`str::escape_unicode`]
 293 * [`str::split_ascii_whitespace`]
 294
 295 #### std
 296 * [`Instant::checked_add`]
 297 * [`Instant::checked_sub`]
 298 * [`SystemTime::checked_add`]
 299 * [`SystemTime::checked_sub`]
 300
 301 Cargo
 302 -----
 303 - [You can now use alternative registries to crates.io.][cargo/6654]
 304
 305 Misc
 306 ----
 307 - [You can now use the `?` operator in your documentation tests without manually
 308   adding `fn main() -> Result<(), _> {}`.][56470]
 309
 310 Compatibility Notes
 311 -------------------
 312 - [`Command::before_exec` is being replaced by the unsafe method
 313   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
 314 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
 315   can now use `const` functions in `static` variables.
 316
 317 [58370]: https://github.com/rust-lang/rust/pull/58370/
 318 [58406]: https://github.com/rust-lang/rust/pull/58406/
 319 [58421]: https://github.com/rust-lang/rust/pull/58421/
 320 [58166]: https://github.com/rust-lang/rust/pull/58166/
 321 [58044]: https://github.com/rust-lang/rust/pull/58044/
 322 [58057]: https://github.com/rust-lang/rust/pull/58057/
 323 [58059]: https://github.com/rust-lang/rust/pull/58059/
 324 [57809]: https://github.com/rust-lang/rust/pull/57809/
 325 [57873]: https://github.com/rust-lang/rust/pull/57873/
 326 [57604]: https://github.com/rust-lang/rust/pull/57604/
 327 [57367]: https://github.com/rust-lang/rust/pull/57367/
 328 [57407]: https://github.com/rust-lang/rust/pull/57407/
 329 [57425]: https://github.com/rust-lang/rust/pull/57425/
 330 [57106]: https://github.com/rust-lang/rust/pull/57106/
 331 [56470]: https://github.com/rust-lang/rust/pull/56470/
 332 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
 333 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
 334 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
 335 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
 336 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
 337 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
 338 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
 339 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
 340 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
 341 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
 342 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
 343 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
 344 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
 345 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
 346 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
 347 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
 348 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
 349 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
 350 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
 351 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
 352 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
 353 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
 354 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
 355 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
 356 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
 357 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
 358 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
 359 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
 360 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
 361 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
 362 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
 363
 364
 365 Version 1.33.0 (2019-02-28)
 366 ==========================
 367
 368 Language
 369 --------
 370 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
 371   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
 372 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
 373   E.g. You can have match statement on a `u8` that covers `0..=255` and
 374   you would no longer be required to have a `_ => unreachable!()` case.
 375 - [You can now have multiple patterns in `if let` and `while let`
 376   expressions.][57532] You can do this with the same syntax as a `match`
 377   expression. E.g.
 378   ```rust
 379   enum Creature {
 380       Crab(String),
 381       Lobster(String),
 382       Person(String),
 383   }
 384
 385   fn main() {
 386       let state = Creature::Crab("Ferris");
 387
 388       if let Creature::Crab(name) | Creature::Person(name) = state {
 389           println!("This creature's name is: {}", name);
 390       }
 391   }
 392   ```
 393 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
 394   this feature will by default produce a warning as this behaviour can be
 395   unintuitive. E.g. `if let _ = 5 {}`
 396 - [You can now use `let` bindings, assignments, expression statements,
 397   and irrefutable pattern destructuring in const functions.][57175]
 398 - [You can now call unsafe const functions.][57067] E.g.
 399   ```rust
 400   const unsafe fn foo() -> i32 { 5 }
 401   const fn bar() -> i32 {
 402       unsafe { foo() }
 403   }
 404   ```
 405 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
 406   E.g. `#[cfg_attr(all(), must_use, optimize)]`
 407 - [You can now specify a specific alignment with the `#[repr(packed)]`
 408   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
 409   with an alignment of 2 bytes and a size of 6 bytes.
 410 - [You can now import an item from a module as an `_`.][56303] This allows you to
 411   import a trait's impls, and not have the name in the namespace. E.g.
 412   ```rust
 413   use std::io::Read as _;
 414
 415   // Allowed as there is only one `Read` in the module.
 416   pub trait Read {}
 417   ```
 418 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
 419
 420 Compiler
 421 --------
 422 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
 423   command line argument.][56351]
 424 - [The mininum required LLVM version has been bumped to 6.0.][56642]
 425 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
 426 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
 427   tier 2 support.][57130] Visit the [platform support][platform-support] page for
 428   information on Rust's platform support.
 429 - [Added support for the `thumbv7neon-linux-androideabi` and
 430   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
 431 - [Added support for the `x86_64-unknown-uefi` target.][56769]
 432
 433 Libraries
 434 ---------
 435 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
 436   functions for all numeric types.][57566]
 437 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
 438   are now `const` functions for all numeric types.][57105]
 439 - [The methods `is_positive` and `is_negative` are now `const` functions for
 440   all signed numeric types.][57105]
 441 - [The `get` method for all `NonZero` types is now `const`.][57167]
 442 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
 443   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
 444   numeric types.][57234]
 445 - [`Ipv4Addr::new` is now a `const` function][57234]
 446
 447 Stabilized APIs
 448 ---------------
 449 - [`unix::FileExt::read_exact_at`]
 450 - [`unix::FileExt::write_all_at`]
 451 - [`Option::transpose`]
 452 - [`Result::transpose`]
 453 - [`convert::identity`]
 454 - [`pin::Pin`]
 455 - [`marker::Unpin`]
 456 - [`marker::PhantomPinned`]
 457 - [`Vec::resize_with`]
 458 - [`VecDeque::resize_with`]
 459 - [`Duration::as_millis`]
 460 - [`Duration::as_micros`]
 461 - [`Duration::as_nanos`]
 462
 463
 464 Cargo
 465 -----
 466 - [You can now publish crates that require a feature flag to compile with
 467   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
 468 - [Cargo should now rebuild a crate if a file was modified during the initial
 469   build.][cargo/6484]
 470
 471 Compatibility Notes
 472 -------------------
 473 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
 474   are now deprecated in the standard library, and their usage will now produce a warning.
 475   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
 476   methods instead.
 477 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
 478   downcasting.
 479 - [Libtest no longer creates a new thread for each test when
 480   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
 481
 482 [55982]: https://github.com/rust-lang/rust/pull/55982/
 483 [56243]: https://github.com/rust-lang/rust/pull/56243
 484 [56303]: https://github.com/rust-lang/rust/pull/56303/
 485 [56351]: https://github.com/rust-lang/rust/pull/56351/
 486 [56362]: https://github.com/rust-lang/rust/pull/56362
 487 [56642]: https://github.com/rust-lang/rust/pull/56642/
 488 [56769]: https://github.com/rust-lang/rust/pull/56769/
 489 [56805]: https://github.com/rust-lang/rust/pull/56805
 490 [56947]: https://github.com/rust-lang/rust/pull/56947/
 491 [57049]: https://github.com/rust-lang/rust/pull/57049/
 492 [57067]: https://github.com/rust-lang/rust/pull/57067/
 493 [57105]: https://github.com/rust-lang/rust/pull/57105
 494 [57130]: https://github.com/rust-lang/rust/pull/57130/
 495 [57167]: https://github.com/rust-lang/rust/pull/57167/
 496 [57175]: https://github.com/rust-lang/rust/pull/57175/
 497 [57234]: https://github.com/rust-lang/rust/pull/57234/
 498 [57332]: https://github.com/rust-lang/rust/pull/57332/
 499 [57465]: https://github.com/rust-lang/rust/pull/57465/
 500 [57532]: https://github.com/rust-lang/rust/pull/57532/
 501 [57535]: https://github.com/rust-lang/rust/pull/57535/
 502 [57566]: https://github.com/rust-lang/rust/pull/57566/
 503 [57615]: https://github.com/rust-lang/rust/pull/57615/
 504 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
 505 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
 506 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
 507 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
 508 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
 509 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
 510 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
 511 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
 512 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
 513 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
 514 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
 515 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
 516 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
 517 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
 518 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
 519 [platform-support]: https://forge.rust-lang.org/platform-support.html
 520
 521 Version 1.32.0 (2019-01-17)
 522 ==========================
 523
 524 Language
 525 --------
 526 #### 2018 edition
 527 - [You can now use the `?` operator in macro definitions.][56245] The `?`
 528   operator allows you to specify zero or one repetitions similar to the `*` and
 529   `+` operators.
 530 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
 531   now always resolve to the item (`enum`, `struct`, etc.) available in the
 532   module if present, before resolving to a external crate or an item the prelude.][56759]
 533   E.g.
 534   ```rust
 535   enum Color { Red, Green, Blue }
 536
 537   use Color::*;
 538   ```
 539
 540 #### All editions
 541 - [You can now match against `PhantomData<T>` types.][55837]
 542 - [You can now match against literals in macros with the `literal`
 543   specifier.][56072] This will match against a literal of any type.
 544   E.g. `1`, `'A'`, `"Hello World"`
 545 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
 546   ```rust
 547   struct Point(i32, i32);
 548
 549   impl Point {
 550       pub fn new(x: i32, y: i32) -> Self {
 551           Self(x, y)
 552       }
 553
 554       pub fn is_origin(&self) -> bool {
 555           match self {
 556               Self(0, 0) => true,
 557               _ => false,
 558           }
 559       }
 560   }
 561   ```
 562 - [Self can also now be used in type definitions.][56366] E.g.
 563   ```rust
 564   enum List<T>
 565   where
 566       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
 567   {
 568       Nil,
 569       Cons(T, Box<Self>) // likewise here
 570   }
 571   ```
 572 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
 573   a `impl Trait` or `dyn Trait` is returned and unused in the program.
 574
 575 Compiler
 576 --------
 577 - [The default allocator has changed from jemalloc to the default allocator on
 578   your system.][55238] The compiler itself on Linux & macOS will still use
 579   jemalloc, but programs compiled with it will use the system allocator.
 580 - [Added the `aarch64-pc-windows-msvc` target.][55702]
 581
 582 Libraries
 583 ---------
 584 - [`PathBuf` now implements `FromStr`.][55148]
 585 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
 586 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
 587   easily debug expressions in your rust program. E.g.
 588   ```rust
 589   let a = 2;
 590   let b = dbg!(a * 2) + 1;
 591   //      ^-- prints: [src/main.rs:4] a * 2 = 4
 592   assert_eq!(b, 5);
 593   ```
 594
 595 The following APIs are now `const` functions and can be used in a
 596 `const` context.
 597
 598 - [`Cell::as_ptr`]
 599 - [`UnsafeCell::get`]
 600 - [`char::is_ascii`]
 601 - [`iter::empty`]
 602 - [`ManuallyDrop::new`]
 603 - [`ManuallyDrop::into_inner`]
 604 - [`RangeInclusive::start`]
 605 - [`RangeInclusive::end`]
 606 - [`NonNull::as_ptr`]
 607 - [`slice::as_ptr`]
 608 - [`str::as_ptr`]
 609 - [`Duration::as_secs`]
 610 - [`Duration::subsec_millis`]
 611 - [`Duration::subsec_micros`]
 612 - [`Duration::subsec_nanos`]
 613 - [`CStr::as_ptr`]
 614 - [`Ipv4Addr::is_unspecified`]
 615 - [`Ipv6Addr::new`]
 616 - [`Ipv6Addr::octets`]
 617
 618 Stabilized APIs
 619 ---------------
 620 - [`i8::to_be_bytes`]
 621 - [`i8::to_le_bytes`]
 622 - [`i8::to_ne_bytes`]
 623 - [`i8::from_be_bytes`]
 624 - [`i8::from_le_bytes`]
 625 - [`i8::from_ne_bytes`]
 626 - [`i16::to_be_bytes`]
 627 - [`i16::to_le_bytes`]
 628 - [`i16::to_ne_bytes`]
 629 - [`i16::from_be_bytes`]
 630 - [`i16::from_le_bytes`]
 631 - [`i16::from_ne_bytes`]
 632 - [`i32::to_be_bytes`]
 633 - [`i32::to_le_bytes`]
 634 - [`i32::to_ne_bytes`]
 635 - [`i32::from_be_bytes`]
 636 - [`i32::from_le_bytes`]
 637 - [`i32::from_ne_bytes`]
 638 - [`i64::to_be_bytes`]
 639 - [`i64::to_le_bytes`]
 640 - [`i64::to_ne_bytes`]
 641 - [`i64::from_be_bytes`]
 642 - [`i64::from_le_bytes`]
 643 - [`i64::from_ne_bytes`]
 644 - [`i128::to_be_bytes`]
 645 - [`i128::to_le_bytes`]
 646 - [`i128::to_ne_bytes`]
 647 - [`i128::from_be_bytes`]
 648 - [`i128::from_le_bytes`]
 649 - [`i128::from_ne_bytes`]
 650 - [`isize::to_be_bytes`]
 651 - [`isize::to_le_bytes`]
 652 - [`isize::to_ne_bytes`]
 653 - [`isize::from_be_bytes`]
 654 - [`isize::from_le_bytes`]
 655 - [`isize::from_ne_bytes`]
 656 - [`u8::to_be_bytes`]
 657 - [`u8::to_le_bytes`]
 658 - [`u8::to_ne_bytes`]
 659 - [`u8::from_be_bytes`]
 660 - [`u8::from_le_bytes`]
 661 - [`u8::from_ne_bytes`]
 662 - [`u16::to_be_bytes`]
 663 - [`u16::to_le_bytes`]
 664 - [`u16::to_ne_bytes`]
 665 - [`u16::from_be_bytes`]
 666 - [`u16::from_le_bytes`]
 667 - [`u16::from_ne_bytes`]
 668 - [`u32::to_be_bytes`]
 669 - [`u32::to_le_bytes`]
 670 - [`u32::to_ne_bytes`]
 671 - [`u32::from_be_bytes`]
 672 - [`u32::from_le_bytes`]
 673 - [`u32::from_ne_bytes`]
 674 - [`u64::to_be_bytes`]
 675 - [`u64::to_le_bytes`]
 676 - [`u64::to_ne_bytes`]
 677 - [`u64::from_be_bytes`]
 678 - [`u64::from_le_bytes`]
 679 - [`u64::from_ne_bytes`]
 680 - [`u128::to_be_bytes`]
 681 - [`u128::to_le_bytes`]
 682 - [`u128::to_ne_bytes`]
 683 - [`u128::from_be_bytes`]
 684 - [`u128::from_le_bytes`]
 685 - [`u128::from_ne_bytes`]
 686 - [`usize::to_be_bytes`]
 687 - [`usize::to_le_bytes`]
 688 - [`usize::to_ne_bytes`]
 689 - [`usize::from_be_bytes`]
 690 - [`usize::from_le_bytes`]
 691 - [`usize::from_ne_bytes`]
 692
 693 Cargo
 694 -----
 695 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
 696 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
 697
 698 Misc
 699 ----
 700 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
 701
 702 Compatibility Notes
 703 -------------------
 704 - [The argument types for AVX's
 705   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
 706   been changed from `*const` to `*mut` as the previous implementation
 707   was unsound.
 708
 709
 710 [55148]: https://github.com/rust-lang/rust/pull/55148/
 711 [55238]: https://github.com/rust-lang/rust/pull/55238/
 712 [55280]: https://github.com/rust-lang/rust/pull/55280/
 713 [55610]: https://github.com/rust-lang/rust/pull/55610/
 714 [55663]: https://github.com/rust-lang/rust/pull/55663/
 715 [55702]: https://github.com/rust-lang/rust/pull/55702/
 716 [55837]: https://github.com/rust-lang/rust/pull/55837/
 717 [55843]: https://github.com/rust-lang/rust/pull/55843/
 718 [56072]: https://github.com/rust-lang/rust/pull/56072/
 719 [56245]: https://github.com/rust-lang/rust/pull/56245/
 720 [56365]: https://github.com/rust-lang/rust/pull/56365/
 721 [56366]: https://github.com/rust-lang/rust/pull/56366/
 722 [56395]: https://github.com/rust-lang/rust/pull/56395/
 723 [56759]: https://github.com/rust-lang/rust/pull/56759/
 724 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
 725 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
 726 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
 727 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
 728 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
 729 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
 730 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
 731 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
 732 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
 733 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
 734 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
 735 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
 736 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
 737 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
 738 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
 739 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
 740 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
 741 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
 742 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
 743 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
 744 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
 745 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
 746 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
 747 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
 748 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
 749 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
 750 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
 751 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
 752 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
 753 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
 754 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
 755 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
 756 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
 757 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
 758 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
 759 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
 760 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
 761 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
 762 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
 763 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
 764 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
 765 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
 766 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
 767 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
 768 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
 769 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
 770 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
 771 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
 772 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
 773 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
 774 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
 775 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
 776 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
 777 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
 778 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
 779 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
 780 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
 781 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
 782 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
 783 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
 784 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
 785 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
 786 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
 787 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
 788 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
 789 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
 790 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
 791 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
 792 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
 793 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
 794 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
 795 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
 796 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
 797 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
 798 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
 799 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
 800 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
 801 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
 802 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
 803 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
 804 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
 805 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
 806 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
 807 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
 808 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
 809 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
 810 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
 811 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
 812 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
 813 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
 814 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
 815 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
 816 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
 817
 818
 819 Version 1.31.1 (2018-12-20)
 820 ===========================
 821
 822 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
 823 - [Fix broken go-to-definition in RLS][rls/1171]
 824 - [Fix infinite loop on hover in RLS][rls/1170]
 825
 826 [56562]: https://github.com/rust-lang/rust/pull/56562
 827 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
 828 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
 829
 830 Version 1.31.0 (2018-12-06)
 831 ==========================
 832
 833 Language
 834 --------
 835 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
 836 - [New lifetime elision rules now allow for eliding lifetimes in functions and
 837   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
 838   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
 839   in structs.
 840 - [You can now define and use `const` functions.][54835] These are currently
 841   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
 842   [language reference][const-reference] for what exactly is available.
 843 - [You can now use tool lints, which allow you to scope lints from external
 844   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
 845 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
 846   a crate, not just in exported functions.][54451]
 847 - [You can now use parentheses in pattern matches.][54497]
 848
 849 Compiler
 850 --------
 851 - [Updated musl to 1.1.20][54430]
 852
 853 Libraries
 854 ---------
 855 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
 856   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
 857 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
 858   into `Option<&mut T>` using the `From` trait.][53218]
 859 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
 860
 861
 862 Stabilized APIs
 863 ---------------
 864 - [`slice::align_to`]
 865 - [`slice::align_to_mut`]
 866 - [`slice::chunks_exact`]
 867 - [`slice::chunks_exact_mut`]
 868 - [`slice::rchunks`]
 869 - [`slice::rchunks_mut`]
 870 - [`slice::rchunks_exact`]
 871 - [`slice::rchunks_exact_mut`]
 872 - [`Option::replace`]
 873
 874 Cargo
 875 -----
 876 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
 877 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
 878   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
 879
 880 [52813]: https://github.com/rust-lang/rust/pull/52813/
 881 [53218]: https://github.com/rust-lang/rust/pull/53218/
 882 [53555]: https://github.com/rust-lang/rust/issues/53555/
 883 [54057]: https://github.com/rust-lang/rust/pull/54057/
 884 [54240]: https://github.com/rust-lang/rust/pull/54240/
 885 [54430]: https://github.com/rust-lang/rust/pull/54430/
 886 [54451]: https://github.com/rust-lang/rust/pull/54451/
 887 [54497]: https://github.com/rust-lang/rust/pull/54497/
 888 [54778]: https://github.com/rust-lang/rust/pull/54778/
 889 [54835]: https://github.com/rust-lang/rust/pull/54835/
 890 [54870]: https://github.com/rust-lang/rust/pull/54870/
 891 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
 892 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
 893 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
 894 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
 895 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
 896 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
 897 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
 898 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
 899 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
 900 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
 901 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
 902 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
 903 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
 904 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
 905
 906 Version 1.30.1 (2018-11-08)
 907 ===========================
 908
 909 - [Fixed overflow ICE in rustdoc][54199]
 910 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
 911
 912 [54199]: https://github.com/rust-lang/rust/pull/54199
 913 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
 914
 915 Version 1.30.0 (2018-10-25)
 916 ==========================
 917
 918 Language
 919 --------
 920 - [Procedural macros are now available.][52081] These kinds of macros allow for
 921   more powerful code generation. There is a [new chapter available][proc-macros]
 922   in the Rust Programming Language book that goes further in depth.
 923 - [You can now use keywords as identifiers using the raw identifiers
 924   syntax (`r#`),][53236] e.g. `let r#for = true;`
 925 - [Using anonymous parameters in traits is now deprecated with a warning and
 926   will be a hard error in the 2018 edition.][53272]
 927 - [You can now use `crate` in paths.][54404] This allows you to refer to the
 928   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
 929 - [Using a external crate no longer requires being prefixed with `::`.][54404]
 930   Previously, using a external crate in a module without a use statement
 931   required `let json = ::serde_json::from_str(foo);` but can now be written
 932   as `let json = serde_json::from_str(foo);`.
 933 - [You can now apply the `#[used]` attribute to static items to prevent the
 934   compiler from optimising them away, even if they appear to be unused,][51363]
 935   e.g. `#[used] static FOO: u32 = 1;`
 936 - [You can now import and reexport macros from other crates with the `use`
 937   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
 938   the root module of the crate. If your macro relies on calling other local
 939   macros, it is recommended to export with the
 940   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
 941   those macros.
 942 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
 943   using the `vis` specifier.][53370]
 944 - [Non-macro attributes now allow all forms of literals, not just
 945   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
 946   write `#[attr(true)]`.
 947 - [You can now specify a function to handle a panic in the Rust runtime with the
 948   `#[panic_handler]` attribute.][51366]
 949
 950 Compiler
 951 --------
 952 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
 953 - [Added the `aarch64-unknown-netbsd` target][53165]
 954
 955 Libraries
 956 ---------
 957 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
 958
 959 Stabilized APIs
 960 ---------------
 961 - [`Ipv4Addr::BROADCAST`]
 962 - [`Ipv4Addr::LOCALHOST`]
 963 - [`Ipv4Addr::UNSPECIFIED`]
 964 - [`Ipv6Addr::LOCALHOST`]
 965 - [`Ipv6Addr::UNSPECIFIED`]
 966 - [`Iterator::find_map`]
 967
 968   The following methods are replacement methods for `trim_left`, `trim_right`,
 969   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
 970   in 1.33.0:
 971 - [`str::trim_end_matches`]
 972 - [`str::trim_end`]
 973 - [`str::trim_start_matches`]
 974 - [`str::trim_start`]
 975
 976 Cargo
 977 ----
 978 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
 979 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
 980   equivalent to calling `rustdoc --error-format=json`.
 981 - [Cargo will now provide a progress bar for builds.][cargo/5995]
 982
 983 Misc
 984 ----
 985 - [`rustdoc` allows you to specify what edition to treat your code as with the
 986   `--edition` option.][54057]
 987 - [`rustdoc` now has the `--color` (specify whether to output color) and
 988   `--error-format` (specify error format, e.g. `json`) options.][53003]
 989 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
 990   debug symbols.][53774]
 991 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
 992   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
 993
 994 [50911]: https://github.com/rust-lang/rust/pull/50911/
 995 [51363]: https://github.com/rust-lang/rust/pull/51363/
 996 [51366]: https://github.com/rust-lang/rust/pull/51366/
 997 [52081]: https://github.com/rust-lang/rust/pull/52081/
 998 [53003]: https://github.com/rust-lang/rust/pull/53003/
 999 [53033]: https://github.com/rust-lang/rust/pull/53033/
1000 [53044]: https://github.com/rust-lang/rust/pull/53044/
1001 [53165]: https://github.com/rust-lang/rust/pull/53165/
1002 [53213]: https://github.com/rust-lang/rust/pull/53213/
1003 [53236]: https://github.com/rust-lang/rust/pull/53236/
1004 [53272]: https://github.com/rust-lang/rust/pull/53272/
1005 [53370]: https://github.com/rust-lang/rust/pull/53370/
1006 [53459]: https://github.com/rust-lang/rust/pull/53459/
1007 [53774]: https://github.com/rust-lang/rust/pull/53774/
1008 [53822]: https://github.com/rust-lang/rust/pull/53822/
1009 [54057]: https://github.com/rust-lang/rust/pull/54057/
1010 [54146]: https://github.com/rust-lang/rust/pull/54146/
1011 [54404]: https://github.com/rust-lang/rust/pull/54404/
1012 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1013 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1014 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1015 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1016
1017 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1018 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1019 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1020 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1021 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1022 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1023 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1024 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1025 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1026 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1027
1028
1029 Version 1.29.2 (2018-10-11)
1030 ===========================
1031
1032 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1033 - The `rls-preview` component on the windows-gnu targets has been restored.
1034
1035 [54639]: https://github.com/rust-lang/rust/pull/54639
1036
1037
1038 Version 1.29.1 (2018-09-25)
1039 ===========================
1040
1041 Security Notes
1042 --------------
1043
1044 - The standard library's `str::repeat` function contained an out of bounds write
1045   caused by an integer overflow. This has been fixed by deterministically
1046   panicking when an overflow happens.
1047
1048   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
1049   us.
1050
1051
1052 Version 1.29.0 (2018-09-13)
1053 ==========================
1054
1055 Compiler
1056 --------
1057 - [Bumped minimum LLVM version to 5.0.][51899]
1058 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1059 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1060
1061 Libraries
1062 ---------
1063 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1064 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1065 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1066 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1067   for `&str`.][51178]
1068 - [`Cell<T>` now allows `T` to be unsized.][50494]
1069 - [`SocketAddr` is now stable on Redox.][52656]
1070
1071 Stabilized APIs
1072 ---------------
1073 - [`Arc::downcast`]
1074 - [`Iterator::flatten`]
1075 - [`Rc::downcast`]
1076
1077 Cargo
1078 -----
1079 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1080   `--locked` to disable this behavior.
1081 - [`cargo-install` will now allow you to cross compile an install
1082   using `--target`.][cargo/5614]
1083 - [Added the `cargo-fix` subcommand to automatically move project code from
1084   2015 edition to 2018.][cargo/5723]
1085 - [`cargo doc` can now optionally document private types using the
1086   `--document-private-items` flag.][cargo/5543]
1087
1088 Misc
1089 ----
1090 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1091   the specified level to that level.][52354] For example `--cap-lints warn`
1092   will demote `deny` and `forbid` lints to `warn`.
1093 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1094   fails and `101` if there is a panic.][52197]
1095 - [A preview of clippy has been made available through rustup.][51122]
1096   You can install the preview with `rustup component add clippy-preview`.
1097
1098 Compatibility Notes
1099 -------------------
1100 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1101   Use `str::get_unchecked(begin..end)` instead.
1102 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1103   Consider using the `home_dir` function from
1104   https://crates.io/crates/dirs instead.
1105 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1106 - [`cfg` attributes and `--cfg` command line flags are now more
1107   strictly validated.][53893]
1108
1109 [53893]: https://github.com/rust-lang/rust/pull/53893/
1110 [52861]: https://github.com/rust-lang/rust/pull/52861/
1111 [52656]: https://github.com/rust-lang/rust/pull/52656/
1112 [52239]: https://github.com/rust-lang/rust/pull/52239/
1113 [52330]: https://github.com/rust-lang/rust/pull/52330/
1114 [52354]: https://github.com/rust-lang/rust/pull/52354/
1115 [52402]: https://github.com/rust-lang/rust/pull/52402/
1116 [52103]: https://github.com/rust-lang/rust/pull/52103/
1117 [52197]: https://github.com/rust-lang/rust/pull/52197/
1118 [51807]: https://github.com/rust-lang/rust/pull/51807/
1119 [51899]: https://github.com/rust-lang/rust/pull/51899/
1120 [51912]: https://github.com/rust-lang/rust/pull/51912/
1121 [51511]: https://github.com/rust-lang/rust/pull/51511/
1122 [51619]: https://github.com/rust-lang/rust/pull/51619/
1123 [51656]: https://github.com/rust-lang/rust/pull/51656/
1124 [51178]: https://github.com/rust-lang/rust/pull/51178/
1125 [51122]: https://github.com/rust-lang/rust/pull/51122
1126 [50494]: https://github.com/rust-lang/rust/pull/50494/
1127 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1128 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1129 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1130 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1131 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1132 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1133 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1134
1135
1136 Version 1.28.0 (2018-08-02)
1137 ===========================
1138
1139 Language
1140 --------
1141 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1142   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1143   the inner type across Foreign Function Interface (FFI) boundaries.
1144 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1145   and can now be used as identifiers.][51196]
1146 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1147   stable.][51241] This will allow users to specify a global allocator for
1148   their program.
1149 - [Unit test functions marked with the `#[test]` attribute can now return
1150   `Result<(), E: Debug>` in addition to `()`.][51298]
1151 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1152   allows macros to easily target lifetimes.
1153
1154 Compiler
1155 --------
1156 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1157   prioritise making smaller binary sizes. `z` is the same as `s` with the
1158   exception that it does not vectorise loops, which typically results in an even
1159   smaller binary.
1160 - [The short error format is now stable.][49546] Specified with
1161   `--error-format=short` this option will provide a more compressed output of
1162   rust error messages.
1163 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1164 - [Reduced the number of allocations in the macro parser.][50855] This can
1165   improve compile times of macro heavy crates on average by 5%.
1166
1167 Libraries
1168 ---------
1169 - [Implemented `Default` for `&mut str`.][51306]
1170 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1171 - [Implemented `Extend` for `()`.][50234]
1172 - [The `Debug` implementation of `time::Duration` should now be more easily
1173   human readable.][50364] Previously a `Duration` of one second would printed as
1174   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1175 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1176   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1177   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1178   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1179   for `PathBuf`.][50170]
1180 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1181   and `Wrapping<i128>`.][50465]
1182 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1183   possible.][51050] This can provide up to a 40% speed increase.
1184 - [Improved error messages when using `format!`.][50610]
1185
1186 Stabilized APIs
1187 ---------------
1188 - [`Iterator::step_by`]
1189 - [`Path::ancestors`]
1190 - [`SystemTime::UNIX_EPOCH`]
1191 - [`alloc::GlobalAlloc`]
1192 - [`alloc::Layout`]
1193 - [`alloc::LayoutErr`]
1194 - [`alloc::System`]
1195 - [`alloc::alloc`]
1196 - [`alloc::alloc_zeroed`]
1197 - [`alloc::dealloc`]
1198 - [`alloc::realloc`]
1199 - [`alloc::handle_alloc_error`]
1200 - [`btree_map::Entry::or_default`]
1201 - [`fmt::Alignment`]
1202 - [`hash_map::Entry::or_default`]
1203 - [`iter::repeat_with`]
1204 - [`num::NonZeroUsize`]
1205 - [`num::NonZeroU128`]
1206 - [`num::NonZeroU16`]
1207 - [`num::NonZeroU32`]
1208 - [`num::NonZeroU64`]
1209 - [`num::NonZeroU8`]
1210 - [`ops::RangeBounds`]
1211 - [`slice::SliceIndex`]
1212 - [`slice::from_mut`]
1213 - [`slice::from_ref`]
1214 - [`{Any + Send + Sync}::downcast_mut`]
1215 - [`{Any + Send + Sync}::downcast_ref`]
1216 - [`{Any + Send + Sync}::is`]
1217
1218 Cargo
1219 -----
1220 - [Cargo will now no longer allow you to publish crates with build scripts that
1221   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1222   considered to be immutable.
1223
1224 Misc
1225 ----
1226 - [The `suggestion_applicability` field in `rustc`'s json output is now
1227   stable.][50486] This will allow dev tools to check whether a code suggestion
1228   would apply to them.
1229
1230 Compatibility Notes
1231 -------------------
1232 - [Rust will consider trait objects with duplicated constraints to be the same
1233   type as without the duplicated constraint.][51276] For example the below code will
1234   now fail to compile.
1235   ```rust
1236   trait Trait {}
1237
1238   impl Trait + Send {
1239       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1240   }
1241
1242   impl Trait + Send + Send {
1243       fn test(&self) { println!("two"); }
1244   }
1245   ```
1246
1247 [49546]: https://github.com/rust-lang/rust/pull/49546/
1248 [50143]: https://github.com/rust-lang/rust/pull/50143/
1249 [50170]: https://github.com/rust-lang/rust/pull/50170/
1250 [50234]: https://github.com/rust-lang/rust/pull/50234/
1251 [50265]: https://github.com/rust-lang/rust/pull/50265/
1252 [50364]: https://github.com/rust-lang/rust/pull/50364/
1253 [50385]: https://github.com/rust-lang/rust/pull/50385/
1254 [50465]: https://github.com/rust-lang/rust/pull/50465/
1255 [50486]: https://github.com/rust-lang/rust/pull/50486/
1256 [50554]: https://github.com/rust-lang/rust/pull/50554/
1257 [50610]: https://github.com/rust-lang/rust/pull/50610/
1258 [50855]: https://github.com/rust-lang/rust/pull/50855/
1259 [51050]: https://github.com/rust-lang/rust/pull/51050/
1260 [51196]: https://github.com/rust-lang/rust/pull/51196/
1261 [51200]: https://github.com/rust-lang/rust/pull/51200/
1262 [51241]: https://github.com/rust-lang/rust/pull/51241/
1263 [51276]: https://github.com/rust-lang/rust/pull/51276/
1264 [51298]: https://github.com/rust-lang/rust/pull/51298/
1265 [51306]: https://github.com/rust-lang/rust/pull/51306/
1266 [51562]: https://github.com/rust-lang/rust/pull/51562/
1267 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1268 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1269 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1270 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1271 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1272 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1273 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1274 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1275 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1276 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1277 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1278 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1279 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1280 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1281 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1282 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1283 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1284 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1285 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1286 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1287 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1288 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1289 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1290 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1291 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1292 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1293 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1294 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1295 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1296 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1297
1298 Version 1.27.2 (2018-07-20)
1299 ===========================
1300
1301 Compatibility Notes
1302 -------------------
1303
1304 - The borrow checker was fixed to avoid potential unsoundness when using
1305   match ergonomics: [#52213][52213].
1306
1307 [52213]: https://github.com/rust-lang/rust/issues/52213
1308
1309 Version 1.27.1 (2018-07-10)
1310 ===========================
1311
1312 Security Notes
1313 --------------
1314
1315 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1316   when running, which enabled executing code as some other user on a
1317   given machine. This release fixes that vulnerability; you can read
1318   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1319
1320   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
1321
1322 Compatibility Notes
1323 -------------------
1324
1325 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1326   match ergonomics: [#51415][51415], [#49534][49534].
1327
1328 [51415]: https://github.com/rust-lang/rust/issues/51415
1329 [49534]: https://github.com/rust-lang/rust/issues/49534
1330 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1331 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1332
1333 Version 1.27.0 (2018-06-21)
1334 ==========================
1335
1336 Language
1337 --------
1338 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1339   be used as an identifier.
1340 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1341   bare `Trait` syntax, and should make it clearer when being used in tandem with
1342   `impl Trait` because it is equivalent to the following syntax:
1343   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1344   `Box<Trait> == Box<dyn Trait>`.
1345 - [Attributes on generic parameters such as types and lifetimes are
1346   now stable.][48851] e.g.
1347   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1348 - [The `#[must_use]` attribute can now also be used on functions as well as
1349   types.][48925] It provides a lint that by default warns users when the
1350   value returned by a function has not been used.
1351
1352 Compiler
1353 --------
1354 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1355
1356 Libraries
1357 ---------
1358 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1359   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1360   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1361   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1362   the `cfg` attribute.
1363 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1364   std are now available in core.][49896]
1365 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1366   to `Self`.][49630]
1367 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1368   that the operation isn't done in place.
1369 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1370   the `#[must_use]` attribute][49533] to warn about unused potentially
1371   expensive allocations.
1372
1373 Stabilized APIs
1374 ---------------
1375 - [`DoubleEndedIterator::rfind`]
1376 - [`DoubleEndedIterator::rfold`]
1377 - [`DoubleEndedIterator::try_rfold`]
1378 - [`Duration::from_micros`]
1379 - [`Duration::from_nanos`]
1380 - [`Duration::subsec_micros`]
1381 - [`Duration::subsec_millis`]
1382 - [`HashMap::remove_entry`]
1383 - [`Iterator::try_fold`]
1384 - [`Iterator::try_for_each`]
1385 - [`NonNull::cast`]
1386 - [`Option::filter`]
1387 - [`String::replace_range`]
1388 - [`Take::set_limit`]
1389 - [`hint::unreachable_unchecked`]
1390 - [`os::unix::process::parent_id`]
1391 - [`ptr::swap_nonoverlapping`]
1392 - [`slice::rsplit_mut`]
1393 - [`slice::rsplit`]
1394 - [`slice::swap_with_slice`]
1395
1396 Cargo
1397 -----
1398 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1399   `readme`, and `repository` fields.][cargo/5386]
1400 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1401 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1402   a different directory than `target` for placing compilation artifacts.
1403 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1404   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1405   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1406   where cargo would infer a binary, Cargo will produce a warning. You can
1407   disable this feature ahead of time by setting any of the following to false:
1408   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1409 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1410   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1411
1412 Misc
1413 ----
1414 - [Added “The Rustc book” into the official documentation.][49707]
1415   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1416 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1417
1418 Compatibility Notes
1419 -------------------
1420 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1421   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1422   compile, `"".is_empty()` will still compile.
1423 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1424   will only print the inner type.][48553] E.g.
1425   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1426   not `AtomicBool(true)`.
1427 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1428   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1429   alignment should cover all use cases.
1430 - The `.description()` method on the `std::error::Error` trait
1431   [has been soft-deprecated][50163]. It is no longer required to implement it.
1432
1433 [48553]: https://github.com/rust-lang/rust/pull/48553/
1434 [48851]: https://github.com/rust-lang/rust/pull/48851/
1435 [48925]: https://github.com/rust-lang/rust/pull/48925/
1436 [49533]: https://github.com/rust-lang/rust/pull/49533/
1437 [49623]: https://github.com/rust-lang/rust/pull/49623/
1438 [49630]: https://github.com/rust-lang/rust/pull/49630/
1439 [49664]: https://github.com/rust-lang/rust/pull/49664/
1440 [49699]: https://github.com/rust-lang/rust/pull/49699/
1441 [49707]: https://github.com/rust-lang/rust/pull/49707/
1442 [49719]: https://github.com/rust-lang/rust/pull/49719/
1443 [49896]: https://github.com/rust-lang/rust/pull/49896/
1444 [49968]: https://github.com/rust-lang/rust/pull/49968/
1445 [50163]: https://github.com/rust-lang/rust/pull/50163
1446 [50177]: https://github.com/rust-lang/rust/pull/50177/
1447 [50378]: https://github.com/rust-lang/rust/pull/50378/
1448 [50398]: https://github.com/rust-lang/rust/pull/50398/
1449 [50423]: https://github.com/rust-lang/rust/pull/50423/
1450 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1451 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1452 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1453 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1454 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1455 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1456 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1457 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1458 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1459 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1460 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1461 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1462 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1463 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1464 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1465 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1466 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1467 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1468 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1469 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1470 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1471 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1472 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1473 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1474 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1475 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1476 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1477 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1478 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1479 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1480
1481
1482 Version 1.26.2 (2018-06-05)
1483 ==========================
1484
1485 Compatibility Notes
1486 -------------------
1487
1488 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1489
1490 [51117]: https://github.com/rust-lang/rust/issues/51117
1491
1492
1493 Version 1.26.1 (2018-05-29)
1494 ==========================
1495
1496 Tools
1497 -----
1498
1499 - [RLS now works on Windows.][50646]
1500 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1501
1502
1503 Compatibility Notes
1504 --------
1505
1506 - [`fn main() -> impl Trait` no longer works for non-Termination
1507   trait.][50656]
1508   This reverts an accidental stabilization.
1509 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1510 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1511
1512 [50646]: https://github.com/rust-lang/rust/issues/50646
1513 [50656]: https://github.com/rust-lang/rust/pull/50656
1514 [50812]: https://github.com/rust-lang/rust/pull/50812
1515 [50950]: https://github.com/rust-lang/rust/issues/50950
1516 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1517
1518 Version 1.26.0 (2018-05-10)
1519 ==========================
1520
1521 Language
1522 --------
1523 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1524   implement either or both traits.][49299]
1525 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1526 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1527   lifetime can be elided.][49458]
1528 - [`impl Trait` is now stable allowing you to have abstract types in returns
1529    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1530   `fn open(path: impl AsRef<Path>)`.
1531 - [Pattern matching will now automatically apply dereferences.][49394]
1532 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1533 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1534 - [A lot of operations are now available in a const context.][46882] E.g. You
1535   can now index into constant arrays, reference and dereference into constants,
1536   and use tuple struct constructors.
1537 - [Fixed entry slice patterns are now stable.][48516] E.g.
1538   ```rust
1539   let points = [1, 2, 3, 4];
1540   match points {
1541       [1, 2, 3, 4] => println!("All points were sequential."),
1542       _ => println!("Not all points were sequential."),
1543   }
1544   ```
1545
1546
1547 Compiler
1548 --------
1549 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1550 - [Fixed exponential projection complexity on nested types.][48296]
1551   This can provide up to a ~12% reduction in compile times for certain crates.
1552 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1553   to remap path prefixes outputted by the compiler.
1554 - [Added `powerpc-unknown-netbsd` target.][48281]
1555
1556 Libraries
1557 ---------
1558 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1559 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1560   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1561 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1562 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1563 - [`ascii::escape_default` is now available in libcore.][48735]
1564 - [Trailing commas are now supported in std and core macros.][48056]
1565 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1566 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1567
1568 Stabilized APIs
1569 ---------------
1570 - [`*const T::add`]
1571 - [`*const T::copy_to_nonoverlapping`]
1572 - [`*const T::copy_to`]
1573 - [`*const T::read_unaligned`]
1574 - [`*const T::read_volatile`]
1575 - [`*const T::read`]
1576 - [`*const T::sub`]
1577 - [`*const T::wrapping_add`]
1578 - [`*const T::wrapping_sub`]
1579 - [`*mut T::add`]
1580 - [`*mut T::copy_to_nonoverlapping`]
1581 - [`*mut T::copy_to`]
1582 - [`*mut T::read_unaligned`]
1583 - [`*mut T::read_volatile`]
1584 - [`*mut T::read`]
1585 - [`*mut T::replace`]
1586 - [`*mut T::sub`]
1587 - [`*mut T::swap`]
1588 - [`*mut T::wrapping_add`]
1589 - [`*mut T::wrapping_sub`]
1590 - [`*mut T::write_bytes`]
1591 - [`*mut T::write_unaligned`]
1592 - [`*mut T::write_volatile`]
1593 - [`*mut T::write`]
1594 - [`Box::leak`]
1595 - [`FromUtf8Error::as_bytes`]
1596 - [`LocalKey::try_with`]
1597 - [`Option::cloned`]
1598 - [`btree_map::Entry::and_modify`]
1599 - [`fs::read_to_string`]
1600 - [`fs::read`]
1601 - [`fs::write`]
1602 - [`hash_map::Entry::and_modify`]
1603 - [`iter::FusedIterator`]
1604 - [`ops::RangeInclusive`]
1605 - [`ops::RangeToInclusive`]
1606 - [`process::id`]
1607 - [`slice::rotate_left`]
1608 - [`slice::rotate_right`]
1609 - [`String::retain`]
1610
1611
1612 Cargo
1613 -----
1614 - [Cargo will now output path to custom commands when `-v` is
1615   passed with `--list`][cargo/5041]
1616 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1617
1618 Misc
1619 ----
1620 - [The second edition of "The Rust Programming Language" book is now recommended
1621   over the first.][48404]
1622
1623 Compatibility Notes
1624 -------------------
1625
1626 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1627   syntax is now invalid.
1628   ```
1629   use std::ops::Fn as dyn;
1630   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1631   ```
1632 - [The result of dereferences are no longer promoted to `'static`.][47408]
1633   e.g.
1634   ```rust
1635   fn main() {
1636       const PAIR: &(i32, i32) = &(0, 1);
1637       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1638   }
1639   ```
1640 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1641 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1642   an error.][48235]
1643 - [Removed hoedown from rustdoc.][48274]
1644 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1645
1646 [46882]: https://github.com/rust-lang/rust/pull/46882
1647 [47379]: https://github.com/rust-lang/rust/pull/47379
1648 [47408]: https://github.com/rust-lang/rust/pull/47408
1649 [47813]: https://github.com/rust-lang/rust/pull/47813
1650 [48056]: https://github.com/rust-lang/rust/pull/48056
1651 [48125]: https://github.com/rust-lang/rust/pull/48125
1652 [48166]: https://github.com/rust-lang/rust/pull/48166
1653 [48235]: https://github.com/rust-lang/rust/pull/48235
1654 [48274]: https://github.com/rust-lang/rust/pull/48274
1655 [48281]: https://github.com/rust-lang/rust/pull/48281
1656 [48296]: https://github.com/rust-lang/rust/pull/48296
1657 [48326]: https://github.com/rust-lang/rust/pull/48326
1658 [48359]: https://github.com/rust-lang/rust/pull/48359
1659 [48404]: https://github.com/rust-lang/rust/pull/48404
1660 [48481]: https://github.com/rust-lang/rust/pull/48481
1661 [48516]: https://github.com/rust-lang/rust/pull/48516
1662 [48628]: https://github.com/rust-lang/rust/pull/48628
1663 [48629]: https://github.com/rust-lang/rust/pull/48629
1664 [48657]: https://github.com/rust-lang/rust/pull/48657
1665 [48735]: https://github.com/rust-lang/rust/pull/48735
1666 [48978]: https://github.com/rust-lang/rust/pull/48978
1667 [49101]: https://github.com/rust-lang/rust/pull/49101
1668 [49109]: https://github.com/rust-lang/rust/pull/49109
1669 [49121]: https://github.com/rust-lang/rust/pull/49121
1670 [49162]: https://github.com/rust-lang/rust/pull/49162
1671 [49184]: https://github.com/rust-lang/rust/pull/49184
1672 [49234]: https://github.com/rust-lang/rust/pull/49234
1673 [49255]: https://github.com/rust-lang/rust/pull/49255
1674 [49299]: https://github.com/rust-lang/rust/pull/49299
1675 [49305]: https://github.com/rust-lang/rust/pull/49305
1676 [49394]: https://github.com/rust-lang/rust/pull/49394
1677 [49458]: https://github.com/rust-lang/rust/pull/49458
1678 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
1679 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
1680 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
1681 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
1682 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
1683 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
1684 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
1685 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
1686 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
1687 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
1688 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
1689 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
1690 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
1691 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
1692 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
1693 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
1694 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
1695 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
1696 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
1697 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
1698 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
1699 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
1700 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
1701 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
1702 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
1703 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
1704 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
1705 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
1706 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
1707 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
1708 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
1709 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
1710 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
1711 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
1712 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
1713 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
1714 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1715 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
1716 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
1717 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
1718 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
1719 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
1720
1721
1722 Version 1.25.0 (2018-03-29)
1723 ==========================
1724
1725 Language
1726 --------
1727 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
1728 - [You can now use nested groups of imports.][47948]
1729   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
1730 - [You can now have `|` at the start of a match arm.][47947] e.g.
1731 ```rust
1732 enum Foo { A, B, C }
1733
1734 fn main() {
1735     let x = Foo::A;
1736     match x {
1737         | Foo::A
1738         | Foo::B => println!("AB"),
1739         | Foo::C => println!("C"),
1740     }
1741 }
1742 ```
1743
1744 Compiler
1745 --------
1746 - [Upgraded to LLVM 6.][47828]
1747 - [Added `-C lto=val` option.][47521]
1748 - [Added `i586-unknown-linux-musl` target][47282]
1749
1750 Libraries
1751 ---------
1752 - [Impl Send for `process::Command` on Unix.][47760]
1753 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
1754 - [`UnsafeCell::into_inner` is now safe.][47204]
1755 - [Implement libstd for CloudABI.][47268]
1756 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
1757 - [Implement `AsRef<Path>` for Component][46985]
1758 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
1759 - [Moved `Duration` to libcore.][46666]
1760
1761 Stabilized APIs
1762 ---------------
1763 - [`Location::column`]
1764 - [`ptr::NonNull`]
1765
1766 The following functions can now be used in a constant expression.
1767 eg. `static MINUTE: Duration = Duration::from_secs(60);`
1768 - [`Duration::new`][47300]
1769 - [`Duration::from_secs`][47300]
1770 - [`Duration::from_millis`][47300]
1771
1772 Cargo
1773 -----
1774 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
1775 - [`cargo new` now defaults to creating a binary crate, instead of a
1776   library crate.][cargo/5029]
1777
1778 Misc
1779 ----
1780 - [Rust by example is now shipped with new releases][46196]
1781
1782 Compatibility Notes
1783 -------------------
1784 - [Deprecated `net::lookup_host`.][47510]
1785 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
1786 - The borrow checker was sometimes incorrectly permitting overlapping borrows
1787   around indexing operations (see [#47349][47349]). This has been fixed (which also
1788   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
1789 - [Removed deprecated unstable attribute `#[simd]`.][47251]
1790
1791 [33903]: https://github.com/rust-lang/rust/pull/33903
1792 [47947]: https://github.com/rust-lang/rust/pull/47947
1793 [47948]: https://github.com/rust-lang/rust/pull/47948
1794 [47760]: https://github.com/rust-lang/rust/pull/47760
1795 [47790]: https://github.com/rust-lang/rust/pull/47790
1796 [47828]: https://github.com/rust-lang/rust/pull/47828
1797 [47398]: https://github.com/rust-lang/rust/pull/47398
1798 [47510]: https://github.com/rust-lang/rust/pull/47510
1799 [47521]: https://github.com/rust-lang/rust/pull/47521
1800 [47204]: https://github.com/rust-lang/rust/pull/47204
1801 [47251]: https://github.com/rust-lang/rust/pull/47251
1802 [47268]: https://github.com/rust-lang/rust/pull/47268
1803 [47282]: https://github.com/rust-lang/rust/pull/47282
1804 [47300]: https://github.com/rust-lang/rust/pull/47300
1805 [47349]: https://github.com/rust-lang/rust/pull/47349
1806 [46931]: https://github.com/rust-lang/rust/pull/46931
1807 [46985]: https://github.com/rust-lang/rust/pull/46985
1808 [47006]: https://github.com/rust-lang/rust/pull/47006
1809 [46830]: https://github.com/rust-lang/rust/pull/46830
1810 [46095]: https://github.com/rust-lang/rust/pull/46095
1811 [46666]: https://github.com/rust-lang/rust/pull/46666
1812 [46196]: https://github.com/rust-lang/rust/pull/46196
1813 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
1814 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
1815 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
1816 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
1817 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1818
1819
1820 Version 1.24.1 (2018-03-01)
1821 ==========================
1822
1823  - [Do not abort when unwinding through FFI][48251]
1824  - [Emit UTF-16 files for linker arguments on Windows][48318]
1825  - [Make the error index generator work again][48308]
1826  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1827
1828 [48251]: https://github.com/rust-lang/rust/issues/48251
1829 [48308]: https://github.com/rust-lang/rust/issues/48308
1830 [48318]: https://github.com/rust-lang/rust/issues/48318
1831 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1832
1833
1834 Version 1.24.0 (2018-02-15)
1835 ==========================
1836
1837 Language
1838 --------
1839 - [External `sysv64` ffi is now available.][46528]
1840   eg. `extern "sysv64" fn foo () {}`
1841
1842 Compiler
1843 --------
1844 - [rustc now uses 16 codegen units by default for release builds.][46910]
1845   For the fastest builds, utilize `codegen-units=1`.
1846 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1847 - [Add `aarch64-unknown-openbsd` support][46760]
1848
1849 Libraries
1850 ---------
1851 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1852   improvement in performance in the majority of cases.
1853 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1854   with Windows.][46798]
1855 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1856 - [impl `From<bool>` for `AtomicBool`][46293]
1857 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1858 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1859 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1860 - [float::from_bits now just uses transmute.][46012] This provides
1861   some optimisations from LLVM.
1862 - [Copied `AsciiExt` methods onto `char`][46077]
1863 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1864 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1865 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1866 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1867
1868 Stabilized APIs
1869 ---------------
1870 - [`RefCell::replace`]
1871 - [`RefCell::swap`]
1872 - [`atomic::spin_loop_hint`]
1873
1874 The following functions can now be used in a constant expression.
1875 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1876
1877 - [`AtomicBool::new`][46287]
1878 - [`AtomicUsize::new`][46287]
1879 - [`AtomicIsize::new`][46287]
1880 - [`AtomicPtr::new`][46287]
1881 - [`Cell::new`][46287]
1882 - [`{integer}::min_value`][46287]
1883 - [`{integer}::max_value`][46287]
1884 - [`mem::size_of`][46287]
1885 - [`mem::align_of`][46287]
1886 - [`ptr::null`][46287]
1887 - [`ptr::null_mut`][46287]
1888 - [`RefCell::new`][46287]
1889 - [`UnsafeCell::new`][46287]
1890
1891 Cargo
1892 -----
1893 - [Added a `workspace.default-members` config that
1894   overrides implied `--all` in virtual workspaces.][cargo/4743]
1895 - [Enable incremental by default on development builds.][cargo/4817] Also added
1896   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1897   per-project or global basis respectively.
1898
1899 Misc
1900 ----
1901
1902 Compatibility Notes
1903 -------------------
1904 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1905 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1906   in accordance with IETF RFC 4291 §2.2.
1907 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1908 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1909   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1910 - [Leading zeros in tuple struct members is now an error][47084]
1911 - [`column!()` macro is one-based instead of zero-based][46977]
1912 - [`fmt::Arguments` can no longer be shared across threads][45198]
1913 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1914 - [Cargo sets a different working directory for the compiler][cargo/4788]
1915
1916 [44884]: https://github.com/rust-lang/rust/pull/44884
1917 [45198]: https://github.com/rust-lang/rust/pull/45198
1918 [45506]: https://github.com/rust-lang/rust/pull/45506
1919 [45904]: https://github.com/rust-lang/rust/pull/45904
1920 [45990]: https://github.com/rust-lang/rust/pull/45990
1921 [46012]: https://github.com/rust-lang/rust/pull/46012
1922 [46077]: https://github.com/rust-lang/rust/pull/46077
1923 [46094]: https://github.com/rust-lang/rust/pull/46094
1924 [46284]: https://github.com/rust-lang/rust/pull/46284
1925 [46287]: https://github.com/rust-lang/rust/pull/46287
1926 [46293]: https://github.com/rust-lang/rust/pull/46293
1927 [46528]: https://github.com/rust-lang/rust/pull/46528
1928 [46671]: https://github.com/rust-lang/rust/pull/46671
1929 [46713]: https://github.com/rust-lang/rust/pull/46713
1930 [46735]: https://github.com/rust-lang/rust/pull/46735
1931 [46749]: https://github.com/rust-lang/rust/pull/46749
1932 [46760]: https://github.com/rust-lang/rust/pull/46760
1933 [46798]: https://github.com/rust-lang/rust/pull/46798
1934 [46828]: https://github.com/rust-lang/rust/pull/46828
1935 [46831]: https://github.com/rust-lang/rust/pull/46831
1936 [46833]: https://github.com/rust-lang/rust/pull/46833
1937 [46910]: https://github.com/rust-lang/rust/pull/46910
1938 [46977]: https://github.com/rust-lang/rust/pull/46977
1939 [47018]: https://github.com/rust-lang/rust/pull/47018
1940 [47080]: https://github.com/rust-lang/rust/pull/47080
1941 [47084]: https://github.com/rust-lang/rust/pull/47084
1942 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1943 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1944 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1945 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1946 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1947 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1948
1949
1950 Version 1.23.0 (2018-01-04)
1951 ==========================
1952
1953 Language
1954 --------
1955 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1956 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1957   Which should fix some confusing errors in some operations.
1958
1959 Compiler
1960 --------
1961 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1962   undefined behavior.][45920]
1963 - [rustc now suggests renaming import if names clash.][45660]
1964 - [Display errors/warnings correctly when there are zero-width or
1965   wide characters.][45711]
1966 - [rustc now avoids unnecessary copies of arguments that are
1967   simple bindings][45380] This should improve memory usage on average by 5-10%.
1968 - [Updated musl used to build musl rustc to 1.1.17][45393]
1969
1970 Libraries
1971 ---------
1972 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1973 - [Implement Hash for raw pointers to unsized types][45483]
1974 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1975 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1976 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1977 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1978   and `<*mut T>::as_mut`][44932]
1979 - [Optimized `Thread::{park, unpark}` implementation][45524]
1980 - [Improved `SliceExt::binary_search` performance.][45333]
1981 - [impl `FromIterator<()>` for `()`][45379]
1982 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1983   is now deprecated.
1984
1985 Stabilized APIs
1986 ---------------
1987
1988 Cargo
1989 -----
1990 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1991   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1992 - [Added unit test checking to `cargo check`][cargo/4592]
1993 - [Cargo now lets you install a specific version
1994   using `cargo install --version`][cargo/4637]
1995
1996 Misc
1997 ----
1998 - [Releases now ship with the Cargo book documentation.][45692]
1999 - [rustdoc now prints rendering warnings on every run.][45324]
2000
2001 Compatibility Notes
2002 -------------------
2003 - [Changes have been made to type equality to make it more correct,
2004   in rare cases this could break some code.][45853] [Tracking issue for
2005   further information][45852]
2006 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2007 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2008   Android 9, the minimum supported version is Android 14.
2009 - [Bumped the minimum LLVM to 3.9][45326]
2010
2011 [44042]: https://github.com/rust-lang/rust/pull/44042
2012 [44932]: https://github.com/rust-lang/rust/pull/44932
2013 [45267]: https://github.com/rust-lang/rust/pull/45267
2014 [45324]: https://github.com/rust-lang/rust/pull/45324
2015 [45326]: https://github.com/rust-lang/rust/pull/45326
2016 [45333]: https://github.com/rust-lang/rust/pull/45333
2017 [45379]: https://github.com/rust-lang/rust/pull/45379
2018 [45380]: https://github.com/rust-lang/rust/pull/45380
2019 [45393]: https://github.com/rust-lang/rust/pull/45393
2020 [45435]: https://github.com/rust-lang/rust/pull/45435
2021 [45483]: https://github.com/rust-lang/rust/pull/45483
2022 [45524]: https://github.com/rust-lang/rust/pull/45524
2023 [45571]: https://github.com/rust-lang/rust/pull/45571
2024 [45580]: https://github.com/rust-lang/rust/pull/45580
2025 [45610]: https://github.com/rust-lang/rust/pull/45610
2026 [45660]: https://github.com/rust-lang/rust/pull/45660
2027 [45692]: https://github.com/rust-lang/rust/pull/45692
2028 [45711]: https://github.com/rust-lang/rust/pull/45711
2029 [45772]: https://github.com/rust-lang/rust/pull/45772
2030 [45852]: https://github.com/rust-lang/rust/issues/45852
2031 [45853]: https://github.com/rust-lang/rust/pull/45853
2032 [45887]: https://github.com/rust-lang/rust/pull/45887
2033 [45920]: https://github.com/rust-lang/rust/pull/45920
2034 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2035 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2036 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2037
2038
2039 Version 1.22.1 (2017-11-22)
2040 ==========================
2041
2042 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2043
2044 [46183]: https://github.com/rust-lang/rust/pull/46183
2045
2046 Version 1.22.0 (2017-11-22)
2047 ==========================
2048
2049 Language
2050 --------
2051 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2052 - [Now accepts underscores in unicode escapes][43716]
2053 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2054 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2055
2056 Compiler
2057 --------
2058 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2059 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2060   This should decrease compile times for debug builds.
2061 - [strict memory alignment now enabled on ARMv6][45094]
2062 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2063
2064 Libraries
2065 ---------
2066 - [Allow atomic operations up to 32 bits
2067   on `armv5te_unknown_linux_gnueabi`][44978]
2068 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2069 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2070 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2071 - [Properly detect overflow in `Instant += Duration`.][44220]
2072 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2073 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2074 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2075
2076 Stabilized APIs
2077 ---------------
2078
2079 Cargo
2080 -----
2081 - [Cargo will now build multi file examples in subdirectories of the `examples`
2082   folder that have a `main.rs` file.][cargo/4496]
2083 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2084   the old format will continue to work and can be updated with `cargo update`.
2085 - [Now supports vendoring git repositories][cargo/3992]
2086
2087 Misc
2088 ----
2089 - [`libbacktrace` is now available on Apple platforms.][44251]
2090 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2091   This now lets you specify that a given code example will fail to compile.
2092
2093 Compatibility Notes
2094 -------------------
2095 - [The minimum Android version that rustc can build for has been bumped
2096   to `4.0` from `2.3`][45656]
2097 - [Allowing `T op= &T` for numeric types has broken some type
2098   inference cases][45480]
2099
2100
2101 [42526]: https://github.com/rust-lang/rust/pull/42526
2102 [43017]: https://github.com/rust-lang/rust/pull/43017
2103 [43716]: https://github.com/rust-lang/rust/pull/43716
2104 [43949]: https://github.com/rust-lang/rust/pull/43949
2105 [44015]: https://github.com/rust-lang/rust/pull/44015
2106 [44220]: https://github.com/rust-lang/rust/pull/44220
2107 [44251]: https://github.com/rust-lang/rust/pull/44251
2108 [44287]: https://github.com/rust-lang/rust/pull/44287
2109 [44303]: https://github.com/rust-lang/rust/pull/44303
2110 [44456]: https://github.com/rust-lang/rust/pull/44456
2111 [44466]: https://github.com/rust-lang/rust/pull/44466
2112 [44895]: https://github.com/rust-lang/rust/pull/44895
2113 [44966]: https://github.com/rust-lang/rust/pull/44966
2114 [44978]: https://github.com/rust-lang/rust/pull/44978
2115 [45041]: https://github.com/rust-lang/rust/pull/45041
2116 [45064]: https://github.com/rust-lang/rust/pull/45064
2117 [45075]: https://github.com/rust-lang/rust/pull/45075
2118 [45094]: https://github.com/rust-lang/rust/pull/45094
2119 [45095]: https://github.com/rust-lang/rust/pull/45095
2120 [45480]: https://github.com/rust-lang/rust/issues/45480
2121 [45656]: https://github.com/rust-lang/rust/pull/45656
2122 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2123 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2124 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2125
2126
2127
2128
2129
2130
2131 Version 1.21.0 (2017-10-12)
2132 ==========================
2133
2134 Language
2135 --------
2136 - [You can now use static references for literals.][43838]
2137   Example:
2138   ```rust
2139   fn main() {
2140       let x: &'static u32 = &0;
2141   }
2142   ```
2143 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2144   Example:
2145   ```rust
2146   my_macro!(Vec<i32>::new); // Always worked
2147   my_macro!(Vec::<i32>::new); // Now works
2148   ```
2149
2150 Compiler
2151 --------
2152 - [Upgraded jemalloc to 4.5.0][43911]
2153 - [Enabled unwinding panics on Redox][43917]
2154 - [Now runs LLVM in parallel during translation phase.][43506]
2155   This should reduce peak memory usage.
2156
2157 Libraries
2158 ---------
2159 - [Generate builtin impls for `Clone` for all arrays and tuples that
2160   are `T: Clone`][43690]
2161 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2162 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2163   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2164
2165 Stabilized APIs
2166 ---------------
2167
2168 [`std::mem::discriminant`]
2169
2170 Cargo
2171 -----
2172 - [You can now call `cargo install` with multiple package names][cargo/4216]
2173 - [Cargo commands inside a virtual workspace will now implicitly
2174   pass `--all`][cargo/4335]
2175 - [Added a `[patch]` section to `Cargo.toml` to handle
2176   prepublication dependencies][cargo/4123] [RFC 1969]
2177 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2178   like patterns][cargo/4270]
2179 - [Added the `--all-targets` option][cargo/4400]
2180 - [Using required dependencies as a feature is now deprecated and emits
2181   a warning][cargo/4364]
2182
2183
2184 Misc
2185 ----
2186 - [Cargo docs are moving][43916]
2187   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2188 - [The rustdoc book is now available][43863]
2189   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2190 - [Added a preview of RLS has been made available through rustup][44204]
2191   Install with `rustup component add rls-preview`
2192 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2193   Previously only showed `std::os::unix`.
2194
2195 Compatibility Notes
2196 -------------------
2197 - [Changes in method matching against higher-ranked types][43880] This may cause
2198   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2199 - [rustc's JSON error output's byte position start at top of file.][42973]
2200   Was previously relative to the rustc's internal `CodeMap` struct which
2201   required the unstable library `libsyntax` to correctly use.
2202 - [`unused_results` lint no longer ignores booleans][43728]
2203
2204 [42565]: https://github.com/rust-lang/rust/pull/42565
2205 [42973]: https://github.com/rust-lang/rust/pull/42973
2206 [43348]: https://github.com/rust-lang/rust/pull/43348
2207 [43459]: https://github.com/rust-lang/rust/pull/43459
2208 [43506]: https://github.com/rust-lang/rust/pull/43506
2209 [43540]: https://github.com/rust-lang/rust/pull/43540
2210 [43690]: https://github.com/rust-lang/rust/pull/43690
2211 [43728]: https://github.com/rust-lang/rust/pull/43728
2212 [43838]: https://github.com/rust-lang/rust/pull/43838
2213 [43863]: https://github.com/rust-lang/rust/pull/43863
2214 [43880]: https://github.com/rust-lang/rust/pull/43880
2215 [43911]: https://github.com/rust-lang/rust/pull/43911
2216 [43916]: https://github.com/rust-lang/rust/pull/43916
2217 [43917]: https://github.com/rust-lang/rust/pull/43917
2218 [44204]: https://github.com/rust-lang/rust/pull/44204
2219 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2220 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2221 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2222 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2223 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2224 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2225 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2226 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2227 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2228
2229 Version 1.20.0 (2017-08-31)
2230 ===========================
2231
2232 Language
2233 --------
2234 - [Associated constants are now stabilised.][42809]
2235 - [A lot of macro bugs are now fixed.][42913]
2236
2237 Compiler
2238 --------
2239
2240 - [Struct fields are now properly coerced to the expected field type.][42807]
2241 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2242   `wasm32-experimental-emscripten` target.
2243 - [Changed some of the error messages to be more helpful.][42033]
2244 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2245   it.][43170]
2246 - [rustc now reports the total number of errors on compilation failure][43015]
2247   previously this was only the number of errors in the pass that failed.
2248 - [Expansion in rustc has been sped up 29x.][42533]
2249 - [added `msp430-none-elf` target.][43099]
2250 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2251   applicable][43178]
2252 - [Fixes backtraces on Redox][43228]
2253 - [rustc now identifies different versions of same crate when absolute paths of
2254   different types match in an error message.][42826]
2255
2256 Libraries
2257 ---------
2258
2259
2260 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2261 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2262   tuples.][43011]
2263 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2264   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2265 - [Impl `Clone` for `DefaultHasher`.][42799]
2266 - [Impl `Sync` for `SyncSender`.][42397]
2267 - [Impl `FromStr` for `char`][42271]
2268 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2269   NaN.][42431]
2270 - [allow messages in the `unimplemented!()` macro.][42155]
2271   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2272 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2273 - [Upgrade to Unicode 10.0.0][42999]
2274 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2275 - [Skip the main thread's manual stack guard on Linux][43072]
2276 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2277 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2278   previously 2^15.
2279 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2280
2281 Stabilized APIs
2282 ---------------
2283
2284 - [`CStr::into_c_string`]
2285 - [`CString::as_c_str`]
2286 - [`CString::into_boxed_c_str`]
2287 - [`Chain::get_mut`]
2288 - [`Chain::get_ref`]
2289 - [`Chain::into_inner`]
2290 - [`Option::get_or_insert_with`]
2291 - [`Option::get_or_insert`]
2292 - [`OsStr::into_os_string`]
2293 - [`OsString::into_boxed_os_str`]
2294 - [`Take::get_mut`]
2295 - [`Take::get_ref`]
2296 - [`Utf8Error::error_len`]
2297 - [`char::EscapeDebug`]
2298 - [`char::escape_debug`]
2299 - [`compile_error!`]
2300 - [`f32::from_bits`]
2301 - [`f32::to_bits`]
2302 - [`f64::from_bits`]
2303 - [`f64::to_bits`]
2304 - [`mem::ManuallyDrop`]
2305 - [`slice::sort_unstable_by_key`]
2306 - [`slice::sort_unstable_by`]
2307 - [`slice::sort_unstable`]
2308 - [`str::from_boxed_utf8_unchecked`]
2309 - [`str::as_bytes_mut`]
2310 - [`str::as_bytes_mut`]
2311 - [`str::from_utf8_mut`]
2312 - [`str::from_utf8_unchecked_mut`]
2313 - [`str::get_mut`]
2314 - [`str::get_unchecked_mut`]
2315 - [`str::get_unchecked`]
2316 - [`str::get`]
2317 - [`str::into_boxed_bytes`]
2318
2319
2320 Cargo
2321 -----
2322 - [Cargo API token location moved from `~/.cargo/config` to
2323   `~/.cargo/credentials`.][cargo/3978]
2324 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2325   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2326   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2327 - [You can now specify version of a binary when installed through
2328   `cargo install` using `--vers`.][cargo/4229]
2329 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2330   failure.][cargo/4248]
2331 - [Changed the convention around which file is the crate root.][cargo/4259]
2332 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2333   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2334
2335 Compatibility Notes
2336 -------------------
2337
2338 - [Functions with `'static` in their return types will now not be as usable as
2339   if they were using lifetime parameters instead.][42417]
2340 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2341   takes the sign of NaN into account where previously didn't.][42430]
2342
2343 [42033]: https://github.com/rust-lang/rust/pull/42033
2344 [42155]: https://github.com/rust-lang/rust/pull/42155
2345 [42271]: https://github.com/rust-lang/rust/pull/42271
2346 [42397]: https://github.com/rust-lang/rust/pull/42397
2347 [42417]: https://github.com/rust-lang/rust/pull/42417
2348 [42430]: https://github.com/rust-lang/rust/pull/42430
2349 [42431]: https://github.com/rust-lang/rust/pull/42431
2350 [42533]: https://github.com/rust-lang/rust/pull/42533
2351 [42571]: https://github.com/rust-lang/rust/pull/42571
2352 [42613]: https://github.com/rust-lang/rust/pull/42613
2353 [42799]: https://github.com/rust-lang/rust/pull/42799
2354 [42807]: https://github.com/rust-lang/rust/pull/42807
2355 [42809]: https://github.com/rust-lang/rust/pull/42809
2356 [42822]: https://github.com/rust-lang/rust/pull/42822
2357 [42826]: https://github.com/rust-lang/rust/pull/42826
2358 [42854]: https://github.com/rust-lang/rust/pull/42854
2359 [42913]: https://github.com/rust-lang/rust/pull/42913
2360 [42999]: https://github.com/rust-lang/rust/pull/42999
2361 [43011]: https://github.com/rust-lang/rust/pull/43011
2362 [43015]: https://github.com/rust-lang/rust/pull/43015
2363 [43072]: https://github.com/rust-lang/rust/pull/43072
2364 [43077]: https://github.com/rust-lang/rust/pull/43077
2365 [43097]: https://github.com/rust-lang/rust/pull/43097
2366 [43099]: https://github.com/rust-lang/rust/pull/43099
2367 [43170]: https://github.com/rust-lang/rust/pull/43170
2368 [43178]: https://github.com/rust-lang/rust/pull/43178
2369 [43185]: https://github.com/rust-lang/rust/pull/43185
2370 [43228]: https://github.com/rust-lang/rust/pull/43228
2371 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2372 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2373 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2374 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2375 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2376 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2377 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2378 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2379 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2380 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2381 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2382 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2383 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2384 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2385 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2386 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2387 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2388 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2389 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2390 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2391 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2392 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2393 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2394 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2395 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2396 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2397 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2398 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2399 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2400 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2401 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2402 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2403 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2404 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2405 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2406 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2407 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2408 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2409 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2410
2411
2412 Version 1.19.0 (2017-07-20)
2413 ===========================
2414
2415 Language
2416 --------
2417
2418 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2419   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2420 - [Macro recursion limit increased to 1024 from 64.][41676]
2421 - [Added lint for detecting unused macros.][41907]
2422 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2423   For example: `let x = loop { break 7; };`
2424 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2425   contain `Copy` types and cannot have a `Drop` implementation.
2426   Example: `union Foo { bar: u8, baz: usize }`
2427 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2428   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2429
2430 Compiler
2431 --------
2432
2433 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2434 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2435   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2436   you should use `--target armv7-linux-androideabi`.
2437 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2438 - [Minor optimisation of string operations.][42037]
2439 - [Compiler error message is now `aborting due to previous error(s)` instead of
2440   `aborting due to N previous errors`][42150] This was previously inaccurate and
2441   would only count certain kinds of errors.
2442 - [The compiler now supports Visual Studio 2017][42225]
2443 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2444 - [Added a lot][42264] of [new error codes][42302]
2445 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2446   libraries with C Run-time Libraries(CRT) to be statically linked.
2447 - [Fixed various ARM codegen bugs][42740]
2448
2449 Libraries
2450 ---------
2451
2452 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2453   `Extend<Cow<'a, str>>`][41449]
2454 - [`Vec` now implements `From<&mut [T]>`][41530]
2455 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2456 - [`SplitWhitespace` now implements `Clone`][41659]
2457 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2458   1.5x faster][41764]
2459 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2460   macros, but for printing to stderr.
2461
2462 Stabilized APIs
2463 ---------------
2464
2465 - [`OsString::shrink_to_fit`]
2466 - [`cmp::Reverse`]
2467 - [`Command::envs`]
2468 - [`thread::ThreadId`]
2469
2470 Cargo
2471 -----
2472
2473 - [Build scripts can now add environment variables to the environment
2474   the crate is being compiled in.
2475   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2476 - [Subcommands now replace the current process rather than spawning a new
2477   child process][cargo/3970]
2478 - [Workspace members can now accept glob file patterns][cargo/3979]
2479 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2480   the members in a given workspace.][cargo/3988]
2481 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2482 - [Target directory path is now in the cargo metadata][cargo/4022]
2483 - [Cargo no longer checks out a local working directory for the
2484   crates.io index][cargo/4026] This should provide smaller file size for the
2485   registry, and improve cloning times, especially on Windows machines.
2486 - [Added an `--exclude` option for excluding certain packages when using the
2487   `--all` option][cargo/4031]
2488 - [Cargo will now automatically retry when receiving a 5xx error
2489   from crates.io][cargo/4032]
2490 - [The `--features` option now accepts multiple comma or space
2491   delimited values.][cargo/4084]
2492 - [Added support for custom target specific runners][cargo/3954]
2493
2494 Misc
2495 ----
2496
2497 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2498   Windows Debugger.
2499 - [Rust will now release XZ compressed packages][rust-installer/57]
2500 - [rustup will now prefer to download rust packages with
2501   XZ compression][rustup/1100] over GZip packages.
2502 - [Added the ability to escape `#` in rust documentation][41785] By adding
2503   additional `#`'s ie. `##` is now `#`
2504
2505 Compatibility Notes
2506 -------------------
2507
2508 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2509 - [`-Z` flags are now no longer allowed to be used on the stable
2510   compiler.][41751] This has been a warning for a year previous to this.
2511 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2512   longer works][42844]. Users should migrate to the built-in `check`
2513   command, which has been available since 1.16.
2514 - [Ending a float literal with `._` is now a hard error.
2515   Example: `42._` .][41946]
2516 - [Any use of a private `extern crate` outside of its module is now a
2517   hard error.][36886] This was previously a warning.
2518 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2519   relative while the `::` prefix makes a path absolute, but was ignored and the
2520   path was relative regardless.
2521 - [Floating point constants in match patterns is now a hard error][36890]
2522   This was previously a warning.
2523 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2524   match patterns is now a hard error][36891] This was previously a warning.
2525 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2526   a warning.
2527 - [From the pound escape, lines consisting of multiple `#`s are
2528   now visible][41785]
2529 - [It is an error to re-export private enum variants][42460]. This is
2530   known to break a number of crates that depend on an older version of
2531   mustache.
2532 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2533   to use it to find the linker, and the build will fail where it did
2534   not previously][42607]
2535
2536 [36886]: https://github.com/rust-lang/rust/issues/36886
2537 [36888]: https://github.com/rust-lang/rust/issues/36888
2538 [36890]: https://github.com/rust-lang/rust/issues/36890
2539 [36891]: https://github.com/rust-lang/rust/issues/36891
2540 [36892]: https://github.com/rust-lang/rust/issues/36892
2541 [37406]: https://github.com/rust-lang/rust/issues/37406
2542 [39983]: https://github.com/rust-lang/rust/pull/39983
2543 [41145]: https://github.com/rust-lang/rust/pull/41145
2544 [41192]: https://github.com/rust-lang/rust/pull/41192
2545 [41258]: https://github.com/rust-lang/rust/pull/41258
2546 [41370]: https://github.com/rust-lang/rust/pull/41370
2547 [41449]: https://github.com/rust-lang/rust/pull/41449
2548 [41530]: https://github.com/rust-lang/rust/pull/41530
2549 [41624]: https://github.com/rust-lang/rust/pull/41624
2550 [41656]: https://github.com/rust-lang/rust/pull/41656
2551 [41659]: https://github.com/rust-lang/rust/pull/41659
2552 [41676]: https://github.com/rust-lang/rust/pull/41676
2553 [41751]: https://github.com/rust-lang/rust/pull/41751
2554 [41764]: https://github.com/rust-lang/rust/pull/41764
2555 [41785]: https://github.com/rust-lang/rust/pull/41785
2556 [41873]: https://github.com/rust-lang/rust/pull/41873
2557 [41907]: https://github.com/rust-lang/rust/pull/41907
2558 [41946]: https://github.com/rust-lang/rust/pull/41946
2559 [42016]: https://github.com/rust-lang/rust/pull/42016
2560 [42037]: https://github.com/rust-lang/rust/pull/42037
2561 [42068]: https://github.com/rust-lang/rust/pull/42068
2562 [42150]: https://github.com/rust-lang/rust/pull/42150
2563 [42162]: https://github.com/rust-lang/rust/pull/42162
2564 [42225]: https://github.com/rust-lang/rust/pull/42225
2565 [42264]: https://github.com/rust-lang/rust/pull/42264
2566 [42302]: https://github.com/rust-lang/rust/pull/42302
2567 [42460]: https://github.com/rust-lang/rust/issues/42460
2568 [42607]: https://github.com/rust-lang/rust/issues/42607
2569 [42740]: https://github.com/rust-lang/rust/pull/42740
2570 [42844]: https://github.com/rust-lang/rust/issues/42844
2571 [42948]: https://github.com/rust-lang/rust/pull/42948
2572 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2573 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2574 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2575 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2576 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2577 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2578 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2579 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2580 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2581 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2582 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2583 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2584 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2585 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2586 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2587 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2588 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2589 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2590 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2591 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2592 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2593 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2594
2595
2596 Version 1.18.0 (2017-06-08)
2597 ===========================
2598
2599 Language
2600 --------
2601
2602 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2603   make the item visible to just that module tree. Also accepts the keyword
2604   `crate` to make something public to the whole crate but not users of the
2605   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2606 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2607   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2608 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2609   types like `Write + Send`, trailing `+` are now supported in trait objects,
2610   and better error reporting for trait objects starting with `?Sized`.
2611 - [0e+10 is now a valid floating point literal][40589]
2612 - [Now warns if you bind a lifetime parameter to 'static][40734]
2613 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2614   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2615   representation in some cases.][40377]
2616
2617 Compiler
2618 --------
2619
2620 - [rustc can now emit mir with `--emit mir`][39891]
2621 - [Improved LLVM IR for trivial functions][40367]
2622 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2623 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2624   opportunities found through profiling
2625 - [Improved backtrace formatting when panicking][38165]
2626
2627 Libraries
2628 ---------
2629
2630 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2631   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2632   iteration or reallocation.
2633 - [Simplified HashMap Bucket interface][40561] provides performance
2634   improvements for iterating and cloning.
2635 - [Specialize Vec::from_elem to use calloc][40409]
2636 - [Fixed Race condition in fs::create_dir_all][39799]
2637 - [No longer caching stdio on Windows][40516]
2638 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2639   2.50%~ faster and in one case now 12.50% faster.
2640 - [Optimized `AtomicBool::fetch_nand`][41143]
2641
2642 Stabilized APIs
2643 ---------------
2644
2645 - [`Child::try_wait`]
2646 - [`HashMap::retain`]
2647 - [`HashSet::retain`]
2648 - [`PeekMut::pop`]
2649 - [`TcpStream::peek`]
2650 - [`UdpSocket::peek`]
2651 - [`UdpSocket::peek_from`]
2652
2653 Cargo
2654 -----
2655
2656 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
2657   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
2658 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
2659 - [Added Android build support][cargo/3885]
2660 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
2661   of a certain type, for example `cargo build --bins` will build all
2662   binaries.
2663 - [Added support for haiku][cargo/3952]
2664
2665 Misc
2666 ----
2667
2668 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
2669 - [Added rust-windbg script for better debugging on Windows][39983]
2670 - [Rust now uses the official cross compiler for NetBSD][40612]
2671 - [rustdoc now accepts `#` at the start of files][40828]
2672 - [Fixed jemalloc support for musl][41168]
2673
2674 Compatibility Notes
2675 -------------------
2676
2677 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
2678   always placed after the sign if it exists and before the digits. With the `#`
2679   flag the zeroes are placed after the prefix and before the digits.
2680 - [Due to the struct field optimisation][40377], using `transmute` on structs
2681   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
2682   always been undefined behavior, but is now more likely to break in practice.
2683 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
2684   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
2685   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
2686 - [Overlapping inherent `impl`s are now a hard error][40728]
2687 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
2688 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
2689   `out.asm` and `out.ll` instead of only one of the filetypes.
2690 - [ calling a function that returns `Self` will no longer work][41805] when
2691   the size of `Self` cannot be statically determined.
2692 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
2693   this has caused a few regressions namely:
2694
2695   - Changed the link order of local static/dynamic libraries (respecting the
2696     order on given rather than having the compiler reorder).
2697   - Changed how MinGW is linked, native code linked to dynamic libraries
2698     may require manually linking to the gcc support library (for the native
2699     code itself)
2700
2701 [38165]: https://github.com/rust-lang/rust/pull/38165
2702 [39799]: https://github.com/rust-lang/rust/pull/39799
2703 [39891]: https://github.com/rust-lang/rust/pull/39891
2704 [39983]: https://github.com/rust-lang/rust/pull/39983
2705 [40043]: https://github.com/rust-lang/rust/pull/40043
2706 [40241]: https://github.com/rust-lang/rust/pull/40241
2707 [40338]: https://github.com/rust-lang/rust/pull/40338
2708 [40367]: https://github.com/rust-lang/rust/pull/40367
2709 [40377]: https://github.com/rust-lang/rust/pull/40377
2710 [40409]: https://github.com/rust-lang/rust/pull/40409
2711 [40516]: https://github.com/rust-lang/rust/pull/40516
2712 [40556]: https://github.com/rust-lang/rust/pull/40556
2713 [40561]: https://github.com/rust-lang/rust/pull/40561
2714 [40589]: https://github.com/rust-lang/rust/pull/40589
2715 [40612]: https://github.com/rust-lang/rust/pull/40612
2716 [40723]: https://github.com/rust-lang/rust/pull/40723
2717 [40728]: https://github.com/rust-lang/rust/pull/40728
2718 [40731]: https://github.com/rust-lang/rust/pull/40731
2719 [40734]: https://github.com/rust-lang/rust/pull/40734
2720 [40805]: https://github.com/rust-lang/rust/pull/40805
2721 [40807]: https://github.com/rust-lang/rust/pull/40807
2722 [40828]: https://github.com/rust-lang/rust/pull/40828
2723 [40870]: https://github.com/rust-lang/rust/pull/40870
2724 [41085]: https://github.com/rust-lang/rust/pull/41085
2725 [41143]: https://github.com/rust-lang/rust/pull/41143
2726 [41168]: https://github.com/rust-lang/rust/pull/41168
2727 [41270]: https://github.com/rust-lang/rust/issues/41270
2728 [41469]: https://github.com/rust-lang/rust/pull/41469
2729 [41805]: https://github.com/rust-lang/rust/issues/41805
2730 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
2731 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
2732 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
2733 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
2734 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
2735 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
2736 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
2737 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
2738 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
2739 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
2740 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
2741 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
2742 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
2743 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
2744
2745
2746 Version 1.17.0 (2017-04-27)
2747 ===========================
2748
2749 Language
2750 --------
2751
2752 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
2753 * [Fields of structs may be initialized without duplicating the field/variable
2754   names][39761]. [RFC 1682]
2755 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
2756 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2757   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
2758   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
2759   `'b`. Soundness fix.
2760 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
2761 * [Static variables may contain references to other statics][40027]
2762
2763 Compiler
2764 --------
2765
2766 * [Exit quickly on only `--emit dep-info`][40336]
2767 * [Make `-C relocation-model` more correctly determine whether the linker
2768   creates a position-independent executable][40245]
2769 * [Add `-C overflow-checks` to directly control whether integer overflow
2770   panics][40037]
2771 * [The rustc type checker now checks items on demand instead of in a single
2772   in-order pass][40008]. This is mostly an internal refactoring in support of
2773   future work, including incremental type checking, but also resolves [RFC
2774   1647], allowing `Self` to appear in `impl` `where` clauses.
2775 * [Optimize vtable loads][39995]
2776 * [Turn off vectorization for Emscripten targets][39990]
2777 * [Provide suggestions for unknown macros imported with `use`][39953]
2778 * [Fix ICEs in path resolution][39939]
2779 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
2780 * [Add clearer error message using `&str + &str`][39116]
2781
2782 Stabilized APIs
2783 ---------------
2784
2785 * [`Arc::into_raw`]
2786 * [`Arc::from_raw`]
2787 * [`Arc::ptr_eq`]
2788 * [`Rc::into_raw`]
2789 * [`Rc::from_raw`]
2790 * [`Rc::ptr_eq`]
2791 * [`Ordering::then`]
2792 * [`Ordering::then_with`]
2793 * [`BTreeMap::range`]
2794 * [`BTreeMap::range_mut`]
2795 * [`collections::Bound`]
2796 * [`process::abort`]
2797 * [`ptr::read_unaligned`]
2798 * [`ptr::write_unaligned`]
2799 * [`Result::expect_err`]
2800 * [`Cell::swap`]
2801 * [`Cell::replace`]
2802 * [`Cell::into_inner`]
2803 * [`Cell::take`]
2804
2805 Libraries
2806 ---------
2807
2808 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
2809 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
2810 * [`String` implements `FromIterator<&char>`][40028]
2811 * `Box` [implements][40009] a number of new conversions:
2812   `From<Box<str>> for String`,
2813   `From<Box<[T]>> for Vec<T>`,
2814   `From<Box<CStr>> for CString`,
2815   `From<Box<OsStr>> for OsString`,
2816   `From<Box<Path>> for PathBuf`,
2817   `Into<Box<str>> for String`,
2818   `Into<Box<[T]>> for Vec<T>`,
2819   `Into<Box<CStr>> for CString`,
2820   `Into<Box<OsStr>> for OsString`,
2821   `Into<Box<Path>> for PathBuf`,
2822   `Default for Box<str>`,
2823   `Default for Box<CStr>`,
2824   `Default for Box<OsStr>`,
2825   `From<&CStr> for Box<CStr>`,
2826   `From<&OsStr> for Box<OsStr>`,
2827   `From<&Path> for Box<Path>`
2828 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2829 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2830 * [Slightly optimize `slice::sort`][39538]
2831 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2832 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2833   `Box<str>` implements `From<&str>`][39438]
2834 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2835   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2836 * [`format!` estimates the needed capacity before writing a string][39356]
2837 * [Support unprivileged symlink creation in Windows][38921]
2838 * [`PathBuf` implements `Default`][38764]
2839 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2840 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2841   and poor hash functions.
2842
2843 Cargo
2844 -----
2845
2846 * [Add `cargo check --all`][cargo/3731]
2847 * [Add an option to ignore SSL revocation checking][cargo/3699]
2848 * [Add `cargo run --package`][cargo/3691]
2849 * [Add `required_features`][cargo/3667]
2850 * [Assume `build.rs` is a build script][cargo/3664]
2851 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2852
2853 Misc
2854 ----
2855
2856 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2857   `rustbook`][39633]
2858 * [The "Unstable Book" documents nightly-only features][ubook]
2859 * [Improve the style of the sidebar in rustdoc output][40265]
2860 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2861 * [Fix MSP430 breakage due to `i128`][40257]
2862 * [Preliminary Solaris/SPARCv9 support][39903]
2863 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2864   run without installing the MSVC runtime.
2865 * [`rustdoc --test` includes file names in test names][39788]
2866 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2867   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2868 * [Initial support for `aarch64-unknown-freebsd`][39491]
2869 * [Initial support for `i686-unknown-netbsd`][39426]
2870 * [This release no longer includes the old makefile build system][39431]. Rust
2871   is built with a custom build system, written in Rust, and with Cargo.
2872 * [Add Debug implementations for libcollection structs][39002]
2873 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2874 * [`--test-threads=0` produces an error][38945]
2875 * [`rustup` installs documentation by default][40526]
2876 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2877   WinDbg and Visual Studio to improve the debugging experience.
2878
2879 Compatibility Notes
2880 -------------------
2881
2882 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2883   workaround, either use MSVC 2015 or run vcvars.bat.
2884 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2885   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2886   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2887   fix.
2888 * [`format!` and `Display::to_string` panic if an underlying formatting
2889   implementation returns an error][40117]. Previously the error was silently
2890   ignored. It is incorrect for `write_fmt` to return an error when writing
2891   to a string.
2892 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2893   crates were marked stable and could be accessed from the stable toolchain.
2894 * [Rust git source no longer includes vendored crates][39728]. Those that need
2895   to build with vendored crates should build from release tarballs.
2896 * [Fix inert attributes from `proc_macro_derives`][39572]
2897 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2898   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2899   build system.
2900 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2901   existing code generally ignores the type of dead-code unless a type-hint is
2902   provided; this can cause surprising inference interactions particularly around
2903   defaulting. The new code uniformly ignores the result type of dead-code.
2904 * [Tuple-struct constructors with private fields are no longer visible][38932]
2905 * [Lifetime parameters that do not appear in the arguments are now considered
2906   early-bound][38897], resolving a soundness bug (#[32330]). The
2907   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2908   April of 2016.
2909 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2910 * [Make transmuting from fn item types to pointer-sized types a hard
2911   error][34198]
2912
2913 [27787]: https://github.com/rust-lang/rust/issues/27787
2914 [32330]: https://github.com/rust-lang/rust/issues/32330
2915 [34198]: https://github.com/rust-lang/rust/pull/34198
2916 [38161]: https://github.com/rust-lang/rust/pull/38161
2917 [38368]: https://github.com/rust-lang/rust/pull/38368
2918 [38584]: https://github.com/rust-lang/rust/issues/38584
2919 [38661]: https://github.com/rust-lang/rust/pull/38661
2920 [38764]: https://github.com/rust-lang/rust/pull/38764
2921 [38864]: https://github.com/rust-lang/rust/issues/38864
2922 [38897]: https://github.com/rust-lang/rust/pull/38897
2923 [38921]: https://github.com/rust-lang/rust/pull/38921
2924 [38932]: https://github.com/rust-lang/rust/pull/38932
2925 [38945]: https://github.com/rust-lang/rust/pull/38945
2926 [38981]: https://github.com/rust-lang/rust/pull/38981
2927 [39002]: https://github.com/rust-lang/rust/pull/39002
2928 [39116]: https://github.com/rust-lang/rust/pull/39116
2929 [39193]: https://github.com/rust-lang/rust/pull/39193
2930 [39265]: https://github.com/rust-lang/rust/pull/39265
2931 [39356]: https://github.com/rust-lang/rust/pull/39356
2932 [39372]: https://github.com/rust-lang/rust/pull/39372
2933 [39426]: https://github.com/rust-lang/rust/pull/39426
2934 [39431]: https://github.com/rust-lang/rust/pull/39431
2935 [39438]: https://github.com/rust-lang/rust/pull/39438
2936 [39440]: https://github.com/rust-lang/rust/pull/39440
2937 [39485]: https://github.com/rust-lang/rust/pull/39485
2938 [39491]: https://github.com/rust-lang/rust/pull/39491
2939 [39518]: https://github.com/rust-lang/rust/pull/39518
2940 [39538]: https://github.com/rust-lang/rust/pull/39538
2941 [39572]: https://github.com/rust-lang/rust/pull/39572
2942 [39633]: https://github.com/rust-lang/rust/pull/39633
2943 [39642]: https://github.com/rust-lang/rust/pull/39642
2944 [39728]: https://github.com/rust-lang/rust/pull/39728
2945 [39761]: https://github.com/rust-lang/rust/pull/39761
2946 [39788]: https://github.com/rust-lang/rust/pull/39788
2947 [39793]: https://github.com/rust-lang/rust/pull/39793
2948 [39837]: https://github.com/rust-lang/rust/pull/39837
2949 [39843]: https://github.com/rust-lang/rust/pull/39843
2950 [39851]: https://github.com/rust-lang/rust/pull/39851
2951 [39903]: https://github.com/rust-lang/rust/pull/39903
2952 [39939]: https://github.com/rust-lang/rust/pull/39939
2953 [39953]: https://github.com/rust-lang/rust/pull/39953
2954 [39960]: https://github.com/rust-lang/rust/pull/39960
2955 [39990]: https://github.com/rust-lang/rust/pull/39990
2956 [39995]: https://github.com/rust-lang/rust/pull/39995
2957 [40008]: https://github.com/rust-lang/rust/pull/40008
2958 [40009]: https://github.com/rust-lang/rust/pull/40009
2959 [40027]: https://github.com/rust-lang/rust/pull/40027
2960 [40028]: https://github.com/rust-lang/rust/pull/40028
2961 [40037]: https://github.com/rust-lang/rust/pull/40037
2962 [40117]: https://github.com/rust-lang/rust/pull/40117
2963 [40166]: https://github.com/rust-lang/rust/pull/40166
2964 [40245]: https://github.com/rust-lang/rust/pull/40245
2965 [40257]: https://github.com/rust-lang/rust/pull/40257
2966 [40261]: https://github.com/rust-lang/rust/pull/40261
2967 [40265]: https://github.com/rust-lang/rust/pull/40265
2968 [40319]: https://github.com/rust-lang/rust/pull/40319
2969 [40336]: https://github.com/rust-lang/rust/pull/40336
2970 [40526]: https://github.com/rust-lang/rust/pull/40526
2971 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2972 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2973 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2974 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2975 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2976 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2977 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2978 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2979 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2980 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2981 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2982 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2983 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2984 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2985 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2986 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2987 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2988 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2989 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2990 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2991 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2992 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2993 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2994 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2995 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2996 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2997 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2998 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2999 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3000 [mdbook]: https://crates.io/crates/mdbook
3001 [ubook]: https://doc.rust-lang.org/unstable-book/
3002
3003
3004 Version 1.16.0 (2017-03-16)
3005 ===========================
3006
3007 Language
3008 --------
3009
3010 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3011 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3012   match patterns][38069]
3013 * [Clean up semantics of `self` in an import list][38313]
3014 * [`Self` may appear in `impl` headers][38920]
3015 * [`Self` may appear in struct expressions][39282]
3016
3017 Compiler
3018 --------
3019
3020 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3021   a `.rmeta` file containing only crate metadata][38571]. This can be
3022   used by tools like the Rust Language Service to perform
3023   metadata-only builds.
3024 * [Levenshtein based typo suggestions now work in most places, while
3025   previously they worked only for fields and sometimes for local
3026   variables][38927]. Together with the overhaul of "no
3027   resolution"/"unexpected resolution" errors (#[38154]) they result in
3028   large and systematic improvement in resolution diagnostics.
3029 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3030   `U`][38670]
3031 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3032 * [`rustc` no longer attempts to provide "consider using an explicit
3033   lifetime" suggestions][37057]. They were inaccurate.
3034
3035 Stabilized APIs
3036 ---------------
3037
3038 * [`VecDeque::truncate`]
3039 * [`VecDeque::resize`]
3040 * [`String::insert_str`]
3041 * [`Duration::checked_add`]
3042 * [`Duration::checked_sub`]
3043 * [`Duration::checked_div`]
3044 * [`Duration::checked_mul`]
3045 * [`str::replacen`]
3046 * [`str::repeat`]
3047 * [`SocketAddr::is_ipv4`]
3048 * [`SocketAddr::is_ipv6`]
3049 * [`IpAddr::is_ipv4`]
3050 * [`IpAddr::is_ipv6`]
3051 * [`Vec::dedup_by`]
3052 * [`Vec::dedup_by_key`]
3053 * [`Result::unwrap_or_default`]
3054 * [`<*const T>::wrapping_offset`]
3055 * [`<*mut T>::wrapping_offset`]
3056 * `CommandExt::creation_flags`
3057 * [`File::set_permissions`]
3058 * [`String::split_off`]
3059
3060 Libraries
3061 ---------
3062
3063 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3064   their argument by `Borrow` parameter][37761]
3065 * [All public types in std implement `Debug`][38006]
3066 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3067 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3068 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3069   Windows][38274]
3070 * [std: Fix partial writes in `LineWriter`][38062]
3071 * [std: Clamp max read/write sizes on Unix][38062]
3072 * [Use more specific panic message for `&str` slicing errors][38066]
3073 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3074   functionality cannot be achieved in std currently.
3075 * [`writeln!`, like `println!`, now accepts a form with no string
3076   or formatting arguments, to just print a newline][38469]
3077 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3078 * [Reduce the size of static data in `std_unicode::tables`][38781]
3079 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3080   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3081   `Display`][38909]
3082 * [`Duration` implements `Sum`][38712]
3083 * [`String` implements `ToSocketAddrs`][39048]
3084
3085 Cargo
3086 -----
3087
3088 * [The `cargo check` command does a type check of a project without
3089   building it][cargo/3296]
3090 * [crates.io will display CI badges from Travis and AppVeyor, if
3091   specified in Cargo.toml][cargo/3546]
3092 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3093 * [Compilation profiles accept integer values for `debug`, in addition
3094   to `true` and `false`. These are passed to `rustc` as the value to
3095   `-C debuginfo`][cargo/3534]
3096 * [Implement `cargo --version --verbose`][cargo/3604]
3097 * [All builds now output 'dep-info' build dependencies compatible with
3098   make and ninja][cargo/3557]
3099 * [Build all workspace members with `build --all`][cargo/3511]
3100 * [Document all workspace members with `doc --all`][cargo/3515]
3101 * [Path deps outside workspace are not members][cargo/3443]
3102
3103 Misc
3104 ----
3105
3106 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3107   the path to the Rust implementation][38589]
3108 * [The `armv7-linux-androideabi` target no longer enables NEON
3109   extensions, per Google's ABI guide][38413]
3110 * [The stock standard library can be compiled for Redox OS][38401]
3111 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3112   available.
3113 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3114   builds available.
3115 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3116
3117 Compatibility Notes
3118 -------------------
3119
3120 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3121   match patterns][38069]
3122 * In this release, references to uninhabited types can not be
3123   pattern-matched. This was accidentally allowed in 1.15.
3124 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3125 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3126   Windows][38274]
3127 * [Clean up semantics of `self` in an import list][38313]
3128 * Reimplemented lifetime elision. This change was almost entirely compatible
3129   with existing code, but it did close a number of small bugs and loopholes,
3130   as well as being more accepting in some other [cases][41105].
3131
3132 [37057]: https://github.com/rust-lang/rust/pull/37057
3133 [37761]: https://github.com/rust-lang/rust/pull/37761
3134 [38006]: https://github.com/rust-lang/rust/pull/38006
3135 [38051]: https://github.com/rust-lang/rust/pull/38051
3136 [38062]: https://github.com/rust-lang/rust/pull/38062
3137 [38062]: https://github.com/rust-lang/rust/pull/38622
3138 [38066]: https://github.com/rust-lang/rust/pull/38066
3139 [38069]: https://github.com/rust-lang/rust/pull/38069
3140 [38131]: https://github.com/rust-lang/rust/pull/38131
3141 [38154]: https://github.com/rust-lang/rust/pull/38154
3142 [38274]: https://github.com/rust-lang/rust/pull/38274
3143 [38304]: https://github.com/rust-lang/rust/pull/38304
3144 [38313]: https://github.com/rust-lang/rust/pull/38313
3145 [38314]: https://github.com/rust-lang/rust/pull/38314
3146 [38327]: https://github.com/rust-lang/rust/pull/38327
3147 [38401]: https://github.com/rust-lang/rust/pull/38401
3148 [38413]: https://github.com/rust-lang/rust/pull/38413
3149 [38469]: https://github.com/rust-lang/rust/pull/38469
3150 [38559]: https://github.com/rust-lang/rust/pull/38559
3151 [38571]: https://github.com/rust-lang/rust/pull/38571
3152 [38580]: https://github.com/rust-lang/rust/pull/38580
3153 [38589]: https://github.com/rust-lang/rust/pull/38589
3154 [38670]: https://github.com/rust-lang/rust/pull/38670
3155 [38712]: https://github.com/rust-lang/rust/pull/38712
3156 [38726]: https://github.com/rust-lang/rust/pull/38726
3157 [38781]: https://github.com/rust-lang/rust/pull/38781
3158 [38798]: https://github.com/rust-lang/rust/pull/38798
3159 [38909]: https://github.com/rust-lang/rust/pull/38909
3160 [38920]: https://github.com/rust-lang/rust/pull/38920
3161 [38927]: https://github.com/rust-lang/rust/pull/38927
3162 [39048]: https://github.com/rust-lang/rust/pull/39048
3163 [39282]: https://github.com/rust-lang/rust/pull/39282
3164 [39379]: https://github.com/rust-lang/rust/pull/39379
3165 [41105]: https://github.com/rust-lang/rust/issues/41105
3166 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3167 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3168 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3169 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3170 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3171 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3172 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3173 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3174 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3175 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3176 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3177 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3178 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3179 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3180 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3181 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3182 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3183 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3184 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3185 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3186 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3187 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3188 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3189 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3190 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3191 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3192 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3193 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3194 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3195 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3196
3197
3198 Version 1.15.1 (2017-02-09)
3199 ===========================
3200
3201 * [Fix IntoIter::as_mut_slice's signature][39466]
3202 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3203
3204 [39466]: https://github.com/rust-lang/rust/pull/39466
3205 [39523]: https://github.com/rust-lang/rust/pull/39523
3206
3207
3208 Version 1.15.0 (2017-02-02)
3209 ===========================
3210
3211 Language
3212 --------
3213
3214 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3215   stable. This allows popular code-generating crates like Serde and Diesel to
3216   work ergonomically. [RFC 1681].
3217 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3218   with curly braces][36868]. Part of [RFC 1506].
3219 * [A number of minor changes to name resolution have been activated][37127].
3220   They add up to more consistent semantics, allowing for future evolution of
3221   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3222   details of what is different. The breaking changes here have been transitioned
3223   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3224 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3225   bounds][38279]
3226 * [`?Sized` can be used in `where` clauses][37791]
3227 * [There is now a limit on the size of monomorphized types and it can be
3228   modified with the `#![type_size_limit]` crate attribute, similarly to
3229   the `#![recursion_limit]` attribute][37789]
3230
3231 Compiler
3232 --------
3233
3234 * [On Windows, the compiler will apply dllimport attributes when linking to
3235   extern functions][37973]. Additional attributes and flags can control which
3236   library kind is linked and its name. [RFC 1717].
3237 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3238 * [The `--test` flag works with procedural macro crates][38107]
3239 * [Fix `extern "aapcs" fn` ABI][37814]
3240 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3241 * [The `format!` expander recognizes incorrect `printf` and shell-style
3242   formatting directives and suggests the correct format][37613].
3243 * [Only report one error for all unused imports in an import list][37456]
3244
3245 Compiler Performance
3246 --------------------
3247
3248 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3249 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3250 * [Don't clone in `UnificationTable::probe`][37848]
3251 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3252 * [Use small vectors in type walker][37760]
3253 * [Macro expansion performance was improved][37701]
3254 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3255 * [Replace FNV with a faster hash function][37229]
3256
3257 Stabilized APIs
3258 ---------------
3259
3260 * [`std::iter::Iterator::min_by`]
3261 * [`std::iter::Iterator::max_by`]
3262 * [`std::os::*::fs::FileExt`]
3263 * [`std::sync::atomic::Atomic*::get_mut`]
3264 * [`std::sync::atomic::Atomic*::into_inner`]
3265 * [`std::vec::IntoIter::as_slice`]
3266 * [`std::vec::IntoIter::as_mut_slice`]
3267 * [`std::sync::mpsc::Receiver::try_iter`]
3268 * [`std::os::unix::process::CommandExt::before_exec`]
3269 * [`std::rc::Rc::strong_count`]
3270 * [`std::rc::Rc::weak_count`]
3271 * [`std::sync::Arc::strong_count`]
3272 * [`std::sync::Arc::weak_count`]
3273 * [`std::char::encode_utf8`]
3274 * [`std::char::encode_utf16`]
3275 * [`std::cell::Ref::clone`]
3276 * [`std::io::Take::into_inner`]
3277
3278 Libraries
3279 ---------
3280
3281 * [The standard sorting algorithm has been rewritten for dramatic performance
3282   improvements][38192]. It is a hybrid merge sort, drawing influences from
3283   Timsort. Previously it was a naive merge sort.
3284 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3285 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3286   performance.
3287 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3288   and `char_indices().last()`][37882]
3289 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3290 * [Chinese characters display correctly in `fmt::Debug`][37855]
3291 * [Derive `Default` for `Duration`][37699]
3292 * [Support creation of anonymous pipes on WinXP/2k][37677]
3293 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3294 * [Don't pass overlapped handles to processes][38835]
3295
3296 Cargo
3297 -----
3298
3299 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3300   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3301   should instead check the variable at runtime with `std::env`. That the value
3302   was set at build time was a bug, and incorrect when cross-compiling. This
3303   change is known to cause breakage.
3304 * [Add `--all` flag to `cargo test`][cargo/3221]
3305 * [Compile statically against the MSVC CRT][cargo/3363]
3306 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3307 * [Link OpenSSL statically on OSX][cargo/3311]
3308 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3309 * [Test for bad path overrides with summaries][cargo/3336]
3310 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3311 * [Fix retrying crate downloads for network errors][cargo/3348]
3312 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3313 * [Emit more info on --message-format=json][cargo/3319]
3314 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3315 * [Don't ignore errors in workspace manifest][cargo/3409]
3316 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3317
3318 Tooling
3319 -------
3320
3321 * [Test runners (binaries built with `--test`) now support a `--list` argument
3322   that lists the tests it contains][38185]
3323 * [Test runners now support a `--exact` argument that makes the test filter
3324   match exactly, instead of matching only a substring of the test name][38181]
3325 * [rustdoc supports a `--playground-url` flag][37763]
3326 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3327
3328 Misc
3329 ----
3330
3331 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3332   continue to be used in this release by passing `--disable-rustbuild` to the
3333   configure script, but they will be deleted soon. Note that the new build
3334   system uses a different on-disk layout that will likely affect any scripts
3335   building Rust.
3336 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3337   releases.
3338 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3339 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3340   releases.
3341
3342 Compatibility Notes
3343 -------------------
3344
3345 * [A number of minor changes to name resolution have been activated][37127].
3346   They add up to more consistent semantics, allowing for future evolution of
3347   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3348   details of what is different. The breaking changes here have been transitioned
3349   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3350 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3351   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3352   should instead check the variable at runtime with `std::env`. That the value
3353   was set at build time was a bug, and incorrect when cross-compiling. This
3354   change is known to cause breakage.
3355 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3356   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3357   1.10 and is now an error by default. It will become a hard error in the near
3358   future.
3359 * [The semantics relating modules to file system directories are changing in
3360   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3361   lint, which is a warning in this release, and will become a hard error in the
3362   future.
3363 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3364 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3365   the underlying iterator][37834]
3366
3367 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3368 [33685]: https://github.com/rust-lang/rust/issues/33685
3369 [36868]: https://github.com/rust-lang/rust/pull/36868
3370 [37127]: https://github.com/rust-lang/rust/pull/37127
3371 [37229]: https://github.com/rust-lang/rust/pull/37229
3372 [37456]: https://github.com/rust-lang/rust/pull/37456
3373 [37527]: https://github.com/rust-lang/rust/pull/37527
3374 [37602]: https://github.com/rust-lang/rust/pull/37602
3375 [37613]: https://github.com/rust-lang/rust/pull/37613
3376 [37615]: https://github.com/rust-lang/rust/pull/37615
3377 [37636]: https://github.com/rust-lang/rust/pull/37636
3378 [37627]: https://github.com/rust-lang/rust/pull/37627
3379 [37642]: https://github.com/rust-lang/rust/pull/37642
3380 [37677]: https://github.com/rust-lang/rust/pull/37677
3381 [37699]: https://github.com/rust-lang/rust/pull/37699
3382 [37701]: https://github.com/rust-lang/rust/pull/37701
3383 [37705]: https://github.com/rust-lang/rust/pull/37705
3384 [37749]: https://github.com/rust-lang/rust/pull/37749
3385 [37760]: https://github.com/rust-lang/rust/pull/37760
3386 [37763]: https://github.com/rust-lang/rust/pull/37763
3387 [37764]: https://github.com/rust-lang/rust/pull/37764
3388 [37789]: https://github.com/rust-lang/rust/pull/37789
3389 [37791]: https://github.com/rust-lang/rust/pull/37791
3390 [37814]: https://github.com/rust-lang/rust/pull/37814
3391 [37817]: https://github.com/rust-lang/rust/pull/37817
3392 [37834]: https://github.com/rust-lang/rust/pull/37834
3393 [37848]: https://github.com/rust-lang/rust/pull/37848
3394 [37855]: https://github.com/rust-lang/rust/pull/37855
3395 [37882]: https://github.com/rust-lang/rust/pull/37882
3396 [37888]: https://github.com/rust-lang/rust/pull/37888
3397 [37973]: https://github.com/rust-lang/rust/pull/37973
3398 [37979]: https://github.com/rust-lang/rust/pull/37979
3399 [38086]: https://github.com/rust-lang/rust/pull/38086
3400 [38107]: https://github.com/rust-lang/rust/pull/38107
3401 [38117]: https://github.com/rust-lang/rust/pull/38117
3402 [38134]: https://github.com/rust-lang/rust/pull/38134
3403 [38146]: https://github.com/rust-lang/rust/pull/38146
3404 [38181]: https://github.com/rust-lang/rust/pull/38181
3405 [38182]: https://github.com/rust-lang/rust/pull/38182
3406 [38185]: https://github.com/rust-lang/rust/pull/38185
3407 [38192]: https://github.com/rust-lang/rust/pull/38192
3408 [38279]: https://github.com/rust-lang/rust/pull/38279
3409 [38835]: https://github.com/rust-lang/rust/pull/38835
3410 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3411 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3412 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3413 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3414 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3415 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3416 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3417 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3418 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3419 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3420 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3421 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3422 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3423 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3424 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3425 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3426 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3427 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3428 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3429 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3430 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3431 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3432 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3433 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3434 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3435 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3436 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3437 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3438 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3439 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3440 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3441 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3442 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3443 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3444 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3445 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3446 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3447 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3448
3449
3450 Version 1.14.0 (2016-12-22)
3451 ===========================
3452
3453 Language
3454 --------
3455
3456 * [`..` matches multiple tuple fields in enum variants, structs
3457   and tuples][36843]. [RFC 1492].
3458 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3459 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3460 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3461   dereferencing][36822]
3462
3463 Compiler
3464 --------
3465
3466 * [Mark enums with non-zero discriminant as non-zero][37224]
3467 * [Lower-case `static mut` names are linted like other
3468   statics and consts][37162]
3469 * [Fix ICE on some macros in const integer positions
3470    (e.g. `[u8; m!()]`)][36819]
3471 * [Improve error message and snippet for "did you mean `x`"][36798]
3472 * [Add a panic-strategy field to the target specification][36794]
3473 * [Include LLVM version in `--version --verbose`][37200]
3474
3475 Compile-time Optimizations
3476 --------------------------
3477
3478 * [Improve macro expansion performance][37569]
3479 * [Shrink `Expr_::ExprInlineAsm`][37445]
3480 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3481 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3482 * [Avoid more allocations when compiling html5ever][37373]
3483 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3484 * [Avoid some allocations in the macro parser][37318]
3485 * [Use a faster deflate setting][37298]
3486 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3487   during interning of slices][37270]
3488 * [Optimize `write_metadata`][37267]
3489 * [Don't process obligation forest cycles when stalled][37231]
3490 * [Avoid many `CrateConfig` clones][37161]
3491 * [Optimize `Substs::super_fold_with`][37108]
3492 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3493 * [Speed up `plug_leaks`][36917]
3494
3495 Libraries
3496 ---------
3497
3498 * [`println!()`, with no arguments, prints newline][36825].
3499   Previously, an empty string was required to achieve the same.
3500 * [`Wrapping` impls standard binary and unary operators, as well as
3501    the `Sum` and `Product` iterators][37356]
3502 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3503   Vec<T>`][37326]
3504 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3505   `VecDeque` iterators][37315]
3506 * [Improve `SipHasher` performance on small values][37312]
3507 * [Add Iterator trait TrustedLen to enable better FromIterator /
3508   Extend][37306]
3509 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3510 * [`ReadDir` implements `Debug`][37221]
3511 * [Implement `RefUnwindSafe` for atomic types][37178]
3512 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3513 * [Avoid allocations in `Decoder::read_str`][37064]
3514 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3515 * [Impl `Debug` for raw pointers to unsized data][36880]
3516 * [Don't reuse `HashMap` random seeds][37470]
3517 * [The internal memory layout of `HashMap` is more cache-friendly, for
3518   significant improvements in some operations][36692]
3519 * [`HashMap` uses less memory on 32-bit architectures][36595]
3520 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3521
3522 Cargo
3523 -----
3524
3525 * [Expose rustc cfg values to build scripts][cargo/3243]
3526 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3527 * [Fix passing --features when testing multiple packages][cargo/3280]
3528 * [Use a single profile set per workspace][cargo/3249]
3529 * [Load `replace` sections from lock files][cargo/3220]
3530 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3531
3532 Tooling
3533 -------
3534
3535 * [rustup is the recommended Rust installation method][1.14rustup]
3536 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3537   S390x. These are [tier 2] platforms and may have major defects. Follow the
3538   instructions on the website to install, or add the targets to an existing
3539   installation with `rustup target add`. The new target triples are:
3540   - `mips-unknown-linux-gnu`
3541   - `mipsel-unknown-linux-gnu`
3542   - `mips64-unknown-linux-gnuabi64`
3543   - `mips64el-unknown-linux-gnuabi64 `
3544   - `powerpc-unknown-linux-gnu`
3545   - `powerpc64-unknown-linux-gnu`
3546   - `powerpc64le-unknown-linux-gnu`
3547   - `s390x-unknown-linux-gnu `
3548 * This release includes target (std) builds for ARM Linux running MUSL
3549   libc. These are [tier 2] platforms and may have major defects. Add the
3550   following triples to an existing rustup installation with `rustup target add`:
3551   - `arm-unknown-linux-musleabi`
3552   - `arm-unknown-linux-musleabihf`
3553   - `armv7-unknown-linux-musleabihf`
3554 * This release includes [experimental support for WebAssembly][1.14wasm], via
3555   the `wasm32-unknown-emscripten` target. This target is known to have major
3556   defects. Please test, report, and fix.
3557 * rustup no longer installs documentation by default. Run `rustup
3558   component add rust-docs` to install.
3559 * [Fix line stepping in debugger][37310]
3560 * [Enable line number debuginfo in releases][37280]
3561
3562 Misc
3563 ----
3564
3565 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3566 * [Add support for Fuchsia OS][37313]
3567 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3568
3569 Compatibility Notes
3570 -------------------
3571
3572 * [A number of forward-compatibility lints used by the compiler
3573   to gradually introduce language changes have been converted
3574   to deny by default][36894]:
3575   - ["use of inaccessible extern crate erroneously allowed"][36886]
3576   - ["type parameter default erroneously allowed in invalid location"][36887]
3577   - ["detects super or self keywords at the beginning of global path"][36888]
3578   - ["two overlapping inherent impls define an item with the same name
3579     were erroneously allowed"][36889]
3580   - ["floating-point constants cannot be used in patterns"][36890]
3581   - ["constants of struct or enum type can only be used in a pattern if
3582      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3583   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3584 * [Prohibit patterns in trait methods without bodies][37378]
3585 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3586 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3587 * [The `$crate` macro variable is accepted in fewer locations][37213]
3588 * [Impls specifying extra region requirements beyond the trait
3589   they implement are rejected][37167]
3590 * [Enums may not be unsized][37111]. Unsized enums are intended to
3591   work but never have. For now they are forbidden.
3592 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3593
3594 [tier 2]: https://forge.rust-lang.org/platform-support.html
3595 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3596 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3597 [36430]: https://github.com/rust-lang/rust/pull/36430
3598 [36595]: https://github.com/rust-lang/rust/pull/36595
3599 [36595]: https://github.com/rust-lang/rust/pull/36595
3600 [36692]: https://github.com/rust-lang/rust/pull/36692
3601 [36767]: https://github.com/rust-lang/rust/pull/36767
3602 [36794]: https://github.com/rust-lang/rust/pull/36794
3603 [36798]: https://github.com/rust-lang/rust/pull/36798
3604 [36819]: https://github.com/rust-lang/rust/pull/36819
3605 [36822]: https://github.com/rust-lang/rust/pull/36822
3606 [36825]: https://github.com/rust-lang/rust/pull/36825
3607 [36843]: https://github.com/rust-lang/rust/pull/36843
3608 [36880]: https://github.com/rust-lang/rust/pull/36880
3609 [36886]: https://github.com/rust-lang/rust/issues/36886
3610 [36887]: https://github.com/rust-lang/rust/issues/36887
3611 [36888]: https://github.com/rust-lang/rust/issues/36888
3612 [36889]: https://github.com/rust-lang/rust/issues/36889
3613 [36890]: https://github.com/rust-lang/rust/issues/36890
3614 [36891]: https://github.com/rust-lang/rust/issues/36891
3615 [36892]: https://github.com/rust-lang/rust/issues/36892
3616 [36894]: https://github.com/rust-lang/rust/pull/36894
3617 [36917]: https://github.com/rust-lang/rust/pull/36917
3618 [36993]: https://github.com/rust-lang/rust/pull/36993
3619 [37037]: https://github.com/rust-lang/rust/pull/37037
3620 [37064]: https://github.com/rust-lang/rust/pull/37064
3621 [37094]: https://github.com/rust-lang/rust/pull/37094
3622 [37108]: https://github.com/rust-lang/rust/pull/37108
3623 [37111]: https://github.com/rust-lang/rust/pull/37111
3624 [37161]: https://github.com/rust-lang/rust/pull/37161
3625 [37162]: https://github.com/rust-lang/rust/pull/37162
3626 [37167]: https://github.com/rust-lang/rust/pull/37167
3627 [37178]: https://github.com/rust-lang/rust/pull/37178
3628 [37200]: https://github.com/rust-lang/rust/pull/37200
3629 [37213]: https://github.com/rust-lang/rust/pull/37213
3630 [37221]: https://github.com/rust-lang/rust/pull/37221
3631 [37224]: https://github.com/rust-lang/rust/pull/37224
3632 [37230]: https://github.com/rust-lang/rust/pull/37230
3633 [37231]: https://github.com/rust-lang/rust/pull/37231
3634 [37247]: https://github.com/rust-lang/rust/pull/37247
3635 [37267]: https://github.com/rust-lang/rust/pull/37267
3636 [37270]: https://github.com/rust-lang/rust/pull/37270
3637 [37273]: https://github.com/rust-lang/rust/pull/37273
3638 [37280]: https://github.com/rust-lang/rust/pull/37280
3639 [37298]: https://github.com/rust-lang/rust/pull/37298
3640 [37306]: https://github.com/rust-lang/rust/pull/37306
3641 [37310]: https://github.com/rust-lang/rust/pull/37310
3642 [37312]: https://github.com/rust-lang/rust/pull/37312
3643 [37313]: https://github.com/rust-lang/rust/pull/37313
3644 [37315]: https://github.com/rust-lang/rust/pull/37315
3645 [37318]: https://github.com/rust-lang/rust/pull/37318
3646 [37322]: https://github.com/rust-lang/rust/pull/37322
3647 [37326]: https://github.com/rust-lang/rust/pull/37326
3648 [37351]: https://github.com/rust-lang/rust/pull/37351
3649 [37356]: https://github.com/rust-lang/rust/pull/37356
3650 [37367]: https://github.com/rust-lang/rust/pull/37367
3651 [37373]: https://github.com/rust-lang/rust/pull/37373
3652 [37378]: https://github.com/rust-lang/rust/pull/37378
3653 [37389]: https://github.com/rust-lang/rust/pull/37389
3654 [37392]: https://github.com/rust-lang/rust/pull/37392
3655 [37427]: https://github.com/rust-lang/rust/pull/37427
3656 [37439]: https://github.com/rust-lang/rust/pull/37439
3657 [37445]: https://github.com/rust-lang/rust/pull/37445
3658 [37470]: https://github.com/rust-lang/rust/pull/37470
3659 [37569]: https://github.com/rust-lang/rust/pull/37569
3660 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3661 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
3662 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
3663 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
3664 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
3665 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
3666 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
3667
3668
3669 Version 1.13.0 (2016-11-10)
3670 ===========================
3671
3672 Language
3673 --------
3674
3675 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
3676   errors, like the `try!` macro, described in [RFC 0243].
3677 * [Stabilize macros in type position][36014]. Described in [RFC 873].
3678 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
3679 * [Fix `#[derive]` for empty tuple structs/variants][35728]
3680 * [Fix lifetime rules for 'if' conditions][36029]
3681 * [Avoid loading and parsing unconfigured non-inline modules][36482]
3682
3683 Compiler
3684 --------
3685
3686 * [Add the `-C link-arg` argument][36574]
3687 * [Remove the old AST-based backend from rustc_trans][35764]
3688 * [Don't enable NEON by default on armv7 Linux][35814]
3689 * [Fix debug line number info for macro expansions][35238]
3690 * [Do not emit "class method" debuginfo for types that are not
3691   DICompositeType][36008]
3692 * [Warn about multiple conflicting #[repr] hints][34623]
3693 * [When sizing DST, don't double-count nested struct prefixes][36351]
3694 * [Default RUST_MIN_STACK to 16MiB for now][36505]
3695 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
3696 * [Reject macros with empty repetitions to avoid infinite loop][36721]
3697 * [Expand macros without recursing to avoid stack overflows][36214]
3698
3699 Diagnostics
3700 -----------
3701
3702 * [Replace macro backtraces with labeled local uses][35702]
3703 * [Improve error message for misplaced doc comments][33922]
3704 * [Buffer unix and lock windows to prevent message interleaving][35975]
3705 * [Update lifetime errors to specifically note temporaries][36171]
3706 * [Special case a few colors for Windows][36178]
3707 * [Suggest `use self` when such an import resolves][36289]
3708 * [Be more specific when type parameter shadows primitive type][36338]
3709 * Many minor improvements
3710
3711 Compile-time Optimizations
3712 --------------------------
3713
3714 * [Compute and cache HIR hashes at beginning][35854]
3715 * [Don't hash types in loan paths][36004]
3716 * [Cache projections in trans][35761]
3717 * [Optimize the parser's last token handling][36527]
3718 * [Only instantiate #[inline] functions in codegen units referencing
3719   them][36524]. This leads to big improvements in cases where crates export
3720   define many inline functions without using them directly.
3721 * [Lazily allocate TypedArena's first chunk][36592]
3722 * [Don't allocate during default HashSet creation][36734]
3723
3724 Stabilized APIs
3725 ---------------
3726
3727 * [`checked_abs`]
3728 * [`wrapping_abs`]
3729 * [`overflowing_abs`]
3730 * [`RefCell::try_borrow`]
3731 * [`RefCell::try_borrow_mut`]
3732
3733 Libraries
3734 ---------
3735
3736 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
3737 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
3738   covariant][35354]
3739 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
3740 * [Implement `Debug` for `std::vec::IntoIter`][35707]
3741 * [`CString`: avoid excessive growth just to 0-terminate][35871]
3742 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
3743 * [Use arc4rand on FreeBSD][35884]
3744 * [memrchr: Correct aligned offset computation][35969]
3745 * [Improve Demangling of Rust Symbols][36059]
3746 * [Use monotonic time in condition variables][35048]
3747 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
3748 * [Implement conversion traits for `char`][35755]
3749 * [Fix illegal instruction caused by overflow in channel cloning][36104]
3750 * [Zero first byte of CString on drop][36264]
3751 * [Inherit overflow checks for sum and product][36372]
3752 * [Add missing Eq implementations][36423]
3753 * [Implement `Debug` for `DirEntry`][36631]
3754 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
3755   `errno`][36754]
3756 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3757 * [Implement more traits for `std::io::ErrorKind`][35911]
3758 * [Optimize BinaryHeap bounds checking][36072]
3759 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
3760   `extend_with_element`][36355]
3761 * [Fix overflow checking in unsigned pow()][34942]
3762
3763 Cargo
3764 -----
3765
3766 * This release includes security fixes to both curl and OpenSSL.
3767 * [Fix transitive doctests when panic=abort][cargo/3021]
3768 * [Add --all-features flag to cargo][cargo/3038]
3769 * [Reject path-based dependencies in `cargo package`][cargo/3060]
3770 * [Don't parse the home directory more than once][cargo/3078]
3771 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
3772 * [Update OpenSSL to 1.0.2j][cargo/3121]
3773 * [Add license and license_file to cargo metadata output][cargo/3110]
3774 * [Make crates-io registry URL optional in config; ignore all changes to
3775   source.crates-io][cargo/3089]
3776 * [Don't download dependencies from other platforms][cargo/3123]
3777 * [Build transitive dev-dependencies when needed][cargo/3125]
3778 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
3779 * [Avoid updating registry when adding existing deps][cargo/3144]
3780 * [Warn about path overrides that won't work][cargo/3136]
3781 * [Use workspaces during `cargo install`][cargo/3146]
3782 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
3783 * [Add --message-format flag][cargo/3000]
3784 * [Pass target environment for rustdoc][cargo/3205]
3785 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
3786 * [Update curl and curl-sys][cargo/3241]
3787 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
3788
3789 Tooling
3790 -------
3791
3792 * [rustdoc: Add the `--sysroot` argument][36586]
3793 * [rustdoc: Fix a couple of issues with the search results][35655]
3794 * [rustdoc: remove the `!` from macro URLs and titles][35234]
3795 * [gdb: Fix pretty-printing special-cased Rust types][35585]
3796 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
3797
3798 Misc
3799 ----
3800
3801 * [Remove unmaintained style guide][35124]
3802 * [Add s390x support][36369]
3803 * [Initial work at Haiku OS support][36727]
3804 * [Add mips-uclibc targets][35734]
3805 * [Crate-ify compiler-rt into compiler-builtins][35021]
3806 * [Add rustc version info (git hash + date) to dist tarball][36213]
3807 * Many documentation improvements
3808
3809 Compatibility Notes
3810 -------------------
3811
3812 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3813 * [Deny (by default) transmuting from fn item types to pointer-sized
3814   types][34923]. Continuing the long transition to zero-sized fn items,
3815   per [RFC 401].
3816 * [Fix `#[derive]` for empty tuple structs/variants][35728].
3817   Part of [RFC 1506].
3818 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3819 * [Fix lifetime rules for 'if' conditions][36029].
3820 * [Inherit overflow checks for sum and product][36372].
3821 * [Forbid user-defined macros named "macro_rules"][36730].
3822
3823 [33922]: https://github.com/rust-lang/rust/pull/33922
3824 [34623]: https://github.com/rust-lang/rust/pull/34623
3825 [34923]: https://github.com/rust-lang/rust/pull/34923
3826 [34942]: https://github.com/rust-lang/rust/pull/34942
3827 [34982]: https://github.com/rust-lang/rust/pull/34982
3828 [35021]: https://github.com/rust-lang/rust/pull/35021
3829 [35048]: https://github.com/rust-lang/rust/pull/35048
3830 [35074]: https://github.com/rust-lang/rust/pull/35074
3831 [35124]: https://github.com/rust-lang/rust/pull/35124
3832 [35234]: https://github.com/rust-lang/rust/pull/35234
3833 [35238]: https://github.com/rust-lang/rust/pull/35238
3834 [35354]: https://github.com/rust-lang/rust/pull/35354
3835 [35559]: https://github.com/rust-lang/rust/pull/35559
3836 [35585]: https://github.com/rust-lang/rust/pull/35585
3837 [35627]: https://github.com/rust-lang/rust/pull/35627
3838 [35655]: https://github.com/rust-lang/rust/pull/35655
3839 [35702]: https://github.com/rust-lang/rust/pull/35702
3840 [35707]: https://github.com/rust-lang/rust/pull/35707
3841 [35728]: https://github.com/rust-lang/rust/pull/35728
3842 [35734]: https://github.com/rust-lang/rust/pull/35734
3843 [35755]: https://github.com/rust-lang/rust/pull/35755
3844 [35761]: https://github.com/rust-lang/rust/pull/35761
3845 [35764]: https://github.com/rust-lang/rust/pull/35764
3846 [35814]: https://github.com/rust-lang/rust/pull/35814
3847 [35854]: https://github.com/rust-lang/rust/pull/35854
3848 [35871]: https://github.com/rust-lang/rust/pull/35871
3849 [35884]: https://github.com/rust-lang/rust/pull/35884
3850 [35911]: https://github.com/rust-lang/rust/pull/35911
3851 [35969]: https://github.com/rust-lang/rust/pull/35969
3852 [35975]: https://github.com/rust-lang/rust/pull/35975
3853 [36004]: https://github.com/rust-lang/rust/pull/36004
3854 [36008]: https://github.com/rust-lang/rust/pull/36008
3855 [36014]: https://github.com/rust-lang/rust/pull/36014
3856 [36029]: https://github.com/rust-lang/rust/pull/36029
3857 [36059]: https://github.com/rust-lang/rust/pull/36059
3858 [36072]: https://github.com/rust-lang/rust/pull/36072
3859 [36101]: https://github.com/rust-lang/rust/pull/36101
3860 [36104]: https://github.com/rust-lang/rust/pull/36104
3861 [36171]: https://github.com/rust-lang/rust/pull/36171
3862 [36173]: https://github.com/rust-lang/rust/pull/36173
3863 [36178]: https://github.com/rust-lang/rust/pull/36178
3864 [36213]: https://github.com/rust-lang/rust/pull/36213
3865 [36214]: https://github.com/rust-lang/rust/pull/36214
3866 [36264]: https://github.com/rust-lang/rust/pull/36264
3867 [36266]: https://github.com/rust-lang/rust/pull/36266
3868 [36289]: https://github.com/rust-lang/rust/pull/36289
3869 [36338]: https://github.com/rust-lang/rust/pull/36338
3870 [36351]: https://github.com/rust-lang/rust/pull/36351
3871 [36355]: https://github.com/rust-lang/rust/pull/36355
3872 [36369]: https://github.com/rust-lang/rust/pull/36369
3873 [36372]: https://github.com/rust-lang/rust/pull/36372
3874 [36423]: https://github.com/rust-lang/rust/pull/36423
3875 [36482]: https://github.com/rust-lang/rust/pull/36482
3876 [36505]: https://github.com/rust-lang/rust/pull/36505
3877 [36524]: https://github.com/rust-lang/rust/pull/36524
3878 [36527]: https://github.com/rust-lang/rust/pull/36527
3879 [36551]: https://github.com/rust-lang/rust/pull/36551
3880 [36574]: https://github.com/rust-lang/rust/pull/36574
3881 [36586]: https://github.com/rust-lang/rust/pull/36586
3882 [36592]: https://github.com/rust-lang/rust/pull/36592
3883 [36631]: https://github.com/rust-lang/rust/pull/36631
3884 [36639]: https://github.com/rust-lang/rust/pull/36639
3885 [36721]: https://github.com/rust-lang/rust/pull/36721
3886 [36727]: https://github.com/rust-lang/rust/pull/36727
3887 [36730]: https://github.com/rust-lang/rust/pull/36730
3888 [36734]: https://github.com/rust-lang/rust/pull/36734
3889 [36754]: https://github.com/rust-lang/rust/pull/36754
3890 [36995]: https://github.com/rust-lang/rust/pull/36995
3891 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3892 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3893 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3894 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3895 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3896 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3897 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3898 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3899 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3900 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3901 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3902 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3903 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3904 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3905 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3906 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3907 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3908 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3909 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3910 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3911 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3912 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3913 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3914 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3915 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3916 [rustup]: https://www.rustup.rs
3917 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3918 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3919 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3920 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3921 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3922 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3923 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3924
3925
3926 Version 1.12.1 (2016-10-20)
3927 ===========================
3928
3929 Regression Fixes
3930 ----------------
3931
3932 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3933 * [Confusion with double negation and booleans][36856]
3934 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3935 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3936 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3937 * [Corrupted memory after updated to 1.12][36936]
3938 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3939 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3940 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3941
3942 [36381]: https://github.com/rust-lang/rust/issues/36381
3943 [36856]: https://github.com/rust-lang/rust/issues/36856
3944 [36875]: https://github.com/rust-lang/rust/issues/36875
3945 [36924]: https://github.com/rust-lang/rust/issues/36924
3946 [36926]: https://github.com/rust-lang/rust/issues/36926
3947 [36936]: https://github.com/rust-lang/rust/issues/36936
3948 [37026]: https://github.com/rust-lang/rust/issues/37026
3949 [37112]: https://github.com/rust-lang/rust/issues/37112
3950 [37153]: https://github.com/rust-lang/rust/issues/37153
3951
3952
3953 Version 1.12.0 (2016-09-29)
3954 ===========================
3955
3956 Highlights
3957 ----------
3958
3959 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3960   This translation pass is far simpler than the previous AST->LLVM pass, and
3961   creates opportunities to perform new optimizations directly on the MIR. It
3962   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3963 * [`rustc` presents a new, more readable error format, along with
3964   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3965   Most common editors supporting Rust have been updated to work with it. It was
3966   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3967
3968 Compiler
3969 --------
3970
3971 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3972   This translation pass is far simpler than the previous AST->LLVM pass, and
3973   creates opportunities to perform new optimizations directly on the MIR. It
3974   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3975 * [Print the Rust target name, not the LLVM target name, with
3976   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3977 * [The computation of `TypeId` is correct in some cases where it was previously
3978   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3979 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3980 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3981   `--print relocation-models`, and `--print code-models` print the available
3982   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3983   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3984 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3985   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3986   These targets produce statically-linked binaries. There are no binary release
3987   builds yet though.
3988
3989 Diagnostics
3990 -----------
3991
3992 * [`rustc` presents a new, more readable error format, along with
3993   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3994   Most common editors supporting Rust have been updated to work with it. It was
3995   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3996 * [In error descriptions, references are now described in plain English,
3997   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3998 * [In error type descriptions, unknown numeric types are named `{integer}` or
3999   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4000 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4001
4002 Language
4003 --------
4004
4005 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4006 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4007 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4008   useful](https://github.com/rust-lang/rust/pull/34908)
4009 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4010   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4011 * [Semicolons are properly required as statement delimiters inside
4012   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4013 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4014
4015 Stabilized APIs
4016 ---------------
4017
4018 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4019 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4020 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4021 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4022 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4023 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4024 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4025 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4026 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4027 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4028   Both on Unix and Windows.
4029 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4030 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4031 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4032 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4033 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4034 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4035 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4036 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4037
4038 Libraries
4039 ---------
4040
4041 * [The `format!` macro and friends now allow a single argument to be formatted
4042   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4043 * [The lifetime bounds on `[T]::binary_search_by` and
4044   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4045 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4046 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4047 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4048 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4049 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4050 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4051 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4052 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4053   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4054 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4055   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4056 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4057 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4058   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4059 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4060 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4061 * [`mpsc::sync_channel` `Receiver`s return any available message before
4062   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4063 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4064 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4065
4066 Cargo
4067 -----
4068
4069 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4070 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4071 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4072 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4073 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4074 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4075 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4076 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4077 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4078 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4079 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4080 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4081 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4082 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4083 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4084 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4085
4086 Performance
4087 -----------
4088
4089 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4090 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4091
4092 Tooling
4093 -------
4094
4095 * [Test binaries now support a `--test-threads` argument to specify the number
4096   of threads used to run tests, and which acts the same as the
4097   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4098 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4099 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4100 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4101 * [Rust releases now come with source packages that can be installed by rustup
4102   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4103   The resulting source code can be used by tools and IDES, located in the
4104   sysroot under `lib/rustlib/src`.
4105
4106 Misc
4107 ----
4108
4109 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4110 * Many minor improvements to the documentation.
4111 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4112
4113 Compatibility Notes
4114 -------------------
4115
4116 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4117   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4118 * [When formatting strings, if "precision" is specified, the "fill",
4119   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4120 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4121
4122
4123 Version 1.11.0 (2016-08-18)
4124 ===========================
4125
4126 Language
4127 --------
4128
4129 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4130 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4131 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4132 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4133 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4134
4135 Stabilized APIs
4136 ---------------
4137
4138 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4139 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4140 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4141 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4142 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4143 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4144   (in libcore - previously stabilized in libstd)
4145 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4146   (in libcore - previously stabilized in libstd)
4147 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4148   (in libcore - previously stabilized in libstd)
4149 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4150   (in libcore - previously stabilized in libstd)
4151 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4152 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4153 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4154 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4155
4156 Libraries
4157 ---------
4158
4159 * [The `thread_local!` macro supports multiple definitions in a single
4160    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4161 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4162 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4163   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4164 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4165 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4166 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4167 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4168
4169 Cargo
4170 -----
4171
4172 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4173 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4174 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4175 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4176 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4177   and `-vv` prints warnings for all crates.
4178 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4179 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4180   This provides room for expansion by arbitrary tools.
4181 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4182 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4183 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4184 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4185 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4186 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4187 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4188
4189 Performance
4190 -----------
4191
4192 * [Caching projections speeds up type check dramatically for some
4193   workloads](https://github.com/rust-lang/rust/pull/33816)
4194 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4195   This hasher is faster, but is believed to provide sufficient
4196   protection from collision attacks.
4197 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4198
4199 Rustdoc
4200 -------
4201
4202 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4203 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4204 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4205 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4206 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4207
4208 Tooling
4209 -------
4210
4211 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4212 * [When emitting debug info, rustc emits frame pointers for closures,
4213   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4214 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4215 * Many more errors have been given error codes and extended
4216   explanations
4217 * API documentation continues to be improved, with many new examples
4218
4219 Misc
4220 ----
4221
4222 * [rustc no longer hangs when dependencies recursively re-export
4223   submodules](https://github.com/rust-lang/rust/pull/34542)
4224 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4225 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4226   rewritten](https://github.com/rust-lang/rust/pull/33895)
4227 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4228   No targets use this yet, but it works toward AVR support.
4229
4230 Compatibility Notes
4231 -------------------
4232
4233 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4234 * [The new follow-set rules that place restrictions on `macro_rules!`
4235   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4236   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4237   and has been a warning since 1.10.
4238 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4239   This causes breakage in some corner cases.
4240
4241
4242 Version 1.10.0 (2016-07-07)
4243 ===========================
4244
4245 Language
4246 --------
4247
4248 * [Allow `concat_idents!` in type positions as well as in expression
4249   positions](https://github.com/rust-lang/rust/pull/33735).
4250 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4251   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4252 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4253 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4254 * [`panic!` can be converted to a runtime abort with the
4255   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4256   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4257 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4258   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4259   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4260   Note that Cargo does not yet directly support cdylibs.
4261
4262 Stabilized APIs
4263 ---------------
4264
4265 * `os::windows::fs::OpenOptionsExt::access_mode`
4266 * `os::windows::fs::OpenOptionsExt::share_mode`
4267 * `os::windows::fs::OpenOptionsExt::custom_flags`
4268 * `os::windows::fs::OpenOptionsExt::attributes`
4269 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4270 * `os::unix::fs::OpenOptionsExt::custom_flags`
4271 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4272 * `Default for sync::Weak`
4273 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4274 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4275 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4276 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4277 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4278 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4279 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4280 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4281 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4282 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4283 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4284 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4285 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4286 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4287 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4288 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4289 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4290 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4291 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4292 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4293 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4294 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4295 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4296 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4297 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4298 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4299 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4300 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4301 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4302 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4303 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4304 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4305 * Read/Write/RawFd impls for `UnixStream`
4306 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4307 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4308 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4309 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4310 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4311 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4312 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4313 * RawFd impls for `UnixListener`
4314 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4315 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4316 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4317 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4318 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4319 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4320 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4321 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4322 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4323 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4324 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4325 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4326 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4327 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4328 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4329 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4330 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4331 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4332 * RawFd impls for `UnixDatagram`
4333 * `{BTree,Hash}Map::values_mut`
4334 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4335
4336 Libraries
4337 ---------
4338
4339 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4340   The semantics of this minor method are subtle and probably not what
4341   most people want.
4342 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4343 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4344   will fall back to `/dev/urandom` temporarily to avoid blocking
4345   during early boot](https://github.com/rust-lang/rust/pull/33086).
4346 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4347 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4348 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4349 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4350 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4351 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4352   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4353
4354 Cargo
4355 -----
4356 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4357   This controls the runtime behavior of the `panic!` macro
4358   and can be either "unwind" (the default), or "abort".
4359   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4360 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4361 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4362 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4363   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4364 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4365 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4366 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4367   By default they are retried twice, which can be customized with the
4368   `net.retry` value in `.cargo/config`.
4369 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4370 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4371 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4372 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4373   Makes it possible to install multiple crates in parallel.
4374 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4375 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4376 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4377 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4378 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4379 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4380
4381 Performance
4382 -----------
4383
4384 * [rustc memory usage was reduced by refactoring the context used for
4385   type checking](https://github.com/rust-lang/rust/pull/33425).
4386 * [Speed up creation of `HashMap`s by caching the random keys used
4387   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4388 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4389 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4390 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4391   10x faster than the previous lookup tables.
4392 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4393
4394 Usability
4395 ---------
4396
4397 * Many incremental improvements to documentation and rustdoc.
4398 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4399 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4400 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4401 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4402 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4403 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4404 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4405
4406 Misc
4407 ----
4408
4409 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4410 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4411 * [`std` no longer prints backtraces on platforms where the running
4412   module must be loaded with `env::current_exe`, which can't be relied
4413   on](https://github.com/rust-lang/rust/pull/33554).
4414 * This release includes std binaries for the i586-unknown-linux-gnu,
4415   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4416   i586 target is for old x86 hardware without SSE2, and the armv7
4417   target is for Android running on modern ARM architectures.
4418 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4419   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4420 * [On Unix the runtime aborts by calling `libc::abort` instead of
4421   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4422 * [Rust is now bootstrapped from the previous release of Rust,
4423   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4424
4425 Compatibility Notes
4426 -------------------
4427
4428 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4429 * [`target_env` for Linux ARM targets is just `gnu`, not
4430   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4431 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4432 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4433 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4434   Affects how macros are parsed.
4435 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4436 * [Feature-gated attributes on macro-generated macro invocations are
4437   now rejected](https://github.com/rust-lang/rust/pull/32791).
4438 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4439   This caused some minor changes to type inference.
4440
4441
4442 Version 1.9.0 (2016-05-26)
4443 ==========================
4444
4445 Language
4446 --------
4447
4448 * The `#[deprecated]` attribute when applied to an API will generate
4449   warnings when used. The warnings may be suppressed with
4450   `#[allow(deprecated)]`. [RFC 1270].
4451 * [`fn` item types are zero sized, and each `fn` names a unique
4452   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4453   `transmute` on a `fn` type will generate a warning for a few cycles,
4454   then will be converted to an error.
4455 * [Field and method resolution understand visibility, so private
4456   fields and methods cannot prevent the proper use of public fields
4457   and methods][1.9fv].
4458 * [The parser considers unicode codepoints in the
4459   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4460
4461 Stabilized APIs
4462 ---------------
4463
4464 * [`std::panic`]
4465 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4466 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4467 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4468 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4469 * [`str::is_char_boundary`]
4470 * [`<*const T>::as_ref`]
4471 * [`<*mut T>::as_ref`]
4472 * [`<*mut T>::as_mut`]
4473 * [`AsciiExt::make_ascii_uppercase`]
4474 * [`AsciiExt::make_ascii_lowercase`]
4475 * [`char::decode_utf16`]
4476 * [`char::DecodeUtf16`]
4477 * [`char::DecodeUtf16Error`]
4478 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4479 * [`BTreeSet::take`]
4480 * [`BTreeSet::replace`]
4481 * [`BTreeSet::get`]
4482 * [`HashSet::take`]
4483 * [`HashSet::replace`]
4484 * [`HashSet::get`]
4485 * [`OsString::with_capacity`]
4486 * [`OsString::clear`]
4487 * [`OsString::capacity`]
4488 * [`OsString::reserve`]
4489 * [`OsString::reserve_exact`]
4490 * [`OsStr::is_empty`]
4491 * [`OsStr::len`]
4492 * [`std::os::unix::thread`]
4493 * [`RawPthread`]
4494 * [`JoinHandleExt`]
4495 * [`JoinHandleExt::as_pthread_t`]
4496 * [`JoinHandleExt::into_pthread_t`]
4497 * [`HashSet::hasher`]
4498 * [`HashMap::hasher`]
4499 * [`CommandExt::exec`]
4500 * [`File::try_clone`]
4501 * [`SocketAddr::set_ip`]
4502 * [`SocketAddr::set_port`]
4503 * [`SocketAddrV4::set_ip`]
4504 * [`SocketAddrV4::set_port`]
4505 * [`SocketAddrV6::set_ip`]
4506 * [`SocketAddrV6::set_port`]
4507 * [`SocketAddrV6::set_flowinfo`]
4508 * [`SocketAddrV6::set_scope_id`]
4509 * [`slice::copy_from_slice`]
4510 * [`ptr::read_volatile`]
4511 * [`ptr::write_volatile`]
4512 * [`OpenOptions::create_new`]
4513 * [`TcpStream::set_nodelay`]
4514 * [`TcpStream::nodelay`]
4515 * [`TcpStream::set_ttl`]
4516 * [`TcpStream::ttl`]
4517 * [`TcpStream::set_only_v6`]
4518 * [`TcpStream::only_v6`]
4519 * [`TcpStream::take_error`]
4520 * [`TcpStream::set_nonblocking`]
4521 * [`TcpListener::set_ttl`]
4522 * [`TcpListener::ttl`]
4523 * [`TcpListener::set_only_v6`]
4524 * [`TcpListener::only_v6`]
4525 * [`TcpListener::take_error`]
4526 * [`TcpListener::set_nonblocking`]
4527 * [`UdpSocket::set_broadcast`]
4528 * [`UdpSocket::broadcast`]
4529 * [`UdpSocket::set_multicast_loop_v4`]
4530 * [`UdpSocket::multicast_loop_v4`]
4531 * [`UdpSocket::set_multicast_ttl_v4`]
4532 * [`UdpSocket::multicast_ttl_v4`]
4533 * [`UdpSocket::set_multicast_loop_v6`]
4534 * [`UdpSocket::multicast_loop_v6`]
4535 * [`UdpSocket::set_multicast_ttl_v6`]
4536 * [`UdpSocket::multicast_ttl_v6`]
4537 * [`UdpSocket::set_ttl`]
4538 * [`UdpSocket::ttl`]
4539 * [`UdpSocket::set_only_v6`]
4540 * [`UdpSocket::only_v6`]
4541 * [`UdpSocket::join_multicast_v4`]
4542 * [`UdpSocket::join_multicast_v6`]
4543 * [`UdpSocket::leave_multicast_v4`]
4544 * [`UdpSocket::leave_multicast_v6`]
4545 * [`UdpSocket::take_error`]
4546 * [`UdpSocket::connect`]
4547 * [`UdpSocket::send`]
4548 * [`UdpSocket::recv`]
4549 * [`UdpSocket::set_nonblocking`]
4550
4551 Libraries
4552 ---------
4553
4554 * [`std::sync::Once` is poisoned if its initialization function
4555   fails][1.9o].
4556 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4557 * [Most types implement `fmt::Debug`][1.9db].
4558 * [The default buffer size used by `BufReader` and `BufWriter` was
4559   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4560   used by other languages.
4561 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4562   `Duration` additionally implements `*=` and `/=`][1.9ta].
4563 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4564 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4565 * [`Chain` implements `BufRead`][1.9ch].
4566 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4567
4568 Cargo
4569 -----
4570
4571 * [Cargo can now run concurrently][1.9cc].
4572 * [Top-level overrides allow specific revisions of crates to be
4573   overridden through the entire crate graph][1.9ct].  This is intended
4574   to make upgrades easier for large projects, by allowing crates to be
4575   forked temporarily until they've been upgraded and republished.
4576 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4577 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4578   on the commandline][1.9cf]. `rustc` arguments can also be specified
4579   in the `build.rustflags` configuration key.
4580
4581 Performance
4582 -----------
4583
4584 * [The time complexity of comparing variables for equivalence during type
4585   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4586   to major compilation time improvement in some scenarios.
4587 * [`ToString` is specialized for `str`, giving it the same performance
4588   as `to_owned`][1.9ts].
4589 * [Spawning processes with `Command::output` no longer creates extra
4590   threads][1.9sp].
4591 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4592   for C-like enums][1.9cl].
4593
4594 Misc
4595 ----
4596
4597 * [Passing the `--quiet` flag to a test runner will produce
4598   much-abbreviated output][1.9q].
4599 * The Rust Project now publishes std binaries for the
4600   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4601   `i586-pc-windows-msvc` targets.
4602
4603 Compatibility Notes
4604 -------------------
4605
4606 * [`std::sync::Once` is poisoned if its initialization function
4607   fails][1.9o].
4608 * [It is illegal to define methods with the same name in overlapping
4609   inherent `impl` blocks][1.9sn].
4610 * [`fn` item types are zero sized, and each `fn` names a unique
4611   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4612   `transmute` on a `fn` type will generate a warning for a few cycles,
4613   then will be converted to an error.
4614 * [Improvements to const evaluation may trigger new errors when integer
4615   literals are out of range][1.9ce].
4616
4617
4618 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4619 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4620 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4621 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4622 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4623 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4624 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4625 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4626 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4627 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4628 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4629 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4630 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4631 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4632 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4633 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4634 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4635 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4636 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4637 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4638 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4639 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4640 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4641 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4642 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4643 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4644 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4645 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4646 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4647 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
4648 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
4649 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
4650 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
4651 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
4652 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
4653 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
4654 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
4655 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
4656 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
4657 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
4658 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
4659 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
4660 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
4661 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
4662 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
4663 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
4664 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
4665 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
4666 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
4667 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
4668 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
4669 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
4670 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
4671 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
4672 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
4673 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
4674 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
4675 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
4676 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
4677 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
4678 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4679 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4680 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4681 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4682 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4683 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4684 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
4685 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4686 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
4687 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4688 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4689 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4690 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4691 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4692 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
4693 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
4694 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
4695 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
4696 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
4697 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
4698 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
4699 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
4700 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
4701 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
4702 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
4703 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
4704 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
4705 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
4706 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
4707 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
4708 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
4709 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
4710 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
4711 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
4712 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
4713 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
4714 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
4715 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
4716 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
4717 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
4718 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
4719 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
4720 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
4721 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
4722 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
4723 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
4724 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
4725 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
4726 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
4727 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
4728
4729
4730 Version 1.8.0 (2016-04-14)
4731 ==========================
4732
4733 Language
4734 --------
4735
4736 * Rust supports overloading of compound assignment statements like
4737   `+=` by implementing the [`AddAssign`], [`SubAssign`],
4738   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
4739   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
4740   traits. [RFC 953].
4741 * Empty structs can be defined with braces, as in `struct Foo { }`, in
4742   addition to the non-braced form, `struct Foo;`. [RFC 218].
4743
4744 Libraries
4745 ---------
4746
4747 * Stabilized APIs:
4748   * [`str::encode_utf16`][] (renamed from `utf16_units`)
4749   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
4750   * [`Ref::map`]
4751   * [`RefMut::map`]
4752   * [`ptr::drop_in_place`]
4753   * [`time::Instant`]
4754   * [`time::SystemTime`]
4755   * [`Instant::now`]
4756   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
4757   * [`Instant::elapsed`]
4758   * [`SystemTime::now`]
4759   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
4760   * [`SystemTime::elapsed`]
4761   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
4762   * [`SystemTimeError`]
4763   * [`SystemTimeError::duration`]
4764   * Various impls for `SystemTimeError`
4765   * [`UNIX_EPOCH`]
4766   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
4767     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
4768     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
4769 * [The `write!` and `writeln!` macros correctly emit errors if any of
4770   their arguments can't be formatted][1.8w].
4771 * [Various I/O functions support large files on 32-bit Linux][1.8l].
4772 * [The Unix-specific `raw` modules, which contain a number of
4773   redefined C types are deprecated][1.8r], including `os::raw::unix`,
4774   `os::raw::macos`, and `os::raw::linux`. These modules defined types
4775   such as `ino_t` and `dev_t`. The inconsistency of these definitions
4776   across platforms was making it difficult to implement `std`
4777   correctly. Those that need these definitions should use the `libc`
4778   crate. [RFC 1415].
4779 * The Unix-specific `MetadataExt` traits, including
4780   `os::unix::fs::MetadataExt`, which expose values such as inode
4781   numbers [no longer return platform-specific types][1.8r], but
4782   instead return widened integers. [RFC 1415].
4783 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
4784 * [Atomic loads and stores are not volatile][1.8a].
4785 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
4786
4787 Performance
4788 -----------
4789
4790 * [Inlining hash functions lead to a 3% compile-time improvement in
4791   some workloads][1.8h].
4792 * When using jemalloc, its symbols are [unprefixed so that it
4793   overrides the libc malloc implementation][1.8h]. This means that for
4794   rustc, LLVM is now using jemalloc, which results in a 6%
4795   compile-time improvement on a specific workload.
4796 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
4797
4798 Misc
4799 ----
4800
4801 * [32-bit MSVC builds finally implement unwinding][1.8ms].
4802   i686-pc-windows-msvc is now considered a tier-1 platform.
4803 * [The `--print targets` flag prints a list of supported targets][1.8t].
4804 * [The `--print cfg` flag prints the `cfg`s defined for the current
4805   target][1.8cf].
4806 * [`rustc` can be built with an new Cargo-based build system, written
4807   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
4808   build system. To enable it configure with `configure --rustbuild`.
4809 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
4810   variants while also indicating the total number of missing variants
4811   if more than 3][1.8m].
4812 * [Executable stacks are disabled on Linux and BSD][1.8nx].
4813 * The Rust Project now publishes binary releases of the standard
4814   library for a number of tier-2 targets:
4815   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
4816   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
4817   `x86_64-rumprun-netbsd`. These can be installed with
4818   tools such as [multirust][1.8mr].
4819
4820 Cargo
4821 -----
4822
4823 * [`cargo init` creates a new Cargo project in the current
4824   directory][1.8ci].  It is otherwise like `cargo new`.
4825 * [Cargo has configuration keys for `-v` and
4826   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4827   `[term]` section of `.cargo/config`.
4828 * [Configuration keys that evaluate to strings or integers can be set
4829   via environment variables][1.8ce]. For example the `build.jobs` key
4830   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4831   precedence over config files.
4832 * [Target-specific dependencies support Rust `cfg` syntax for
4833   describing targets][1.8cfg] so that dependencies for multiple
4834   targets can be specified together. [RFC 1361].
4835 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4836   `RUSTDOC` take precedence over the `build.target-dir`,
4837   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4838 * [The child process tree is killed on Windows when Cargo is
4839   killed][1.8ck].
4840 * [The `build.target` configuration value sets the target platform,
4841   like `--target`][1.8ct].
4842
4843 Compatibility Notes
4844 -------------------
4845
4846 * [Unstable compiler flags have been further restricted][1.8u]. Since
4847   1.0 `-Z` flags have been considered unstable, and other flags that
4848   were considered unstable additionally required passing `-Z
4849   unstable-options` to access. Unlike unstable language and library
4850   features though, these options have been accessible on the stable
4851   release channel. Going forward, *new unstable flags will not be
4852   available on the stable release channel*, and old unstable flags
4853   will warn about their usage. In the future, all unstable flags will
4854   be unavailable on the stable release channel.
4855 * [It is no longer possible to `match` on empty enum variants using
4856   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4857 * The Unix-specific `MetadataExt` traits, including
4858   `os::unix::fs::MetadataExt`, which expose values such as inode
4859   numbers [no longer return platform-specific types][1.8r], but
4860   instead return widened integers. [RFC 1415].
4861 * [Modules sourced from the filesystem cannot appear within arbitrary
4862   blocks, but only within other modules][1.8mf].
4863 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4864 * On Unix, [stack overflow triggers a runtime abort instead of a
4865   SIGSEGV][1.8so].
4866 * [`Command::spawn` and its equivalents return an error if any of
4867   its command-line arguments contain interior `NUL`s][1.8n].
4868 * [Tuple and unit enum variants from other crates are in the type
4869   namespace][1.8tn].
4870 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4871   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4872   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4873   instead of `foo.lib`.
4874
4875
4876 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4877 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4878 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4879 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4880 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4881 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4882 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4883 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4884 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4885 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4886 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4887 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4888 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4889 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4890 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4891 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4892 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4893 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4894 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4895 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4896 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4897 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4898 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4899 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4900 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4901 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4902 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4903 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4904 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4905 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4906 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4907 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4908 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4909 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4910 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4911 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4912 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4913 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4914 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4915 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4916 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4917 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4918 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4919 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4920 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4921 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4922 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4923 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4924 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4925 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4926 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4927 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4928 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4929 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4930 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4931 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4932 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4933 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4934 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4935 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4936
4937
4938 Version 1.7.0 (2016-03-03)
4939 ==========================
4940
4941 Libraries
4942 ---------
4943
4944 * Stabilized APIs
4945   * `Path`
4946     * [`Path::strip_prefix`][] (renamed from relative_from)
4947     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4948   * `Ipv4Addr`
4949     * [`Ipv4Addr::is_loopback`]
4950     * [`Ipv4Addr::is_private`]
4951     * [`Ipv4Addr::is_link_local`]
4952     * [`Ipv4Addr::is_multicast`]
4953     * [`Ipv4Addr::is_broadcast`]
4954     * [`Ipv4Addr::is_documentation`]
4955   * `Ipv6Addr`
4956     * [`Ipv6Addr::is_unspecified`]
4957     * [`Ipv6Addr::is_loopback`]
4958     * [`Ipv6Addr::is_multicast`]
4959   * `Vec`
4960     * [`Vec::as_slice`]
4961     * [`Vec::as_mut_slice`]
4962   * `String`
4963     * [`String::as_str`]
4964     * [`String::as_mut_str`]
4965   * Slices
4966     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4967     be the same length
4968     * `<[T]>::`[`sort_by_key`]
4969   * checked, saturated, and overflowing operations
4970     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4971     * [`i32::saturating_mul`]
4972     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4973     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4974     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4975     * [`u32::saturating_mul`]
4976     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4977     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4978     * and checked, saturated, and overflowing operations for other primitive types
4979   * FFI
4980     * [`ffi::IntoStringError`]
4981     * [`CString::into_string`]
4982     * [`CString::into_bytes`]
4983     * [`CString::into_bytes_with_nul`]
4984     * `From<CString> for Vec<u8>`
4985   * `IntoStringError`
4986     * [`IntoStringError::into_cstring`]
4987     * [`IntoStringError::utf8_error`]
4988     * `Error for IntoStringError`
4989   * Hashing
4990     * [`std::hash::BuildHasher`]
4991     * [`BuildHasher::Hasher`]
4992     * [`BuildHasher::build_hasher`]
4993     * [`std::hash::BuildHasherDefault`]
4994     * [`HashMap::with_hasher`]
4995     * [`HashMap::with_capacity_and_hasher`]
4996     * [`HashSet::with_hasher`]
4997     * [`HashSet::with_capacity_and_hasher`]
4998     * [`std::collections::hash_map::RandomState`]
4999     * [`RandomState::new`]
5000 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5001   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5002   from bytes is faster.
5003 * [The performance of `LineWriter` (and thus `io::stdout`) was
5004   improved by using `memchr` to search for newlines][1.7m].
5005 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5006   `f64` variants were stabilized previously.
5007 * [`BTreeMap` was rewritten to use less memory and improve the performance
5008   of insertion and iteration, the latter by as much as 5x][1.7bm].
5009 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5010   covariant over their contained type][1.7bt].
5011 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5012   over their contained type][1.7ll].
5013 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5014   searching methods.
5015 * [`Any` is implemented for unsized types][1.7a].
5016 * [`Hash` is implemented for `Duration`][1.7h].
5017
5018 Misc
5019 ----
5020
5021 * [When running tests with `--test`, rustdoc will pass `--cfg`
5022   arguments to the compiler][1.7dt].
5023 * [The compiler is built with RPATH information by default][1.7rpa].
5024   This means that it will be possible to run `rustc` when installed in
5025   unusual configurations without configuring the dynamic linker search
5026   path explicitly.
5027 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5028   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5029   over `LD_LIBRARY_PATH`.
5030
5031 Cargo
5032 -----
5033
5034 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5035   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5036 * [The `rerun-if-changed` build script directive no longer causes the
5037   build script to incorrectly run twice in certain scenarios][1.7rr].
5038
5039 Compatibility Notes
5040 -------------------
5041
5042 * Soundness fixes to the interactions between associated types and
5043   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5044   code that violates the new rules. This is a significant change that
5045   is known to break existing code, so it has emitted warnings for the
5046   new error cases since 1.4 to give crate authors time to adapt. The
5047   details of what is changing are subtle; read the RFC for more.
5048 * [Several bugs in the compiler's visibility calculations were
5049   fixed][1.7v]. Since this was found to break significant amounts of
5050   code, the new errors will be emitted as warnings for several release
5051   cycles, under the `private_in_public` lint.
5052 * Defaulted type parameters were accidentally accepted in positions
5053   that were not intended. In this release, [defaulted type parameters
5054   appearing outside of type definitions will generate a
5055   warning][1.7d], which will become an error in future releases.
5056 * [Parsing "." as a float results in an error instead of 0][1.7p].
5057   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5058 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5059
5060 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5061 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5062 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5063 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5064 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5065 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5066 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5067 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5068 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5069 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5070 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5071 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5072 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5073 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5074 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5075 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5076 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5077 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5078 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5079 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5080 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5081 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5082 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5083 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5084 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5085 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5086 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5087 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5088 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5089 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5090 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5091 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5092 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5093 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5094 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5095 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5096 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5097 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5098 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5099 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5100 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5101 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5102 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5103 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5104 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5105 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5106 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5107 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5108 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5109 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5110 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5111 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5112 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5113 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5114 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5115 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5116 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5117 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5118 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5119 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5120 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5121 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5122 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5123 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5124 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5125 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5126 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5127 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5128 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5129 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5130 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5131 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5132 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5133 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5134 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5135 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5136 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5137 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5138 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5139
5140
5141 Version 1.6.0 (2016-01-21)
5142 ==========================
5143
5144 Language
5145 --------
5146
5147 * The `#![no_std]` attribute causes a crate to not be linked to the
5148   standard library, but only the [core library][1.6co], as described
5149   in [RFC 1184]. The core library defines common types and traits but
5150   has no platform dependencies whatsoever, and is the basis for Rust
5151   software in environments that cannot support a full port of the
5152   standard library, such as operating systems. Most of the core
5153   library is now stable.
5154
5155 Libraries
5156 ---------
5157
5158 * Stabilized APIs:
5159   [`Read::read_exact`],
5160   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
5161   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5162   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5163   [`os::unix::fs::DirBuilderExt`],
5164   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5165   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5166   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5167   [`collections::hash_map::Drain`],
5168   [`collections::hash_map::HashMap::drain`],
5169   [`collections::hash_set::Drain`],
5170   [`collections::hash_set::HashSet::drain`],
5171   [`collections::binary_heap::Drain`],
5172   [`collections::binary_heap::BinaryHeap::drain`],
5173   [`Vec::extend_from_slice`][] (renamed from `push_all`),
5174   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5175   [`RwLock::into_inner`],
5176   [`Iterator::min_by_key`][] (renamed from `min_by`),
5177   [`Iterator::max_by_key`][] (renamed from `max_by`).
5178 * The [core library][1.6co] is stable, as are most of its APIs.
5179 * [The `assert_eq!` macro supports arguments that don't implement
5180   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5181   `assert!`.
5182 * Several timer functions that take duration in milliseconds [are
5183   deprecated in favor of those that take `Duration`][1.6ms]. These
5184   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5185   `thread::park_timeout_ms`.
5186 * The algorithm by which `Vec` reserves additional elements was
5187   [tweaked to not allocate excessive space][1.6a] while still growing
5188   exponentially.
5189 * `From` conversions are [implemented from integers to floats][1.6f]
5190   in cases where the conversion is lossless. Thus they are not
5191   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5192   or `f64`. They are also not implemented for `isize` and `usize`
5193   because the implementations would be platform-specific. `From` is
5194   also implemented from `f32` to `f64`.
5195 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5196 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5197 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5198 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5199   improvements.
5200 * Sorting slices that are already sorted [is 50% faster in some
5201   cases][1.6s].
5202
5203 Cargo
5204 -----
5205
5206 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5207 * Cargo build scripts can specify their dependencies by emitting the
5208   [`rerun-if-changed`][1.6rr] key.
5209 * crates.io will reject publication of crates with dependencies that
5210   have a wildcard version constraint. Crates with wildcard
5211   dependencies were seen to cause a variety of problems, as described
5212   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5213   warning.
5214 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5215   release folder.  A variety of artifacts that Cargo failed to clean
5216   are now correctly deleted.
5217
5218 Misc
5219 ----
5220
5221 * The `unreachable_code` lint [warns when a function call's argument
5222   diverges][1.6dv].
5223 * The parser indicates [failures that may be caused by
5224   confusingly-similar Unicode characters][1.6uc]
5225 * Certain macro errors [are reported at definition time][1.6m], not
5226   expansion.
5227
5228 Compatibility Notes
5229 -------------------
5230
5231 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5232   environment variable when locating crates. This was a pre-cargo
5233   feature for integrating with the package manager that was
5234   accidentally never removed.
5235 * [A number of bugs were fixed in the privacy checker][1.6p] that
5236   could cause previously-accepted code to break.
5237 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5238 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5239   struct pattern syntax (`Foo(..)`) can no longer be used to match
5240   unit structs. This is a warning now, but will become an error in
5241   future releases. Patterns that share the same name as a const are
5242   now an error.
5243 * A bug was fixed that causes [rustc not to apply default type
5244   parameters][1.6xc] when resolving certain method implementations of
5245   traits defined in other crates.
5246
5247 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5248 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5249 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5250 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5251 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5252 [1.6co]: http://doc.rust-lang.org/core/index.html
5253 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5254 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5255 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5256 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5257 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5258 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5259 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5260 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5261 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5262 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5263 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5264 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5265 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5266 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5267 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5268 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5269 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5270 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5271 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5272 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5273 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5274 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5275 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5276 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5277 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5278 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5279 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5280 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5281 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5282 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5283 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5284 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5285 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5286 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5287 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5288 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5289 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5290 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5291 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5292 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5293 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5294
5295
5296 Version 1.5.0 (2015-12-10)
5297 ==========================
5298
5299 * ~700 changes, numerous bugfixes
5300
5301 Highlights
5302 ----------
5303
5304 * Stabilized APIs:
5305   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5306   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5307   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5308   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5309   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5310   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5311   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5312   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5313   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5314   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5315   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5316   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5317   [`Path::read_link`], [`Path::symlink_metadata`],
5318   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5319   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5320   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5321   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5322   [`slice::split_first_mut`], [`slice::split_first`],
5323   [`slice::split_last_mut`], [`slice::split_last`],
5324   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5325   [`str::MatchIndices`], [`str::RMatchIndices`],
5326   [`str::match_indices`], [`str::rmatch_indices`],
5327   [`str::slice_mut_unchecked`], [`string::ParseError`].
5328 * Rust applications hosted on crates.io can be installed locally to
5329   `~/.cargo/bin` with the [`cargo install`] command. Among other
5330   things this makes it easier to augment Cargo with new subcommands:
5331   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5332   invoked as `cargo foo`.
5333 * Crates with wildcard (`*`) dependencies will [emit warnings when
5334   published][1.5w]. In 1.6 it will no longer be possible to publish
5335   crates with wildcard dependencies.
5336
5337 Breaking Changes
5338 ----------------
5339
5340 * The rules determining when a particular lifetime must outlive
5341   a particular value (known as '[dropck]') have been [modified
5342   to not rely on parametricity][1.5p].
5343 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5344   and `Arc`][1.5a]. Because these smart pointer types implement
5345   `Deref`, this causes breakage in cases where the interior type
5346   contains methods of the same name.
5347 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5348   that they could drop their content. Soundness fix.
5349 * All method invocations are [properly checked][1.5wf1] for
5350   [well-formedness][1.5wf2]. Soundness fix.
5351 * Traits whose supertraits contain `Self` are [not object
5352   safe][1.5o]. Soundness fix.
5353 * Target specifications support a [`no_default_libraries`][1.5nd]
5354   setting that controls whether `-nodefaultlibs` is passed to the
5355   linker, and in turn the `is_like_windows` setting no longer affects
5356   the `-nodefaultlibs` flag.
5357 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5358 * The `#[inline]` and `#[repr]` attributes [can only appear
5359   in valid locations][1.5at].
5360 * Native libraries linked from the local crate are [passed to
5361   the linker before native libraries from upstream crates][1.5nl].
5362 * Two rarely-used attributes, `#[no_debug]` and
5363   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5364 * Negation of unsigned integers, which has been a warning for
5365   several releases, [is now behind a feature gate and will
5366   generate errors][1.5nu].
5367 * The parser accidentally accepted visibility modifiers on
5368   enum variants, a bug [which has been fixed][1.5ev].
5369 * [A bug was fixed that allowed `use` statements to import unstable
5370   features][1.5use].
5371
5372 Language
5373 --------
5374
5375 * When evaluating expressions at compile-time that are not
5376   compile-time constants (const-evaluating expressions in non-const
5377   contexts), incorrect code such as overlong bitshifts and arithmetic
5378   overflow will [generate a warning instead of an error][1.5ce],
5379   delaying the error until runtime. This will allow the
5380   const-evaluator to be expanded in the future backwards-compatibly.
5381 * The `improper_ctypes` lint [no longer warns about using `isize` and
5382   `usize` in FFI][1.5ict].
5383
5384 Libraries
5385 ---------
5386
5387 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5388   invariant][1.5c].
5389 * `Default` is [implemented for mutable slices][1.5d].
5390 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5391 * There are now `From` conversions [between floating point
5392   types][1.5f] where the conversions are lossless.
5393 * There are now `From` conversions [between integer types][1.5i] where
5394   the conversions are lossless.
5395 * [`fs::Metadata` implements `Clone`][1.5fs].
5396 * The `parse` method [accepts a leading "+" when parsing
5397   integers][1.5pi].
5398 * [`AsMut` is implemented for `Vec`][1.5am].
5399 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5400   been optimized][1.5cf] and no longer rely on the default impl.
5401 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5402   `unsafe extern "C"` function types now [implement `Clone`,
5403   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5404   `fmt::Debug` for up to 12 arguments][1.5fp].
5405 * [Dropping `Vec`s is much faster in unoptimized builds when the
5406   element types don't implement `Drop`][1.5dv].
5407 * A bug that caused in incorrect behavior when [combining `VecDeque`
5408   with zero-sized types][1.5vdz] was resolved.
5409 * [`PartialOrd` for slices is faster][1.5po].
5410
5411 Miscellaneous
5412 -------------
5413
5414 * [Crate metadata size was reduced by 20%][1.5md].
5415 * [Improvements to code generation reduced the size of libcore by 3.3
5416   MB and rustc's memory usage by 18MB][1.5m].
5417 * [Improvements to deref translation increased performance in
5418   unoptimized builds][1.5dr].
5419 * Various errors in trait resolution [are deduplicated to only be
5420   reported once][1.5te].
5421 * Rust has preliminary [support for rumprun kernels][1.5rr].
5422 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5423
5424 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5425 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5426 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5427 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5428 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5429 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5430 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5431 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5432 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5433 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5434 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5435 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5436 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5437 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5438 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5439 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5440 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5441 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5442 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5443 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5444 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5445 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5446 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5447 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5448 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5449 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5450 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5451 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5452 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5453 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5454 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5455 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5456 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5457 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5458 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5459 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5460 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5461 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5462 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5463 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5464 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5465 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5466 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5467 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5468 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5469 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5470 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5471 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5472 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5473 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5474 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5475 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5476 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5477 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5478 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5479 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5480 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5481 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5482 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5483 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5484 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5485 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5486 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5487 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5488 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5489 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5490 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5491 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5492 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5493 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5494 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5495 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5496 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5497 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5498 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5499 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5500 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5501 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5502 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5503 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5504 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5505 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5506 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5507 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5508 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5509 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5510 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5511 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5512 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5513
5514 Version 1.4.0 (2015-10-29)
5515 ==========================
5516
5517 * ~1200 changes, numerous bugfixes
5518
5519 Highlights
5520 ----------
5521
5522 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5523   GNU) are now supported and recommended for use.
5524
5525 Breaking Changes
5526 ----------------
5527
5528 * [Several changes have been made to fix type soundness and improve
5529   the behavior of associated types][sound]. See [RFC 1214]. Although
5530   we have mostly introduced these changes as warnings this release, to
5531   become errors next release, there are still some scenarios that will
5532   see immediate breakage.
5533 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5534   line breaks in addition to `\n`][crlf].
5535 * [Loans of `'static` lifetime extend to the end of a function][stat].
5536 * [`str::parse` no longer introduces avoidable rounding error when
5537   parsing floating point numbers. Together with earlier changes to
5538   float formatting/output, "round trips" like f.to_string().parse()
5539   now preserve the value of f exactly. Additionally, leading plus
5540   signs are now accepted][fp3].
5541
5542
5543 Language
5544 --------
5545
5546 * `use` statements that import multiple items [can now rename
5547   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5548 * [Binops work correctly on fat pointers][binfat].
5549 * `pub extern crate`, which does not behave as expected, [issues a
5550   warning][pec] until a better solution is found.
5551
5552 Libraries
5553 ---------
5554
5555 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5556   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5557   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5558   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5559   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5560   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5561   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5562   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5563   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5564   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5565   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5566   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5567   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5568   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5569   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5570   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5571   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5572   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5573   [`thread::sleep`].
5574 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5575   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5576   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5577   `f64::from_str_radix`.
5578 * [Reverse-searching strings is faster with the 'two-way'
5579   algorithm][s].
5580 * [`std::io::copy` allows `?Sized` arguments][cc].
5581 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5582   [override `count`, `nth` and `last` with an O(1)
5583   implementation][it].
5584 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5585 * [`IntoRawFd` has been added to the Unix-specific prelude,
5586   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5587   prelude][pr].
5588 * [`Extend<String>` and `FromIterator<String` are both implemented for
5589   `String`][es].
5590 * [`IntoIterator` is implemented for references to `Option` and
5591   `Result`][into2].
5592 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5593   Copy`][ext] as part of [RFC 839]. This will cause type inference
5594   breakage in rare situations.
5595 * [`BinaryHeap` implements `Debug`][bh2].
5596 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5597   arrays][bm].
5598 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5599   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5600 * [String comparison is faster][faststr].
5601 * `&mut T` where `T: std::fmt::Write` [also implements
5602   `std::fmt::Write`][mutw].
5603 * [A stable regression in `VecDeque::push_back` and other
5604   capacity-altering methods that caused panics for zero-sized types
5605   was fixed][vd].
5606 * [Function pointers implement traits for up to 12 parameters][fp2].
5607
5608 Miscellaneous
5609 -------------
5610
5611 * The compiler [no longer uses the 'morestack' feature to prevent
5612   stack overflow][mm]. Instead it uses guard pages and stack
5613   probes (though stack probes are not yet implemented on any platform
5614   but Windows).
5615 * [The compiler matches traits faster when projections are involved][p].
5616 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5617   `usize`][ffi].
5618 * [Cargo now displays useful information about what its doing during
5619   `cargo update`][cu].
5620
5621 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5622 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5623 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5624 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5625 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5626 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5627 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5628 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5629 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5630 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5631 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5632 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5633 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5634 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5635 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5636 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5637 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5638 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5639 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5640 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5641 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5642 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5643 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5644 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5645 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5646 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5647 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
5648 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
5649 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
5650 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
5651 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
5652 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
5653 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
5654 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
5655 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
5656 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
5657 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
5658 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
5659 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
5660 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
5661 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
5662 [bh2]: https://github.com/rust-lang/rust/pull/28156
5663 [binfat]: https://github.com/rust-lang/rust/pull/28270
5664 [bm]: https://github.com/rust-lang/rust/pull/28197
5665 [cc]: https://github.com/rust-lang/rust/pull/27531
5666 [crlf]: https://github.com/rust-lang/rust/pull/28034
5667 [cu]: https://github.com/rust-lang/cargo/pull/1931
5668 [d]: https://github.com/rust-lang/rust/pull/27825
5669 [dep]: https://github.com/rust-lang/rust/pull/28339
5670 [es]: https://github.com/rust-lang/rust/pull/27956
5671 [ext]: https://github.com/rust-lang/rust/pull/28094
5672 [faststr]: https://github.com/rust-lang/rust/pull/28338
5673 [ffi]: https://github.com/rust-lang/rust/pull/28779
5674 [fp]: https://github.com/rust-lang/rust/pull/28268
5675 [fp2]: https://github.com/rust-lang/rust/pull/28560
5676 [fp3]: https://github.com/rust-lang/rust/pull/27307
5677 [i]: https://github.com/rust-lang/rust/pull/27451
5678 [into2]: https://github.com/rust-lang/rust/pull/28039
5679 [it]: https://github.com/rust-lang/rust/pull/27652
5680 [mm]: https://github.com/rust-lang/rust/pull/27338
5681 [mutw]: https://github.com/rust-lang/rust/pull/28368
5682 [sound]: https://github.com/rust-lang/rust/pull/27641
5683 [p]: https://github.com/rust-lang/rust/pull/27866
5684 [pec]: https://github.com/rust-lang/rust/pull/28486
5685 [pr]: https://github.com/rust-lang/rust/pull/27896
5686 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5687 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5688 [s]: https://github.com/rust-lang/rust/pull/27474
5689 [stab]: https://github.com/rust-lang/rust/pull/28339
5690 [stat]: https://github.com/rust-lang/rust/pull/28321
5691 [vd]: https://github.com/rust-lang/rust/pull/28494
5692
5693 Version 1.3.0 (2015-09-17)
5694 ==============================
5695
5696 * ~900 changes, numerous bugfixes
5697
5698 Highlights
5699 ----------
5700
5701 * The [new object lifetime defaults][nold] have been [turned
5702   on][nold2] after a cycle of warnings about the change. Now types
5703   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
5704   being interpreted as `&'a Box<Trait+'a>` to `&'a
5705   Box<Trait+'static>`.
5706 * [The Rustonomicon][nom] is a new book in the official documentation
5707   that dives into writing unsafe Rust.
5708 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
5709   timekeeping is employed by other std APIs, as well as out-of-tree
5710   time crates.
5711
5712 Breaking Changes
5713 ----------------
5714
5715 * The [new object lifetime defaults][nold] have been [turned
5716   on][nold2] after a cycle of warnings about the change.
5717 * There is a known [regression][lr] in how object lifetime elision is
5718   interpreted, the proper solution for which is undetermined.
5719 * The `#[prelude_import]` attribute, an internal implementation
5720   detail, was accidentally stabilized previously. [It has been put
5721   behind the `prelude_import` feature gate][pi]. This change is
5722   believed to break no existing code.
5723 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5724   [more sane for dynamically sized types][dst3]. Code that relied on
5725   the previous behavior is thought to be broken.
5726 * The `dropck` rules, which checks that destructors can't access
5727   destroyed values, [have been updated][dropck] to match the
5728   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
5729   cause some previously-compiling code to no longer build.
5730
5731 Language
5732 --------
5733
5734 * The [new object lifetime defaults][nold] have been [turned
5735   on][nold2] after a cycle of warnings about the change.
5736 * Semicolons may [now follow types and paths in
5737   macros](https://github.com/rust-lang/rust/pull/27000).
5738 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5739   [more sane for dynamically sized types][dst3]. Code that relied on
5740   the previous behavior is not known to exist, and suspected to be
5741   broken.
5742 * `'static` variables [may now be recursive][st].
5743 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
5744   implementations correctly.
5745 * The `dropck` rules, which checks that destructors can't access
5746   destroyed values, [have been updated][dropck] to match the
5747   [RFC][dropckrfc].
5748
5749 Libraries
5750 ---------
5751
5752 * The [`Duration`] API, [has been stabilized][ds], as well as the
5753   `std::time` module, which presently contains only `Duration`.
5754 * `Box<str>` and `Box<[T]>` both implement `Clone`.
5755 * The owned C string, [`CString`], implements [`Borrow`] and the
5756   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
5757   these allow C strings to be borrowed and cloned in generic code.
5758 * [`CStr`] implements [`Debug`].
5759 * [`AtomicPtr`] implements [`Debug`].
5760 * [`Error`] trait objects [can be downcast to their concrete types][e]
5761   in many common configurations, using the [`is`], [`downcast`],
5762   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
5763   [`Any`] trait.
5764 * Searching for substrings now [employs the two-way algorithm][search]
5765   instead of doing a naive search. This gives major speedups to a
5766   number of methods, including [`contains`][sc], [`find`][sf],
5767   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
5768   [`ends_with`][sew] are also faster.
5769 * The performance of `PartialEq` for slices is [much faster][ps].
5770 * The [`Hash`] trait offers the default method, [`hash_slice`], which
5771   is overridden and optimized by the implementations for scalars.
5772 * The [`Hasher`] trait now has a number of specialized `write_*`
5773   methods for primitive types, for efficiency.
5774 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
5775   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
5776   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
5777   of [`std::error::Error::cause`][iec] also delegates to the inner
5778   error.
5779 * [`process::Child`][pc] gained the [`id`] method, which returns a
5780   `u32` representing the platform-specific process identifier.
5781 * The [`connect`] method on slices is deprecated, replaced by the new
5782   [`join`] method (note that both of these are on the *unstable*
5783   [`SliceConcatExt`] trait, but through the magic of the prelude are
5784   available to stable code anyway).
5785 * The [`Div`] operator is implemented for [`Wrapping`] types.
5786 * [`DerefMut` is implemented for `String`][dms].
5787 * Performance of SipHash (the default hasher for `HashMap`) is
5788   [better for long data][sh].
5789 * [`AtomicPtr`] implements [`Send`].
5790 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
5791   are now [specialized to use uninitialized buffers for increased
5792   performance][rte].
5793 * Lifetime parameters of foreign functions [are now resolved
5794   properly][f].
5795
5796 Misc
5797 ----
5798
5799 * Rust can now, with some coercion, [produce programs that run on
5800   Windows XP][xp], though XP is not considered a supported platform.
5801 * Porting Rust on Windows from the GNU toolchain to MSVC continues
5802   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
5803   recommended for use in 1.3, though should be fully-functional
5804   in the [64-bit 1.4 beta][b14].
5805 * On Fedora-based systems installation will [properly configure the
5806   dynamic linker][fl].
5807 * The compiler gained many new extended error descriptions, which can
5808   be accessed with the `--explain` flag.
5809 * The `dropck` pass, which checks that destructors can't access
5810   destroyed values, [has been rewritten][dropck]. This fixes some
5811   soundness holes, and as such will cause some previously-compiling
5812   code to no longer build.
5813 * `rustc` now uses [LLVM to write archive files where possible][ar].
5814   Eventually this will eliminate the compiler's dependency on the ar
5815   utility.
5816 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
5817   supported FreeBSD on x86_64).
5818 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5819   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5820   more strict.
5821 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5822   will kill the process instead of leaking][nlp].
5823
5824 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5825 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5826 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5827 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5828 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5829 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5830 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5831 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5832 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5833 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5834 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5835 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5836 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5837 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5838 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5839 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5840 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5841 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5842 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5843 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5844 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5845 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5846 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5847 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5848 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5849 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5850 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5851 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5852 [ar]: https://github.com/rust-lang/rust/pull/26926
5853 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5854 [dms]: https://github.com/rust-lang/rust/pull/26241
5855 [dropck]: https://github.com/rust-lang/rust/pull/27261
5856 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5857 [ds]: https://github.com/rust-lang/rust/pull/26818
5858 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5859 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5860 [dst3]: https://github.com/rust-lang/rust/pull/27351
5861 [e]: https://github.com/rust-lang/rust/pull/24793
5862 [f]: https://github.com/rust-lang/rust/pull/26588
5863 [fb]: https://github.com/rust-lang/rust/pull/26959
5864 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5865 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5866 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5867 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5868 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5869 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5870 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5871 [lic]: https://github.com/rust-lang/rust/pull/26583
5872 [lnu]: https://github.com/rust-lang/rust/pull/27026
5873 [lr]: https://github.com/rust-lang/rust/issues/27248
5874 [lum]: https://github.com/rust-lang/rust/pull/26378
5875 [lur]: https://github.com/rust-lang/rust/pull/26783
5876 [nlp]: https://github.com/rust-lang/rust/pull/27176
5877 [nold2]: https://github.com/rust-lang/rust/pull/27045
5878 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5879 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5880 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5881 [pi]: https://github.com/rust-lang/rust/pull/26699
5882 [ps]: https://github.com/rust-lang/rust/pull/26884
5883 [rte]: https://github.com/rust-lang/rust/pull/26950
5884 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5885 [search]: https://github.com/rust-lang/rust/pull/26327
5886 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5887 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5888 [sh]: https://github.com/rust-lang/rust/pull/27280
5889 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5890 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5891 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5892 [st]: https://github.com/rust-lang/rust/pull/26630
5893 [win1]: https://github.com/rust-lang/rust/pull/26569
5894 [win2]: https://github.com/rust-lang/rust/pull/26741
5895 [win3]: https://github.com/rust-lang/rust/pull/26741
5896 [win4]: https://github.com/rust-lang/rust/pull/27210
5897 [xp]: https://github.com/rust-lang/rust/pull/26569
5898
5899 Version 1.2.0 (2015-08-07)
5900 ==========================
5901
5902 * ~1200 changes, numerous bugfixes
5903
5904 Highlights
5905 ----------
5906
5907 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5908   like `Rc` to contain types without a fixed size, arrays and trait
5909   objects, finally enabling use of `Rc<[T]>` and completing the
5910   implementation of DST.
5911 * [Parallel codegen][parcodegen] is now working again, which can
5912   substantially speed up large builds in debug mode; It also gets
5913   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5914   jobs). It's not enabled by default, but will be "in the near
5915   future". It can be activated with the `-C codegen-units=N` flag to
5916   `rustc`.
5917 * This is the first release with [experimental support for linking
5918   with the MSVC linker and lib C on Windows (instead of using the GNU
5919   variants via MinGW)][win]. It is yet recommended only for the most
5920   intrepid Rustaceans.
5921 * Benchmark compilations are showing a 30% improvement in
5922   bootstrapping over 1.1.
5923
5924 Breaking Changes
5925 ----------------
5926
5927 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5928   unicode case mapping, which is a previously-planned change in
5929   behavior and considered a bugfix.
5930 * [`mem::align_of`] now specifies [the *minimum alignment* for
5931   T][align], which is usually the alignment programs are interested
5932   in, and the same value reported by clang's
5933   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5934   break real code.
5935 * [The `#[packed]` attribute is no longer silently accepted by the
5936   compiler][packed]. This attribute did nothing and code that
5937   mentioned it likely did not work as intended.
5938 * Associated type defaults are [now behind the
5939   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5940   defaults *did not work*, but could be mentioned syntactically. As
5941   such this breakage has minimal impact.
5942
5943 Language
5944 --------
5945
5946 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5947   matching against dereferenceable values.
5948
5949 Libraries
5950 ---------
5951
5952 * The [`Extend`] trait, which grows a collection from an iterator, is
5953   implemented over iterators of references, for `String`, `Vec`,
5954   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5955   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5956 * The [`iter::once`] function returns an iterator that yields a single
5957   element, and [`iter::empty`] returns an iterator that yields no
5958   elements.
5959 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5960   over substring matches.
5961 * [`Cell`] and [`RefCell`] both implement `Eq`.
5962 * A number of methods for wrapping arithmetic are added to the
5963   integral types, [`wrapping_div`], [`wrapping_rem`],
5964   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5965   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5966   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5967   type.. It is illegal for the default arithmetic operations in Rust
5968   to overflow; the desire to wrap must be explicit.
5969 * The `{:#?}` formatting specifier [displays the alternate,
5970   pretty-printed][debugfmt] form of the `Debug` formatter. This
5971   feature was actually introduced prior to 1.0 with little
5972   fanfare.
5973 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5974   for writing data to formatted strings, similar to [`io::Write`].
5975 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5976   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5977   are used by code generators to emit implementations of [`Debug`].
5978 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5979   methods that convert case, following Unicode case mapping.
5980 * It is now easier to handle poisoned locks. The [`PoisonError`]
5981   type, returned by failing lock operations, exposes `into_inner`,
5982   `get_ref`, and `get_mut`, which all give access to the inner lock
5983   guard, and allow the poisoned lock to continue to operate. The
5984   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5985   poisoned lock without attempting to take the lock.
5986 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5987   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5988   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5989   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5990   `ChildStderr`.
5991 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5992   malformed input.
5993
5994 Misc
5995 ----
5996
5997 * `rustc` employs smarter heuristics for guessing at [typos].
5998 * `rustc` emits more efficient code for [no-op conversions between
5999   unsafe pointers][nop].
6000 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6001   resulting in faster compile times and smaller code.
6002
6003 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6004 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6005 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6006 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6007 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6008 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6009 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6010 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6011 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6012 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6013 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6014 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6015 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6016 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6017 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6018 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6019 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6020 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6021 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6022 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6023 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6024 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6025 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6026 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6027 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6028 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6029 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6030 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6031 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6032 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6033 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6034 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6035 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6036 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6037 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6038 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6039 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6040 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6041 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6042 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6043 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6044 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6045 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6046 [align]: https://github.com/rust-lang/rust/pull/25646
6047 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6048 [typos]: https://github.com/rust-lang/rust/pull/26087
6049 [nop]: https://github.com/rust-lang/rust/pull/26336
6050 [fat]: https://github.com/rust-lang/rust/pull/26411
6051 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6052 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6053 [packed]: https://github.com/rust-lang/rust/pull/25541
6054 [ad]: https://github.com/rust-lang/rust/pull/27382
6055 [win]: https://github.com/rust-lang/rust/pull/25350
6056
6057 Version 1.1.0 (2015-06-25)
6058 =========================
6059
6060 * ~850 changes, numerous bugfixes
6061
6062 Highlights
6063 ----------
6064
6065 * The [`std::fs` module has been expanded][fs] to expand the set of
6066   functionality exposed:
6067   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6068     don't incur a syscall on some platforms.
6069   * A `symlink_metadata` function has been added.
6070   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6071     access to all underlying information.
6072 * The compiler now contains extended explanations of many errors. When an error
6073   with an explanation occurs the compiler suggests using the `--explain` flag
6074   to read the explanation. Error explanations are also [available online][err-index].
6075 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6076   well as other work, the time to bootstrap the compiler decreased by
6077   32%.
6078
6079 Libraries
6080 ---------
6081
6082 * The [`str::split_whitespace`] method splits a string on unicode
6083   whitespace boundaries.
6084 * On both Windows and Unix, new extension traits provide conversion of
6085   I/O types to and from the underlying system handles. On Unix, these
6086   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6087   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6088   `TcpListener`, and `UpdSocket`. Further implementations for
6089   `std::process` will be stabilized later.
6090 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6091   Windows, symlinks can be created with
6092   `std::os::windows::symlink_dir` and
6093   `std::os::windows::symlink_file`.
6094 * The `mpsc::Receiver` type can now be converted into an iterator with
6095   `into_iter` on the [`IntoIterator`] trait.
6096 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6097   implementation of the [`From`] trait.
6098 * The `Debug` implementation for `RangeFull` [creates output that is
6099   more consistent with other implementations][rf].
6100 * [`Debug` is implemented for `File`][file].
6101 * The `Default` implementation for `Arc` [no longer requires `Sync +
6102   Send`][arc].
6103 * [The `Iterator` methods `count`, `nth`, and `last` have been
6104   overridden for slices to have O(1) performance instead of O(n)][si].
6105 * Incorrect handling of paths on Windows has been improved in both the
6106   compiler and the standard library.
6107 * [`AtomicPtr` gained a `Default` implementation][ap].
6108 * In accordance with Rust's policy on arithmetic overflow `abs` now
6109   [panics on overflow when debug assertions are enabled][abs].
6110 * The [`Cloned`] iterator, which was accidentally left unstable for
6111   1.0 [has been stabilized][c].
6112 * The [`Incoming`] iterator, which iterates over incoming TCP
6113   connections, and which was accidentally unnamable in 1.0, [is now
6114   properly exported][inc].
6115 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6116   `sift_up` or `sift_down` panic][bh].
6117 * The [`split_off`] method of `LinkedList` [no longer corrupts
6118   the list in certain scenarios][ll].
6119
6120 Misc
6121 ----
6122
6123 * Type checking performance [has improved notably][sk] with
6124   [multiple improvements][pre].
6125 * The compiler [suggests code changes][ch] for more errors.
6126 * rustc and it's build system have experimental support for [building
6127   toolchains against MUSL][m] instead of glibc on Linux.
6128 * The compiler defines the `target_env` cfg value, which is used for
6129   distinguishing toolchains that are otherwise for the same
6130   platform. Presently this is set to `gnu` for common GNU Linux
6131   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6132 * The [`cargo rustc`][crc] command invokes a build with custom flags
6133   to rustc.
6134 * [Android executables are always position independent][pie].
6135 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6136   with `Drop`][drop].
6137
6138 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6139 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6140 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6141 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6142 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6143 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6144 [rf]: https://github.com/rust-lang/rust/pull/24491
6145 [err-index]: https://doc.rust-lang.org/error-index.html
6146 [sk]: https://github.com/rust-lang/rust/pull/24615
6147 [pre]: https://github.com/rust-lang/rust/pull/25323
6148 [file]: https://github.com/rust-lang/rust/pull/24598
6149 [ch]: https://github.com/rust-lang/rust/pull/24683
6150 [arc]: https://github.com/rust-lang/rust/pull/24695
6151 [si]: https://github.com/rust-lang/rust/pull/24701
6152 [ap]: https://github.com/rust-lang/rust/pull/24834
6153 [m]: https://github.com/rust-lang/rust/pull/24777
6154 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6155 [crc]: https://github.com/rust-lang/cargo/pull/1568
6156 [pie]: https://github.com/rust-lang/rust/pull/24953
6157 [abs]: https://github.com/rust-lang/rust/pull/25441
6158 [c]: https://github.com/rust-lang/rust/pull/25496
6159 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6160 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6161 [inc]: https://github.com/rust-lang/rust/pull/25522
6162 [bh]: https://github.com/rust-lang/rust/pull/25856
6163 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6164 [ll]: https://github.com/rust-lang/rust/pull/26022
6165 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6166 [drop]: https://github.com/rust-lang/rust/pull/24935
6167
6168 Version 1.0.0 (2015-05-15)
6169 ========================
6170
6171 * ~1500 changes, numerous bugfixes
6172
6173 Highlights
6174 ----------
6175
6176 * The vast majority of the standard library is now `#[stable]`. It is
6177   no longer possible to use unstable features with a stable build of
6178   the compiler.
6179 * Many popular crates on [crates.io] now work on the stable release
6180   channel.
6181 * Arithmetic on basic integer types now [checks for overflow in debug
6182   builds][overflow].
6183
6184 Language
6185 --------
6186
6187 * Several [restrictions have been added to trait coherence][coh] in
6188   order to make it easier for upstream authors to change traits
6189   without breaking downstream code.
6190 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6191   improve error messages and macro behavior. For example, `0b1234` is
6192   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6193 * Trait bounds [are always invariant][inv], eliminating the need for
6194   the `PhantomFn` and `MarkerTrait` lang items, which have been
6195   removed.
6196 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6197   "foo" as bar` syntax has been replaced with `extern crate foo as
6198   bar`, and Cargo now automatically translates "-" in *package* names
6199   to underscore for the crate name.
6200 * [Lifetime shadowing is an error][lt].
6201 * [`Send` no longer implies `'static`][send-rfc].
6202 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6203   `MyType::default()`.
6204 * Primitive types [now have inherent methods][prim-inherent],
6205   obviating the need for extension traits like `SliceExt`.
6206 * Methods with `Self: Sized` in their `where` clause are [considered
6207   object-safe][self-sized], allowing many extension traits like
6208   `IteratorExt` to be merged into the traits they extended.
6209 * You can now [refer to associated types][assoc-where] whose
6210   corresponding trait bounds appear only in a `where` clause.
6211 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6212   like `Send` and `Sync` are now library-defined.
6213 * A [Reflect trait][reflect] was introduced, which means that
6214   downcasting via the `Any` trait is effectively limited to concrete
6215   types. This helps retain the potentially-important "parametricity"
6216   property: generic code cannot behave differently for different type
6217   arguments except in minor ways.
6218 * The `unsafe_destructor` feature is now deprecated in favor of the
6219   [new `dropck`][dropck]. This change is a major reduction in unsafe
6220   code.
6221
6222 Libraries
6223 ---------
6224
6225 * The `thread_local` module [has been renamed to `std::thread`][th].
6226 * The methods of `IteratorExt` [have been moved to the `Iterator`
6227   trait itself][ie].
6228 * Several traits that implement Rust's conventions for type
6229   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6230   [centralized in the `std::convert` module][con].
6231 * The `FromError` trait [was removed in favor of `From`][fe].
6232 * The basic sleep function [has moved to
6233   `std::thread::sleep_ms`][slp].
6234 * The `splitn` function now takes an `n` parameter that represents the
6235   number of items yielded by the returned iterator [instead of the
6236   number of 'splits'][spl].
6237 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6238 * [Derived implementations of `PartialOrd` now order enums according
6239   to their explicitly-assigned discriminants][po].
6240 * [Methods for searching strings are generic over `Pattern`s][pat],
6241   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6242   some others.
6243 * [In method resolution, object methods are resolved before inherent
6244   methods][meth].
6245 * [`String::from_str` has been deprecated in favor of the `From` impl,
6246   `String::from`][sf].
6247 * [`io::Error` implements `Sync`][ios].
6248 * [The `words` method on `&str` has been replaced with
6249   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6250   a word?'
6251 * The new path and IO modules are complete and `#[stable]`. This
6252   was the major library focus for this cycle.
6253 * The path API was [revised][path-normalize] to normalize `.`,
6254   adjusting the tradeoffs in favor of the most common usage.
6255 * A large number of remaining APIs in `std` were also stabilized
6256   during this cycle; about 75% of the non-deprecated API surface
6257   is now stable.
6258 * The new [string pattern API][string-pattern] landed, which makes
6259   the string slice API much more internally consistent and flexible.
6260 * A new set of [generic conversion traits][conversion] replaced
6261   many existing ad hoc traits.
6262 * Generic numeric traits were [completely removed][num-traits]. This
6263   was made possible thanks to inherent methods for primitive types,
6264   and the removal gives maximal flexibility for designing a numeric
6265   hierarchy in the future.
6266 * The `Fn` traits are now related via [inheritance][fn-inherit]
6267   and provide ergonomic [blanket implementations][fn-blanket].
6268 * The `Index` and `IndexMut` traits were changed to
6269   [take the index by value][index-value], enabling code like
6270   `hash_map["string"]` to work.
6271 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6272   `Copy` data is known to be `Clone` as well.
6273
6274 Misc
6275 ----
6276
6277 * Many errors now have extended explanations that can be accessed with
6278   the `--explain` flag to `rustc`.
6279 * Many new examples have been added to the standard library
6280   documentation.
6281 * rustdoc has received a number of improvements focused on completion
6282   and polish.
6283 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6284 * Much headway was made on ecosystem-wide CI, making it possible
6285   to [compare builds for breakage][ci-compare].
6286
6287
6288 [crates.io]: http://crates.io
6289 [clo]: https://github.com/rust-lang/rust/pull/24034
6290 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6291 [con]: https://github.com/rust-lang/rust/pull/23875
6292 [cr]: https://github.com/rust-lang/rust/pull/23419
6293 [fe]: https://github.com/rust-lang/rust/pull/23879
6294 [ie]: https://github.com/rust-lang/rust/pull/23300
6295 [inv]: https://github.com/rust-lang/rust/pull/23938
6296 [ios]: https://github.com/rust-lang/rust/pull/24133
6297 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6298 [lt]: https://github.com/rust-lang/rust/pull/24057
6299 [meth]: https://github.com/rust-lang/rust/pull/24056
6300 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6301 [po]: https://github.com/rust-lang/rust/pull/24270
6302 [sf]: https://github.com/rust-lang/rust/pull/24517
6303 [slp]: https://github.com/rust-lang/rust/pull/23949
6304 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6305 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6306 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6307 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6308 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6309 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6310 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6311 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6312 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6313 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6314 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6315 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6316 [reflect]: https://github.com/rust-lang/rust/pull/23712
6317 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6318 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6319 [index-value]: https://github.com/rust-lang/rust/pull/23601
6320 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6321 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6322 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6323 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6324 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6325 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6326
6327
6328 Version 1.0.0-alpha.2 (2015-02-20)
6329 =====================================
6330
6331 * ~1300 changes, numerous bugfixes
6332
6333 * Highlights
6334
6335     * The various I/O modules were [overhauled][io-rfc] to reduce
6336       unnecessary abstractions and provide better interoperation with
6337       the underlying platform. The old `io` module remains temporarily
6338       at `std::old_io`.
6339     * The standard library now [participates in feature gating][feat],
6340       so use of unstable libraries now requires a `#![feature(...)]`
6341       attribute. The impact of this change is [described on the
6342       forum][feat-forum]. [RFC][feat-rfc].
6343
6344 * Language
6345
6346     * `for` loops [now operate on the `IntoIterator` trait][into],
6347       which eliminates the need to call `.iter()`, etc. to iterate
6348       over collections. There are some new subtleties to remember
6349       though regarding what sort of iterators various types yield, in
6350       particular that `for foo in bar { }` yields values from a move
6351       iterator, destroying the original collection. [RFC][into-rfc].
6352     * Objects now have [default lifetime bounds][obj], so you don't
6353       have to write `Box<Trait+'static>` when you don't care about
6354       storing references. [RFC][obj-rfc].
6355     * In types that implement `Drop`, [lifetimes must outlive the
6356       value][drop]. This will soon make it possible to safely
6357       implement `Drop` for types where `#[unsafe_destructor]` is now
6358       required. Read the [gorgeous RFC][drop-rfc] for details.
6359     * The fully qualified <T as Trait>::X syntax lets you set the Self
6360       type for a trait method or associated type. [RFC][ufcs-rfc].
6361     * References to types that implement `Deref<U>` now [automatically
6362       coerce to references][deref] to the dereferenced type `U`,
6363       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6364       should eliminate many unsightly uses of `&*`, as when converting
6365       from references to vectors into references to
6366       slices. [RFC][deref-rfc].
6367     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6368       `|:|`) is obsolete and closure kind is inferred from context.
6369     * [`Self` is a keyword][Self].
6370
6371 * Libraries
6372
6373     * The `Show` and `String` formatting traits [have been
6374       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6375       their related purposes. Automatically getting a string
6376       conversion to use with `format!("{:?}", something_to_debug)` is
6377       now written `#[derive(Debug)]`.
6378     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6379       OsStr}`, provide strings in platform-specific encodings for easier
6380       interop with system APIs. [RFC][osstr-rfc].
6381     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6382       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6383       creating raw pointers.
6384
6385 * Tooling
6386
6387     * Certain long error messages of the form 'expected foo found bar'
6388       are now [split neatly across multiple
6389       lines][multiline]. Examples in the PR.
6390     * On Unix Rust can be [uninstalled][un] by running
6391       `/usr/local/lib/rustlib/uninstall.sh`.
6392     * The `#[rustc_on_unimplemented]` attribute, requiring the
6393       'on_unimplemented' feature, lets rustc [display custom error
6394       messages when a trait is expected to be implemented for a type
6395       but is not][onun].
6396
6397 * Misc
6398
6399     * Rust is tested against a [LALR grammar][lalr], which parses
6400       almost all the Rust files that rustc does.
6401
6402 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6403 [close]: https://github.com/rust-lang/rust/pull/21843
6404 [deref]: https://github.com/rust-lang/rust/pull/21351
6405 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6406 [drop]: https://github.com/rust-lang/rust/pull/21972
6407 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6408 [feat]: https://github.com/rust-lang/rust/pull/21248
6409 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6410 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6411 [fmt]: https://github.com/rust-lang/rust/pull/21457
6412 [into]: https://github.com/rust-lang/rust/pull/20790
6413 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6414 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6415 [lalr]: https://github.com/rust-lang/rust/pull/21452
6416 [multiline]: https://github.com/rust-lang/rust/pull/19870
6417 [obj]: https://github.com/rust-lang/rust/pull/22230
6418 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6419 [onun]: https://github.com/rust-lang/rust/pull/20889
6420 [osstr]: https://github.com/rust-lang/rust/pull/21488
6421 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6422 [Self]: https://github.com/rust-lang/rust/pull/22158
6423 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6424 [un]: https://github.com/rust-lang/rust/pull/22256
6425
6426
6427 Version 1.0.0-alpha (2015-01-09)
6428 ==================================
6429
6430   * ~2400 changes, numerous bugfixes
6431
6432   * Highlights
6433
6434     * The language itself is considered feature complete for 1.0,
6435       though there will be many usability improvements and bugfixes
6436       before the final release.
6437     * Nearly 50% of the public API surface of the standard library has
6438       been declared 'stable'. Those interfaces are unlikely to change
6439       before 1.0.
6440     * The long-running debate over integer types has been
6441       [settled][ints]: Rust will ship with types named `isize` and
6442       `usize`, rather than `int` and `uint`, for pointer-sized
6443       integers. Guidelines will be rolled out during the alpha cycle.
6444     * Most crates that are not `std` have been moved out of the Rust
6445       distribution into the Cargo ecosystem so they can evolve
6446       separately and don't need to be stabilized as quickly, including
6447       'time', 'getopts', 'num', 'regex', and 'term'.
6448     * Documentation continues to be expanded with more API coverage, more
6449       examples, and more in-depth explanations. The guides have been
6450       consolidated into [The Rust Programming Language][trpl].
6451     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6452     * All official Rust binary installers now come with [Cargo], the
6453       Rust package manager.
6454
6455 * Language
6456
6457     * Closures have been [completely redesigned][unboxed] to be
6458       implemented in terms of traits, can now be used as generic type
6459       bounds and thus monomorphized and inlined, or via an opaque
6460       pointer (boxed) as in the old system. The new system is often
6461       referred to as 'unboxed' closures.
6462     * Traits now support [associated types][assoc], allowing families
6463       of related types to be defined together and used generically in
6464       powerful ways.
6465     * Enum variants are [namespaced by their type names][enum].
6466     * [`where` clauses][where] provide a more versatile and attractive
6467       syntax for specifying generic bounds, though the previous syntax
6468       remains valid.
6469     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6470       numeric types.
6471     * Rust [no longer has a runtime][rt] of any description, and only
6472       supports OS threads, not green threads.
6473     * At long last, Rust has been overhauled for 'dynamically-sized
6474       types' ([DST]), which integrates 'fat pointers' (object types,
6475       arrays, and `str`) more deeply into the type system, making it
6476       more consistent.
6477     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6478       `..j` that produce range types and which, when combined with the
6479       `Index` operator and multidispatch, leads to a convenient slice
6480       notation, `[i..j]`.
6481     * The new range syntax revealed an ambiguity in the fixed-length
6482       array syntax, so now fixed length arrays [are written `[T;
6483       N]`][arrays].
6484     * The `Copy` trait is no longer implemented automatically. Unsafe
6485       pointers no longer implement `Sync` and `Send` so types
6486       containing them don't automatically either. `Sync` and `Send`
6487       are now 'unsafe traits' so one can "forcibly" implement them via
6488       `unsafe impl` if a type confirms to the requirements for them
6489       even though the internals do not (e.g. structs containing unsafe
6490       pointers like `Arc`). These changes are intended to prevent some
6491       footguns and are collectively known as [opt-in built-in
6492       traits][oibit] (though `Sync` and `Send` will soon become pure
6493       library types unknown to the compiler).
6494     * Operator traits now take their operands [by value][ops], and
6495       comparison traits can use multidispatch to compare one type
6496       against multiple other types, allowing e.g. `String` to be
6497       compared with `&str`.
6498     * `if let` and `while let` are no longer feature-gated.
6499     * Rust has adopted a more [uniform syntax for escaping unicode
6500       characters][unicode].
6501     * `macro_rules!` [has been declared stable][mac]. Though it is a
6502       flawed system it is sufficiently popular that it must be usable
6503       for 1.0. Effort has gone into [future-proofing][mac-future] it
6504       in ways that will allow other macro systems to be developed in
6505       parallel, and won't otherwise impact the evolution of the
6506       language.
6507     * The prelude has been [pared back significantly][prelude] such
6508       that it is the minimum necessary to support the most pervasive
6509       code patterns, and through [generalized where clauses][where]
6510       many of the prelude extension traits have been consolidated.
6511     * Rust's rudimentary reflection [has been removed][refl], as it
6512       incurred too much code generation for little benefit.
6513     * [Struct variants][structvars] are no longer feature-gated.
6514     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6515       known as 'higher-ranked trait bounds', this crucially allows
6516       unboxed closures to work.
6517     * Macros invocations surrounded by parens or square brackets and
6518       not terminated by a semicolon are [parsed as
6519       expressions][macros], which makes expressions like `vec![1i32,
6520       2, 3].len()` work as expected.
6521     * Trait objects now implement their traits automatically, and
6522       traits that can be coerced to objects now must be [object
6523       safe][objsafe].
6524     * Automatically deriving traits is now done with `#[derive(...)]`
6525       not `#[deriving(...)]` for [consistency with other naming
6526       conventions][derive].
6527     * Importing the containing module or enum at the same time as
6528       items or variants they contain is [now done with `self` instead
6529       of `mod`][self], as in use `foo::{self, bar}`
6530     * Glob imports are no longer feature-gated.
6531     * The `box` operator and `box` patterns have been feature-gated
6532       pending a redesign. For now unique boxes should be allocated
6533       like other containers, with `Box::new`.
6534
6535 * Libraries
6536
6537     * A [series][coll1] of [efforts][coll2] to establish
6538       [conventions][coll3] for collections types has resulted in API
6539       improvements throughout the standard library.
6540     * New [APIs for error handling][err] provide ergonomic interop
6541       between error types, and [new conventions][err-conv] describe
6542       more clearly the recommended error handling strategies in Rust.
6543     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6544       it is easier to discuss failure in the context of error handling
6545       without making clarifications as to whether you are referring to
6546       the 'fail' macro or failure more generally.
6547     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6548       syscall when available.
6549     * The 'serialize' crate has been renamed 'rustc-serialize' and
6550       moved out of the distribution to Cargo. Although it is widely
6551       used now, it is expected to be superseded in the near future.
6552     * The `Show` formatter, typically implemented with
6553       `#[derive(Show)]` is [now requested with the `{:?}`
6554       specifier][show] and is intended for use by all types, for uses
6555       such as `println!` debugging. The new `String` formatter must be
6556       implemented by hand, uses the `{}` specifier, and is intended
6557       for full-fidelity conversions of things that can logically be
6558       represented as strings.
6559
6560 * Tooling
6561
6562     * [Flexible target specification][flex] allows rustc's code
6563       generation to be configured to support otherwise-unsupported
6564       platforms.
6565     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6566       respective debuggers with Rust-appropriate pretty-printing.
6567     * The Windows installation of Rust is distributed with the
6568       MinGW components currently required to link binaries on that
6569       platform.
6570
6571 * Misc
6572
6573     * Nullable enum optimizations have been extended to more types so
6574       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6575       space than the inner types themselves.
6576     * Work has begun on supporting AArch64.
6577
6578 [Cargo]: https://crates.io
6579 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6580 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6581 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6582 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6583 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6584 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6585 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6586 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6587 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6588 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6589 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6590 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6591 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6592 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6593 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6594 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6595 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6596 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6597 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6598 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6599 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6600 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6601 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6602 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6603 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6604 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6605 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6606 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6607 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6608 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6609 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6610 [trpl]: https://doc.rust-lang.org/book/index.html
6611 [rbe]: http://rustbyexample.com/
6612
6613
6614 Version 0.12.0 (2014-10-09)
6615 =============================
6616
6617   * ~1900 changes, numerous bugfixes
6618
6619   * Highlights
6620
6621     * The introductory documentation (now called The Rust Guide) has
6622       been completely rewritten, as have a number of supplementary
6623       guides.
6624     * Rust's package manager, Cargo, continues to improve and is
6625       sometimes considered to be quite awesome.
6626     * Many API's in `std` have been reviewed and updated for
6627       consistency with the in-development Rust coding
6628       guidelines. The standard library documentation tracks
6629       stabilization progress.
6630     * Minor libraries have been moved out-of-tree to the rust-lang org
6631       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6632       be installed with Cargo.
6633     * Lifetime elision allows lifetime annotations to be left off of
6634       function declarations in many common scenarios.
6635     * Rust now works on 64-bit Windows.
6636
6637   * Language
6638     * Indexing can be overloaded with the `Index` and `IndexMut`
6639       traits.
6640     * The `if let` construct takes a branch only if the `let` pattern
6641       matches, currently behind the 'if_let' feature gate.
6642     * 'where clauses', a more flexible syntax for specifying trait
6643       bounds that is more aesthetic, have been added for traits and
6644       free functions. Where clauses will in the future make it
6645       possible to constrain associated types, which would be
6646       impossible with the existing syntax.
6647     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
6648       the 'slicing_syntax' feature gate, and can be overloaded with
6649       the `Slice` or `SliceMut` traits.
6650     * The syntax for matching of sub-slices has been changed to use a
6651       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
6652       consistency with other uses of `..` and to future-proof
6653       potential additional uses of the syntax.
6654     * The syntax for matching inclusive ranges in patterns has changed
6655       from `0..3` to `0...4` to be consistent with the exclusive range
6656       syntax for slicing.
6657     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
6658       c]`) has been put behind the 'advanced_slice_patterns' feature
6659       gate and may be removed in the future.
6660     * Components of tuples and tuple structs can be extracted using
6661       the `value.0` syntax, currently behind the `tuple_indexing`
6662       feature gate.
6663     * The `#[crate_id]` attribute is no longer supported; versioning
6664       is handled by the package manager.
6665     * Renaming crate imports are now written `extern crate foo as bar`
6666       instead of `extern crate bar = foo`.
6667     * Renaming use statements are now written `use foo as bar` instead
6668       of `use bar = foo`.
6669     * `let` and `match` bindings and argument names in macros are now
6670       hygienic.
6671     * The new, more efficient, closure types ('unboxed closures') have
6672       been added under a feature gate, 'unboxed_closures'. These will
6673       soon replace the existing closure types, once higher-ranked
6674       trait lifetimes are added to the language.
6675     * `move` has been added as a keyword, for indicating closures
6676       that capture by value.
6677     * Mutation and assignment is no longer allowed in pattern guards.
6678     * Generic structs and enums can now have trait bounds.
6679     * The `Share` trait is now called `Sync` to free up the term
6680       'shared' to refer to 'shared reference' (the default reference
6681       type.
6682     * Dynamically-sized types have been mostly implemented,
6683       unifying the behavior of fat-pointer types with the rest of the
6684       type system.
6685     * As part of dynamically-sized types, the `Sized` trait has been
6686       introduced, which qualifying types implement by default, and
6687       which type parameters expect by default. To specify that a type
6688       parameter does not need to be sized, write `<Sized? T>`. Most
6689       types are `Sized`, notable exceptions being unsized arrays
6690       (`[T]`) and trait types.
6691     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
6692     * Lifetime bounds can now be applied to type parameters and object
6693       types.
6694     * The old, reference counted GC type, `Gc<T>` which was once
6695       denoted by the `@` sigil, has finally been removed. GC will be
6696       revisited in the future.
6697
6698   * Libraries
6699     * Library documentation has been improved for a number of modules.
6700     * Bit-vectors, collections::bitv has been modernized.
6701     * The url crate is deprecated in favor of
6702       http://github.com/servo/rust-url, which can be installed with
6703       Cargo.
6704     * Most I/O stream types can be cloned and subsequently closed from
6705       a different thread.
6706     * A `std::time::Duration` type has been added for use in I/O
6707       methods that rely on timers, as well as in the 'time' crate's
6708       `Timespec` arithmetic.
6709     * The runtime I/O abstraction layer that enabled the green thread
6710       scheduler to do non-thread-blocking I/O has been removed, along
6711       with the libuv-based implementation employed by the green thread
6712       scheduler. This will greatly simplify the future I/O work.
6713     * `collections::btree` has been rewritten to have a more
6714       idiomatic and efficient design.
6715
6716   * Tooling
6717     * rustdoc output now indicates the stability levels of API's.
6718     * The `--crate-name` flag can specify the name of the crate
6719       being compiled, like `#[crate_name]`.
6720     * The `-C metadata` specifies additional metadata to hash into
6721       symbol names, and `-C extra-filename` specifies additional
6722       information to put into the output filename, for use by the
6723       package manager for versioning.
6724     * debug info generation has continued to improve and should be
6725       more reliable under both gdb and lldb.
6726     * rustc has experimental support for compiling in parallel
6727       using the `-C codegen-units` flag.
6728     * rustc no longer encodes rpath information into binaries by
6729       default.
6730
6731   * Misc
6732     * Stack usage has been optimized with LLVM lifetime annotations.
6733     * Official Rust binaries on Linux are more compatible with older
6734       kernels and distributions, built on CentOS 5.10.
6735
6736
6737 Version 0.11.0 (2014-07-02)
6738 ==========================
6739
6740   * ~1700 changes, numerous bugfixes
6741
6742   * Language
6743     * ~[T] has been removed from the language. This type is superseded by
6744       the Vec<T> type.
6745     * ~str has been removed from the language. This type is superseded by
6746       the String type.
6747     * ~T has been removed from the language. This type is superseded by the
6748       Box<T> type.
6749     * @T has been removed from the language. This type is superseded by the
6750       standard library's std::gc::Gc<T> type.
6751     * Struct fields are now all private by default.
6752     * Vector indices and shift amounts are both required to be a `uint`
6753       instead of any integral type.
6754     * Byte character, byte string, and raw byte string literals are now all
6755       supported by prefixing the normal literal with a `b`.
6756     * Multiple ABIs are no longer allowed in an ABI string
6757     * The syntax for lifetimes on closures/procedures has been tweaked
6758       slightly: `<'a>|A, B|: 'b + K -> T`
6759     * Floating point modulus has been removed from the language; however it
6760       is still provided by a library implementation.
6761     * Private enum variants are now disallowed.
6762     * The `priv` keyword has been removed from the language.
6763     * A closure can no longer be invoked through a &-pointer.
6764     * The `use foo, bar, baz;` syntax has been removed from the language.
6765     * The transmute intrinsic no longer works on type parameters.
6766     * Statics now allow blocks/items in their definition.
6767     * Trait bounds are separated from objects with + instead of : now.
6768     * Objects can no longer be read while they are mutably borrowed.
6769     * The address of a static is now marked as insignificant unless the
6770       #[inline(never)] attribute is placed it.
6771     * The #[unsafe_destructor] attribute is now behind a feature gate.
6772     * Struct literals are no longer allowed in ambiguous positions such as
6773       if, while, match, and for..in.
6774     * Declaration of lang items and intrinsics are now feature-gated by
6775       default.
6776     * Integral literals no longer default to `int`, and floating point
6777       literals no longer default to `f64`. Literals must be suffixed with an
6778       appropriate type if inference cannot determine the type of the
6779       literal.
6780     * The Box<T> type is no longer implicitly borrowed to &mut T.
6781     * Procedures are now required to not capture borrowed references.
6782
6783   * Libraries
6784     * The standard library is now a "facade" over a number of underlying
6785       libraries. This means that development on the standard library should
6786       be speedier due to smaller crates, as well as a clearer line between
6787       all dependencies.
6788     * A new library, libcore, lives under the standard library's facade
6789       which is Rust's "0-assumption" library, suitable for embedded and
6790       kernel development for example.
6791     * A regex crate has been added to the standard distribution. This crate
6792       includes statically compiled regular expressions.
6793     * The unwrap/unwrap_err methods on Result require a Show bound for
6794       better error messages.
6795     * The return types of the std::comm primitives have been centralized
6796       around the Result type.
6797     * A number of I/O primitives have gained the ability to time out their
6798       operations.
6799     * A number of I/O primitives have gained the ability to close their
6800       reading/writing halves to cancel pending operations.
6801     * Reverse iterator methods have been removed in favor of `rev()` on
6802       their forward-iteration counterparts.
6803     * A bitflags! macro has been added to enable easy interop with C and
6804       management of bit flags.
6805     * A debug_assert! macro is now provided which is disabled when
6806       `--cfg ndebug` is passed to the compiler.
6807     * A graphviz crate has been added for creating .dot files.
6808     * The std::cast module has been migrated into std::mem.
6809     * The std::local_data api has been migrated from freestanding functions
6810       to being based on methods.
6811     * The Pod trait has been renamed to Copy.
6812     * jemalloc has been added as the default allocator for types.
6813     * The API for allocating memory has been changed to use proper alignment
6814       and sized deallocation
6815     * Connecting a TcpStream or binding a TcpListener is now based on a
6816       string address and a u16 port. This allows connecting to a hostname as
6817       opposed to an IP.
6818     * The Reader trait now contains a core method, read_at_least(), which
6819       correctly handles many repeated 0-length reads.
6820     * The process-spawning API is now centered around a builder-style
6821       Command struct.
6822     * The :? printing qualifier has been moved from the standard library to
6823       an external libdebug crate.
6824     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6825       have been renamed to Eq/Ord.
6826     * The select/plural methods have been removed from format!. The escapes
6827       for { and } have also changed from \{ and \} to {{ and }},
6828       respectively.
6829     * The TaskBuilder API has been re-worked to be a true builder, and
6830       extension traits for spawning native/green tasks have been added.
6831
6832   * Tooling
6833     * All breaking changes to the language or libraries now have their
6834       commit message annotated with `[breaking-change]` to allow for easy
6835       discovery of breaking changes.
6836     * The compiler will now try to suggest how to annotate lifetimes if a
6837       lifetime-related error occurs.
6838     * Debug info continues to be improved greatly with general bug fixes and
6839       better support for situations like link time optimization (LTO).
6840     * Usage of syntax extensions when cross-compiling has been fixed.
6841     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6842       -fdata-sections and --gc-sections has been enabled by default
6843     * The compiler is now stricter about where it will load module files
6844       from when a module is declared via `mod foo;`.
6845     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6846       Syntax extensions are now discovered via a "plugin registrar" type
6847       which will be extended in the future to other various plugins.
6848     * Lints have been restructured to allow for dynamically loadable lints.
6849     * A number of rustdoc improvements:
6850       * The HTML output has been visually redesigned.
6851       * Markdown is now powered by hoedown instead of sundown.
6852       * Searching heuristics have been greatly improved.
6853       * The search index has been reduced in size by a great amount.
6854       * Cross-crate documentation via `pub use` has been greatly improved.
6855       * Primitive types are now hyperlinked and documented.
6856     * Documentation has been moved from static.rust-lang.org/doc to
6857       doc.rust-lang.org
6858     * A new sandbox, play.rust-lang.org, is available for running and
6859       sharing rust code examples on-line.
6860     * Unused attributes are now more robustly warned about.
6861     * The dead_code lint now warns about unused struct fields.
6862     * Cross-compiling to iOS is now supported.
6863     * Cross-compiling to mipsel is now supported.
6864     * Stability attributes are now inherited by default and no longer apply
6865       to intra-crate usage, only inter-crate usage.
6866     * Error message related to non-exhaustive match expressions have been
6867       greatly improved.
6868
6869
6870 Version 0.10 (2014-04-03)
6871 =========================
6872
6873   * ~1500 changes, numerous bugfixes
6874
6875   * Language
6876     * A new RFC process is now in place for modifying the language.
6877     * Patterns with `@`-pointers have been removed from the language.
6878     * Patterns with unique vectors (`~[T]`) have been removed from the
6879       language.
6880     * Patterns with unique strings (`~str`) have been removed from the
6881       language.
6882     * `@str` has been removed from the language.
6883     * `@[T]` has been removed from the language.
6884     * `@self` has been removed from the language.
6885     * `@Trait` has been removed from the language.
6886     * Headers on `~` allocations which contain `@` boxes inside the type for
6887       reference counting have been removed.
6888     * The semantics around the lifetimes of temporary expressions have changed,
6889       see #3511 and #11585 for more information.
6890     * Cross-crate syntax extensions are now possible, but feature gated. See
6891       #11151 for more information. This includes both `macro_rules!` macros as
6892       well as syntax extensions such as `format!`.
6893     * New lint modes have been added, and older ones have been turned on to be
6894       warn-by-default.
6895       * Unnecessary parentheses
6896       * Uppercase statics
6897       * Camel Case types
6898       * Uppercase variables
6899       * Publicly visible private types
6900       * `#[deriving]` with raw pointers
6901     * Unsafe functions can no longer be coerced to closures.
6902     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6903     * The `#[simd]` attribute is now behind a feature gate.
6904     * Visibility is no longer allowed on `extern crate` statements, and
6905       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6906     * Trailing commas are now allowed in argument lists and tuple patterns.
6907     * The `do` keyword has been removed, it is now a reserved keyword.
6908     * Default type parameters have been implemented, but are feature gated.
6909     * Borrowed variables through captures in closures are now considered soundly.
6910     * `extern mod` is now `extern crate`
6911     * The `Freeze` trait has been removed.
6912     * The `Share` trait has been added for types that can be shared among
6913       threads.
6914     * Labels in macros are now hygienic.
6915     * Expression/statement macro invocations can be delimited with `{}` now.
6916     * Treatment of types allowed in `static mut` locations has been tweaked.
6917     * The `*` and `.` operators are now overloadable through the `Deref` and
6918       `DerefMut` traits.
6919     * `~Trait` and `proc` no longer have `Send` bounds by default.
6920     * Partial type hints are now supported with the `_` type marker.
6921     * An `Unsafe` type was introduced for interior mutability. It is now
6922       considered undefined to transmute from `&T` to `&mut T` without using the
6923       `Unsafe` type.
6924     * The #[linkage] attribute was implemented for extern statics/functions.
6925     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6926     * `Pod` was renamed to `Copy`.
6927
6928   * Libraries
6929     * The `libextra` library has been removed. It has now been decomposed into
6930       component libraries with smaller and more focused nuggets of
6931       functionality. The full list of libraries can be found on the
6932       documentation index page.
6933     * std: `std::condition` has been removed. All I/O errors are now propagated
6934       through the `Result` type. In order to assist with error handling, a
6935       `try!` macro for unwrapping errors with an early return and a lint for
6936       unused results has been added. See #12039 for more information.
6937     * std: The `vec` module has been renamed to `slice`.
6938     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6939       This will become the only growable vector in the future.
6940     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6941       are now found at `std::io::BufferedReader` instead of
6942       `std::io::buffered::BufferedReader`.
6943     * std: `print` and `println` are no longer in the prelude, the `print!` and
6944       `println!` macros are intended to be used instead.
6945     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6946       attempts to statically prevent cycles.
6947     * std: The standard distribution is adopting the policy of pushing failure
6948       to the user rather than failing in libraries. Many functions (such as
6949       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6950     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6951       deriving mode: `#[deriving(Show)]`.
6952     * std: `ToStr` is now implemented for all types implementing `Show`.
6953     * std: The formatting trait methods now take `&self` instead of `&T`
6954     * std: The `invert()` method on iterators has been renamed to `rev()`
6955     * std: `std::num` has seen a reduction in the genericity of its traits,
6956       consolidating functionality into a few core traits.
6957     * std: Backtraces are now printed on task failure if the environment
6958       variable `RUST_BACKTRACE` is present.
6959     * std: Naming conventions for iterators have been standardized. More details
6960       can be found on the wiki's style guide.
6961     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6962       still implement the function.
6963     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6964     * std: `assert_approx_eq!` has been removed
6965     * std: The `e` and `E` formatting specifiers for floats have been added to
6966       print them in exponential notation.
6967     * std: The `Times` trait has been removed
6968     * std: Indications of variance and opting out of builtin bounds is done
6969       through marker types in `std::kinds::marker` now
6970     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6971       `#[deriving(Hash)]` is now possible.
6972     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6973     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6974     * std: `Chan::new` is now `channel()`.
6975     * std: A new synchronous channel type has been implemented.
6976     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6977     * std: `hashmap` and `trie` have been moved to `libcollections`
6978     * std: `run` has been rolled into `io::process`
6979     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6980     * std: The equality and comparison traits have seen some reorganization.
6981     * std: `rand` has moved to `librand`.
6982     * std: `to_{lower,upper}case` has been implemented for `char`.
6983     * std: Logging has been moved to `liblog`.
6984     * collections: `HashMap` has been rewritten for higher performance and less
6985       memory usage.
6986     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6987       it can be booted manually. The runtime guide has more information and
6988       examples.
6989     * native: All I/O functionality except signals has been implemented.
6990     * green: Task spawning with `libgreen` has been optimized with stack caching
6991       and various trimming of code.
6992     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6993     * sync: The `extra::sync` module has been updated to modern rust (and moved
6994       to the `sync` library), tweaking and improving various interfaces while
6995       dropping redundant functionality.
6996     * sync: A new `Barrier` type has been added to the `sync` library.
6997     * sync: An efficient mutex for native and green tasks has been implemented.
6998     * serialize: The `base64` module has seen some improvement. It treats
6999       newlines better, has non-string error values, and has seen general
7000       cleanup.
7001     * fourcc: A `fourcc!` macro was introduced
7002     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7003       hexadecimal literal.
7004
7005   * Tooling
7006     * `rustpkg` has been deprecated and removed from the main repository. Its
7007       replacement, `cargo`, is under development.
7008     * Nightly builds of rust are now available
7009     * The memory usage of rustc has been improved many times throughout this
7010       release cycle.
7011     * The build process supports disabling rpath support for the rustc binary
7012       itself.
7013     * Code generation has improved in some cases, giving more information to the
7014       LLVM optimization passes to enable more extensive optimizations.
7015     * Debuginfo compatibility with lldb on OSX has been restored.
7016     * The master branch is now gated on an android bot, making building for
7017       android much more reliable.
7018     * Output flags have been centralized into one `--emit` flag.
7019     * Crate type flags have been centralized into one `--crate-type` flag.
7020     * Codegen flags have been consolidated behind a `-C` flag.
7021     * Linking against outdated crates now has improved error messages.
7022     * Error messages with lifetimes will often suggest how to annotate the
7023       function to fix the error.
7024     * Many more types are documented in the standard library, and new guides
7025       were written.
7026     * Many `rustdoc` improvements:
7027       * code blocks are syntax highlighted.
7028       * render standalone markdown files.
7029       * the --test flag tests all code blocks by default.
7030       * exported macros are displayed.
7031       * re-exported types have their documentation inlined at the location of the
7032         first re-export.
7033       * search works across crates that have been rendered to the same output
7034         directory.
7035
7036
7037 Version 0.9 (2014-01-09)
7038 ==========================
7039
7040    * ~1800 changes, numerous bugfixes
7041
7042    * Language
7043       * The `float` type has been removed. Use `f32` or `f64` instead.
7044       * A new facility for enabling experimental features (feature gating) has
7045         been added, using the crate-level `#[feature(foo)]` attribute.
7046       * Managed boxes (@) are now behind a feature gate
7047         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7048         standard library's `Gc` or `Rc` types instead.
7049       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7050       * Jumping back to the top of a loop is now done with `continue` instead of
7051         `loop`.
7052       * Strings can no longer be mutated through index assignment.
7053       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7054         hash delimiters, as in `r###"foo"###`.
7055       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7056         called once.
7057       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7058       * `@fn`s have been removed.
7059       * `do` only works with procs in order to make it obvious what the cost
7060         of `do` is.
7061       * Single-element tuple-like structs can no longer be dereferenced to
7062         obtain the inner value. A more comprehensive solution for overloading
7063         the dereference operator will be provided in the future.
7064       * The `#[link(...)]` attribute has been replaced with
7065         `#[crate_id = "name#vers"]`.
7066       * Empty `impl`s must be terminated with empty braces and may not be
7067         terminated with a semicolon.
7068       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7069         no longer has any special meaning.
7070       * The old `fmt!` string formatting macro has been removed.
7071       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7072         `print!` and `println!`.
7073       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7074       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7075         `extern mod foo = "bar"` instead.
7076       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7077       * Macros can have attributes.
7078       * Macros can expand to items with attributes.
7079       * Macros can expand to multiple items.
7080       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7081       * Comments may be nested.
7082       * Values automatically coerce to trait objects they implement, without
7083         an explicit `as`.
7084       * Enum discriminants are no longer an entire word but as small as needed to
7085         contain all the variants. The `repr` attribute can be used to override
7086         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7087         `#[repr(C)]` to match C enums.
7088       * Non-string literals are not allowed in attributes (they never worked).
7089       * The FFI now supports variadic functions.
7090       * Octal numeric literals, as in `0o7777`.
7091       * The `concat!` syntax extension performs compile-time string concatenation.
7092       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7093         removed as Rust no longer uses segmented stacks.
7094       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7095       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7096         not `*`; ignoring remaining fields of a struct is also done with `..`,
7097         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7098       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7099       * `rustc` supports the "system" calling convention, which defaults to the
7100         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7101         "C" elsewhere.
7102       * The `type_overflow` lint (default: warn) checks literals for overflow.
7103       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7104       * The `attribute_usage` lint (default: warn) warns about unknown
7105         attributes.
7106       * The `unknown_features` lint (default: warn) warns about unknown
7107         feature gates.
7108       * The `dead_code` lint (default: warn) checks for dead code.
7109       * Rust libraries can be linked statically to one another
7110       * `#[link_args]` is behind the `link_args` feature gate.
7111       * Native libraries are now linked with `#[link(name = "foo")]`
7112       * Native libraries can be statically linked to a rust crate
7113         (`#[link(name = "foo", kind = "static")]`).
7114       * Native OS X frameworks are now officially supported
7115         (`#[link(name = "foo", kind = "framework")]`).
7116       * The `#[thread_local]` attribute creates thread-local (not task-local)
7117         variables. Currently behind the `thread_local` feature gate.
7118       * The `return` keyword may be used in closures.
7119       * Types that can be copied via a memcpy implement the `Pod` kind.
7120       * The `cfg` attribute can now be used on struct fields and enum variants.
7121
7122    * Libraries
7123       * std: The `option` and `result` API's have been overhauled to make them
7124         simpler, more consistent, and more composable.
7125       * std: The entire `std::io` module has been replaced with one that is
7126         more comprehensive and that properly interfaces with the underlying
7127         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7128         implemented.
7129       * std: `io::util` contains a number of useful implementations of
7130         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7131         `ZeroReader`, `TeeReader`.
7132       * std: The reference counted pointer type `extra::rc` moved into std.
7133       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7134         just a wrapper around it).
7135       * std: The `Either` type has been removed.
7136       * std: `fmt::Default` can be implemented for any type to provide default
7137         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7138       * std: The `rand` API continues to be tweaked.
7139       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7140         on failure in gdb, is now named `rust_fail`.
7141       * std: The `each_key` and `each_value` methods on `HashMap` have been
7142         replaced by the `keys` and `values` iterators.
7143       * std: Functions dealing with type size and alignment have moved from the
7144         `sys` module to the `mem` module.
7145       * std: The `path` module was written and API changed.
7146       * std: `str::from_utf8` has been changed to cast instead of allocate.
7147       * std: `starts_with` and `ends_with` methods added to vectors via the
7148         `ImmutableEqVector` trait, which is in the prelude.
7149       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7150         if the index is out of bounds.
7151       * std: Task failure no longer propagates between tasks, as the model was
7152         complex, expensive, and incompatible with thread-based tasks.
7153       * std: The `Any` type can be used for dynamic typing.
7154       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7155         `task::try`.
7156       * std: Methods that produce iterators generally do not have an `_iter`
7157         suffix now.
7158       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7159         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7160       * std: `util::ignore` renamed to `prelude::drop`.
7161       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7162         trait.
7163       * std: `vec::raw` has seen a lot of cleanup and API changes.
7164       * std: The standard library no longer includes any C++ code, and very
7165         minimal C, eliminating the dependency on libstdc++.
7166       * std: Runtime scheduling and I/O functionality has been factored out into
7167         extensible interfaces and is now implemented by two different crates:
7168         libnative, for native threading and I/O; and libgreen, for green threading
7169         and I/O. This paves the way for using the standard library in more limited
7170         embedded environments.
7171       * std: The `comm` module has been rewritten to be much faster, have a
7172         simpler, more consistent API, and to work for both native and green
7173         threading.
7174       * std: All libuv dependencies have been moved into the rustuv crate.
7175       * native: New implementations of runtime scheduling on top of OS threads.
7176       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7177         and other I/O.
7178       * green: The green thread scheduler and message passing types are almost
7179         entirely lock-free.
7180       * extra: The `flatpipes` module had bitrotted and was removed.
7181       * extra: All crypto functions have been removed and Rust now has a policy of
7182         not reimplementing crypto in the standard library. In the future crypto
7183         will be provided by external crates with bindings to established libraries.
7184       * extra: `c_vec` has been modernized.
7185       * extra: The `sort` module has been removed. Use the `sort` method on
7186         mutable slices.
7187
7188    * Tooling
7189       * The `rust` and `rusti` commands have been removed, due to lack of
7190         maintenance.
7191       * `rustdoc` was completely rewritten.
7192       * `rustdoc` can test code examples in documentation.
7193       * `rustpkg` can test packages with the argument, 'test'.
7194       * `rustpkg` supports arbitrary dependencies, including C libraries.
7195       * `rustc`'s support for generating debug info is improved again.
7196       * `rustc` has better error reporting for unbalanced delimiters.
7197       * `rustc`'s JIT support was removed due to bitrot.
7198       * Executables and static libraries can be built with LTO (-Z lto)
7199       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7200         build tools.
7201
7202
7203 Version 0.8 (2013-09-26)
7204 ============================
7205
7206    * ~2200 changes, numerous bugfixes
7207
7208    * Language
7209       * The `for` loop syntax has changed to work with the `Iterator` trait.
7210       * At long last, unwinding works on Windows.
7211       * Default methods are ready for use.
7212       * Many trait inheritance bugs fixed.
7213       * Owned and borrowed trait objects work more reliably.
7214       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7215       * rustc can omit emission of code for the `debug!` macro if it is passed
7216         `--cfg ndebug`
7217       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7218         for foo.rs, then foo/mod.rs, and will generate an error when both are
7219         present.
7220       * Strings no longer contain trailing nulls. The new `std::c_str` module
7221         provides new mechanisms for converting to C strings.
7222       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7223       * The FFI has been overhauled such that foreign functions are called directly,
7224         instead of through a stack-switching wrapper.
7225       * Calling a foreign function must be done through a Rust function with the
7226         `#[fixed_stack_segment]` attribute.
7227       * The `externfn!` macro can be used to declare both a foreign function and
7228         a `#[fixed_stack_segment]` wrapper at once.
7229       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7230       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7231       * `priv` is disallowed everywhere except for struct fields and enum variants.
7232       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7233       * `ref` bindings in irrefutable patterns work correctly now.
7234       * `char` is now prevented from containing invalid code points.
7235       * Casting to `bool` is no longer allowed.
7236       * `\0` is now accepted as an escape in chars and strings.
7237       * `yield` is a reserved keyword.
7238       * `typeof` is a reserved keyword.
7239       * Crates may be imported by URL with `extern mod foo = "url";`.
7240       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7241       * Static vectors can be initialized with repeating elements,
7242         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7243       * Static structs can be initialized with functional record update,
7244         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7245       * `cfg!` can be used to conditionally execute code based on the crate
7246         configuration, similarly to `#[cfg(...)]`.
7247       * The `unnecessary_qualification` lint detects unneeded module
7248         prefixes (default: allow).
7249       * Arithmetic operations have been implemented on the SIMD types in
7250         `std::unstable::simd`.
7251       * Exchange allocation headers were removed, reducing memory usage.
7252       * `format!` implements a completely new, extensible, and higher-performance
7253         string formatting system. It will replace `fmt!`.
7254       * `print!` and `println!` write formatted strings (using the `format!`
7255         extension) to stdout.
7256       * `write!` and `writeln!` write formatted strings (using the `format!`
7257         extension) to the new Writers in `std::rt::io`.
7258       * The library section in which a function or static is placed may
7259         be specified with `#[link_section = "..."]`.
7260       * The `proto!` syntax extension for defining bounded message protocols
7261         was removed.
7262       * `macro_rules!` is hygienic for `let` declarations.
7263       * The `#[export_name]` attribute specifies the name of a symbol.
7264       * `unreachable!` can be used to indicate unreachable code, and fails
7265         if executed.
7266
7267    * Libraries
7268       * std: Transitioned to the new runtime, written in Rust.
7269       * std: Added an experimental I/O library, `rt::io`, based on the new
7270         runtime.
7271       * std: A new generic `range` function was added to the prelude, replacing
7272         `uint::range` and friends.
7273       * std: `range_rev` no longer exists. Since range is an iterator it can be
7274         reversed with `range(lo, hi).invert()`.
7275       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7276         renamed to `unwrap_or`.
7277       * std: The `iterator` module was renamed to `iter`.
7278       * std: Integral types now support the `checked_add`, `checked_sub`, and
7279         `checked_mul` operations for detecting overflow.
7280       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7281         consistency.
7282       * std: Methods are standardizing on conventions for casting methods:
7283         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7284         and cheap casts.
7285       * std: The `CString` type in `c_str` provides new ways to convert to and
7286         from C strings.
7287       * std: `DoubleEndedIterator` can yield elements in two directions.
7288       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7289         two splices.
7290       * std: `str::from_bytes` renamed to `str::from_utf8`.
7291       * std: `pop_opt` and `shift_opt` methods added to vectors.
7292       * std: The task-local data interface no longer uses @, and keys are
7293         no longer function pointers.
7294       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7295       * std: Added `SharedPort` to `comm`.
7296       * std: `Eq` has a default method for `ne`; only `eq` is required
7297         in implementations.
7298       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7299         is required in implementations.
7300       * std: `is_utf8` performance is improved, impacting many string functions.
7301       * std: `os::MemoryMap` provides cross-platform mmap.
7302       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7303         are not 'in-bounds' are considered undefined.
7304       * std: Many freestanding functions in `vec` removed in favor of methods.
7305       * std: Many freestanding functions on scalar types removed in favor of
7306         methods.
7307       * std: Many options to task builders were removed since they don't make
7308         sense in the new scheduler design.
7309       * std: More containers implement `FromIterator` so can be created by the
7310         `collect` method.
7311       * std: More complete atomic types in `unstable::atomics`.
7312       * std: `comm::PortSet` removed.
7313       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7314         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7315         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7316         default implementations.
7317       * std: Various `from_str` functions were removed in favor of a generic
7318         `from_str` which is available in the prelude.
7319       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7320       * extra: `dlist`, the doubly-linked list was modernized.
7321       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7322       * extra: Added `glob` module, replacing `std::os::glob`.
7323       * extra: `rope` was removed.
7324       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7325       * extra: `net`, and `timer` were removed. The experimental replacements
7326         are `std::rt::io::net` and `std::rt::io::timer`.
7327       * extra: Iterators implemented for `SmallIntMap`.
7328       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7329       * extra: `SmallIntSet` removed. Use `BitvSet`.
7330       * extra: Performance of JSON parsing greatly improved.
7331       * extra: `semver` updated to SemVer 2.0.0.
7332       * extra: `term` handles more terminals correctly.
7333       * extra: `dbg` module removed.
7334       * extra: `par` module removed.
7335       * extra: `future` was cleaned up, with some method renames.
7336       * extra: Most free functions in `getopts` were converted to methods.
7337
7338    * Other
7339       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7340       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7341         similarly to gcc's `--march` flag.
7342       * rustc's performance compiling small crates is much better.
7343       * rustpkg has received many improvements.
7344       * rustpkg supports git tags as package IDs.
7345       * rustpkg builds into target-specific directories so it can be used for
7346         cross-compiling.
7347       * The number of concurrent test tasks is controlled by the environment
7348         variable RUST_TEST_TASKS.
7349       * The test harness can now report metrics for benchmarks.
7350       * All tools have man pages.
7351       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7352       * The runtime uses jemalloc for allocations.
7353       * Segmented stacks are temporarily disabled as part of the transition to
7354         the new runtime. Stack overflows are possible!
7355       * A new documentation backend, rustdoc_ng, is available for use. It is
7356         still invoked through the normal `rustdoc` command.
7357
7358
7359 Version 0.7 (2013-07-03)
7360 =======================
7361
7362    * ~2000 changes, numerous bugfixes
7363
7364    * Language
7365       * `impl`s no longer accept a visibility qualifier. Put them on methods
7366         instead.
7367       * The borrow checker has been rewritten with flow-sensitivity, fixing
7368         many bugs and inconveniences.
7369       * The `self` parameter no longer implicitly means `&'self self`,
7370         and can be explicitly marked with a lifetime.
7371       * Overloadable compound operators (`+=`, etc.) have been temporarily
7372         removed due to bugs.
7373       * The `for` loop protocol now requires `for`-iterators to return `bool`
7374         so they compose better.
7375       * The `Durable` trait is replaced with the `'static` bounds.
7376       * Trait default methods work more often.
7377       * Structs with the `#[packed]` attribute have byte alignment and
7378         no padding between fields.
7379       * Type parameters bound by `Copy` must now be copied explicitly with
7380         the `copy` keyword.
7381       * It is now illegal to move out of a dereferenced unsafe pointer.
7382       * `Option<~T>` is now represented as a nullable pointer.
7383       * `@mut` does dynamic borrow checks correctly.
7384       * The `main` function is only detected at the topmost level of the crate.
7385         The `#[main]` attribute is still valid anywhere.
7386       * Struct fields may no longer be mutable. Use inherited mutability.
7387       * The `#[no_send]` attribute makes a type that would otherwise be
7388         `Send`, not.
7389       * The `#[no_freeze]` attribute makes a type that would otherwise be
7390         `Freeze`, not.
7391       * Unbounded recursion will abort the process after reaching the limit
7392         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7393       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7394         are never implicitly copyable.
7395       * `#[static_assert]` makes compile-time assertions about static bools.
7396       * At long last, 'argument modes' no longer exist.
7397       * The rarely used `use mod` statement no longer exists.
7398
7399    * Syntax extensions
7400       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7401         argument list.
7402       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7403         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7404         `#[deriving(...)]`.
7405       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7406         and unsuffixed integer literals.
7407
7408    * Libraries
7409       * The `core` crate was renamed to `std`.
7410       * The `std` crate was renamed to `extra`.
7411       * More and improved documentation.
7412       * std: `iterator` module for external iterator objects.
7413       * Many old-style (internal, higher-order function) iterators replaced by
7414         implementations of `Iterator`.
7415       * std: Many old internal vector and string iterators,
7416         incl. `any`, `all`. removed.
7417       * std: The `finalize` method of `Drop` renamed to `drop`.
7418       * std: The `drop` method now takes `&mut self` instead of `&self`.
7419       * std: The prelude no longer re-exports any modules, only types and traits.
7420       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7421         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7422       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7423         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7424       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7425         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7426       * std: Many types implement `Clone`.
7427       * std: `path` type renamed to `Path`.
7428       * std: `mut` module and `Mut` type removed.
7429       * std: Many standalone functions removed in favor of methods and iterators
7430         in `vec`, `str`. In the future methods will also work as functions.
7431       * std: `reinterpret_cast` removed. Use `transmute`.
7432       * std: ascii string handling in `std::ascii`.
7433       * std: `Rand` is implemented for ~/@.
7434       * std: `run` module for spawning processes overhauled.
7435       * std: Various atomic types added to `unstable::atomic`.
7436       * std: Various types implement `Zero`.
7437       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7438       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7439       * std: Added `os::mkdir_recursive`.
7440       * std: Added `os::glob` function performs filesystems globs.
7441       * std: `FuzzyEq` renamed to `ApproxEq`.
7442       * std: `Map` now defines `pop` and `swap` methods.
7443       * std: `Cell` constructors converted to static methods.
7444       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7445       * extra: `flate` module moved from `std` to `extra`.
7446       * extra: `fileinput` module for iterating over a series of files.
7447       * extra: `Complex` number type and `complex` module.
7448       * extra: `Rational` number type and `rational` module.
7449       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7450       * extra: `term` uses terminfo now, is more correct.
7451       * extra: `arc` functions converted to methods.
7452       * extra: Implementation of fixed output size variations of SHA-2.
7453
7454    * Tooling
7455       * `unused_variable`  lint mode for unused variables (default: warn).
7456       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7457         (default: warn).
7458       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7459         (default: warn).
7460       * `dead_assignment` lint mode for unread variables (default: warn).
7461       * `unnecessary_allocation` lint mode detects some heap allocations that are
7462         immediately borrowed so could be written without allocating (default: warn).
7463       * `missing_doc` lint mode (default: allow).
7464       * `unreachable_code` lint mode (default: warn).
7465       * The `rusti` command has been rewritten and a number of bugs addressed.
7466       * rustc outputs in color on more terminals.
7467       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7468       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7469       * Compiling with `-g` will make the binary record information about
7470         dynamic borrowcheck failures for debugging.
7471       * rustdoc has a nicer stylesheet.
7472       * Various improvements to rustdoc.
7473       * Improvements to rustpkg (see the detailed release notes).
7474
7475
7476 Version 0.6 (2013-04-03)
7477 ========================
7478
7479    * ~2100 changes, numerous bugfixes
7480
7481    * Syntax changes
7482       * The self type parameter in traits is now spelled `Self`
7483       * The `self` parameter in trait and impl methods must now be explicitly
7484         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7485       * Static methods no longer require the `static` keyword and instead
7486         are distinguished by the lack of a `self` parameter
7487       * Replaced the `Durable` trait with the `'static` lifetime
7488       * The old closure type syntax with the trailing sigil has been
7489         removed in favor of the more consistent leading sigil
7490       * `super` is a keyword, and may be prefixed to paths
7491       * Trait bounds are separated with `+` instead of whitespace
7492       * Traits are implemented with `impl Trait for Type`
7493         instead of `impl Type: Trait`
7494       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7495       * The `export` keyword has finally been removed
7496       * The `move` keyword has been removed (see "Semantic changes")
7497       * The interior mutability qualifier on vectors, `[mut T]`, has been
7498         removed. Use `&mut [T]`, etc.
7499       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7500       * `fail` is no longer a keyword. Use `fail!()`
7501       * `assert` is no longer a keyword. Use `assert!()`
7502       * `log` is no longer a keyword. use `debug!`, etc.
7503       * 1-tuples may be represented as `(T,)`
7504       * Struct fields may no longer be `mut`. Use inherited mutability,
7505         `@mut T`, `core::mut` or `core::cell`
7506       * `extern mod { ... }` is no longer valid syntax for foreign
7507         function modules. Use extern blocks: `extern { ... }`
7508       * Newtype enums removed. Use tuple-structs.
7509       * Trait implementations no longer support visibility modifiers
7510       * Pattern matching over vectors improved and expanded
7511       * `const` renamed to `static` to correspond to lifetime name,
7512         and make room for future `static mut` unsafe mutable globals.
7513       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7514       * `Clone` implementations can be automatically generated with
7515         `#[deriving(Clone)]`
7516       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7517         instead of `foo as Bar`.
7518       * Fixed length vector types are now written as `[int, .. 3]`
7519         instead of `[int * 3]`.
7520       * Fixed length vector types can express the length as a constant
7521         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7522
7523    * Semantic changes
7524       * Types with owned pointers or custom destructors move by default,
7525         eliminating the `move` keyword
7526       * All foreign functions are considered unsafe
7527       * &mut is now unaliasable
7528       * Writes to borrowed @mut pointers are prevented dynamically
7529       * () has size 0
7530       * The name of the main function can be customized using #[main]
7531       * The default type of an inferred closure is &fn instead of @fn
7532       * `use` statements may no longer be "chained" - they cannot import
7533         identifiers imported by previous `use` statements
7534       * `use` statements are crate relative, importing from the "top"
7535         of the crate by default. Paths may be prefixed with `super::`
7536         or `self::` to change the search behavior.
7537       * Method visibility is inherited from the implementation declaration
7538       * Structural records have been removed
7539       * Many more types can be used in static items, including enums
7540         'static-lifetime pointers and vectors
7541       * Pattern matching over vectors improved and expanded
7542       * Typechecking of closure types has been overhauled to
7543         improve inference and eliminate unsoundness
7544       * Macros leave scope at the end of modules, unless that module is
7545         tagged with #[macro_escape]
7546
7547    * Libraries
7548       * Added big integers to `std::bigint`
7549       * Removed `core::oldcomm` module
7550       * Added pipe-based `core::comm` module
7551       * Numeric traits have been reorganized under `core::num`
7552       * `vec::slice` finally returns a slice
7553       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7554       * Containers reorganized around traits in `core::container`
7555       * `core::dvec` removed, `~[T]` is a drop-in replacement
7556       * `core::send_map` renamed to `core::hashmap`
7557       * `std::map` removed; replaced with `core::hashmap`
7558       * `std::treemap` reimplemented as an owned balanced tree
7559       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7560       * `core::trie` added as a fast ordered map for integer keys
7561       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7562       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7563         overload the comparison operators, whereas `TotalOrd` is used
7564         by certain container types
7565
7566    * Other
7567       * Replaced the 'cargo' package manager with 'rustpkg'
7568       * Added all-purpose 'rust' tool
7569       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7570       * rustc now *attempts* to offer spelling suggestions
7571       * Improved support for ARM and Android
7572       * Preliminary MIPS backend
7573       * Improved foreign function ABI implementation for x86, x86_64
7574       * Various memory usage improvements
7575       * Rust code may be embedded in foreign code under limited circumstances
7576       * Inline assembler supported by new asm!() syntax extension.
7577
7578
7579 Version 0.5 (2012-12-21)
7580 ===========================
7581
7582    * ~900 changes, numerous bugfixes
7583
7584    * Syntax changes
7585       * Removed `<-` move operator
7586       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7587       * Removed old fixed length vector syntax - `[T]/N`
7588       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7589       * Macros may now expand to items and statements
7590       * `a.b()` is always parsed as a method call, never as a field projection
7591       * `Eq` and `IterBytes` implementations can be automatically generated
7592         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7593       * Removed the special crate language for `.rc` files
7594       * Function arguments may consist of any irrefutable pattern
7595
7596    * Semantic changes
7597       * `&` and `~` pointers may point to objects
7598       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7599       * Enum variants may be structs
7600       * Destructors can be added to all nominal types with the Drop trait
7601       * Structs and nullary enum variants may be constants
7602       * Values that cannot be implicitly copied are now automatically moved
7603         without writing `move` explicitly
7604       * `&T` may now be coerced to `*T`
7605       * Coercions happen in `let` statements as well as function calls
7606       * `use` statements now take crate-relative paths
7607       * The module and type namespaces have been merged so that static
7608         method names can be resolved under the trait in which they are
7609         declared
7610
7611    * Improved support for language features
7612       * Trait inheritance works in many scenarios
7613       * More support for explicit self arguments in methods - `self`, `&self`
7614         `@self`, and `~self` all generally work as expected
7615       * Static methods work in more situations
7616       * Experimental: Traits may declare default methods for the implementations
7617         to use
7618
7619    * Libraries
7620       * New condition handling system in `core::condition`
7621       * Timsort added to `std::sort`
7622       * New priority queue, `std::priority_queue`
7623       * Pipes for serializable types, `std::flatpipes'
7624       * Serialization overhauled to be trait-based
7625       * Expanded `getopts` definitions
7626       * Moved futures to `std`
7627       * More functions are pure now
7628       * `core::comm` renamed to `oldcomm`. Still deprecated
7629       * `rustdoc` and `cargo` are libraries now
7630
7631    * Misc
7632       * Added a preliminary REPL, `rusti`
7633       * License changed from MIT to dual MIT/APL2
7634
7635
7636 Version 0.4 (2012-10-15)
7637 ==========================
7638
7639    * ~2000 changes, numerous bugfixes
7640
7641    * Syntax
7642       * All keywords are now strict and may not be used as identifiers anywhere
7643       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7644         'of', 'with', 'to', 'class'.
7645       * Classes are replaced with simpler structs
7646       * Explicit method self types
7647       * `ret` became `return` and `alt` became `match`
7648       * `import` is now `use`; `use is now `extern mod`
7649       * `extern mod { ... }` is now `extern { ... }`
7650       * `use mod` is the recommended way to import modules
7651       * `pub` and `priv` replace deprecated export lists
7652       * The syntax of `match` pattern arms now uses fat arrow (=>)
7653       * `main` no longer accepts an args vector; use `os::args` instead
7654
7655    * Semantics
7656       * Trait implementations are now coherent, ala Haskell typeclasses
7657       * Trait methods may be static
7658       * Argument modes are deprecated
7659       * Borrowed pointers are much more mature and recommended for use
7660       * Strings and vectors in the static region are stored in constant memory
7661       * Typestate was removed
7662       * Resolution rewritten to be more reliable
7663       * Support for 'dual-mode' data structures (freezing and thawing)
7664
7665    * Libraries
7666       * Most binary operators can now be overloaded via the traits in
7667         `core::ops'
7668       * `std::net::url` for representing URLs
7669       * Sendable hash maps in `core::send_map`
7670       * `core::task' gained a (currently unsafe) task-local storage API
7671
7672    * Concurrency
7673       * An efficient new intertask communication primitive called the pipe,
7674         along with a number of higher-level channel types, in `core::pipes`
7675       * `std::arc`, an atomically reference counted, immutable, shared memory
7676         type
7677       * `std::sync`, various exotic synchronization tools based on arcs and pipes
7678       * Futures are now based on pipes and sendable
7679       * More robust linked task failure
7680       * Improved task builder API
7681
7682    * Other
7683       * Improved error reporting
7684       * Preliminary JIT support
7685       * Preliminary work on precise GC
7686       * Extensive architectural improvements to rustc
7687       * Begun a transition away from buggy C++-based reflection (shape) code to
7688         Rust-based (visitor) code
7689       * All hash functions and tables converted to secure, randomized SipHash
7690
7691
7692 Version 0.3  (2012-07-12)
7693 ========================
7694
7695    * ~1900 changes, numerous bugfixes
7696
7697    * New coding conveniences
7698       * Integer-literal suffix inference
7699       * Per-item control over warnings, errors
7700       * #[cfg(windows)] and #[cfg(unix)] attributes
7701       * Documentation comments
7702       * More compact closure syntax
7703       * 'do' expressions for treating higher-order functions as
7704         control structures
7705       * *-patterns (wildcard extended to all constructor fields)
7706
7707    * Semantic cleanup
7708       * Name resolution pass and exhaustiveness checker rewritten
7709       * Region pointers and borrow checking supersede alias
7710         analysis
7711       * Init-ness checking is now provided by a region-based liveness
7712         pass instead of the typestate pass; same for last-use analysis
7713       * Extensive work on region pointers
7714
7715    * Experimental new language features
7716       * Slices and fixed-size, interior-allocated vectors
7717       * #!-comments for lang versioning, shell execution
7718       * Destructors and iface implementation for classes;
7719         type-parameterized classes and class methods
7720       * 'const' type kind for types that can be used to implement
7721         shared-memory concurrency patterns
7722
7723    * Type reflection
7724
7725    * Removal of various obsolete features
7726       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
7727                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
7728
7729       * Constructs: do-while loops ('do' repurposed), fn binding,
7730                     resources (replaced by destructors)
7731
7732    * Compiler reorganization
7733       * Syntax-layer of compiler split into separate crate
7734       * Clang (from LLVM project) integrated into build
7735       * Typechecker split into sub-modules
7736
7737    * New library code
7738       * New time functions
7739       * Extension methods for many built-in types
7740       * Arc: atomic-refcount read-only / exclusive-use shared cells
7741       * Par: parallel map and search routines
7742       * Extensive work on libuv interface
7743       * Much vector code moved to libraries
7744       * Syntax extensions: #line, #col, #file, #mod, #stringify,
7745         #include, #include_str, #include_bin
7746
7747    * Tool improvements
7748       * Cargo automatically resolves dependencies
7749
7750
7751 Version 0.2  (2012-03-29)
7752 =========================
7753
7754    * >1500 changes, numerous bugfixes
7755
7756    * New docs and doc tooling
7757
7758    * New port: FreeBSD x86_64
7759
7760    * Compilation model enhancements
7761       * Generics now specialized, multiply instantiated
7762       * Functions now inlined across separate crates
7763
7764    * Scheduling, stack and threading fixes
7765       * Noticeably improved message-passing performance
7766       * Explicit schedulers
7767       * Callbacks from C
7768       * Helgrind clean
7769
7770    * Experimental new language features
7771       * Operator overloading
7772       * Region pointers
7773       * Classes
7774
7775    * Various language extensions
7776       * C-callback function types: 'crust fn ...'
7777       * Infinite-loop construct: 'loop { ... }'
7778       * Shorten 'mutable' to 'mut'
7779       * Required mutable-local qualifier: 'let mut ...'
7780       * Basic glob-exporting: 'export foo::*;'
7781       * Alt now exhaustive, 'alt check' for runtime-checked
7782       * Block-function form of 'for' loop, with 'break' and 'ret'.
7783
7784    * New library code
7785       * AST quasi-quote syntax extension
7786       * Revived libuv interface
7787       * New modules: core::{future, iter}, std::arena
7788       * Merged per-platform std::{os*, fs*} to core::{libc, os}
7789       * Extensive cleanup, regularization in libstd, libcore
7790
7791
7792 Version 0.1  (2012-01-20)
7793 ===============================
7794
7795    * Most language features work, including:
7796       * Unique pointers, unique closures, move semantics
7797       * Interface-constrained generics
7798       * Static interface dispatch
7799       * Stack growth
7800       * Multithread task scheduling
7801       * Typestate predicates
7802       * Failure unwinding, destructors
7803       * Pattern matching and destructuring assignment
7804       * Lightweight block-lambda syntax
7805       * Preliminary macro-by-example
7806
7807    * Compiler works with the following configurations:
7808       * Linux: x86 and x86_64 hosts and targets
7809       * macOS: x86 and x86_64 hosts and targets
7810       * Windows: x86 hosts and targets
7811
7812    * Cross compilation / multi-target configuration supported.
7813
7814    * Preliminary API-documentation and package-management tools included.
7815
7816 Known issues:
7817
7818    * Documentation is incomplete.
7819
7820    * Performance is below intended target.
7821
7822    * Standard library APIs are subject to extensive change, reorganization.
7823
7824    * Language-level versioning is not yet operational - future code will
7825      break unexpectedly.