RELEASES.md

   1 Version 1.37.0 (2019-08-15)
   2 ==========================
   3
   4 Language
   5 --------
   6 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
   7   [`Box`][62228], or an [array][62235] and unused.
   8 - [You can now use the `cfg` and `cfg_attr` attributes on
   9   generic parameters.][61547]
  10 - [You can now use enum variants through type alias.][61682] e.g. You can
  11   write the following:
  12   ```rust
  13   type MyOption = Option<u8>;
  14
  15   fn increment_or_zero(x: MyOption) -> u8 {
  16       match x {
  17           MyOption::Some(y) => y + 1,
  18           MyOption::None => 0,
  19       }
  20   }
  21   ```
  22 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
  23   `const _: u32 = 5;`.
  24 - [You can now use `#[repr(align(X)]` on enums.][61229]
  25 - [The  `?` Kleene macro operator is now available in the
  26   2015 edition.][60932]
  27
  28 Compiler
  29 --------
  30 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
  31   and `-C profile-use` flags.][61268] For more information on how to use profile
  32   guided optimization, please refer to the [rustc book][rustc-book-pgo].
  33 - [The `rust-lldb` wrapper script should now work again.][61827]
  34
  35 Libraries
  36 ---------
  37 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
  38
  39 Stabilized APIs
  40 ---------------
  41 - [`BufReader::buffer`]
  42 - [`BufWriter::buffer`]
  43 - [`Cell::from_mut`]
  44 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
  45 - [`DoubleEndedIterator::nth_back`]
  46 - [`Option::xor`]
  47 - [`Wrapping::reverse_bits`]
  48 - [`i128::reverse_bits`]
  49 - [`i16::reverse_bits`]
  50 - [`i32::reverse_bits`]
  51 - [`i64::reverse_bits`]
  52 - [`i8::reverse_bits`]
  53 - [`isize::reverse_bits`]
  54 - [`slice::copy_within`]
  55 - [`u128::reverse_bits`]
  56 - [`u16::reverse_bits`]
  57 - [`u32::reverse_bits`]
  58 - [`u64::reverse_bits`]
  59 - [`u8::reverse_bits`]
  60 - [`usize::reverse_bits`]
  61
  62 Cargo
  63 -----
  64 - [`Cargo.lock` files are now included by default when publishing executable crates
  65   with executables.][cargo/7026]
  66 - [You can now specify `default-run="foo"` in `[package]` to specify the
  67   default executable to use for `cargo run`.][cargo/7056]
  68
  69 Misc
  70 ----
  71
  72 Compatibility Notes
  73 -------------------
  74 - [Using `...` for inclusive range patterns will now warn by default.][61342]
  75   Please transition your code to using the `..=` syntax for inclusive
  76   ranges instead.
  77 - [Using a trait object without the `dyn` will now warn by default.][61203]
  78   Please transition your code to use `dyn Trait` for trait objects instead.
  79
  80 [62228]: https://github.com/rust-lang/rust/pull/62228/
  81 [62235]: https://github.com/rust-lang/rust/pull/62235/
  82 [61802]: https://github.com/rust-lang/rust/pull/61802/
  83 [61827]: https://github.com/rust-lang/rust/pull/61827/
  84 [61547]: https://github.com/rust-lang/rust/pull/61547/
  85 [61682]: https://github.com/rust-lang/rust/pull/61682/
  86 [61268]: https://github.com/rust-lang/rust/pull/61268/
  87 [61342]: https://github.com/rust-lang/rust/pull/61342/
  88 [61347]: https://github.com/rust-lang/rust/pull/61347/
  89 [61100]: https://github.com/rust-lang/rust/pull/61100/
  90 [61203]: https://github.com/rust-lang/rust/pull/61203/
  91 [61229]: https://github.com/rust-lang/rust/pull/61229/
  92 [60932]: https://github.com/rust-lang/rust/pull/60932/
  93 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
  94 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
  95 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
  96 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
  97 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
  98 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
  99 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
 100 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
 101 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
 102 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
 103 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
 104 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
 105 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
 106 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
 107 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
 108 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
 109 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
 110 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
 111 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
 112 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
 113 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
 114 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
 115 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
 116 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
 117
 118
 119 Version 1.36.0 (2019-07-04)
 120 ==========================
 121
 122 Language
 123 --------
 124 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
 125 - [The order of traits in trait objects no longer affects the semantics of that
 126   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
 127   `dyn fmt::Debug + Send`, where this was previously not the case.
 128
 129 Libraries
 130 ---------
 131 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
 132 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
 133 - [`mem::needs_drop` is now available as a const fn.][60364]
 134 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
 135 - [`String` now implements `BorrowMut<str>`.][60404]
 136 - [`io::Cursor` now implements `Default`.][60234]
 137 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
 138 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
 139   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
 140   environment has access to heap memory allocation.
 141 - [`String` now implements `From<&String>`.][59825]
 142 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
 143   return a tuple of each argument when there is multiple arguments.
 144 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
 145   not used.][59648]
 146
 147 Stabilized APIs
 148 ---------------
 149 - [`VecDeque::rotate_left`]
 150 - [`VecDeque::rotate_right`]
 151 - [`Iterator::copied`]
 152 - [`io::IoSlice`]
 153 - [`io::IoSliceMut`]
 154 - [`Read::read_vectored`]
 155 - [`Write::write_vectored`]
 156 - [`str::as_mut_ptr`]
 157 - [`mem::MaybeUninit`]
 158 - [`pointer::align_offset`]
 159 - [`future::Future`]
 160 - [`task::Context`]
 161 - [`task::RawWaker`]
 162 - [`task::RawWakerVTable`]
 163 - [`task::Waker`]
 164 - [`task::Poll`]
 165
 166 Cargo
 167 -----
 168 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
 169 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
 170
 171 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
 172
 173 Clippy
 174 ------
 175 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
 176
 177 Misc
 178 ----
 179
 180 Compatibility Notes
 181 -------------------
 182 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
 183   longer recommended, and will be deprecated in 1.39.0.
 184
 185 [60318]: https://github.com/rust-lang/rust/pull/60318/
 186 [60364]: https://github.com/rust-lang/rust/pull/60364/
 187 [60370]: https://github.com/rust-lang/rust/pull/60370/
 188 [60404]: https://github.com/rust-lang/rust/pull/60404/
 189 [60234]: https://github.com/rust-lang/rust/pull/60234/
 190 [60244]: https://github.com/rust-lang/rust/pull/60244/
 191 [58623]: https://github.com/rust-lang/rust/pull/58623/
 192 [59648]: https://github.com/rust-lang/rust/pull/59648/
 193 [59675]: https://github.com/rust-lang/rust/pull/59675/
 194 [59825]: https://github.com/rust-lang/rust/pull/59825/
 195 [59826]: https://github.com/rust-lang/rust/pull/59826/
 196 [59445]: https://github.com/rust-lang/rust/pull/59445/
 197 [59114]: https://github.com/rust-lang/rust/pull/59114/
 198 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
 199 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
 200 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
 201 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
 202 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
 203 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
 204 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
 205 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
 206 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
 207 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
 208 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
 209 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
 210 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
 211 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
 212 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
 213 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
 214 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
 215 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
 216 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
 217 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
 218
 219
 220 Version 1.35.0 (2019-05-23)
 221 ==========================
 222
 223 Language
 224 --------
 225 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
 226   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
 227 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
 228   ```rust
 229   unsafe fn call_unsafe(func: unsafe fn()) {
 230       func()
 231   }
 232
 233   pub fn main() {
 234       unsafe { call_unsafe(|| {}); }
 235   }
 236   ```
 237
 238
 239 Compiler
 240 --------
 241 - [Added the `armv6-unknown-freebsd-gnueabihf` and
 242   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
 243 - [Added the `wasm32-unknown-wasi` target.][59464]
 244
 245
 246 Libraries
 247 ---------
 248 - [`Thread` will now show its ID in `Debug` output.][59460]
 249 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
 250 - [`alloc::System` now implements `Default`.][59451]
 251 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
 252   last field.][59076]
 253 - [`char::{ToLowercase, ToUppercase}` now
 254   implement `ExactSizeIterator`.][58778]
 255 - [All `NonZero` numeric types now implement `FromStr`.][58717]
 256 - [Removed the `Read` trait bounds
 257   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
 258 - [You can now call the `dbg!` macro without any parameters to print the file
 259   and line where it is called.][57847]
 260 - [In place ASCII case conversions are now up to 4× faster.][59283]
 261   e.g. `str::make_ascii_lowercase`
 262 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
 263   and `Send`.][58369]
 264
 265 Stabilized APIs
 266 ---------------
 267 - [`f32::copysign`]
 268 - [`f64::copysign`]
 269 - [`RefCell::replace_with`]
 270 - [`RefCell::map_split`]
 271 - [`ptr::hash`]
 272 - [`Range::contains`]
 273 - [`RangeFrom::contains`]
 274 - [`RangeTo::contains`]
 275 - [`RangeInclusive::contains`]
 276 - [`RangeToInclusive::contains`]
 277 - [`Option::copied`]
 278
 279 Cargo
 280 -----
 281 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
 282   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
 283   platform specific.
 284
 285 Misc
 286 ----
 287 - [The Rust toolchain is now available natively for musl based distros.][58575]
 288
 289 [59460]: https://github.com/rust-lang/rust/pull/59460/
 290 [59464]: https://github.com/rust-lang/rust/pull/59464/
 291 [59500]: https://github.com/rust-lang/rust/pull/59500/
 292 [59512]: https://github.com/rust-lang/rust/pull/59512/
 293 [59580]: https://github.com/rust-lang/rust/pull/59580/
 294 [59283]: https://github.com/rust-lang/rust/pull/59283/
 295 [59451]: https://github.com/rust-lang/rust/pull/59451/
 296 [59076]: https://github.com/rust-lang/rust/pull/59076/
 297 [58778]: https://github.com/rust-lang/rust/pull/58778/
 298 [58717]: https://github.com/rust-lang/rust/pull/58717/
 299 [58369]: https://github.com/rust-lang/rust/pull/58369/
 300 [58423]: https://github.com/rust-lang/rust/pull/58423/
 301 [58080]: https://github.com/rust-lang/rust/pull/58080/
 302 [57847]: https://github.com/rust-lang/rust/pull/57847/
 303 [58575]: https://github.com/rust-lang/rust/pull/58575
 304 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
 305 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
 306 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
 307 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
 308 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
 309 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
 310 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
 311 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
 312 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
 313 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
 314 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
 315 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
 316
 317 Version 1.34.2 (2019-05-14)
 318 ===========================
 319
 320 * [Destabilize the `Error::type_id` function due to a security
 321    vulnerability][60785] ([CVE-2019-12083])
 322
 323 [60785]: https://github.com/rust-lang/rust/pull/60785
 324 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
 325
 326 Version 1.34.1 (2019-04-25)
 327 ===========================
 328
 329 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
 330 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
 331 * [Fix Clippy panic when checking some macros][clippy/3805]
 332
 333 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
 334 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
 335 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
 336
 337 Version 1.34.0 (2019-04-11)
 338 ==========================
 339
 340 Language
 341 --------
 342 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
 343   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
 344   but had no effect.
 345 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
 346   `#[attr{}]` procedural macros.][57367]
 347 - [You can now write `extern crate self as foo;`][57407] to import your
 348   crate's root into the extern prelude.
 349
 350
 351 Compiler
 352 --------
 353 - [You can now target `riscv64imac-unknown-none-elf` and
 354   `riscv64gc-unknown-none-elf`.][58406]
 355 - [You can now enable linker plugin LTO optimisations with
 356   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
 357   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
 358   boundaries.
 359 - [You can now target `powerpc64-unknown-freebsd`.][57809]
 360
 361
 362 Libraries
 363 ---------
 364 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
 365   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
 366   the `Hash` trait to create an iterator.
 367 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
 368   methods.][58421] Most notably you no longer require the `Ord` trait to create
 369   an iterator.
 370 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
 371   for all numeric types.][58044]
 372 - [Indexing a `str` is now generic over all types that
 373   implement `SliceIndex<str>`.][57604]
 374 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
 375   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
 376   produce a warning if their returning type is unused.
 377 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
 378   `overflowing_pow` are now available for all numeric types.][57873] These are
 379   equivalent to methods such as `wrapping_add` for the `pow` operation.
 380
 381
 382 Stabilized APIs
 383 ---------------
 384
 385 #### std & core
 386 * [`Any::type_id`]
 387 * [`Error::type_id`]
 388 * [`atomic::AtomicI16`]
 389 * [`atomic::AtomicI32`]
 390 * [`atomic::AtomicI64`]
 391 * [`atomic::AtomicI8`]
 392 * [`atomic::AtomicU16`]
 393 * [`atomic::AtomicU32`]
 394 * [`atomic::AtomicU64`]
 395 * [`atomic::AtomicU8`]
 396 * [`convert::Infallible`]
 397 * [`convert::TryFrom`]
 398 * [`convert::TryInto`]
 399 * [`iter::from_fn`]
 400 * [`iter::successors`]
 401 * [`num::NonZeroI128`]
 402 * [`num::NonZeroI16`]
 403 * [`num::NonZeroI32`]
 404 * [`num::NonZeroI64`]
 405 * [`num::NonZeroI8`]
 406 * [`num::NonZeroIsize`]
 407 * [`slice::sort_by_cached_key`]
 408 * [`str::escape_debug`]
 409 * [`str::escape_default`]
 410 * [`str::escape_unicode`]
 411 * [`str::split_ascii_whitespace`]
 412
 413 #### std
 414 * [`Instant::checked_add`]
 415 * [`Instant::checked_sub`]
 416 * [`SystemTime::checked_add`]
 417 * [`SystemTime::checked_sub`]
 418
 419 Cargo
 420 -----
 421 - [You can now use alternative registries to crates.io.][cargo/6654]
 422
 423 Misc
 424 ----
 425 - [You can now use the `?` operator in your documentation tests without manually
 426   adding `fn main() -> Result<(), _> {}`.][56470]
 427
 428 Compatibility Notes
 429 -------------------
 430 - [`Command::before_exec` is being replaced by the unsafe method
 431   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
 432 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
 433   can now use `const` functions in `static` variables.
 434
 435 [58370]: https://github.com/rust-lang/rust/pull/58370/
 436 [58406]: https://github.com/rust-lang/rust/pull/58406/
 437 [58421]: https://github.com/rust-lang/rust/pull/58421/
 438 [58166]: https://github.com/rust-lang/rust/pull/58166/
 439 [58044]: https://github.com/rust-lang/rust/pull/58044/
 440 [58057]: https://github.com/rust-lang/rust/pull/58057/
 441 [58059]: https://github.com/rust-lang/rust/pull/58059/
 442 [57809]: https://github.com/rust-lang/rust/pull/57809/
 443 [57873]: https://github.com/rust-lang/rust/pull/57873/
 444 [57604]: https://github.com/rust-lang/rust/pull/57604/
 445 [57367]: https://github.com/rust-lang/rust/pull/57367/
 446 [57407]: https://github.com/rust-lang/rust/pull/57407/
 447 [57425]: https://github.com/rust-lang/rust/pull/57425/
 448 [57106]: https://github.com/rust-lang/rust/pull/57106/
 449 [56470]: https://github.com/rust-lang/rust/pull/56470/
 450 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
 451 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
 452 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
 453 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
 454 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
 455 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
 456 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
 457 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
 458 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
 459 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
 460 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
 461 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
 462 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
 463 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
 464 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
 465 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
 466 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
 467 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
 468 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
 469 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
 470 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
 471 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
 472 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
 473 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
 474 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
 475 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
 476 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
 477 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
 478 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
 479 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
 480 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
 481
 482
 483 Version 1.33.0 (2019-02-28)
 484 ==========================
 485
 486 Language
 487 --------
 488 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
 489   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
 490 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
 491   E.g. You can have match statement on a `u8` that covers `0..=255` and
 492   you would no longer be required to have a `_ => unreachable!()` case.
 493 - [You can now have multiple patterns in `if let` and `while let`
 494   expressions.][57532] You can do this with the same syntax as a `match`
 495   expression. E.g.
 496   ```rust
 497   enum Creature {
 498       Crab(String),
 499       Lobster(String),
 500       Person(String),
 501   }
 502
 503   fn main() {
 504       let state = Creature::Crab("Ferris");
 505
 506       if let Creature::Crab(name) | Creature::Person(name) = state {
 507           println!("This creature's name is: {}", name);
 508       }
 509   }
 510   ```
 511 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
 512   this feature will by default produce a warning as this behaviour can be
 513   unintuitive. E.g. `if let _ = 5 {}`
 514 - [You can now use `let` bindings, assignments, expression statements,
 515   and irrefutable pattern destructuring in const functions.][57175]
 516 - [You can now call unsafe const functions.][57067] E.g.
 517   ```rust
 518   const unsafe fn foo() -> i32 { 5 }
 519   const fn bar() -> i32 {
 520       unsafe { foo() }
 521   }
 522   ```
 523 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
 524   E.g. `#[cfg_attr(all(), must_use, optimize)]`
 525 - [You can now specify a specific alignment with the `#[repr(packed)]`
 526   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
 527   with an alignment of 2 bytes and a size of 6 bytes.
 528 - [You can now import an item from a module as an `_`.][56303] This allows you to
 529   import a trait's impls, and not have the name in the namespace. E.g.
 530   ```rust
 531   use std::io::Read as _;
 532
 533   // Allowed as there is only one `Read` in the module.
 534   pub trait Read {}
 535   ```
 536 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
 537
 538 Compiler
 539 --------
 540 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
 541   command line argument.][56351]
 542 - [The minimum required LLVM version has been bumped to 6.0.][56642]
 543 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
 544 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
 545   tier 2 support.][57130] Visit the [platform support][platform-support] page for
 546   information on Rust's platform support.
 547 - [Added support for the `thumbv7neon-linux-androideabi` and
 548   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
 549 - [Added support for the `x86_64-unknown-uefi` target.][56769]
 550
 551 Libraries
 552 ---------
 553 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
 554   functions for all numeric types.][57566]
 555 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
 556   are now `const` functions for all numeric types.][57105]
 557 - [The methods `is_positive` and `is_negative` are now `const` functions for
 558   all signed numeric types.][57105]
 559 - [The `get` method for all `NonZero` types is now `const`.][57167]
 560 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
 561   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
 562   numeric types.][57234]
 563 - [`Ipv4Addr::new` is now a `const` function][57234]
 564
 565 Stabilized APIs
 566 ---------------
 567 - [`unix::FileExt::read_exact_at`]
 568 - [`unix::FileExt::write_all_at`]
 569 - [`Option::transpose`]
 570 - [`Result::transpose`]
 571 - [`convert::identity`]
 572 - [`pin::Pin`]
 573 - [`marker::Unpin`]
 574 - [`marker::PhantomPinned`]
 575 - [`Vec::resize_with`]
 576 - [`VecDeque::resize_with`]
 577 - [`Duration::as_millis`]
 578 - [`Duration::as_micros`]
 579 - [`Duration::as_nanos`]
 580
 581
 582 Cargo
 583 -----
 584 - [You can now publish crates that require a feature flag to compile with
 585   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
 586 - [Cargo should now rebuild a crate if a file was modified during the initial
 587   build.][cargo/6484]
 588
 589 Compatibility Notes
 590 -------------------
 591 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
 592   are now deprecated in the standard library, and their usage will now produce a warning.
 593   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
 594   methods instead.
 595 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
 596   downcasting.
 597 - [Libtest no longer creates a new thread for each test when
 598   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
 599
 600 [55982]: https://github.com/rust-lang/rust/pull/55982/
 601 [56243]: https://github.com/rust-lang/rust/pull/56243
 602 [56303]: https://github.com/rust-lang/rust/pull/56303/
 603 [56351]: https://github.com/rust-lang/rust/pull/56351/
 604 [56362]: https://github.com/rust-lang/rust/pull/56362
 605 [56642]: https://github.com/rust-lang/rust/pull/56642/
 606 [56769]: https://github.com/rust-lang/rust/pull/56769/
 607 [56805]: https://github.com/rust-lang/rust/pull/56805
 608 [56947]: https://github.com/rust-lang/rust/pull/56947/
 609 [57049]: https://github.com/rust-lang/rust/pull/57049/
 610 [57067]: https://github.com/rust-lang/rust/pull/57067/
 611 [57105]: https://github.com/rust-lang/rust/pull/57105
 612 [57130]: https://github.com/rust-lang/rust/pull/57130/
 613 [57167]: https://github.com/rust-lang/rust/pull/57167/
 614 [57175]: https://github.com/rust-lang/rust/pull/57175/
 615 [57234]: https://github.com/rust-lang/rust/pull/57234/
 616 [57332]: https://github.com/rust-lang/rust/pull/57332/
 617 [57465]: https://github.com/rust-lang/rust/pull/57465/
 618 [57532]: https://github.com/rust-lang/rust/pull/57532/
 619 [57535]: https://github.com/rust-lang/rust/pull/57535/
 620 [57566]: https://github.com/rust-lang/rust/pull/57566/
 621 [57615]: https://github.com/rust-lang/rust/pull/57615/
 622 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
 623 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
 624 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
 625 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
 626 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
 627 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
 628 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
 629 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
 630 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
 631 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
 632 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
 633 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
 634 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
 635 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
 636 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
 637 [platform-support]: https://forge.rust-lang.org/platform-support.html
 638
 639 Version 1.32.0 (2019-01-17)
 640 ==========================
 641
 642 Language
 643 --------
 644 #### 2018 edition
 645 - [You can now use the `?` operator in macro definitions.][56245] The `?`
 646   operator allows you to specify zero or one repetitions similar to the `*` and
 647   `+` operators.
 648 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
 649   now always resolve to the item (`enum`, `struct`, etc.) available in the
 650   module if present, before resolving to a external crate or an item the prelude.][56759]
 651   E.g.
 652   ```rust
 653   enum Color { Red, Green, Blue }
 654
 655   use Color::*;
 656   ```
 657
 658 #### All editions
 659 - [You can now match against `PhantomData<T>` types.][55837]
 660 - [You can now match against literals in macros with the `literal`
 661   specifier.][56072] This will match against a literal of any type.
 662   E.g. `1`, `'A'`, `"Hello World"`
 663 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
 664   ```rust
 665   struct Point(i32, i32);
 666
 667   impl Point {
 668       pub fn new(x: i32, y: i32) -> Self {
 669           Self(x, y)
 670       }
 671
 672       pub fn is_origin(&self) -> bool {
 673           match self {
 674               Self(0, 0) => true,
 675               _ => false,
 676           }
 677       }
 678   }
 679   ```
 680 - [Self can also now be used in type definitions.][56366] E.g.
 681   ```rust
 682   enum List<T>
 683   where
 684       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
 685   {
 686       Nil,
 687       Cons(T, Box<Self>) // likewise here
 688   }
 689   ```
 690 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
 691   a `impl Trait` or `dyn Trait` is returned and unused in the program.
 692
 693 Compiler
 694 --------
 695 - [The default allocator has changed from jemalloc to the default allocator on
 696   your system.][55238] The compiler itself on Linux & macOS will still use
 697   jemalloc, but programs compiled with it will use the system allocator.
 698 - [Added the `aarch64-pc-windows-msvc` target.][55702]
 699
 700 Libraries
 701 ---------
 702 - [`PathBuf` now implements `FromStr`.][55148]
 703 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
 704 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
 705   easily debug expressions in your rust program. E.g.
 706   ```rust
 707   let a = 2;
 708   let b = dbg!(a * 2) + 1;
 709   //      ^-- prints: [src/main.rs:4] a * 2 = 4
 710   assert_eq!(b, 5);
 711   ```
 712
 713 The following APIs are now `const` functions and can be used in a
 714 `const` context.
 715
 716 - [`Cell::as_ptr`]
 717 - [`UnsafeCell::get`]
 718 - [`char::is_ascii`]
 719 - [`iter::empty`]
 720 - [`ManuallyDrop::new`]
 721 - [`ManuallyDrop::into_inner`]
 722 - [`RangeInclusive::start`]
 723 - [`RangeInclusive::end`]
 724 - [`NonNull::as_ptr`]
 725 - [`slice::as_ptr`]
 726 - [`str::as_ptr`]
 727 - [`Duration::as_secs`]
 728 - [`Duration::subsec_millis`]
 729 - [`Duration::subsec_micros`]
 730 - [`Duration::subsec_nanos`]
 731 - [`CStr::as_ptr`]
 732 - [`Ipv4Addr::is_unspecified`]
 733 - [`Ipv6Addr::new`]
 734 - [`Ipv6Addr::octets`]
 735
 736 Stabilized APIs
 737 ---------------
 738 - [`i8::to_be_bytes`]
 739 - [`i8::to_le_bytes`]
 740 - [`i8::to_ne_bytes`]
 741 - [`i8::from_be_bytes`]
 742 - [`i8::from_le_bytes`]
 743 - [`i8::from_ne_bytes`]
 744 - [`i16::to_be_bytes`]
 745 - [`i16::to_le_bytes`]
 746 - [`i16::to_ne_bytes`]
 747 - [`i16::from_be_bytes`]
 748 - [`i16::from_le_bytes`]
 749 - [`i16::from_ne_bytes`]
 750 - [`i32::to_be_bytes`]
 751 - [`i32::to_le_bytes`]
 752 - [`i32::to_ne_bytes`]
 753 - [`i32::from_be_bytes`]
 754 - [`i32::from_le_bytes`]
 755 - [`i32::from_ne_bytes`]
 756 - [`i64::to_be_bytes`]
 757 - [`i64::to_le_bytes`]
 758 - [`i64::to_ne_bytes`]
 759 - [`i64::from_be_bytes`]
 760 - [`i64::from_le_bytes`]
 761 - [`i64::from_ne_bytes`]
 762 - [`i128::to_be_bytes`]
 763 - [`i128::to_le_bytes`]
 764 - [`i128::to_ne_bytes`]
 765 - [`i128::from_be_bytes`]
 766 - [`i128::from_le_bytes`]
 767 - [`i128::from_ne_bytes`]
 768 - [`isize::to_be_bytes`]
 769 - [`isize::to_le_bytes`]
 770 - [`isize::to_ne_bytes`]
 771 - [`isize::from_be_bytes`]
 772 - [`isize::from_le_bytes`]
 773 - [`isize::from_ne_bytes`]
 774 - [`u8::to_be_bytes`]
 775 - [`u8::to_le_bytes`]
 776 - [`u8::to_ne_bytes`]
 777 - [`u8::from_be_bytes`]
 778 - [`u8::from_le_bytes`]
 779 - [`u8::from_ne_bytes`]
 780 - [`u16::to_be_bytes`]
 781 - [`u16::to_le_bytes`]
 782 - [`u16::to_ne_bytes`]
 783 - [`u16::from_be_bytes`]
 784 - [`u16::from_le_bytes`]
 785 - [`u16::from_ne_bytes`]
 786 - [`u32::to_be_bytes`]
 787 - [`u32::to_le_bytes`]
 788 - [`u32::to_ne_bytes`]
 789 - [`u32::from_be_bytes`]
 790 - [`u32::from_le_bytes`]
 791 - [`u32::from_ne_bytes`]
 792 - [`u64::to_be_bytes`]
 793 - [`u64::to_le_bytes`]
 794 - [`u64::to_ne_bytes`]
 795 - [`u64::from_be_bytes`]
 796 - [`u64::from_le_bytes`]
 797 - [`u64::from_ne_bytes`]
 798 - [`u128::to_be_bytes`]
 799 - [`u128::to_le_bytes`]
 800 - [`u128::to_ne_bytes`]
 801 - [`u128::from_be_bytes`]
 802 - [`u128::from_le_bytes`]
 803 - [`u128::from_ne_bytes`]
 804 - [`usize::to_be_bytes`]
 805 - [`usize::to_le_bytes`]
 806 - [`usize::to_ne_bytes`]
 807 - [`usize::from_be_bytes`]
 808 - [`usize::from_le_bytes`]
 809 - [`usize::from_ne_bytes`]
 810
 811 Cargo
 812 -----
 813 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
 814 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
 815
 816 Misc
 817 ----
 818 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
 819
 820 Compatibility Notes
 821 -------------------
 822 - [The argument types for AVX's
 823   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
 824   been changed from `*const` to `*mut` as the previous implementation
 825   was unsound.
 826
 827
 828 [55148]: https://github.com/rust-lang/rust/pull/55148/
 829 [55238]: https://github.com/rust-lang/rust/pull/55238/
 830 [55280]: https://github.com/rust-lang/rust/pull/55280/
 831 [55610]: https://github.com/rust-lang/rust/pull/55610/
 832 [55663]: https://github.com/rust-lang/rust/pull/55663/
 833 [55702]: https://github.com/rust-lang/rust/pull/55702/
 834 [55837]: https://github.com/rust-lang/rust/pull/55837/
 835 [55843]: https://github.com/rust-lang/rust/pull/55843/
 836 [56072]: https://github.com/rust-lang/rust/pull/56072/
 837 [56245]: https://github.com/rust-lang/rust/pull/56245/
 838 [56365]: https://github.com/rust-lang/rust/pull/56365/
 839 [56366]: https://github.com/rust-lang/rust/pull/56366/
 840 [56395]: https://github.com/rust-lang/rust/pull/56395/
 841 [56759]: https://github.com/rust-lang/rust/pull/56759/
 842 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
 843 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
 844 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
 845 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
 846 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
 847 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
 848 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
 849 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
 850 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
 851 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
 852 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
 853 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
 854 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
 855 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
 856 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
 857 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
 858 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
 859 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
 860 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
 861 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
 862 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
 863 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
 864 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
 865 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
 866 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
 867 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
 868 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
 869 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
 870 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
 871 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
 872 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
 873 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
 874 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
 875 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
 876 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
 877 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
 878 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
 879 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
 880 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
 881 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
 882 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
 883 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
 884 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
 885 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
 886 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
 887 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
 888 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
 889 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
 890 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
 891 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
 892 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
 893 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
 894 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
 895 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
 896 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
 897 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
 898 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
 899 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
 900 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
 901 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
 902 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
 903 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
 904 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
 905 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
 906 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
 907 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
 908 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
 909 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
 910 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
 911 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
 912 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
 913 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
 914 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
 915 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
 916 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
 917 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
 918 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
 919 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
 920 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
 921 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
 922 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
 923 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
 924 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
 925 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
 926 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
 927 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
 928 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
 929 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
 930 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
 931 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
 932 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
 933 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
 934 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
 935
 936
 937 Version 1.31.1 (2018-12-20)
 938 ===========================
 939
 940 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
 941 - [Fix broken go-to-definition in RLS][rls/1171]
 942 - [Fix infinite loop on hover in RLS][rls/1170]
 943
 944 [56562]: https://github.com/rust-lang/rust/pull/56562
 945 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
 946 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
 947
 948 Version 1.31.0 (2018-12-06)
 949 ==========================
 950
 951 Language
 952 --------
 953 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
 954 - [New lifetime elision rules now allow for eliding lifetimes in functions and
 955   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
 956   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
 957   in structs.
 958 - [You can now define and use `const` functions.][54835] These are currently
 959   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
 960   [language reference][const-reference] for what exactly is available.
 961 - [You can now use tool lints, which allow you to scope lints from external
 962   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
 963 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
 964   a crate, not just in exported functions.][54451]
 965 - [You can now use parentheses in pattern matches.][54497]
 966
 967 Compiler
 968 --------
 969 - [Updated musl to 1.1.20][54430]
 970
 971 Libraries
 972 ---------
 973 - [You can now convert `num::NonZero*` types to their raw equivalents using the
 974   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
 975 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
 976   into `Option<&mut T>` using the `From` trait.][53218]
 977 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
 978
 979
 980 Stabilized APIs
 981 ---------------
 982 - [`slice::align_to`]
 983 - [`slice::align_to_mut`]
 984 - [`slice::chunks_exact`]
 985 - [`slice::chunks_exact_mut`]
 986 - [`slice::rchunks`]
 987 - [`slice::rchunks_mut`]
 988 - [`slice::rchunks_exact`]
 989 - [`slice::rchunks_exact_mut`]
 990 - [`Option::replace`]
 991
 992 Cargo
 993 -----
 994 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
 995 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
 996   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
 997
 998 [52813]: https://github.com/rust-lang/rust/pull/52813/
 999 [53218]: https://github.com/rust-lang/rust/pull/53218/
1000 [53555]: https://github.com/rust-lang/rust/issues/53555/
1001 [54057]: https://github.com/rust-lang/rust/pull/54057/
1002 [54240]: https://github.com/rust-lang/rust/pull/54240/
1003 [54430]: https://github.com/rust-lang/rust/pull/54430/
1004 [54451]: https://github.com/rust-lang/rust/pull/54451/
1005 [54497]: https://github.com/rust-lang/rust/pull/54497/
1006 [54778]: https://github.com/rust-lang/rust/pull/54778/
1007 [54835]: https://github.com/rust-lang/rust/pull/54835/
1008 [54870]: https://github.com/rust-lang/rust/pull/54870/
1009 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1010 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1011 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1012 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1013 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1014 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1015 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1016 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1017 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1018 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1019 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1020 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1021 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1022 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1023
1024 Version 1.30.1 (2018-11-08)
1025 ===========================
1026
1027 - [Fixed overflow ICE in rustdoc][54199]
1028 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1029
1030 [54199]: https://github.com/rust-lang/rust/pull/54199
1031 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1032
1033 Version 1.30.0 (2018-10-25)
1034 ==========================
1035
1036 Language
1037 --------
1038 - [Procedural macros are now available.][52081] These kinds of macros allow for
1039   more powerful code generation. There is a [new chapter available][proc-macros]
1040   in the Rust Programming Language book that goes further in depth.
1041 - [You can now use keywords as identifiers using the raw identifiers
1042   syntax (`r#`),][53236] e.g. `let r#for = true;`
1043 - [Using anonymous parameters in traits is now deprecated with a warning and
1044   will be a hard error in the 2018 edition.][53272]
1045 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1046   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1047 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1048   Previously, using a external crate in a module without a use statement
1049   required `let json = ::serde_json::from_str(foo);` but can now be written
1050   as `let json = serde_json::from_str(foo);`.
1051 - [You can now apply the `#[used]` attribute to static items to prevent the
1052   compiler from optimising them away, even if they appear to be unused,][51363]
1053   e.g. `#[used] static FOO: u32 = 1;`
1054 - [You can now import and reexport macros from other crates with the `use`
1055   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1056   the root module of the crate. If your macro relies on calling other local
1057   macros, it is recommended to export with the
1058   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1059   those macros.
1060 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1061   using the `vis` specifier.][53370]
1062 - [Non-macro attributes now allow all forms of literals, not just
1063   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1064   write `#[attr(true)]`.
1065 - [You can now specify a function to handle a panic in the Rust runtime with the
1066   `#[panic_handler]` attribute.][51366]
1067
1068 Compiler
1069 --------
1070 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1071 - [Added the `aarch64-unknown-netbsd` target][53165]
1072
1073 Libraries
1074 ---------
1075 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1076
1077 Stabilized APIs
1078 ---------------
1079 - [`Ipv4Addr::BROADCAST`]
1080 - [`Ipv4Addr::LOCALHOST`]
1081 - [`Ipv4Addr::UNSPECIFIED`]
1082 - [`Ipv6Addr::LOCALHOST`]
1083 - [`Ipv6Addr::UNSPECIFIED`]
1084 - [`Iterator::find_map`]
1085
1086   The following methods are replacement methods for `trim_left`, `trim_right`,
1087   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1088   in 1.33.0:
1089 - [`str::trim_end_matches`]
1090 - [`str::trim_end`]
1091 - [`str::trim_start_matches`]
1092 - [`str::trim_start`]
1093
1094 Cargo
1095 ----
1096 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1097 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1098   equivalent to calling `rustdoc --error-format=json`.
1099 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1100
1101 Misc
1102 ----
1103 - [`rustdoc` allows you to specify what edition to treat your code as with the
1104   `--edition` option.][54057]
1105 - [`rustdoc` now has the `--color` (specify whether to output color) and
1106   `--error-format` (specify error format, e.g. `json`) options.][53003]
1107 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1108   debug symbols.][53774]
1109 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1110   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1111
1112 [50911]: https://github.com/rust-lang/rust/pull/50911/
1113 [51363]: https://github.com/rust-lang/rust/pull/51363/
1114 [51366]: https://github.com/rust-lang/rust/pull/51366/
1115 [52081]: https://github.com/rust-lang/rust/pull/52081/
1116 [53003]: https://github.com/rust-lang/rust/pull/53003/
1117 [53033]: https://github.com/rust-lang/rust/pull/53033/
1118 [53044]: https://github.com/rust-lang/rust/pull/53044/
1119 [53165]: https://github.com/rust-lang/rust/pull/53165/
1120 [53213]: https://github.com/rust-lang/rust/pull/53213/
1121 [53236]: https://github.com/rust-lang/rust/pull/53236/
1122 [53272]: https://github.com/rust-lang/rust/pull/53272/
1123 [53370]: https://github.com/rust-lang/rust/pull/53370/
1124 [53459]: https://github.com/rust-lang/rust/pull/53459/
1125 [53774]: https://github.com/rust-lang/rust/pull/53774/
1126 [53822]: https://github.com/rust-lang/rust/pull/53822/
1127 [54057]: https://github.com/rust-lang/rust/pull/54057/
1128 [54146]: https://github.com/rust-lang/rust/pull/54146/
1129 [54404]: https://github.com/rust-lang/rust/pull/54404/
1130 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1131 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1132 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1133 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1134
1135 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1136 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1137 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1138 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1139 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1140 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1141 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1142 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1143 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1144 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1145
1146
1147 Version 1.29.2 (2018-10-11)
1148 ===========================
1149
1150 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1151 - The `rls-preview` component on the windows-gnu targets has been restored.
1152
1153 [54639]: https://github.com/rust-lang/rust/pull/54639
1154
1155
1156 Version 1.29.1 (2018-09-25)
1157 ===========================
1158
1159 Security Notes
1160 --------------
1161
1162 - The standard library's `str::repeat` function contained an out of bounds write
1163   caused by an integer overflow. This has been fixed by deterministically
1164   panicking when an overflow happens.
1165
1166   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1167   us.
1168
1169
1170 Version 1.29.0 (2018-09-13)
1171 ==========================
1172
1173 Compiler
1174 --------
1175 - [Bumped minimum LLVM version to 5.0.][51899]
1176 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1177 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1178
1179 Libraries
1180 ---------
1181 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1182 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1183 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1184 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1185   for `&str`.][51178]
1186 - [`Cell<T>` now allows `T` to be unsized.][50494]
1187 - [`SocketAddr` is now stable on Redox.][52656]
1188
1189 Stabilized APIs
1190 ---------------
1191 - [`Arc::downcast`]
1192 - [`Iterator::flatten`]
1193 - [`Rc::downcast`]
1194
1195 Cargo
1196 -----
1197 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1198   `--locked` to disable this behavior.
1199 - [`cargo-install` will now allow you to cross compile an install
1200   using `--target`.][cargo/5614]
1201 - [Added the `cargo-fix` subcommand to automatically move project code from
1202   2015 edition to 2018.][cargo/5723]
1203 - [`cargo doc` can now optionally document private types using the
1204   `--document-private-items` flag.][cargo/5543]
1205
1206 Misc
1207 ----
1208 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1209   the specified level to that level.][52354] For example `--cap-lints warn`
1210   will demote `deny` and `forbid` lints to `warn`.
1211 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1212   fails and `101` if there is a panic.][52197]
1213 - [A preview of clippy has been made available through rustup.][51122]
1214   You can install the preview with `rustup component add clippy-preview`.
1215
1216 Compatibility Notes
1217 -------------------
1218 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1219   Use `str::get_unchecked(begin..end)` instead.
1220 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1221   Consider using the `home_dir` function from
1222   https://crates.io/crates/dirs instead.
1223 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1224 - [`cfg` attributes and `--cfg` command line flags are now more
1225   strictly validated.][53893]
1226
1227 [53893]: https://github.com/rust-lang/rust/pull/53893/
1228 [52861]: https://github.com/rust-lang/rust/pull/52861/
1229 [52656]: https://github.com/rust-lang/rust/pull/52656/
1230 [52239]: https://github.com/rust-lang/rust/pull/52239/
1231 [52330]: https://github.com/rust-lang/rust/pull/52330/
1232 [52354]: https://github.com/rust-lang/rust/pull/52354/
1233 [52402]: https://github.com/rust-lang/rust/pull/52402/
1234 [52103]: https://github.com/rust-lang/rust/pull/52103/
1235 [52197]: https://github.com/rust-lang/rust/pull/52197/
1236 [51807]: https://github.com/rust-lang/rust/pull/51807/
1237 [51899]: https://github.com/rust-lang/rust/pull/51899/
1238 [51912]: https://github.com/rust-lang/rust/pull/51912/
1239 [51511]: https://github.com/rust-lang/rust/pull/51511/
1240 [51619]: https://github.com/rust-lang/rust/pull/51619/
1241 [51656]: https://github.com/rust-lang/rust/pull/51656/
1242 [51178]: https://github.com/rust-lang/rust/pull/51178/
1243 [51122]: https://github.com/rust-lang/rust/pull/51122
1244 [50494]: https://github.com/rust-lang/rust/pull/50494/
1245 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1246 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1247 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1248 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1249 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1250 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1251 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1252
1253
1254 Version 1.28.0 (2018-08-02)
1255 ===========================
1256
1257 Language
1258 --------
1259 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1260   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1261   the inner type across Foreign Function Interface (FFI) boundaries.
1262 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1263   and can now be used as identifiers.][51196]
1264 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1265   stable.][51241] This will allow users to specify a global allocator for
1266   their program.
1267 - [Unit test functions marked with the `#[test]` attribute can now return
1268   `Result<(), E: Debug>` in addition to `()`.][51298]
1269 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1270   allows macros to easily target lifetimes.
1271
1272 Compiler
1273 --------
1274 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1275   prioritise making smaller binary sizes. `z` is the same as `s` with the
1276   exception that it does not vectorise loops, which typically results in an even
1277   smaller binary.
1278 - [The short error format is now stable.][49546] Specified with
1279   `--error-format=short` this option will provide a more compressed output of
1280   rust error messages.
1281 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1282 - [Reduced the number of allocations in the macro parser.][50855] This can
1283   improve compile times of macro heavy crates on average by 5%.
1284
1285 Libraries
1286 ---------
1287 - [Implemented `Default` for `&mut str`.][51306]
1288 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1289 - [Implemented `Extend` for `()`.][50234]
1290 - [The `Debug` implementation of `time::Duration` should now be more easily
1291   human readable.][50364] Previously a `Duration` of one second would printed as
1292   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1293 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1294   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1295   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1296   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1297   for `PathBuf`.][50170]
1298 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1299   and `Wrapping<i128>`.][50465]
1300 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1301   possible.][51050] This can provide up to a 40% speed increase.
1302 - [Improved error messages when using `format!`.][50610]
1303
1304 Stabilized APIs
1305 ---------------
1306 - [`Iterator::step_by`]
1307 - [`Path::ancestors`]
1308 - [`SystemTime::UNIX_EPOCH`]
1309 - [`alloc::GlobalAlloc`]
1310 - [`alloc::Layout`]
1311 - [`alloc::LayoutErr`]
1312 - [`alloc::System`]
1313 - [`alloc::alloc`]
1314 - [`alloc::alloc_zeroed`]
1315 - [`alloc::dealloc`]
1316 - [`alloc::realloc`]
1317 - [`alloc::handle_alloc_error`]
1318 - [`btree_map::Entry::or_default`]
1319 - [`fmt::Alignment`]
1320 - [`hash_map::Entry::or_default`]
1321 - [`iter::repeat_with`]
1322 - [`num::NonZeroUsize`]
1323 - [`num::NonZeroU128`]
1324 - [`num::NonZeroU16`]
1325 - [`num::NonZeroU32`]
1326 - [`num::NonZeroU64`]
1327 - [`num::NonZeroU8`]
1328 - [`ops::RangeBounds`]
1329 - [`slice::SliceIndex`]
1330 - [`slice::from_mut`]
1331 - [`slice::from_ref`]
1332 - [`{Any + Send + Sync}::downcast_mut`]
1333 - [`{Any + Send + Sync}::downcast_ref`]
1334 - [`{Any + Send + Sync}::is`]
1335
1336 Cargo
1337 -----
1338 - [Cargo will now no longer allow you to publish crates with build scripts that
1339   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1340   considered to be immutable.
1341
1342 Misc
1343 ----
1344 - [The `suggestion_applicability` field in `rustc`'s json output is now
1345   stable.][50486] This will allow dev tools to check whether a code suggestion
1346   would apply to them.
1347
1348 Compatibility Notes
1349 -------------------
1350 - [Rust will consider trait objects with duplicated constraints to be the same
1351   type as without the duplicated constraint.][51276] For example the below code will
1352   now fail to compile.
1353   ```rust
1354   trait Trait {}
1355
1356   impl Trait + Send {
1357       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1358   }
1359
1360   impl Trait + Send + Send {
1361       fn test(&self) { println!("two"); }
1362   }
1363   ```
1364
1365 [49546]: https://github.com/rust-lang/rust/pull/49546/
1366 [50143]: https://github.com/rust-lang/rust/pull/50143/
1367 [50170]: https://github.com/rust-lang/rust/pull/50170/
1368 [50234]: https://github.com/rust-lang/rust/pull/50234/
1369 [50265]: https://github.com/rust-lang/rust/pull/50265/
1370 [50364]: https://github.com/rust-lang/rust/pull/50364/
1371 [50385]: https://github.com/rust-lang/rust/pull/50385/
1372 [50465]: https://github.com/rust-lang/rust/pull/50465/
1373 [50486]: https://github.com/rust-lang/rust/pull/50486/
1374 [50554]: https://github.com/rust-lang/rust/pull/50554/
1375 [50610]: https://github.com/rust-lang/rust/pull/50610/
1376 [50855]: https://github.com/rust-lang/rust/pull/50855/
1377 [51050]: https://github.com/rust-lang/rust/pull/51050/
1378 [51196]: https://github.com/rust-lang/rust/pull/51196/
1379 [51200]: https://github.com/rust-lang/rust/pull/51200/
1380 [51241]: https://github.com/rust-lang/rust/pull/51241/
1381 [51276]: https://github.com/rust-lang/rust/pull/51276/
1382 [51298]: https://github.com/rust-lang/rust/pull/51298/
1383 [51306]: https://github.com/rust-lang/rust/pull/51306/
1384 [51562]: https://github.com/rust-lang/rust/pull/51562/
1385 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1386 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1387 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1388 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1389 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1390 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1391 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1392 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1393 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1394 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1395 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1396 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1397 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1398 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1399 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1400 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1401 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1402 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1403 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1404 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1405 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1406 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1407 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1408 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1409 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1410 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1411 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1412 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1413 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1414 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1415
1416 Version 1.27.2 (2018-07-20)
1417 ===========================
1418
1419 Compatibility Notes
1420 -------------------
1421
1422 - The borrow checker was fixed to avoid potential unsoundness when using
1423   match ergonomics: [#52213][52213].
1424
1425 [52213]: https://github.com/rust-lang/rust/issues/52213
1426
1427 Version 1.27.1 (2018-07-10)
1428 ===========================
1429
1430 Security Notes
1431 --------------
1432
1433 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1434   when running, which enabled executing code as some other user on a
1435   given machine. This release fixes that vulnerability; you can read
1436   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1437
1438   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
1439
1440 Compatibility Notes
1441 -------------------
1442
1443 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1444   match ergonomics: [#51415][51415], [#49534][49534].
1445
1446 [51415]: https://github.com/rust-lang/rust/issues/51415
1447 [49534]: https://github.com/rust-lang/rust/issues/49534
1448 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1449 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1450
1451 Version 1.27.0 (2018-06-21)
1452 ==========================
1453
1454 Language
1455 --------
1456 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1457   be used as an identifier.
1458 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1459   bare `Trait` syntax, and should make it clearer when being used in tandem with
1460   `impl Trait` because it is equivalent to the following syntax:
1461   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1462   `Box<Trait> == Box<dyn Trait>`.
1463 - [Attributes on generic parameters such as types and lifetimes are
1464   now stable.][48851] e.g.
1465   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1466 - [The `#[must_use]` attribute can now also be used on functions as well as
1467   types.][48925] It provides a lint that by default warns users when the
1468   value returned by a function has not been used.
1469
1470 Compiler
1471 --------
1472 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1473
1474 Libraries
1475 ---------
1476 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1477   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1478   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1479   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1480   the `cfg` attribute.
1481 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1482   std are now available in core.][49896]
1483 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1484   to `Self`.][49630]
1485 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1486   that the operation isn't done in place.
1487 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1488   the `#[must_use]` attribute][49533] to warn about unused potentially
1489   expensive allocations.
1490
1491 Stabilized APIs
1492 ---------------
1493 - [`DoubleEndedIterator::rfind`]
1494 - [`DoubleEndedIterator::rfold`]
1495 - [`DoubleEndedIterator::try_rfold`]
1496 - [`Duration::from_micros`]
1497 - [`Duration::from_nanos`]
1498 - [`Duration::subsec_micros`]
1499 - [`Duration::subsec_millis`]
1500 - [`HashMap::remove_entry`]
1501 - [`Iterator::try_fold`]
1502 - [`Iterator::try_for_each`]
1503 - [`NonNull::cast`]
1504 - [`Option::filter`]
1505 - [`String::replace_range`]
1506 - [`Take::set_limit`]
1507 - [`hint::unreachable_unchecked`]
1508 - [`os::unix::process::parent_id`]
1509 - [`ptr::swap_nonoverlapping`]
1510 - [`slice::rsplit_mut`]
1511 - [`slice::rsplit`]
1512 - [`slice::swap_with_slice`]
1513
1514 Cargo
1515 -----
1516 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1517   `readme`, and `repository` fields.][cargo/5386]
1518 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1519 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1520   a different directory than `target` for placing compilation artifacts.
1521 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1522   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1523   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1524   where cargo would infer a binary, Cargo will produce a warning. You can
1525   disable this feature ahead of time by setting any of the following to false:
1526   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1527 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1528   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1529
1530 Misc
1531 ----
1532 - [Added “The Rustc book” into the official documentation.][49707]
1533   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1534 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1535
1536 Compatibility Notes
1537 -------------------
1538 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1539   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1540   compile, `"".is_empty()` will still compile.
1541 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1542   will only print the inner type.][48553] E.g.
1543   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1544   not `AtomicBool(true)`.
1545 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1546   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1547   alignment should cover all use cases.
1548 - The `.description()` method on the `std::error::Error` trait
1549   [has been soft-deprecated][50163]. It is no longer required to implement it.
1550
1551 [48553]: https://github.com/rust-lang/rust/pull/48553/
1552 [48851]: https://github.com/rust-lang/rust/pull/48851/
1553 [48925]: https://github.com/rust-lang/rust/pull/48925/
1554 [49533]: https://github.com/rust-lang/rust/pull/49533/
1555 [49623]: https://github.com/rust-lang/rust/pull/49623/
1556 [49630]: https://github.com/rust-lang/rust/pull/49630/
1557 [49664]: https://github.com/rust-lang/rust/pull/49664/
1558 [49699]: https://github.com/rust-lang/rust/pull/49699/
1559 [49707]: https://github.com/rust-lang/rust/pull/49707/
1560 [49719]: https://github.com/rust-lang/rust/pull/49719/
1561 [49896]: https://github.com/rust-lang/rust/pull/49896/
1562 [49968]: https://github.com/rust-lang/rust/pull/49968/
1563 [50163]: https://github.com/rust-lang/rust/pull/50163
1564 [50177]: https://github.com/rust-lang/rust/pull/50177/
1565 [50378]: https://github.com/rust-lang/rust/pull/50378/
1566 [50398]: https://github.com/rust-lang/rust/pull/50398/
1567 [50423]: https://github.com/rust-lang/rust/pull/50423/
1568 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1569 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1570 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1571 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1572 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1573 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1574 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1575 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1576 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1577 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1578 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1579 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1580 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1581 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1582 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1583 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1584 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1585 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1586 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1587 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1588 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1589 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1590 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1591 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1592 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1593 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1594 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1595 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1596 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1597 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1598
1599
1600 Version 1.26.2 (2018-06-05)
1601 ==========================
1602
1603 Compatibility Notes
1604 -------------------
1605
1606 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1607
1608 [51117]: https://github.com/rust-lang/rust/issues/51117
1609
1610
1611 Version 1.26.1 (2018-05-29)
1612 ==========================
1613
1614 Tools
1615 -----
1616
1617 - [RLS now works on Windows.][50646]
1618 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1619
1620
1621 Compatibility Notes
1622 --------
1623
1624 - [`fn main() -> impl Trait` no longer works for non-Termination
1625   trait.][50656]
1626   This reverts an accidental stabilization.
1627 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1628 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1629
1630 [50646]: https://github.com/rust-lang/rust/issues/50646
1631 [50656]: https://github.com/rust-lang/rust/pull/50656
1632 [50812]: https://github.com/rust-lang/rust/pull/50812
1633 [50950]: https://github.com/rust-lang/rust/issues/50950
1634 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1635
1636 Version 1.26.0 (2018-05-10)
1637 ==========================
1638
1639 Language
1640 --------
1641 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1642   implement either or both traits.][49299]
1643 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1644 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1645   lifetime can be elided.][49458]
1646 - [`impl Trait` is now stable allowing you to have abstract types in returns
1647    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1648   `fn open(path: impl AsRef<Path>)`.
1649 - [Pattern matching will now automatically apply dereferences.][49394]
1650 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1651 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1652 - [A lot of operations are now available in a const context.][46882] E.g. You
1653   can now index into constant arrays, reference and dereference into constants,
1654   and use tuple struct constructors.
1655 - [Fixed entry slice patterns are now stable.][48516] E.g.
1656   ```rust
1657   let points = [1, 2, 3, 4];
1658   match points {
1659       [1, 2, 3, 4] => println!("All points were sequential."),
1660       _ => println!("Not all points were sequential."),
1661   }
1662   ```
1663
1664
1665 Compiler
1666 --------
1667 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1668 - [Fixed exponential projection complexity on nested types.][48296]
1669   This can provide up to a ~12% reduction in compile times for certain crates.
1670 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1671   to remap path prefixes outputted by the compiler.
1672 - [Added `powerpc-unknown-netbsd` target.][48281]
1673
1674 Libraries
1675 ---------
1676 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1677 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1678   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1679 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1680 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1681 - [`ascii::escape_default` is now available in libcore.][48735]
1682 - [Trailing commas are now supported in std and core macros.][48056]
1683 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1684 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1685
1686 Stabilized APIs
1687 ---------------
1688 - [`*const T::add`]
1689 - [`*const T::copy_to_nonoverlapping`]
1690 - [`*const T::copy_to`]
1691 - [`*const T::read_unaligned`]
1692 - [`*const T::read_volatile`]
1693 - [`*const T::read`]
1694 - [`*const T::sub`]
1695 - [`*const T::wrapping_add`]
1696 - [`*const T::wrapping_sub`]
1697 - [`*mut T::add`]
1698 - [`*mut T::copy_to_nonoverlapping`]
1699 - [`*mut T::copy_to`]
1700 - [`*mut T::read_unaligned`]
1701 - [`*mut T::read_volatile`]
1702 - [`*mut T::read`]
1703 - [`*mut T::replace`]
1704 - [`*mut T::sub`]
1705 - [`*mut T::swap`]
1706 - [`*mut T::wrapping_add`]
1707 - [`*mut T::wrapping_sub`]
1708 - [`*mut T::write_bytes`]
1709 - [`*mut T::write_unaligned`]
1710 - [`*mut T::write_volatile`]
1711 - [`*mut T::write`]
1712 - [`Box::leak`]
1713 - [`FromUtf8Error::as_bytes`]
1714 - [`LocalKey::try_with`]
1715 - [`Option::cloned`]
1716 - [`btree_map::Entry::and_modify`]
1717 - [`fs::read_to_string`]
1718 - [`fs::read`]
1719 - [`fs::write`]
1720 - [`hash_map::Entry::and_modify`]
1721 - [`iter::FusedIterator`]
1722 - [`ops::RangeInclusive`]
1723 - [`ops::RangeToInclusive`]
1724 - [`process::id`]
1725 - [`slice::rotate_left`]
1726 - [`slice::rotate_right`]
1727 - [`String::retain`]
1728
1729
1730 Cargo
1731 -----
1732 - [Cargo will now output path to custom commands when `-v` is
1733   passed with `--list`][cargo/5041]
1734 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1735
1736 Misc
1737 ----
1738 - [The second edition of "The Rust Programming Language" book is now recommended
1739   over the first.][48404]
1740
1741 Compatibility Notes
1742 -------------------
1743
1744 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1745   syntax is now invalid.
1746   ```
1747   use std::ops::Fn as dyn;
1748   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1749   ```
1750 - [The result of dereferences are no longer promoted to `'static`.][47408]
1751   e.g.
1752   ```rust
1753   fn main() {
1754       const PAIR: &(i32, i32) = &(0, 1);
1755       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1756   }
1757   ```
1758 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1759 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1760   an error.][48235]
1761 - [Removed hoedown from rustdoc.][48274]
1762 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1763
1764 [46882]: https://github.com/rust-lang/rust/pull/46882
1765 [47379]: https://github.com/rust-lang/rust/pull/47379
1766 [47408]: https://github.com/rust-lang/rust/pull/47408
1767 [47813]: https://github.com/rust-lang/rust/pull/47813
1768 [48056]: https://github.com/rust-lang/rust/pull/48056
1769 [48125]: https://github.com/rust-lang/rust/pull/48125
1770 [48166]: https://github.com/rust-lang/rust/pull/48166
1771 [48235]: https://github.com/rust-lang/rust/pull/48235
1772 [48274]: https://github.com/rust-lang/rust/pull/48274
1773 [48281]: https://github.com/rust-lang/rust/pull/48281
1774 [48296]: https://github.com/rust-lang/rust/pull/48296
1775 [48326]: https://github.com/rust-lang/rust/pull/48326
1776 [48359]: https://github.com/rust-lang/rust/pull/48359
1777 [48404]: https://github.com/rust-lang/rust/pull/48404
1778 [48481]: https://github.com/rust-lang/rust/pull/48481
1779 [48516]: https://github.com/rust-lang/rust/pull/48516
1780 [48628]: https://github.com/rust-lang/rust/pull/48628
1781 [48629]: https://github.com/rust-lang/rust/pull/48629
1782 [48657]: https://github.com/rust-lang/rust/pull/48657
1783 [48735]: https://github.com/rust-lang/rust/pull/48735
1784 [48978]: https://github.com/rust-lang/rust/pull/48978
1785 [49101]: https://github.com/rust-lang/rust/pull/49101
1786 [49109]: https://github.com/rust-lang/rust/pull/49109
1787 [49121]: https://github.com/rust-lang/rust/pull/49121
1788 [49162]: https://github.com/rust-lang/rust/pull/49162
1789 [49184]: https://github.com/rust-lang/rust/pull/49184
1790 [49234]: https://github.com/rust-lang/rust/pull/49234
1791 [49255]: https://github.com/rust-lang/rust/pull/49255
1792 [49299]: https://github.com/rust-lang/rust/pull/49299
1793 [49305]: https://github.com/rust-lang/rust/pull/49305
1794 [49394]: https://github.com/rust-lang/rust/pull/49394
1795 [49458]: https://github.com/rust-lang/rust/pull/49458
1796 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
1797 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
1798 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
1799 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
1800 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
1801 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
1802 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
1803 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
1804 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
1805 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
1806 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
1807 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
1808 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
1809 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
1810 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
1811 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
1812 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
1813 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
1814 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
1815 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
1816 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
1817 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
1818 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
1819 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
1820 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
1821 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
1822 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
1823 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
1824 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
1825 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
1826 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
1827 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
1828 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
1829 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
1830 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
1831 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
1832 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1833 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
1834 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
1835 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
1836 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
1837 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
1838
1839
1840 Version 1.25.0 (2018-03-29)
1841 ==========================
1842
1843 Language
1844 --------
1845 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
1846 - [You can now use nested groups of imports.][47948]
1847   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
1848 - [You can now have `|` at the start of a match arm.][47947] e.g.
1849 ```rust
1850 enum Foo { A, B, C }
1851
1852 fn main() {
1853     let x = Foo::A;
1854     match x {
1855         | Foo::A
1856         | Foo::B => println!("AB"),
1857         | Foo::C => println!("C"),
1858     }
1859 }
1860 ```
1861
1862 Compiler
1863 --------
1864 - [Upgraded to LLVM 6.][47828]
1865 - [Added `-C lto=val` option.][47521]
1866 - [Added `i586-unknown-linux-musl` target][47282]
1867
1868 Libraries
1869 ---------
1870 - [Impl Send for `process::Command` on Unix.][47760]
1871 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
1872 - [`UnsafeCell::into_inner` is now safe.][47204]
1873 - [Implement libstd for CloudABI.][47268]
1874 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
1875 - [Implement `AsRef<Path>` for Component][46985]
1876 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
1877 - [Moved `Duration` to libcore.][46666]
1878
1879 Stabilized APIs
1880 ---------------
1881 - [`Location::column`]
1882 - [`ptr::NonNull`]
1883
1884 The following functions can now be used in a constant expression.
1885 eg. `static MINUTE: Duration = Duration::from_secs(60);`
1886 - [`Duration::new`][47300]
1887 - [`Duration::from_secs`][47300]
1888 - [`Duration::from_millis`][47300]
1889
1890 Cargo
1891 -----
1892 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
1893 - [`cargo new` now defaults to creating a binary crate, instead of a
1894   library crate.][cargo/5029]
1895
1896 Misc
1897 ----
1898 - [Rust by example is now shipped with new releases][46196]
1899
1900 Compatibility Notes
1901 -------------------
1902 - [Deprecated `net::lookup_host`.][47510]
1903 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
1904 - The borrow checker was sometimes incorrectly permitting overlapping borrows
1905   around indexing operations (see [#47349][47349]). This has been fixed (which also
1906   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
1907 - [Removed deprecated unstable attribute `#[simd]`.][47251]
1908
1909 [33903]: https://github.com/rust-lang/rust/pull/33903
1910 [47947]: https://github.com/rust-lang/rust/pull/47947
1911 [47948]: https://github.com/rust-lang/rust/pull/47948
1912 [47760]: https://github.com/rust-lang/rust/pull/47760
1913 [47790]: https://github.com/rust-lang/rust/pull/47790
1914 [47828]: https://github.com/rust-lang/rust/pull/47828
1915 [47398]: https://github.com/rust-lang/rust/pull/47398
1916 [47510]: https://github.com/rust-lang/rust/pull/47510
1917 [47521]: https://github.com/rust-lang/rust/pull/47521
1918 [47204]: https://github.com/rust-lang/rust/pull/47204
1919 [47251]: https://github.com/rust-lang/rust/pull/47251
1920 [47268]: https://github.com/rust-lang/rust/pull/47268
1921 [47282]: https://github.com/rust-lang/rust/pull/47282
1922 [47300]: https://github.com/rust-lang/rust/pull/47300
1923 [47349]: https://github.com/rust-lang/rust/pull/47349
1924 [46931]: https://github.com/rust-lang/rust/pull/46931
1925 [46985]: https://github.com/rust-lang/rust/pull/46985
1926 [47006]: https://github.com/rust-lang/rust/pull/47006
1927 [46830]: https://github.com/rust-lang/rust/pull/46830
1928 [46095]: https://github.com/rust-lang/rust/pull/46095
1929 [46666]: https://github.com/rust-lang/rust/pull/46666
1930 [46196]: https://github.com/rust-lang/rust/pull/46196
1931 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
1932 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
1933 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
1934 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
1935 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1936
1937
1938 Version 1.24.1 (2018-03-01)
1939 ==========================
1940
1941  - [Do not abort when unwinding through FFI][48251]
1942  - [Emit UTF-16 files for linker arguments on Windows][48318]
1943  - [Make the error index generator work again][48308]
1944  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1945
1946 [48251]: https://github.com/rust-lang/rust/issues/48251
1947 [48308]: https://github.com/rust-lang/rust/issues/48308
1948 [48318]: https://github.com/rust-lang/rust/issues/48318
1949 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1950
1951
1952 Version 1.24.0 (2018-02-15)
1953 ==========================
1954
1955 Language
1956 --------
1957 - [External `sysv64` ffi is now available.][46528]
1958   eg. `extern "sysv64" fn foo () {}`
1959
1960 Compiler
1961 --------
1962 - [rustc now uses 16 codegen units by default for release builds.][46910]
1963   For the fastest builds, utilize `codegen-units=1`.
1964 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1965 - [Add `aarch64-unknown-openbsd` support][46760]
1966
1967 Libraries
1968 ---------
1969 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1970   improvement in performance in the majority of cases.
1971 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1972   with Windows.][46798]
1973 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1974 - [impl `From<bool>` for `AtomicBool`][46293]
1975 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1976 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1977 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1978 - [float::from_bits now just uses transmute.][46012] This provides
1979   some optimisations from LLVM.
1980 - [Copied `AsciiExt` methods onto `char`][46077]
1981 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1982 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1983 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1984 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1985
1986 Stabilized APIs
1987 ---------------
1988 - [`RefCell::replace`]
1989 - [`RefCell::swap`]
1990 - [`atomic::spin_loop_hint`]
1991
1992 The following functions can now be used in a constant expression.
1993 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1994
1995 - [`AtomicBool::new`][46287]
1996 - [`AtomicUsize::new`][46287]
1997 - [`AtomicIsize::new`][46287]
1998 - [`AtomicPtr::new`][46287]
1999 - [`Cell::new`][46287]
2000 - [`{integer}::min_value`][46287]
2001 - [`{integer}::max_value`][46287]
2002 - [`mem::size_of`][46287]
2003 - [`mem::align_of`][46287]
2004 - [`ptr::null`][46287]
2005 - [`ptr::null_mut`][46287]
2006 - [`RefCell::new`][46287]
2007 - [`UnsafeCell::new`][46287]
2008
2009 Cargo
2010 -----
2011 - [Added a `workspace.default-members` config that
2012   overrides implied `--all` in virtual workspaces.][cargo/4743]
2013 - [Enable incremental by default on development builds.][cargo/4817] Also added
2014   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2015   per-project or global basis respectively.
2016
2017 Misc
2018 ----
2019
2020 Compatibility Notes
2021 -------------------
2022 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2023 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2024   in accordance with IETF RFC 4291 §2.2.
2025 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2026 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2027   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2028 - [Leading zeros in tuple struct members is now an error][47084]
2029 - [`column!()` macro is one-based instead of zero-based][46977]
2030 - [`fmt::Arguments` can no longer be shared across threads][45198]
2031 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2032 - [Cargo sets a different working directory for the compiler][cargo/4788]
2033
2034 [44884]: https://github.com/rust-lang/rust/pull/44884
2035 [45198]: https://github.com/rust-lang/rust/pull/45198
2036 [45506]: https://github.com/rust-lang/rust/pull/45506
2037 [45904]: https://github.com/rust-lang/rust/pull/45904
2038 [45990]: https://github.com/rust-lang/rust/pull/45990
2039 [46012]: https://github.com/rust-lang/rust/pull/46012
2040 [46077]: https://github.com/rust-lang/rust/pull/46077
2041 [46094]: https://github.com/rust-lang/rust/pull/46094
2042 [46284]: https://github.com/rust-lang/rust/pull/46284
2043 [46287]: https://github.com/rust-lang/rust/pull/46287
2044 [46293]: https://github.com/rust-lang/rust/pull/46293
2045 [46528]: https://github.com/rust-lang/rust/pull/46528
2046 [46671]: https://github.com/rust-lang/rust/pull/46671
2047 [46713]: https://github.com/rust-lang/rust/pull/46713
2048 [46735]: https://github.com/rust-lang/rust/pull/46735
2049 [46749]: https://github.com/rust-lang/rust/pull/46749
2050 [46760]: https://github.com/rust-lang/rust/pull/46760
2051 [46798]: https://github.com/rust-lang/rust/pull/46798
2052 [46828]: https://github.com/rust-lang/rust/pull/46828
2053 [46831]: https://github.com/rust-lang/rust/pull/46831
2054 [46833]: https://github.com/rust-lang/rust/pull/46833
2055 [46910]: https://github.com/rust-lang/rust/pull/46910
2056 [46977]: https://github.com/rust-lang/rust/pull/46977
2057 [47018]: https://github.com/rust-lang/rust/pull/47018
2058 [47080]: https://github.com/rust-lang/rust/pull/47080
2059 [47084]: https://github.com/rust-lang/rust/pull/47084
2060 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2061 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2062 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2063 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2064 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2065 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2066
2067
2068 Version 1.23.0 (2018-01-04)
2069 ==========================
2070
2071 Language
2072 --------
2073 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2074 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2075   Which should fix some confusing errors in some operations.
2076
2077 Compiler
2078 --------
2079 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2080   undefined behavior.][45920]
2081 - [rustc now suggests renaming import if names clash.][45660]
2082 - [Display errors/warnings correctly when there are zero-width or
2083   wide characters.][45711]
2084 - [rustc now avoids unnecessary copies of arguments that are
2085   simple bindings][45380] This should improve memory usage on average by 5-10%.
2086 - [Updated musl used to build musl rustc to 1.1.17][45393]
2087
2088 Libraries
2089 ---------
2090 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2091 - [Implement Hash for raw pointers to unsized types][45483]
2092 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2093 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2094 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2095 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2096   and `<*mut T>::as_mut`][44932]
2097 - [Optimized `Thread::{park, unpark}` implementation][45524]
2098 - [Improved `SliceExt::binary_search` performance.][45333]
2099 - [impl `FromIterator<()>` for `()`][45379]
2100 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2101   is now deprecated.
2102
2103 Stabilized APIs
2104 ---------------
2105
2106 Cargo
2107 -----
2108 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2109   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2110 - [Added unit test checking to `cargo check`][cargo/4592]
2111 - [Cargo now lets you install a specific version
2112   using `cargo install --version`][cargo/4637]
2113
2114 Misc
2115 ----
2116 - [Releases now ship with the Cargo book documentation.][45692]
2117 - [rustdoc now prints rendering warnings on every run.][45324]
2118
2119 Compatibility Notes
2120 -------------------
2121 - [Changes have been made to type equality to make it more correct,
2122   in rare cases this could break some code.][45853] [Tracking issue for
2123   further information][45852]
2124 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2125 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2126   Android 9, the minimum supported version is Android 14.
2127 - [Bumped the minimum LLVM to 3.9][45326]
2128
2129 [44042]: https://github.com/rust-lang/rust/pull/44042
2130 [44932]: https://github.com/rust-lang/rust/pull/44932
2131 [45267]: https://github.com/rust-lang/rust/pull/45267
2132 [45324]: https://github.com/rust-lang/rust/pull/45324
2133 [45326]: https://github.com/rust-lang/rust/pull/45326
2134 [45333]: https://github.com/rust-lang/rust/pull/45333
2135 [45379]: https://github.com/rust-lang/rust/pull/45379
2136 [45380]: https://github.com/rust-lang/rust/pull/45380
2137 [45393]: https://github.com/rust-lang/rust/pull/45393
2138 [45435]: https://github.com/rust-lang/rust/pull/45435
2139 [45483]: https://github.com/rust-lang/rust/pull/45483
2140 [45524]: https://github.com/rust-lang/rust/pull/45524
2141 [45571]: https://github.com/rust-lang/rust/pull/45571
2142 [45580]: https://github.com/rust-lang/rust/pull/45580
2143 [45610]: https://github.com/rust-lang/rust/pull/45610
2144 [45660]: https://github.com/rust-lang/rust/pull/45660
2145 [45692]: https://github.com/rust-lang/rust/pull/45692
2146 [45711]: https://github.com/rust-lang/rust/pull/45711
2147 [45772]: https://github.com/rust-lang/rust/pull/45772
2148 [45852]: https://github.com/rust-lang/rust/issues/45852
2149 [45853]: https://github.com/rust-lang/rust/pull/45853
2150 [45887]: https://github.com/rust-lang/rust/pull/45887
2151 [45920]: https://github.com/rust-lang/rust/pull/45920
2152 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2153 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2154 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2155
2156
2157 Version 1.22.1 (2017-11-22)
2158 ==========================
2159
2160 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2161
2162 [46183]: https://github.com/rust-lang/rust/pull/46183
2163
2164 Version 1.22.0 (2017-11-22)
2165 ==========================
2166
2167 Language
2168 --------
2169 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2170 - [Now accepts underscores in unicode escapes][43716]
2171 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2172 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2173
2174 Compiler
2175 --------
2176 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2177 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2178   This should decrease compile times for debug builds.
2179 - [strict memory alignment now enabled on ARMv6][45094]
2180 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2181
2182 Libraries
2183 ---------
2184 - [Allow atomic operations up to 32 bits
2185   on `armv5te_unknown_linux_gnueabi`][44978]
2186 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2187 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2188 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2189 - [Properly detect overflow in `Instant += Duration`.][44220]
2190 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2191 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2192 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2193
2194 Stabilized APIs
2195 ---------------
2196
2197 Cargo
2198 -----
2199 - [Cargo will now build multi file examples in subdirectories of the `examples`
2200   folder that have a `main.rs` file.][cargo/4496]
2201 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2202   the old format will continue to work and can be updated with `cargo update`.
2203 - [Now supports vendoring git repositories][cargo/3992]
2204
2205 Misc
2206 ----
2207 - [`libbacktrace` is now available on Apple platforms.][44251]
2208 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2209   This now lets you specify that a given code example will fail to compile.
2210
2211 Compatibility Notes
2212 -------------------
2213 - [The minimum Android version that rustc can build for has been bumped
2214   to `4.0` from `2.3`][45656]
2215 - [Allowing `T op= &T` for numeric types has broken some type
2216   inference cases][45480]
2217
2218
2219 [42526]: https://github.com/rust-lang/rust/pull/42526
2220 [43017]: https://github.com/rust-lang/rust/pull/43017
2221 [43716]: https://github.com/rust-lang/rust/pull/43716
2222 [43949]: https://github.com/rust-lang/rust/pull/43949
2223 [44015]: https://github.com/rust-lang/rust/pull/44015
2224 [44220]: https://github.com/rust-lang/rust/pull/44220
2225 [44251]: https://github.com/rust-lang/rust/pull/44251
2226 [44287]: https://github.com/rust-lang/rust/pull/44287
2227 [44303]: https://github.com/rust-lang/rust/pull/44303
2228 [44456]: https://github.com/rust-lang/rust/pull/44456
2229 [44466]: https://github.com/rust-lang/rust/pull/44466
2230 [44895]: https://github.com/rust-lang/rust/pull/44895
2231 [44966]: https://github.com/rust-lang/rust/pull/44966
2232 [44978]: https://github.com/rust-lang/rust/pull/44978
2233 [45041]: https://github.com/rust-lang/rust/pull/45041
2234 [45064]: https://github.com/rust-lang/rust/pull/45064
2235 [45075]: https://github.com/rust-lang/rust/pull/45075
2236 [45094]: https://github.com/rust-lang/rust/pull/45094
2237 [45095]: https://github.com/rust-lang/rust/pull/45095
2238 [45480]: https://github.com/rust-lang/rust/issues/45480
2239 [45656]: https://github.com/rust-lang/rust/pull/45656
2240 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2241 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2242 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2243
2244
2245
2246
2247
2248
2249 Version 1.21.0 (2017-10-12)
2250 ==========================
2251
2252 Language
2253 --------
2254 - [You can now use static references for literals.][43838]
2255   Example:
2256   ```rust
2257   fn main() {
2258       let x: &'static u32 = &0;
2259   }
2260   ```
2261 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2262   Example:
2263   ```rust
2264   my_macro!(Vec<i32>::new); // Always worked
2265   my_macro!(Vec::<i32>::new); // Now works
2266   ```
2267
2268 Compiler
2269 --------
2270 - [Upgraded jemalloc to 4.5.0][43911]
2271 - [Enabled unwinding panics on Redox][43917]
2272 - [Now runs LLVM in parallel during translation phase.][43506]
2273   This should reduce peak memory usage.
2274
2275 Libraries
2276 ---------
2277 - [Generate builtin impls for `Clone` for all arrays and tuples that
2278   are `T: Clone`][43690]
2279 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2280 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2281   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2282
2283 Stabilized APIs
2284 ---------------
2285
2286 [`std::mem::discriminant`]
2287
2288 Cargo
2289 -----
2290 - [You can now call `cargo install` with multiple package names][cargo/4216]
2291 - [Cargo commands inside a virtual workspace will now implicitly
2292   pass `--all`][cargo/4335]
2293 - [Added a `[patch]` section to `Cargo.toml` to handle
2294   prepublication dependencies][cargo/4123] [RFC 1969]
2295 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2296   like patterns][cargo/4270]
2297 - [Added the `--all-targets` option][cargo/4400]
2298 - [Using required dependencies as a feature is now deprecated and emits
2299   a warning][cargo/4364]
2300
2301
2302 Misc
2303 ----
2304 - [Cargo docs are moving][43916]
2305   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2306 - [The rustdoc book is now available][43863]
2307   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2308 - [Added a preview of RLS has been made available through rustup][44204]
2309   Install with `rustup component add rls-preview`
2310 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2311   Previously only showed `std::os::unix`.
2312
2313 Compatibility Notes
2314 -------------------
2315 - [Changes in method matching against higher-ranked types][43880] This may cause
2316   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2317 - [rustc's JSON error output's byte position start at top of file.][42973]
2318   Was previously relative to the rustc's internal `CodeMap` struct which
2319   required the unstable library `libsyntax` to correctly use.
2320 - [`unused_results` lint no longer ignores booleans][43728]
2321
2322 [42565]: https://github.com/rust-lang/rust/pull/42565
2323 [42973]: https://github.com/rust-lang/rust/pull/42973
2324 [43348]: https://github.com/rust-lang/rust/pull/43348
2325 [43459]: https://github.com/rust-lang/rust/pull/43459
2326 [43506]: https://github.com/rust-lang/rust/pull/43506
2327 [43540]: https://github.com/rust-lang/rust/pull/43540
2328 [43690]: https://github.com/rust-lang/rust/pull/43690
2329 [43728]: https://github.com/rust-lang/rust/pull/43728
2330 [43838]: https://github.com/rust-lang/rust/pull/43838
2331 [43863]: https://github.com/rust-lang/rust/pull/43863
2332 [43880]: https://github.com/rust-lang/rust/pull/43880
2333 [43911]: https://github.com/rust-lang/rust/pull/43911
2334 [43916]: https://github.com/rust-lang/rust/pull/43916
2335 [43917]: https://github.com/rust-lang/rust/pull/43917
2336 [44204]: https://github.com/rust-lang/rust/pull/44204
2337 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2338 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2339 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2340 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2341 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2342 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2343 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2344 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2345 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2346
2347 Version 1.20.0 (2017-08-31)
2348 ===========================
2349
2350 Language
2351 --------
2352 - [Associated constants are now stabilised.][42809]
2353 - [A lot of macro bugs are now fixed.][42913]
2354
2355 Compiler
2356 --------
2357
2358 - [Struct fields are now properly coerced to the expected field type.][42807]
2359 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2360   `wasm32-experimental-emscripten` target.
2361 - [Changed some of the error messages to be more helpful.][42033]
2362 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2363   it.][43170]
2364 - [rustc now reports the total number of errors on compilation failure][43015]
2365   previously this was only the number of errors in the pass that failed.
2366 - [Expansion in rustc has been sped up 29x.][42533]
2367 - [added `msp430-none-elf` target.][43099]
2368 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2369   applicable][43178]
2370 - [Fixes backtraces on Redox][43228]
2371 - [rustc now identifies different versions of same crate when absolute paths of
2372   different types match in an error message.][42826]
2373
2374 Libraries
2375 ---------
2376
2377
2378 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2379 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2380   tuples.][43011]
2381 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2382   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2383 - [Impl `Clone` for `DefaultHasher`.][42799]
2384 - [Impl `Sync` for `SyncSender`.][42397]
2385 - [Impl `FromStr` for `char`][42271]
2386 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2387   NaN.][42431]
2388 - [allow messages in the `unimplemented!()` macro.][42155]
2389   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2390 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2391 - [Upgrade to Unicode 10.0.0][42999]
2392 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2393 - [Skip the main thread's manual stack guard on Linux][43072]
2394 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2395 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2396   previously 2^15.
2397 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2398
2399 Stabilized APIs
2400 ---------------
2401
2402 - [`CStr::into_c_string`]
2403 - [`CString::as_c_str`]
2404 - [`CString::into_boxed_c_str`]
2405 - [`Chain::get_mut`]
2406 - [`Chain::get_ref`]
2407 - [`Chain::into_inner`]
2408 - [`Option::get_or_insert_with`]
2409 - [`Option::get_or_insert`]
2410 - [`OsStr::into_os_string`]
2411 - [`OsString::into_boxed_os_str`]
2412 - [`Take::get_mut`]
2413 - [`Take::get_ref`]
2414 - [`Utf8Error::error_len`]
2415 - [`char::EscapeDebug`]
2416 - [`char::escape_debug`]
2417 - [`compile_error!`]
2418 - [`f32::from_bits`]
2419 - [`f32::to_bits`]
2420 - [`f64::from_bits`]
2421 - [`f64::to_bits`]
2422 - [`mem::ManuallyDrop`]
2423 - [`slice::sort_unstable_by_key`]
2424 - [`slice::sort_unstable_by`]
2425 - [`slice::sort_unstable`]
2426 - [`str::from_boxed_utf8_unchecked`]
2427 - [`str::as_bytes_mut`]
2428 - [`str::as_bytes_mut`]
2429 - [`str::from_utf8_mut`]
2430 - [`str::from_utf8_unchecked_mut`]
2431 - [`str::get_mut`]
2432 - [`str::get_unchecked_mut`]
2433 - [`str::get_unchecked`]
2434 - [`str::get`]
2435 - [`str::into_boxed_bytes`]
2436
2437
2438 Cargo
2439 -----
2440 - [Cargo API token location moved from `~/.cargo/config` to
2441   `~/.cargo/credentials`.][cargo/3978]
2442 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2443   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2444   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2445 - [You can now specify version of a binary when installed through
2446   `cargo install` using `--vers`.][cargo/4229]
2447 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2448   failure.][cargo/4248]
2449 - [Changed the convention around which file is the crate root.][cargo/4259]
2450 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2451   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2452
2453 Compatibility Notes
2454 -------------------
2455
2456 - [Functions with `'static` in their return types will now not be as usable as
2457   if they were using lifetime parameters instead.][42417]
2458 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2459   takes the sign of NaN into account where previously didn't.][42430]
2460
2461 [42033]: https://github.com/rust-lang/rust/pull/42033
2462 [42155]: https://github.com/rust-lang/rust/pull/42155
2463 [42271]: https://github.com/rust-lang/rust/pull/42271
2464 [42397]: https://github.com/rust-lang/rust/pull/42397
2465 [42417]: https://github.com/rust-lang/rust/pull/42417
2466 [42430]: https://github.com/rust-lang/rust/pull/42430
2467 [42431]: https://github.com/rust-lang/rust/pull/42431
2468 [42533]: https://github.com/rust-lang/rust/pull/42533
2469 [42571]: https://github.com/rust-lang/rust/pull/42571
2470 [42613]: https://github.com/rust-lang/rust/pull/42613
2471 [42799]: https://github.com/rust-lang/rust/pull/42799
2472 [42807]: https://github.com/rust-lang/rust/pull/42807
2473 [42809]: https://github.com/rust-lang/rust/pull/42809
2474 [42822]: https://github.com/rust-lang/rust/pull/42822
2475 [42826]: https://github.com/rust-lang/rust/pull/42826
2476 [42854]: https://github.com/rust-lang/rust/pull/42854
2477 [42913]: https://github.com/rust-lang/rust/pull/42913
2478 [42999]: https://github.com/rust-lang/rust/pull/42999
2479 [43011]: https://github.com/rust-lang/rust/pull/43011
2480 [43015]: https://github.com/rust-lang/rust/pull/43015
2481 [43072]: https://github.com/rust-lang/rust/pull/43072
2482 [43077]: https://github.com/rust-lang/rust/pull/43077
2483 [43097]: https://github.com/rust-lang/rust/pull/43097
2484 [43099]: https://github.com/rust-lang/rust/pull/43099
2485 [43170]: https://github.com/rust-lang/rust/pull/43170
2486 [43178]: https://github.com/rust-lang/rust/pull/43178
2487 [43185]: https://github.com/rust-lang/rust/pull/43185
2488 [43228]: https://github.com/rust-lang/rust/pull/43228
2489 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2490 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2491 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2492 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2493 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2494 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2495 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2496 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2497 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2498 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2499 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2500 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2501 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2502 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2503 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2504 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2505 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2506 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2507 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2508 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2509 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2510 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2511 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2512 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2513 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2514 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2515 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2516 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2517 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2518 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2519 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2520 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2521 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2522 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2523 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2524 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2525 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2526 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2527 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2528
2529
2530 Version 1.19.0 (2017-07-20)
2531 ===========================
2532
2533 Language
2534 --------
2535
2536 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2537   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2538 - [Macro recursion limit increased to 1024 from 64.][41676]
2539 - [Added lint for detecting unused macros.][41907]
2540 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2541   For example: `let x = loop { break 7; };`
2542 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2543   contain `Copy` types and cannot have a `Drop` implementation.
2544   Example: `union Foo { bar: u8, baz: usize }`
2545 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2546   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2547
2548 Compiler
2549 --------
2550
2551 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2552 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2553   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2554   you should use `--target armv7-linux-androideabi`.
2555 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2556 - [Minor optimisation of string operations.][42037]
2557 - [Compiler error message is now `aborting due to previous error(s)` instead of
2558   `aborting due to N previous errors`][42150] This was previously inaccurate and
2559   would only count certain kinds of errors.
2560 - [The compiler now supports Visual Studio 2017][42225]
2561 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2562 - [Added a lot][42264] of [new error codes][42302]
2563 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2564   libraries with C Run-time Libraries(CRT) to be statically linked.
2565 - [Fixed various ARM codegen bugs][42740]
2566
2567 Libraries
2568 ---------
2569
2570 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2571   `Extend<Cow<'a, str>>`][41449]
2572 - [`Vec` now implements `From<&mut [T]>`][41530]
2573 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2574 - [`SplitWhitespace` now implements `Clone`][41659]
2575 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2576   1.5x faster][41764]
2577 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2578   macros, but for printing to stderr.
2579
2580 Stabilized APIs
2581 ---------------
2582
2583 - [`OsString::shrink_to_fit`]
2584 - [`cmp::Reverse`]
2585 - [`Command::envs`]
2586 - [`thread::ThreadId`]
2587
2588 Cargo
2589 -----
2590
2591 - [Build scripts can now add environment variables to the environment
2592   the crate is being compiled in.
2593   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2594 - [Subcommands now replace the current process rather than spawning a new
2595   child process][cargo/3970]
2596 - [Workspace members can now accept glob file patterns][cargo/3979]
2597 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2598   the members in a given workspace.][cargo/3988]
2599 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2600 - [Target directory path is now in the cargo metadata][cargo/4022]
2601 - [Cargo no longer checks out a local working directory for the
2602   crates.io index][cargo/4026] This should provide smaller file size for the
2603   registry, and improve cloning times, especially on Windows machines.
2604 - [Added an `--exclude` option for excluding certain packages when using the
2605   `--all` option][cargo/4031]
2606 - [Cargo will now automatically retry when receiving a 5xx error
2607   from crates.io][cargo/4032]
2608 - [The `--features` option now accepts multiple comma or space
2609   delimited values.][cargo/4084]
2610 - [Added support for custom target specific runners][cargo/3954]
2611
2612 Misc
2613 ----
2614
2615 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2616   Windows Debugger.
2617 - [Rust will now release XZ compressed packages][rust-installer/57]
2618 - [rustup will now prefer to download rust packages with
2619   XZ compression][rustup/1100] over GZip packages.
2620 - [Added the ability to escape `#` in rust documentation][41785] By adding
2621   additional `#`'s ie. `##` is now `#`
2622
2623 Compatibility Notes
2624 -------------------
2625
2626 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2627 - [`-Z` flags are now no longer allowed to be used on the stable
2628   compiler.][41751] This has been a warning for a year previous to this.
2629 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2630   longer works][42844]. Users should migrate to the built-in `check`
2631   command, which has been available since 1.16.
2632 - [Ending a float literal with `._` is now a hard error.
2633   Example: `42._` .][41946]
2634 - [Any use of a private `extern crate` outside of its module is now a
2635   hard error.][36886] This was previously a warning.
2636 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2637   relative while the `::` prefix makes a path absolute, but was ignored and the
2638   path was relative regardless.
2639 - [Floating point constants in match patterns is now a hard error][36890]
2640   This was previously a warning.
2641 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2642   match patterns is now a hard error][36891] This was previously a warning.
2643 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2644   a warning.
2645 - [From the pound escape, lines consisting of multiple `#`s are
2646   now visible][41785]
2647 - [It is an error to re-export private enum variants][42460]. This is
2648   known to break a number of crates that depend on an older version of
2649   mustache.
2650 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2651   to use it to find the linker, and the build will fail where it did
2652   not previously][42607]
2653
2654 [36886]: https://github.com/rust-lang/rust/issues/36886
2655 [36888]: https://github.com/rust-lang/rust/issues/36888
2656 [36890]: https://github.com/rust-lang/rust/issues/36890
2657 [36891]: https://github.com/rust-lang/rust/issues/36891
2658 [36892]: https://github.com/rust-lang/rust/issues/36892
2659 [37406]: https://github.com/rust-lang/rust/issues/37406
2660 [39983]: https://github.com/rust-lang/rust/pull/39983
2661 [41145]: https://github.com/rust-lang/rust/pull/41145
2662 [41192]: https://github.com/rust-lang/rust/pull/41192
2663 [41258]: https://github.com/rust-lang/rust/pull/41258
2664 [41370]: https://github.com/rust-lang/rust/pull/41370
2665 [41449]: https://github.com/rust-lang/rust/pull/41449
2666 [41530]: https://github.com/rust-lang/rust/pull/41530
2667 [41624]: https://github.com/rust-lang/rust/pull/41624
2668 [41656]: https://github.com/rust-lang/rust/pull/41656
2669 [41659]: https://github.com/rust-lang/rust/pull/41659
2670 [41676]: https://github.com/rust-lang/rust/pull/41676
2671 [41751]: https://github.com/rust-lang/rust/pull/41751
2672 [41764]: https://github.com/rust-lang/rust/pull/41764
2673 [41785]: https://github.com/rust-lang/rust/pull/41785
2674 [41873]: https://github.com/rust-lang/rust/pull/41873
2675 [41907]: https://github.com/rust-lang/rust/pull/41907
2676 [41946]: https://github.com/rust-lang/rust/pull/41946
2677 [42016]: https://github.com/rust-lang/rust/pull/42016
2678 [42037]: https://github.com/rust-lang/rust/pull/42037
2679 [42068]: https://github.com/rust-lang/rust/pull/42068
2680 [42150]: https://github.com/rust-lang/rust/pull/42150
2681 [42162]: https://github.com/rust-lang/rust/pull/42162
2682 [42225]: https://github.com/rust-lang/rust/pull/42225
2683 [42264]: https://github.com/rust-lang/rust/pull/42264
2684 [42302]: https://github.com/rust-lang/rust/pull/42302
2685 [42460]: https://github.com/rust-lang/rust/issues/42460
2686 [42607]: https://github.com/rust-lang/rust/issues/42607
2687 [42740]: https://github.com/rust-lang/rust/pull/42740
2688 [42844]: https://github.com/rust-lang/rust/issues/42844
2689 [42948]: https://github.com/rust-lang/rust/pull/42948
2690 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2691 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2692 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2693 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2694 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2695 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2696 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2697 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2698 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2699 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2700 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2701 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2702 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2703 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2704 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2705 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2706 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2707 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2708 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2709 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2710 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2711 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2712
2713
2714 Version 1.18.0 (2017-06-08)
2715 ===========================
2716
2717 Language
2718 --------
2719
2720 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2721   make the item visible to just that module tree. Also accepts the keyword
2722   `crate` to make something public to the whole crate but not users of the
2723   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2724 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2725   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2726 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2727   types like `Write + Send`, trailing `+` are now supported in trait objects,
2728   and better error reporting for trait objects starting with `?Sized`.
2729 - [0e+10 is now a valid floating point literal][40589]
2730 - [Now warns if you bind a lifetime parameter to 'static][40734]
2731 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2732   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2733   representation in some cases.][40377]
2734
2735 Compiler
2736 --------
2737
2738 - [rustc can now emit mir with `--emit mir`][39891]
2739 - [Improved LLVM IR for trivial functions][40367]
2740 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2741 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2742   opportunities found through profiling
2743 - [Improved backtrace formatting when panicking][38165]
2744
2745 Libraries
2746 ---------
2747
2748 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2749   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2750   iteration or reallocation.
2751 - [Simplified HashMap Bucket interface][40561] provides performance
2752   improvements for iterating and cloning.
2753 - [Specialize Vec::from_elem to use calloc][40409]
2754 - [Fixed Race condition in fs::create_dir_all][39799]
2755 - [No longer caching stdio on Windows][40516]
2756 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2757   2.50%~ faster and in one case now 12.50% faster.
2758 - [Optimized `AtomicBool::fetch_nand`][41143]
2759
2760 Stabilized APIs
2761 ---------------
2762
2763 - [`Child::try_wait`]
2764 - [`HashMap::retain`]
2765 - [`HashSet::retain`]
2766 - [`PeekMut::pop`]
2767 - [`TcpStream::peek`]
2768 - [`UdpSocket::peek`]
2769 - [`UdpSocket::peek_from`]
2770
2771 Cargo
2772 -----
2773
2774 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
2775   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
2776 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
2777 - [Added Android build support][cargo/3885]
2778 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
2779   of a certain type, for example `cargo build --bins` will build all
2780   binaries.
2781 - [Added support for haiku][cargo/3952]
2782
2783 Misc
2784 ----
2785
2786 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
2787 - [Added rust-windbg script for better debugging on Windows][39983]
2788 - [Rust now uses the official cross compiler for NetBSD][40612]
2789 - [rustdoc now accepts `#` at the start of files][40828]
2790 - [Fixed jemalloc support for musl][41168]
2791
2792 Compatibility Notes
2793 -------------------
2794
2795 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
2796   always placed after the sign if it exists and before the digits. With the `#`
2797   flag the zeroes are placed after the prefix and before the digits.
2798 - [Due to the struct field optimisation][40377], using `transmute` on structs
2799   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
2800   always been undefined behavior, but is now more likely to break in practice.
2801 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
2802   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
2803   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
2804 - [Overlapping inherent `impl`s are now a hard error][40728]
2805 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
2806 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
2807   `out.asm` and `out.ll` instead of only one of the filetypes.
2808 - [ calling a function that returns `Self` will no longer work][41805] when
2809   the size of `Self` cannot be statically determined.
2810 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
2811   this has caused a few regressions namely:
2812
2813   - Changed the link order of local static/dynamic libraries (respecting the
2814     order on given rather than having the compiler reorder).
2815   - Changed how MinGW is linked, native code linked to dynamic libraries
2816     may require manually linking to the gcc support library (for the native
2817     code itself)
2818
2819 [38165]: https://github.com/rust-lang/rust/pull/38165
2820 [39799]: https://github.com/rust-lang/rust/pull/39799
2821 [39891]: https://github.com/rust-lang/rust/pull/39891
2822 [39983]: https://github.com/rust-lang/rust/pull/39983
2823 [40043]: https://github.com/rust-lang/rust/pull/40043
2824 [40241]: https://github.com/rust-lang/rust/pull/40241
2825 [40338]: https://github.com/rust-lang/rust/pull/40338
2826 [40367]: https://github.com/rust-lang/rust/pull/40367
2827 [40377]: https://github.com/rust-lang/rust/pull/40377
2828 [40409]: https://github.com/rust-lang/rust/pull/40409
2829 [40516]: https://github.com/rust-lang/rust/pull/40516
2830 [40556]: https://github.com/rust-lang/rust/pull/40556
2831 [40561]: https://github.com/rust-lang/rust/pull/40561
2832 [40589]: https://github.com/rust-lang/rust/pull/40589
2833 [40612]: https://github.com/rust-lang/rust/pull/40612
2834 [40723]: https://github.com/rust-lang/rust/pull/40723
2835 [40728]: https://github.com/rust-lang/rust/pull/40728
2836 [40731]: https://github.com/rust-lang/rust/pull/40731
2837 [40734]: https://github.com/rust-lang/rust/pull/40734
2838 [40805]: https://github.com/rust-lang/rust/pull/40805
2839 [40807]: https://github.com/rust-lang/rust/pull/40807
2840 [40828]: https://github.com/rust-lang/rust/pull/40828
2841 [40870]: https://github.com/rust-lang/rust/pull/40870
2842 [41085]: https://github.com/rust-lang/rust/pull/41085
2843 [41143]: https://github.com/rust-lang/rust/pull/41143
2844 [41168]: https://github.com/rust-lang/rust/pull/41168
2845 [41270]: https://github.com/rust-lang/rust/issues/41270
2846 [41469]: https://github.com/rust-lang/rust/pull/41469
2847 [41805]: https://github.com/rust-lang/rust/issues/41805
2848 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
2849 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
2850 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
2851 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
2852 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
2853 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
2854 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
2855 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
2856 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
2857 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
2858 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
2859 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
2860 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
2861 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
2862
2863
2864 Version 1.17.0 (2017-04-27)
2865 ===========================
2866
2867 Language
2868 --------
2869
2870 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
2871 * [Fields of structs may be initialized without duplicating the field/variable
2872   names][39761]. [RFC 1682]
2873 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
2874 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2875   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
2876   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
2877   `'b`. Soundness fix.
2878 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
2879 * [Static variables may contain references to other statics][40027]
2880
2881 Compiler
2882 --------
2883
2884 * [Exit quickly on only `--emit dep-info`][40336]
2885 * [Make `-C relocation-model` more correctly determine whether the linker
2886   creates a position-independent executable][40245]
2887 * [Add `-C overflow-checks` to directly control whether integer overflow
2888   panics][40037]
2889 * [The rustc type checker now checks items on demand instead of in a single
2890   in-order pass][40008]. This is mostly an internal refactoring in support of
2891   future work, including incremental type checking, but also resolves [RFC
2892   1647], allowing `Self` to appear in `impl` `where` clauses.
2893 * [Optimize vtable loads][39995]
2894 * [Turn off vectorization for Emscripten targets][39990]
2895 * [Provide suggestions for unknown macros imported with `use`][39953]
2896 * [Fix ICEs in path resolution][39939]
2897 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
2898 * [Add clearer error message using `&str + &str`][39116]
2899
2900 Stabilized APIs
2901 ---------------
2902
2903 * [`Arc::into_raw`]
2904 * [`Arc::from_raw`]
2905 * [`Arc::ptr_eq`]
2906 * [`Rc::into_raw`]
2907 * [`Rc::from_raw`]
2908 * [`Rc::ptr_eq`]
2909 * [`Ordering::then`]
2910 * [`Ordering::then_with`]
2911 * [`BTreeMap::range`]
2912 * [`BTreeMap::range_mut`]
2913 * [`collections::Bound`]
2914 * [`process::abort`]
2915 * [`ptr::read_unaligned`]
2916 * [`ptr::write_unaligned`]
2917 * [`Result::expect_err`]
2918 * [`Cell::swap`]
2919 * [`Cell::replace`]
2920 * [`Cell::into_inner`]
2921 * [`Cell::take`]
2922
2923 Libraries
2924 ---------
2925
2926 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
2927 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
2928 * [`String` implements `FromIterator<&char>`][40028]
2929 * `Box` [implements][40009] a number of new conversions:
2930   `From<Box<str>> for String`,
2931   `From<Box<[T]>> for Vec<T>`,
2932   `From<Box<CStr>> for CString`,
2933   `From<Box<OsStr>> for OsString`,
2934   `From<Box<Path>> for PathBuf`,
2935   `Into<Box<str>> for String`,
2936   `Into<Box<[T]>> for Vec<T>`,
2937   `Into<Box<CStr>> for CString`,
2938   `Into<Box<OsStr>> for OsString`,
2939   `Into<Box<Path>> for PathBuf`,
2940   `Default for Box<str>`,
2941   `Default for Box<CStr>`,
2942   `Default for Box<OsStr>`,
2943   `From<&CStr> for Box<CStr>`,
2944   `From<&OsStr> for Box<OsStr>`,
2945   `From<&Path> for Box<Path>`
2946 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2947 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2948 * [Slightly optimize `slice::sort`][39538]
2949 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2950 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2951   `Box<str>` implements `From<&str>`][39438]
2952 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2953   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2954 * [`format!` estimates the needed capacity before writing a string][39356]
2955 * [Support unprivileged symlink creation in Windows][38921]
2956 * [`PathBuf` implements `Default`][38764]
2957 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2958 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2959   and poor hash functions.
2960
2961 Cargo
2962 -----
2963
2964 * [Add `cargo check --all`][cargo/3731]
2965 * [Add an option to ignore SSL revocation checking][cargo/3699]
2966 * [Add `cargo run --package`][cargo/3691]
2967 * [Add `required_features`][cargo/3667]
2968 * [Assume `build.rs` is a build script][cargo/3664]
2969 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2970
2971 Misc
2972 ----
2973
2974 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2975   `rustbook`][39633]
2976 * [The "Unstable Book" documents nightly-only features][ubook]
2977 * [Improve the style of the sidebar in rustdoc output][40265]
2978 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2979 * [Fix MSP430 breakage due to `i128`][40257]
2980 * [Preliminary Solaris/SPARCv9 support][39903]
2981 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2982   run without installing the MSVC runtime.
2983 * [`rustdoc --test` includes file names in test names][39788]
2984 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2985   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2986 * [Initial support for `aarch64-unknown-freebsd`][39491]
2987 * [Initial support for `i686-unknown-netbsd`][39426]
2988 * [This release no longer includes the old makefile build system][39431]. Rust
2989   is built with a custom build system, written in Rust, and with Cargo.
2990 * [Add Debug implementations for libcollection structs][39002]
2991 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2992 * [`--test-threads=0` produces an error][38945]
2993 * [`rustup` installs documentation by default][40526]
2994 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2995   WinDbg and Visual Studio to improve the debugging experience.
2996
2997 Compatibility Notes
2998 -------------------
2999
3000 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3001   workaround, either use MSVC 2015 or run vcvars.bat.
3002 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3003   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3004   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3005   fix.
3006 * [`format!` and `Display::to_string` panic if an underlying formatting
3007   implementation returns an error][40117]. Previously the error was silently
3008   ignored. It is incorrect for `write_fmt` to return an error when writing
3009   to a string.
3010 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3011   crates were marked stable and could be accessed from the stable toolchain.
3012 * [Rust git source no longer includes vendored crates][39728]. Those that need
3013   to build with vendored crates should build from release tarballs.
3014 * [Fix inert attributes from `proc_macro_derives`][39572]
3015 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3016   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3017   build system.
3018 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3019   existing code generally ignores the type of dead-code unless a type-hint is
3020   provided; this can cause surprising inference interactions particularly around
3021   defaulting. The new code uniformly ignores the result type of dead-code.
3022 * [Tuple-struct constructors with private fields are no longer visible][38932]
3023 * [Lifetime parameters that do not appear in the arguments are now considered
3024   early-bound][38897], resolving a soundness bug (#[32330]). The
3025   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3026   April of 2016.
3027 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3028 * [Make transmuting from fn item types to pointer-sized types a hard
3029   error][34198]
3030
3031 [27787]: https://github.com/rust-lang/rust/issues/27787
3032 [32330]: https://github.com/rust-lang/rust/issues/32330
3033 [34198]: https://github.com/rust-lang/rust/pull/34198
3034 [38161]: https://github.com/rust-lang/rust/pull/38161
3035 [38368]: https://github.com/rust-lang/rust/pull/38368
3036 [38584]: https://github.com/rust-lang/rust/issues/38584
3037 [38661]: https://github.com/rust-lang/rust/pull/38661
3038 [38764]: https://github.com/rust-lang/rust/pull/38764
3039 [38864]: https://github.com/rust-lang/rust/issues/38864
3040 [38897]: https://github.com/rust-lang/rust/pull/38897
3041 [38921]: https://github.com/rust-lang/rust/pull/38921
3042 [38932]: https://github.com/rust-lang/rust/pull/38932
3043 [38945]: https://github.com/rust-lang/rust/pull/38945
3044 [38981]: https://github.com/rust-lang/rust/pull/38981
3045 [39002]: https://github.com/rust-lang/rust/pull/39002
3046 [39116]: https://github.com/rust-lang/rust/pull/39116
3047 [39193]: https://github.com/rust-lang/rust/pull/39193
3048 [39265]: https://github.com/rust-lang/rust/pull/39265
3049 [39356]: https://github.com/rust-lang/rust/pull/39356
3050 [39372]: https://github.com/rust-lang/rust/pull/39372
3051 [39426]: https://github.com/rust-lang/rust/pull/39426
3052 [39431]: https://github.com/rust-lang/rust/pull/39431
3053 [39438]: https://github.com/rust-lang/rust/pull/39438
3054 [39440]: https://github.com/rust-lang/rust/pull/39440
3055 [39485]: https://github.com/rust-lang/rust/pull/39485
3056 [39491]: https://github.com/rust-lang/rust/pull/39491
3057 [39518]: https://github.com/rust-lang/rust/pull/39518
3058 [39538]: https://github.com/rust-lang/rust/pull/39538
3059 [39572]: https://github.com/rust-lang/rust/pull/39572
3060 [39633]: https://github.com/rust-lang/rust/pull/39633
3061 [39642]: https://github.com/rust-lang/rust/pull/39642
3062 [39728]: https://github.com/rust-lang/rust/pull/39728
3063 [39761]: https://github.com/rust-lang/rust/pull/39761
3064 [39788]: https://github.com/rust-lang/rust/pull/39788
3065 [39793]: https://github.com/rust-lang/rust/pull/39793
3066 [39837]: https://github.com/rust-lang/rust/pull/39837
3067 [39843]: https://github.com/rust-lang/rust/pull/39843
3068 [39851]: https://github.com/rust-lang/rust/pull/39851
3069 [39903]: https://github.com/rust-lang/rust/pull/39903
3070 [39939]: https://github.com/rust-lang/rust/pull/39939
3071 [39953]: https://github.com/rust-lang/rust/pull/39953
3072 [39960]: https://github.com/rust-lang/rust/pull/39960
3073 [39990]: https://github.com/rust-lang/rust/pull/39990
3074 [39995]: https://github.com/rust-lang/rust/pull/39995
3075 [40008]: https://github.com/rust-lang/rust/pull/40008
3076 [40009]: https://github.com/rust-lang/rust/pull/40009
3077 [40027]: https://github.com/rust-lang/rust/pull/40027
3078 [40028]: https://github.com/rust-lang/rust/pull/40028
3079 [40037]: https://github.com/rust-lang/rust/pull/40037
3080 [40117]: https://github.com/rust-lang/rust/pull/40117
3081 [40166]: https://github.com/rust-lang/rust/pull/40166
3082 [40245]: https://github.com/rust-lang/rust/pull/40245
3083 [40257]: https://github.com/rust-lang/rust/pull/40257
3084 [40261]: https://github.com/rust-lang/rust/pull/40261
3085 [40265]: https://github.com/rust-lang/rust/pull/40265
3086 [40319]: https://github.com/rust-lang/rust/pull/40319
3087 [40336]: https://github.com/rust-lang/rust/pull/40336
3088 [40526]: https://github.com/rust-lang/rust/pull/40526
3089 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3090 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3091 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3092 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3093 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3094 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3095 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3096 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3097 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3098 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3099 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3100 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3101 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3102 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3103 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3104 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3105 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3106 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3107 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3108 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3109 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3110 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3111 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3112 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3113 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3114 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3115 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3116 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3117 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3118 [mdbook]: https://crates.io/crates/mdbook
3119 [ubook]: https://doc.rust-lang.org/unstable-book/
3120
3121
3122 Version 1.16.0 (2017-03-16)
3123 ===========================
3124
3125 Language
3126 --------
3127
3128 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3129 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3130   match patterns][38069]
3131 * [Clean up semantics of `self` in an import list][38313]
3132 * [`Self` may appear in `impl` headers][38920]
3133 * [`Self` may appear in struct expressions][39282]
3134
3135 Compiler
3136 --------
3137
3138 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3139   a `.rmeta` file containing only crate metadata][38571]. This can be
3140   used by tools like the Rust Language Service to perform
3141   metadata-only builds.
3142 * [Levenshtein based typo suggestions now work in most places, while
3143   previously they worked only for fields and sometimes for local
3144   variables][38927]. Together with the overhaul of "no
3145   resolution"/"unexpected resolution" errors (#[38154]) they result in
3146   large and systematic improvement in resolution diagnostics.
3147 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3148   `U`][38670]
3149 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3150 * [`rustc` no longer attempts to provide "consider using an explicit
3151   lifetime" suggestions][37057]. They were inaccurate.
3152
3153 Stabilized APIs
3154 ---------------
3155
3156 * [`VecDeque::truncate`]
3157 * [`VecDeque::resize`]
3158 * [`String::insert_str`]
3159 * [`Duration::checked_add`]
3160 * [`Duration::checked_sub`]
3161 * [`Duration::checked_div`]
3162 * [`Duration::checked_mul`]
3163 * [`str::replacen`]
3164 * [`str::repeat`]
3165 * [`SocketAddr::is_ipv4`]
3166 * [`SocketAddr::is_ipv6`]
3167 * [`IpAddr::is_ipv4`]
3168 * [`IpAddr::is_ipv6`]
3169 * [`Vec::dedup_by`]
3170 * [`Vec::dedup_by_key`]
3171 * [`Result::unwrap_or_default`]
3172 * [`<*const T>::wrapping_offset`]
3173 * [`<*mut T>::wrapping_offset`]
3174 * `CommandExt::creation_flags`
3175 * [`File::set_permissions`]
3176 * [`String::split_off`]
3177
3178 Libraries
3179 ---------
3180
3181 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3182   their argument by `Borrow` parameter][37761]
3183 * [All public types in std implement `Debug`][38006]
3184 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3185 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3186 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3187   Windows][38274]
3188 * [std: Fix partial writes in `LineWriter`][38062]
3189 * [std: Clamp max read/write sizes on Unix][38062]
3190 * [Use more specific panic message for `&str` slicing errors][38066]
3191 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3192   functionality cannot be achieved in std currently.
3193 * [`writeln!`, like `println!`, now accepts a form with no string
3194   or formatting arguments, to just print a newline][38469]
3195 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3196 * [Reduce the size of static data in `std_unicode::tables`][38781]
3197 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3198   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3199   `Display`][38909]
3200 * [`Duration` implements `Sum`][38712]
3201 * [`String` implements `ToSocketAddrs`][39048]
3202
3203 Cargo
3204 -----
3205
3206 * [The `cargo check` command does a type check of a project without
3207   building it][cargo/3296]
3208 * [crates.io will display CI badges from Travis and AppVeyor, if
3209   specified in Cargo.toml][cargo/3546]
3210 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3211 * [Compilation profiles accept integer values for `debug`, in addition
3212   to `true` and `false`. These are passed to `rustc` as the value to
3213   `-C debuginfo`][cargo/3534]
3214 * [Implement `cargo --version --verbose`][cargo/3604]
3215 * [All builds now output 'dep-info' build dependencies compatible with
3216   make and ninja][cargo/3557]
3217 * [Build all workspace members with `build --all`][cargo/3511]
3218 * [Document all workspace members with `doc --all`][cargo/3515]
3219 * [Path deps outside workspace are not members][cargo/3443]
3220
3221 Misc
3222 ----
3223
3224 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3225   the path to the Rust implementation][38589]
3226 * [The `armv7-linux-androideabi` target no longer enables NEON
3227   extensions, per Google's ABI guide][38413]
3228 * [The stock standard library can be compiled for Redox OS][38401]
3229 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3230   available.
3231 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3232   builds available.
3233 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3234
3235 Compatibility Notes
3236 -------------------
3237
3238 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3239   match patterns][38069]
3240 * In this release, references to uninhabited types can not be
3241   pattern-matched. This was accidentally allowed in 1.15.
3242 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3243 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3244   Windows][38274]
3245 * [Clean up semantics of `self` in an import list][38313]
3246 * Reimplemented lifetime elision. This change was almost entirely compatible
3247   with existing code, but it did close a number of small bugs and loopholes,
3248   as well as being more accepting in some other [cases][41105].
3249
3250 [37057]: https://github.com/rust-lang/rust/pull/37057
3251 [37761]: https://github.com/rust-lang/rust/pull/37761
3252 [38006]: https://github.com/rust-lang/rust/pull/38006
3253 [38051]: https://github.com/rust-lang/rust/pull/38051
3254 [38062]: https://github.com/rust-lang/rust/pull/38062
3255 [38062]: https://github.com/rust-lang/rust/pull/38622
3256 [38066]: https://github.com/rust-lang/rust/pull/38066
3257 [38069]: https://github.com/rust-lang/rust/pull/38069
3258 [38131]: https://github.com/rust-lang/rust/pull/38131
3259 [38154]: https://github.com/rust-lang/rust/pull/38154
3260 [38274]: https://github.com/rust-lang/rust/pull/38274
3261 [38304]: https://github.com/rust-lang/rust/pull/38304
3262 [38313]: https://github.com/rust-lang/rust/pull/38313
3263 [38314]: https://github.com/rust-lang/rust/pull/38314
3264 [38327]: https://github.com/rust-lang/rust/pull/38327
3265 [38401]: https://github.com/rust-lang/rust/pull/38401
3266 [38413]: https://github.com/rust-lang/rust/pull/38413
3267 [38469]: https://github.com/rust-lang/rust/pull/38469
3268 [38559]: https://github.com/rust-lang/rust/pull/38559
3269 [38571]: https://github.com/rust-lang/rust/pull/38571
3270 [38580]: https://github.com/rust-lang/rust/pull/38580
3271 [38589]: https://github.com/rust-lang/rust/pull/38589
3272 [38670]: https://github.com/rust-lang/rust/pull/38670
3273 [38712]: https://github.com/rust-lang/rust/pull/38712
3274 [38726]: https://github.com/rust-lang/rust/pull/38726
3275 [38781]: https://github.com/rust-lang/rust/pull/38781
3276 [38798]: https://github.com/rust-lang/rust/pull/38798
3277 [38909]: https://github.com/rust-lang/rust/pull/38909
3278 [38920]: https://github.com/rust-lang/rust/pull/38920
3279 [38927]: https://github.com/rust-lang/rust/pull/38927
3280 [39048]: https://github.com/rust-lang/rust/pull/39048
3281 [39282]: https://github.com/rust-lang/rust/pull/39282
3282 [39379]: https://github.com/rust-lang/rust/pull/39379
3283 [41105]: https://github.com/rust-lang/rust/issues/41105
3284 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3285 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3286 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3287 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3288 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3289 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3290 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3291 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3292 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3293 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3294 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3295 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3296 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3297 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3298 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3299 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3300 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3301 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3302 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3303 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3304 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3305 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3306 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3307 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3308 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3309 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3310 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3311 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3312 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3313 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3314
3315
3316 Version 1.15.1 (2017-02-09)
3317 ===========================
3318
3319 * [Fix IntoIter::as_mut_slice's signature][39466]
3320 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3321
3322 [39466]: https://github.com/rust-lang/rust/pull/39466
3323 [39523]: https://github.com/rust-lang/rust/pull/39523
3324
3325
3326 Version 1.15.0 (2017-02-02)
3327 ===========================
3328
3329 Language
3330 --------
3331
3332 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3333   stable. This allows popular code-generating crates like Serde and Diesel to
3334   work ergonomically. [RFC 1681].
3335 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3336   with curly braces][36868]. Part of [RFC 1506].
3337 * [A number of minor changes to name resolution have been activated][37127].
3338   They add up to more consistent semantics, allowing for future evolution of
3339   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3340   details of what is different. The breaking changes here have been transitioned
3341   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3342 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3343   bounds][38279]
3344 * [`?Sized` can be used in `where` clauses][37791]
3345 * [There is now a limit on the size of monomorphized types and it can be
3346   modified with the `#![type_size_limit]` crate attribute, similarly to
3347   the `#![recursion_limit]` attribute][37789]
3348
3349 Compiler
3350 --------
3351
3352 * [On Windows, the compiler will apply dllimport attributes when linking to
3353   extern functions][37973]. Additional attributes and flags can control which
3354   library kind is linked and its name. [RFC 1717].
3355 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3356 * [The `--test` flag works with procedural macro crates][38107]
3357 * [Fix `extern "aapcs" fn` ABI][37814]
3358 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3359 * [The `format!` expander recognizes incorrect `printf` and shell-style
3360   formatting directives and suggests the correct format][37613].
3361 * [Only report one error for all unused imports in an import list][37456]
3362
3363 Compiler Performance
3364 --------------------
3365
3366 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3367 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3368 * [Don't clone in `UnificationTable::probe`][37848]
3369 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3370 * [Use small vectors in type walker][37760]
3371 * [Macro expansion performance was improved][37701]
3372 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3373 * [Replace FNV with a faster hash function][37229]
3374
3375 Stabilized APIs
3376 ---------------
3377
3378 * [`std::iter::Iterator::min_by`]
3379 * [`std::iter::Iterator::max_by`]
3380 * [`std::os::*::fs::FileExt`]
3381 * [`std::sync::atomic::Atomic*::get_mut`]
3382 * [`std::sync::atomic::Atomic*::into_inner`]
3383 * [`std::vec::IntoIter::as_slice`]
3384 * [`std::vec::IntoIter::as_mut_slice`]
3385 * [`std::sync::mpsc::Receiver::try_iter`]
3386 * [`std::os::unix::process::CommandExt::before_exec`]
3387 * [`std::rc::Rc::strong_count`]
3388 * [`std::rc::Rc::weak_count`]
3389 * [`std::sync::Arc::strong_count`]
3390 * [`std::sync::Arc::weak_count`]
3391 * [`std::char::encode_utf8`]
3392 * [`std::char::encode_utf16`]
3393 * [`std::cell::Ref::clone`]
3394 * [`std::io::Take::into_inner`]
3395
3396 Libraries
3397 ---------
3398
3399 * [The standard sorting algorithm has been rewritten for dramatic performance
3400   improvements][38192]. It is a hybrid merge sort, drawing influences from
3401   Timsort. Previously it was a naive merge sort.
3402 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3403 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3404   performance.
3405 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3406   and `char_indices().last()`][37882]
3407 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3408 * [Chinese characters display correctly in `fmt::Debug`][37855]
3409 * [Derive `Default` for `Duration`][37699]
3410 * [Support creation of anonymous pipes on WinXP/2k][37677]
3411 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3412 * [Don't pass overlapped handles to processes][38835]
3413
3414 Cargo
3415 -----
3416
3417 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3418   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3419   should instead check the variable at runtime with `std::env`. That the value
3420   was set at build time was a bug, and incorrect when cross-compiling. This
3421   change is known to cause breakage.
3422 * [Add `--all` flag to `cargo test`][cargo/3221]
3423 * [Compile statically against the MSVC CRT][cargo/3363]
3424 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3425 * [Link OpenSSL statically on OSX][cargo/3311]
3426 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3427 * [Test for bad path overrides with summaries][cargo/3336]
3428 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3429 * [Fix retrying crate downloads for network errors][cargo/3348]
3430 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3431 * [Emit more info on --message-format=json][cargo/3319]
3432 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3433 * [Don't ignore errors in workspace manifest][cargo/3409]
3434 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3435
3436 Tooling
3437 -------
3438
3439 * [Test runners (binaries built with `--test`) now support a `--list` argument
3440   that lists the tests it contains][38185]
3441 * [Test runners now support a `--exact` argument that makes the test filter
3442   match exactly, instead of matching only a substring of the test name][38181]
3443 * [rustdoc supports a `--playground-url` flag][37763]
3444 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3445
3446 Misc
3447 ----
3448
3449 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3450   continue to be used in this release by passing `--disable-rustbuild` to the
3451   configure script, but they will be deleted soon. Note that the new build
3452   system uses a different on-disk layout that will likely affect any scripts
3453   building Rust.
3454 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3455   releases.
3456 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3457 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3458   releases.
3459
3460 Compatibility Notes
3461 -------------------
3462
3463 * [A number of minor changes to name resolution have been activated][37127].
3464   They add up to more consistent semantics, allowing for future evolution of
3465   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3466   details of what is different. The breaking changes here have been transitioned
3467   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3468 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3469   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3470   should instead check the variable at runtime with `std::env`. That the value
3471   was set at build time was a bug, and incorrect when cross-compiling. This
3472   change is known to cause breakage.
3473 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3474   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3475   1.10 and is now an error by default. It will become a hard error in the near
3476   future.
3477 * [The semantics relating modules to file system directories are changing in
3478   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3479   lint, which is a warning in this release, and will become a hard error in the
3480   future.
3481 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3482 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3483   the underlying iterator][37834]
3484
3485 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3486 [33685]: https://github.com/rust-lang/rust/issues/33685
3487 [36868]: https://github.com/rust-lang/rust/pull/36868
3488 [37127]: https://github.com/rust-lang/rust/pull/37127
3489 [37229]: https://github.com/rust-lang/rust/pull/37229
3490 [37456]: https://github.com/rust-lang/rust/pull/37456
3491 [37527]: https://github.com/rust-lang/rust/pull/37527
3492 [37602]: https://github.com/rust-lang/rust/pull/37602
3493 [37613]: https://github.com/rust-lang/rust/pull/37613
3494 [37615]: https://github.com/rust-lang/rust/pull/37615
3495 [37636]: https://github.com/rust-lang/rust/pull/37636
3496 [37627]: https://github.com/rust-lang/rust/pull/37627
3497 [37642]: https://github.com/rust-lang/rust/pull/37642
3498 [37677]: https://github.com/rust-lang/rust/pull/37677
3499 [37699]: https://github.com/rust-lang/rust/pull/37699
3500 [37701]: https://github.com/rust-lang/rust/pull/37701
3501 [37705]: https://github.com/rust-lang/rust/pull/37705
3502 [37749]: https://github.com/rust-lang/rust/pull/37749
3503 [37760]: https://github.com/rust-lang/rust/pull/37760
3504 [37763]: https://github.com/rust-lang/rust/pull/37763
3505 [37764]: https://github.com/rust-lang/rust/pull/37764
3506 [37789]: https://github.com/rust-lang/rust/pull/37789
3507 [37791]: https://github.com/rust-lang/rust/pull/37791
3508 [37814]: https://github.com/rust-lang/rust/pull/37814
3509 [37817]: https://github.com/rust-lang/rust/pull/37817
3510 [37834]: https://github.com/rust-lang/rust/pull/37834
3511 [37848]: https://github.com/rust-lang/rust/pull/37848
3512 [37855]: https://github.com/rust-lang/rust/pull/37855
3513 [37882]: https://github.com/rust-lang/rust/pull/37882
3514 [37888]: https://github.com/rust-lang/rust/pull/37888
3515 [37973]: https://github.com/rust-lang/rust/pull/37973
3516 [37979]: https://github.com/rust-lang/rust/pull/37979
3517 [38086]: https://github.com/rust-lang/rust/pull/38086
3518 [38107]: https://github.com/rust-lang/rust/pull/38107
3519 [38117]: https://github.com/rust-lang/rust/pull/38117
3520 [38134]: https://github.com/rust-lang/rust/pull/38134
3521 [38146]: https://github.com/rust-lang/rust/pull/38146
3522 [38181]: https://github.com/rust-lang/rust/pull/38181
3523 [38182]: https://github.com/rust-lang/rust/pull/38182
3524 [38185]: https://github.com/rust-lang/rust/pull/38185
3525 [38192]: https://github.com/rust-lang/rust/pull/38192
3526 [38279]: https://github.com/rust-lang/rust/pull/38279
3527 [38835]: https://github.com/rust-lang/rust/pull/38835
3528 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3529 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3530 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3531 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3532 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3533 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3534 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3535 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3536 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3537 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3538 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3539 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3540 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3541 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3542 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3543 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3544 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3545 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3546 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3547 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3548 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3549 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3550 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3551 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3552 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3553 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3554 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3555 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3556 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3557 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3558 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3559 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3560 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3561 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3562 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3563 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3564 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3565 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3566
3567
3568 Version 1.14.0 (2016-12-22)
3569 ===========================
3570
3571 Language
3572 --------
3573
3574 * [`..` matches multiple tuple fields in enum variants, structs
3575   and tuples][36843]. [RFC 1492].
3576 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3577 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3578 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3579   dereferencing][36822]
3580
3581 Compiler
3582 --------
3583
3584 * [Mark enums with non-zero discriminant as non-zero][37224]
3585 * [Lower-case `static mut` names are linted like other
3586   statics and consts][37162]
3587 * [Fix ICE on some macros in const integer positions
3588    (e.g. `[u8; m!()]`)][36819]
3589 * [Improve error message and snippet for "did you mean `x`"][36798]
3590 * [Add a panic-strategy field to the target specification][36794]
3591 * [Include LLVM version in `--version --verbose`][37200]
3592
3593 Compile-time Optimizations
3594 --------------------------
3595
3596 * [Improve macro expansion performance][37569]
3597 * [Shrink `Expr_::ExprInlineAsm`][37445]
3598 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3599 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3600 * [Avoid more allocations when compiling html5ever][37373]
3601 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3602 * [Avoid some allocations in the macro parser][37318]
3603 * [Use a faster deflate setting][37298]
3604 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3605   during interning of slices][37270]
3606 * [Optimize `write_metadata`][37267]
3607 * [Don't process obligation forest cycles when stalled][37231]
3608 * [Avoid many `CrateConfig` clones][37161]
3609 * [Optimize `Substs::super_fold_with`][37108]
3610 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3611 * [Speed up `plug_leaks`][36917]
3612
3613 Libraries
3614 ---------
3615
3616 * [`println!()`, with no arguments, prints newline][36825].
3617   Previously, an empty string was required to achieve the same.
3618 * [`Wrapping` impls standard binary and unary operators, as well as
3619    the `Sum` and `Product` iterators][37356]
3620 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3621   Vec<T>`][37326]
3622 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3623   `VecDeque` iterators][37315]
3624 * [Improve `SipHasher` performance on small values][37312]
3625 * [Add Iterator trait TrustedLen to enable better FromIterator /
3626   Extend][37306]
3627 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3628 * [`ReadDir` implements `Debug`][37221]
3629 * [Implement `RefUnwindSafe` for atomic types][37178]
3630 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3631 * [Avoid allocations in `Decoder::read_str`][37064]
3632 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3633 * [Impl `Debug` for raw pointers to unsized data][36880]
3634 * [Don't reuse `HashMap` random seeds][37470]
3635 * [The internal memory layout of `HashMap` is more cache-friendly, for
3636   significant improvements in some operations][36692]
3637 * [`HashMap` uses less memory on 32-bit architectures][36595]
3638 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3639
3640 Cargo
3641 -----
3642
3643 * [Expose rustc cfg values to build scripts][cargo/3243]
3644 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3645 * [Fix passing --features when testing multiple packages][cargo/3280]
3646 * [Use a single profile set per workspace][cargo/3249]
3647 * [Load `replace` sections from lock files][cargo/3220]
3648 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3649
3650 Tooling
3651 -------
3652
3653 * [rustup is the recommended Rust installation method][1.14rustup]
3654 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3655   S390x. These are [tier 2] platforms and may have major defects. Follow the
3656   instructions on the website to install, or add the targets to an existing
3657   installation with `rustup target add`. The new target triples are:
3658   - `mips-unknown-linux-gnu`
3659   - `mipsel-unknown-linux-gnu`
3660   - `mips64-unknown-linux-gnuabi64`
3661   - `mips64el-unknown-linux-gnuabi64 `
3662   - `powerpc-unknown-linux-gnu`
3663   - `powerpc64-unknown-linux-gnu`
3664   - `powerpc64le-unknown-linux-gnu`
3665   - `s390x-unknown-linux-gnu `
3666 * This release includes target (std) builds for ARM Linux running MUSL
3667   libc. These are [tier 2] platforms and may have major defects. Add the
3668   following triples to an existing rustup installation with `rustup target add`:
3669   - `arm-unknown-linux-musleabi`
3670   - `arm-unknown-linux-musleabihf`
3671   - `armv7-unknown-linux-musleabihf`
3672 * This release includes [experimental support for WebAssembly][1.14wasm], via
3673   the `wasm32-unknown-emscripten` target. This target is known to have major
3674   defects. Please test, report, and fix.
3675 * rustup no longer installs documentation by default. Run `rustup
3676   component add rust-docs` to install.
3677 * [Fix line stepping in debugger][37310]
3678 * [Enable line number debuginfo in releases][37280]
3679
3680 Misc
3681 ----
3682
3683 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3684 * [Add support for Fuchsia OS][37313]
3685 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3686
3687 Compatibility Notes
3688 -------------------
3689
3690 * [A number of forward-compatibility lints used by the compiler
3691   to gradually introduce language changes have been converted
3692   to deny by default][36894]:
3693   - ["use of inaccessible extern crate erroneously allowed"][36886]
3694   - ["type parameter default erroneously allowed in invalid location"][36887]
3695   - ["detects super or self keywords at the beginning of global path"][36888]
3696   - ["two overlapping inherent impls define an item with the same name
3697     were erroneously allowed"][36889]
3698   - ["floating-point constants cannot be used in patterns"][36890]
3699   - ["constants of struct or enum type can only be used in a pattern if
3700      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3701   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3702 * [Prohibit patterns in trait methods without bodies][37378]
3703 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3704 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3705 * [The `$crate` macro variable is accepted in fewer locations][37213]
3706 * [Impls specifying extra region requirements beyond the trait
3707   they implement are rejected][37167]
3708 * [Enums may not be unsized][37111]. Unsized enums are intended to
3709   work but never have. For now they are forbidden.
3710 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3711
3712 [tier 2]: https://forge.rust-lang.org/platform-support.html
3713 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3714 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3715 [36430]: https://github.com/rust-lang/rust/pull/36430
3716 [36595]: https://github.com/rust-lang/rust/pull/36595
3717 [36595]: https://github.com/rust-lang/rust/pull/36595
3718 [36692]: https://github.com/rust-lang/rust/pull/36692
3719 [36767]: https://github.com/rust-lang/rust/pull/36767
3720 [36794]: https://github.com/rust-lang/rust/pull/36794
3721 [36798]: https://github.com/rust-lang/rust/pull/36798
3722 [36819]: https://github.com/rust-lang/rust/pull/36819
3723 [36822]: https://github.com/rust-lang/rust/pull/36822
3724 [36825]: https://github.com/rust-lang/rust/pull/36825
3725 [36843]: https://github.com/rust-lang/rust/pull/36843
3726 [36880]: https://github.com/rust-lang/rust/pull/36880
3727 [36886]: https://github.com/rust-lang/rust/issues/36886
3728 [36887]: https://github.com/rust-lang/rust/issues/36887
3729 [36888]: https://github.com/rust-lang/rust/issues/36888
3730 [36889]: https://github.com/rust-lang/rust/issues/36889
3731 [36890]: https://github.com/rust-lang/rust/issues/36890
3732 [36891]: https://github.com/rust-lang/rust/issues/36891
3733 [36892]: https://github.com/rust-lang/rust/issues/36892
3734 [36894]: https://github.com/rust-lang/rust/pull/36894
3735 [36917]: https://github.com/rust-lang/rust/pull/36917
3736 [36993]: https://github.com/rust-lang/rust/pull/36993
3737 [37037]: https://github.com/rust-lang/rust/pull/37037
3738 [37064]: https://github.com/rust-lang/rust/pull/37064
3739 [37094]: https://github.com/rust-lang/rust/pull/37094
3740 [37108]: https://github.com/rust-lang/rust/pull/37108
3741 [37111]: https://github.com/rust-lang/rust/pull/37111
3742 [37161]: https://github.com/rust-lang/rust/pull/37161
3743 [37162]: https://github.com/rust-lang/rust/pull/37162
3744 [37167]: https://github.com/rust-lang/rust/pull/37167
3745 [37178]: https://github.com/rust-lang/rust/pull/37178
3746 [37200]: https://github.com/rust-lang/rust/pull/37200
3747 [37213]: https://github.com/rust-lang/rust/pull/37213
3748 [37221]: https://github.com/rust-lang/rust/pull/37221
3749 [37224]: https://github.com/rust-lang/rust/pull/37224
3750 [37230]: https://github.com/rust-lang/rust/pull/37230
3751 [37231]: https://github.com/rust-lang/rust/pull/37231
3752 [37247]: https://github.com/rust-lang/rust/pull/37247
3753 [37267]: https://github.com/rust-lang/rust/pull/37267
3754 [37270]: https://github.com/rust-lang/rust/pull/37270
3755 [37273]: https://github.com/rust-lang/rust/pull/37273
3756 [37280]: https://github.com/rust-lang/rust/pull/37280
3757 [37298]: https://github.com/rust-lang/rust/pull/37298
3758 [37306]: https://github.com/rust-lang/rust/pull/37306
3759 [37310]: https://github.com/rust-lang/rust/pull/37310
3760 [37312]: https://github.com/rust-lang/rust/pull/37312
3761 [37313]: https://github.com/rust-lang/rust/pull/37313
3762 [37315]: https://github.com/rust-lang/rust/pull/37315
3763 [37318]: https://github.com/rust-lang/rust/pull/37318
3764 [37322]: https://github.com/rust-lang/rust/pull/37322
3765 [37326]: https://github.com/rust-lang/rust/pull/37326
3766 [37351]: https://github.com/rust-lang/rust/pull/37351
3767 [37356]: https://github.com/rust-lang/rust/pull/37356
3768 [37367]: https://github.com/rust-lang/rust/pull/37367
3769 [37373]: https://github.com/rust-lang/rust/pull/37373
3770 [37378]: https://github.com/rust-lang/rust/pull/37378
3771 [37389]: https://github.com/rust-lang/rust/pull/37389
3772 [37392]: https://github.com/rust-lang/rust/pull/37392
3773 [37427]: https://github.com/rust-lang/rust/pull/37427
3774 [37439]: https://github.com/rust-lang/rust/pull/37439
3775 [37445]: https://github.com/rust-lang/rust/pull/37445
3776 [37470]: https://github.com/rust-lang/rust/pull/37470
3777 [37569]: https://github.com/rust-lang/rust/pull/37569
3778 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3779 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
3780 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
3781 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
3782 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
3783 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
3784 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
3785
3786
3787 Version 1.13.0 (2016-11-10)
3788 ===========================
3789
3790 Language
3791 --------
3792
3793 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
3794   errors, like the `try!` macro, described in [RFC 0243].
3795 * [Stabilize macros in type position][36014]. Described in [RFC 873].
3796 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
3797 * [Fix `#[derive]` for empty tuple structs/variants][35728]
3798 * [Fix lifetime rules for 'if' conditions][36029]
3799 * [Avoid loading and parsing unconfigured non-inline modules][36482]
3800
3801 Compiler
3802 --------
3803
3804 * [Add the `-C link-arg` argument][36574]
3805 * [Remove the old AST-based backend from rustc_trans][35764]
3806 * [Don't enable NEON by default on armv7 Linux][35814]
3807 * [Fix debug line number info for macro expansions][35238]
3808 * [Do not emit "class method" debuginfo for types that are not
3809   DICompositeType][36008]
3810 * [Warn about multiple conflicting #[repr] hints][34623]
3811 * [When sizing DST, don't double-count nested struct prefixes][36351]
3812 * [Default RUST_MIN_STACK to 16MiB for now][36505]
3813 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
3814 * [Reject macros with empty repetitions to avoid infinite loop][36721]
3815 * [Expand macros without recursing to avoid stack overflows][36214]
3816
3817 Diagnostics
3818 -----------
3819
3820 * [Replace macro backtraces with labeled local uses][35702]
3821 * [Improve error message for misplaced doc comments][33922]
3822 * [Buffer unix and lock windows to prevent message interleaving][35975]
3823 * [Update lifetime errors to specifically note temporaries][36171]
3824 * [Special case a few colors for Windows][36178]
3825 * [Suggest `use self` when such an import resolves][36289]
3826 * [Be more specific when type parameter shadows primitive type][36338]
3827 * Many minor improvements
3828
3829 Compile-time Optimizations
3830 --------------------------
3831
3832 * [Compute and cache HIR hashes at beginning][35854]
3833 * [Don't hash types in loan paths][36004]
3834 * [Cache projections in trans][35761]
3835 * [Optimize the parser's last token handling][36527]
3836 * [Only instantiate #[inline] functions in codegen units referencing
3837   them][36524]. This leads to big improvements in cases where crates export
3838   define many inline functions without using them directly.
3839 * [Lazily allocate TypedArena's first chunk][36592]
3840 * [Don't allocate during default HashSet creation][36734]
3841
3842 Stabilized APIs
3843 ---------------
3844
3845 * [`checked_abs`]
3846 * [`wrapping_abs`]
3847 * [`overflowing_abs`]
3848 * [`RefCell::try_borrow`]
3849 * [`RefCell::try_borrow_mut`]
3850
3851 Libraries
3852 ---------
3853
3854 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
3855 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
3856   covariant][35354]
3857 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
3858 * [Implement `Debug` for `std::vec::IntoIter`][35707]
3859 * [`CString`: avoid excessive growth just to 0-terminate][35871]
3860 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
3861 * [Use arc4rand on FreeBSD][35884]
3862 * [memrchr: Correct aligned offset computation][35969]
3863 * [Improve Demangling of Rust Symbols][36059]
3864 * [Use monotonic time in condition variables][35048]
3865 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
3866 * [Implement conversion traits for `char`][35755]
3867 * [Fix illegal instruction caused by overflow in channel cloning][36104]
3868 * [Zero first byte of CString on drop][36264]
3869 * [Inherit overflow checks for sum and product][36372]
3870 * [Add missing Eq implementations][36423]
3871 * [Implement `Debug` for `DirEntry`][36631]
3872 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
3873   `errno`][36754]
3874 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3875 * [Implement more traits for `std::io::ErrorKind`][35911]
3876 * [Optimize BinaryHeap bounds checking][36072]
3877 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
3878   `extend_with_element`][36355]
3879 * [Fix overflow checking in unsigned pow()][34942]
3880
3881 Cargo
3882 -----
3883
3884 * This release includes security fixes to both curl and OpenSSL.
3885 * [Fix transitive doctests when panic=abort][cargo/3021]
3886 * [Add --all-features flag to cargo][cargo/3038]
3887 * [Reject path-based dependencies in `cargo package`][cargo/3060]
3888 * [Don't parse the home directory more than once][cargo/3078]
3889 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
3890 * [Update OpenSSL to 1.0.2j][cargo/3121]
3891 * [Add license and license_file to cargo metadata output][cargo/3110]
3892 * [Make crates-io registry URL optional in config; ignore all changes to
3893   source.crates-io][cargo/3089]
3894 * [Don't download dependencies from other platforms][cargo/3123]
3895 * [Build transitive dev-dependencies when needed][cargo/3125]
3896 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
3897 * [Avoid updating registry when adding existing deps][cargo/3144]
3898 * [Warn about path overrides that won't work][cargo/3136]
3899 * [Use workspaces during `cargo install`][cargo/3146]
3900 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
3901 * [Add --message-format flag][cargo/3000]
3902 * [Pass target environment for rustdoc][cargo/3205]
3903 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
3904 * [Update curl and curl-sys][cargo/3241]
3905 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
3906
3907 Tooling
3908 -------
3909
3910 * [rustdoc: Add the `--sysroot` argument][36586]
3911 * [rustdoc: Fix a couple of issues with the search results][35655]
3912 * [rustdoc: remove the `!` from macro URLs and titles][35234]
3913 * [gdb: Fix pretty-printing special-cased Rust types][35585]
3914 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
3915
3916 Misc
3917 ----
3918
3919 * [Remove unmaintained style guide][35124]
3920 * [Add s390x support][36369]
3921 * [Initial work at Haiku OS support][36727]
3922 * [Add mips-uclibc targets][35734]
3923 * [Crate-ify compiler-rt into compiler-builtins][35021]
3924 * [Add rustc version info (git hash + date) to dist tarball][36213]
3925 * Many documentation improvements
3926
3927 Compatibility Notes
3928 -------------------
3929
3930 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3931 * [Deny (by default) transmuting from fn item types to pointer-sized
3932   types][34923]. Continuing the long transition to zero-sized fn items,
3933   per [RFC 401].
3934 * [Fix `#[derive]` for empty tuple structs/variants][35728].
3935   Part of [RFC 1506].
3936 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3937 * [Fix lifetime rules for 'if' conditions][36029].
3938 * [Inherit overflow checks for sum and product][36372].
3939 * [Forbid user-defined macros named "macro_rules"][36730].
3940
3941 [33922]: https://github.com/rust-lang/rust/pull/33922
3942 [34623]: https://github.com/rust-lang/rust/pull/34623
3943 [34923]: https://github.com/rust-lang/rust/pull/34923
3944 [34942]: https://github.com/rust-lang/rust/pull/34942
3945 [34982]: https://github.com/rust-lang/rust/pull/34982
3946 [35021]: https://github.com/rust-lang/rust/pull/35021
3947 [35048]: https://github.com/rust-lang/rust/pull/35048
3948 [35074]: https://github.com/rust-lang/rust/pull/35074
3949 [35124]: https://github.com/rust-lang/rust/pull/35124
3950 [35234]: https://github.com/rust-lang/rust/pull/35234
3951 [35238]: https://github.com/rust-lang/rust/pull/35238
3952 [35354]: https://github.com/rust-lang/rust/pull/35354
3953 [35559]: https://github.com/rust-lang/rust/pull/35559
3954 [35585]: https://github.com/rust-lang/rust/pull/35585
3955 [35627]: https://github.com/rust-lang/rust/pull/35627
3956 [35655]: https://github.com/rust-lang/rust/pull/35655
3957 [35702]: https://github.com/rust-lang/rust/pull/35702
3958 [35707]: https://github.com/rust-lang/rust/pull/35707
3959 [35728]: https://github.com/rust-lang/rust/pull/35728
3960 [35734]: https://github.com/rust-lang/rust/pull/35734
3961 [35755]: https://github.com/rust-lang/rust/pull/35755
3962 [35761]: https://github.com/rust-lang/rust/pull/35761
3963 [35764]: https://github.com/rust-lang/rust/pull/35764
3964 [35814]: https://github.com/rust-lang/rust/pull/35814
3965 [35854]: https://github.com/rust-lang/rust/pull/35854
3966 [35871]: https://github.com/rust-lang/rust/pull/35871
3967 [35884]: https://github.com/rust-lang/rust/pull/35884
3968 [35911]: https://github.com/rust-lang/rust/pull/35911
3969 [35969]: https://github.com/rust-lang/rust/pull/35969
3970 [35975]: https://github.com/rust-lang/rust/pull/35975
3971 [36004]: https://github.com/rust-lang/rust/pull/36004
3972 [36008]: https://github.com/rust-lang/rust/pull/36008
3973 [36014]: https://github.com/rust-lang/rust/pull/36014
3974 [36029]: https://github.com/rust-lang/rust/pull/36029
3975 [36059]: https://github.com/rust-lang/rust/pull/36059
3976 [36072]: https://github.com/rust-lang/rust/pull/36072
3977 [36101]: https://github.com/rust-lang/rust/pull/36101
3978 [36104]: https://github.com/rust-lang/rust/pull/36104
3979 [36171]: https://github.com/rust-lang/rust/pull/36171
3980 [36173]: https://github.com/rust-lang/rust/pull/36173
3981 [36178]: https://github.com/rust-lang/rust/pull/36178
3982 [36213]: https://github.com/rust-lang/rust/pull/36213
3983 [36214]: https://github.com/rust-lang/rust/pull/36214
3984 [36264]: https://github.com/rust-lang/rust/pull/36264
3985 [36266]: https://github.com/rust-lang/rust/pull/36266
3986 [36289]: https://github.com/rust-lang/rust/pull/36289
3987 [36338]: https://github.com/rust-lang/rust/pull/36338
3988 [36351]: https://github.com/rust-lang/rust/pull/36351
3989 [36355]: https://github.com/rust-lang/rust/pull/36355
3990 [36369]: https://github.com/rust-lang/rust/pull/36369
3991 [36372]: https://github.com/rust-lang/rust/pull/36372
3992 [36423]: https://github.com/rust-lang/rust/pull/36423
3993 [36482]: https://github.com/rust-lang/rust/pull/36482
3994 [36505]: https://github.com/rust-lang/rust/pull/36505
3995 [36524]: https://github.com/rust-lang/rust/pull/36524
3996 [36527]: https://github.com/rust-lang/rust/pull/36527
3997 [36551]: https://github.com/rust-lang/rust/pull/36551
3998 [36574]: https://github.com/rust-lang/rust/pull/36574
3999 [36586]: https://github.com/rust-lang/rust/pull/36586
4000 [36592]: https://github.com/rust-lang/rust/pull/36592
4001 [36631]: https://github.com/rust-lang/rust/pull/36631
4002 [36639]: https://github.com/rust-lang/rust/pull/36639
4003 [36721]: https://github.com/rust-lang/rust/pull/36721
4004 [36727]: https://github.com/rust-lang/rust/pull/36727
4005 [36730]: https://github.com/rust-lang/rust/pull/36730
4006 [36734]: https://github.com/rust-lang/rust/pull/36734
4007 [36754]: https://github.com/rust-lang/rust/pull/36754
4008 [36995]: https://github.com/rust-lang/rust/pull/36995
4009 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4010 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4011 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4012 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4013 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4014 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4015 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4016 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4017 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4018 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4019 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4020 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4021 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4022 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4023 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4024 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4025 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4026 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4027 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4028 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4029 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4030 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4031 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4032 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4033 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4034 [rustup]: https://www.rustup.rs
4035 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4036 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4037 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4038 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4039 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4040 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4041 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4042
4043
4044 Version 1.12.1 (2016-10-20)
4045 ===========================
4046
4047 Regression Fixes
4048 ----------------
4049
4050 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4051 * [Confusion with double negation and booleans][36856]
4052 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4053 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4054 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4055 * [Corrupted memory after updated to 1.12][36936]
4056 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4057 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4058 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4059
4060 [36381]: https://github.com/rust-lang/rust/issues/36381
4061 [36856]: https://github.com/rust-lang/rust/issues/36856
4062 [36875]: https://github.com/rust-lang/rust/issues/36875
4063 [36924]: https://github.com/rust-lang/rust/issues/36924
4064 [36926]: https://github.com/rust-lang/rust/issues/36926
4065 [36936]: https://github.com/rust-lang/rust/issues/36936
4066 [37026]: https://github.com/rust-lang/rust/issues/37026
4067 [37112]: https://github.com/rust-lang/rust/issues/37112
4068 [37153]: https://github.com/rust-lang/rust/issues/37153
4069
4070
4071 Version 1.12.0 (2016-09-29)
4072 ===========================
4073
4074 Highlights
4075 ----------
4076
4077 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4078   This translation pass is far simpler than the previous AST->LLVM pass, and
4079   creates opportunities to perform new optimizations directly on the MIR. It
4080   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4081 * [`rustc` presents a new, more readable error format, along with
4082   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4083   Most common editors supporting Rust have been updated to work with it. It was
4084   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4085
4086 Compiler
4087 --------
4088
4089 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4090   This translation pass is far simpler than the previous AST->LLVM pass, and
4091   creates opportunities to perform new optimizations directly on the MIR. It
4092   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4093 * [Print the Rust target name, not the LLVM target name, with
4094   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4095 * [The computation of `TypeId` is correct in some cases where it was previously
4096   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4097 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4098 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4099   `--print relocation-models`, and `--print code-models` print the available
4100   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4101   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4102 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4103   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4104   These targets produce statically-linked binaries. There are no binary release
4105   builds yet though.
4106
4107 Diagnostics
4108 -----------
4109
4110 * [`rustc` presents a new, more readable error format, along with
4111   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4112   Most common editors supporting Rust have been updated to work with it. It was
4113   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4114 * [In error descriptions, references are now described in plain English,
4115   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4116 * [In error type descriptions, unknown numeric types are named `{integer}` or
4117   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4118 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4119
4120 Language
4121 --------
4122
4123 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4124 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4125 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4126   useful](https://github.com/rust-lang/rust/pull/34908)
4127 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4128   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4129 * [Semicolons are properly required as statement delimiters inside
4130   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4131 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4132
4133 Stabilized APIs
4134 ---------------
4135
4136 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4137 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4138 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4139 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4140 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4141 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4142 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4143 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4144 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4145 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4146   Both on Unix and Windows.
4147 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4148 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4149 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4150 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4151 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4152 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4153 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4154 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4155
4156 Libraries
4157 ---------
4158
4159 * [The `format!` macro and friends now allow a single argument to be formatted
4160   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4161 * [The lifetime bounds on `[T]::binary_search_by` and
4162   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4163 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4164 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4165 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4166 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4167 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4168 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4169 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4170 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4171   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4172 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4173   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4174 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4175 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4176   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4177 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4178 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4179 * [`mpsc::sync_channel` `Receiver`s return any available message before
4180   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4181 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4182 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4183
4184 Cargo
4185 -----
4186
4187 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4188 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4189 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4190 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4191 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4192 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4193 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4194 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4195 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4196 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4197 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4198 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4199 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4200 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4201 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4202 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4203
4204 Performance
4205 -----------
4206
4207 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4208 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4209
4210 Tooling
4211 -------
4212
4213 * [Test binaries now support a `--test-threads` argument to specify the number
4214   of threads used to run tests, and which acts the same as the
4215   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4216 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4217 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4218 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4219 * [Rust releases now come with source packages that can be installed by rustup
4220   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4221   The resulting source code can be used by tools and IDES, located in the
4222   sysroot under `lib/rustlib/src`.
4223
4224 Misc
4225 ----
4226
4227 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4228 * Many minor improvements to the documentation.
4229 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4230
4231 Compatibility Notes
4232 -------------------
4233
4234 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4235   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4236 * [When formatting strings, if "precision" is specified, the "fill",
4237   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4238 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4239
4240
4241 Version 1.11.0 (2016-08-18)
4242 ===========================
4243
4244 Language
4245 --------
4246
4247 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4248 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4249 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4250 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4251 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4252
4253 Stabilized APIs
4254 ---------------
4255
4256 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4257 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4258 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4259 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4260 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4261 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4262   (in libcore - previously stabilized in libstd)
4263 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4264   (in libcore - previously stabilized in libstd)
4265 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4266   (in libcore - previously stabilized in libstd)
4267 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4268   (in libcore - previously stabilized in libstd)
4269 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4270 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4271 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4272 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4273
4274 Libraries
4275 ---------
4276
4277 * [The `thread_local!` macro supports multiple definitions in a single
4278    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4279 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4280 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4281   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4282 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4283 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4284 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4285 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4286
4287 Cargo
4288 -----
4289
4290 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4291 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4292 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4293 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4294 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4295   and `-vv` prints warnings for all crates.
4296 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4297 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4298   This provides room for expansion by arbitrary tools.
4299 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4300 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4301 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4302 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4303 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4304 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4305 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4306
4307 Performance
4308 -----------
4309
4310 * [Caching projections speeds up type check dramatically for some
4311   workloads](https://github.com/rust-lang/rust/pull/33816)
4312 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4313   This hasher is faster, but is believed to provide sufficient
4314   protection from collision attacks.
4315 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4316
4317 Rustdoc
4318 -------
4319
4320 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4321 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4322 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4323 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4324 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4325
4326 Tooling
4327 -------
4328
4329 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4330 * [When emitting debug info, rustc emits frame pointers for closures,
4331   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4332 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4333 * Many more errors have been given error codes and extended
4334   explanations
4335 * API documentation continues to be improved, with many new examples
4336
4337 Misc
4338 ----
4339
4340 * [rustc no longer hangs when dependencies recursively re-export
4341   submodules](https://github.com/rust-lang/rust/pull/34542)
4342 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4343 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4344   rewritten](https://github.com/rust-lang/rust/pull/33895)
4345 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4346   No targets use this yet, but it works toward AVR support.
4347
4348 Compatibility Notes
4349 -------------------
4350
4351 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4352 * [The new follow-set rules that place restrictions on `macro_rules!`
4353   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4354   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4355   and has been a warning since 1.10.
4356 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4357   This causes breakage in some corner cases.
4358
4359
4360 Version 1.10.0 (2016-07-07)
4361 ===========================
4362
4363 Language
4364 --------
4365
4366 * [Allow `concat_idents!` in type positions as well as in expression
4367   positions](https://github.com/rust-lang/rust/pull/33735).
4368 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4369   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4370 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4371 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4372 * [`panic!` can be converted to a runtime abort with the
4373   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4374   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4375 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4376   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4377   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4378   Note that Cargo does not yet directly support cdylibs.
4379
4380 Stabilized APIs
4381 ---------------
4382
4383 * `os::windows::fs::OpenOptionsExt::access_mode`
4384 * `os::windows::fs::OpenOptionsExt::share_mode`
4385 * `os::windows::fs::OpenOptionsExt::custom_flags`
4386 * `os::windows::fs::OpenOptionsExt::attributes`
4387 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4388 * `os::unix::fs::OpenOptionsExt::custom_flags`
4389 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4390 * `Default for sync::Weak`
4391 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4392 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4393 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4394 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4395 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4396 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4397 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4398 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4399 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4400 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4401 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4402 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4403 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4404 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4405 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4406 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4407 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4408 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4409 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4410 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4411 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4412 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4413 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4414 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4415 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4416 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4417 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4418 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4419 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4420 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4421 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4422 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4423 * Read/Write/RawFd impls for `UnixStream`
4424 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4425 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4426 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4427 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4428 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4429 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4430 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4431 * RawFd impls for `UnixListener`
4432 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4433 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4434 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4435 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4436 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4437 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4438 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4439 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4440 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4441 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4442 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4443 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4444 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4445 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4446 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4447 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4448 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4449 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4450 * RawFd impls for `UnixDatagram`
4451 * `{BTree,Hash}Map::values_mut`
4452 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4453
4454 Libraries
4455 ---------
4456
4457 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4458   The semantics of this minor method are subtle and probably not what
4459   most people want.
4460 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4461 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4462   will fall back to `/dev/urandom` temporarily to avoid blocking
4463   during early boot](https://github.com/rust-lang/rust/pull/33086).
4464 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4465 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4466 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4467 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4468 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4469 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4470   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4471
4472 Cargo
4473 -----
4474 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4475   This controls the runtime behavior of the `panic!` macro
4476   and can be either "unwind" (the default), or "abort".
4477   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4478 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4479 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4480 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4481   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4482 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4483 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4484 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4485   By default they are retried twice, which can be customized with the
4486   `net.retry` value in `.cargo/config`.
4487 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4488 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4489 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4490 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4491   Makes it possible to install multiple crates in parallel.
4492 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4493 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4494 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4495 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4496 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4497 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4498
4499 Performance
4500 -----------
4501
4502 * [rustc memory usage was reduced by refactoring the context used for
4503   type checking](https://github.com/rust-lang/rust/pull/33425).
4504 * [Speed up creation of `HashMap`s by caching the random keys used
4505   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4506 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4507 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4508 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4509   10x faster than the previous lookup tables.
4510 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4511
4512 Usability
4513 ---------
4514
4515 * Many incremental improvements to documentation and rustdoc.
4516 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4517 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4518 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4519 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4520 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4521 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4522 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4523
4524 Misc
4525 ----
4526
4527 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4528 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4529 * [`std` no longer prints backtraces on platforms where the running
4530   module must be loaded with `env::current_exe`, which can't be relied
4531   on](https://github.com/rust-lang/rust/pull/33554).
4532 * This release includes std binaries for the i586-unknown-linux-gnu,
4533   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4534   i586 target is for old x86 hardware without SSE2, and the armv7
4535   target is for Android running on modern ARM architectures.
4536 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4537   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4538 * [On Unix the runtime aborts by calling `libc::abort` instead of
4539   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4540 * [Rust is now bootstrapped from the previous release of Rust,
4541   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4542
4543 Compatibility Notes
4544 -------------------
4545
4546 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4547 * [`target_env` for Linux ARM targets is just `gnu`, not
4548   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4549 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4550 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4551 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4552   Affects how macros are parsed.
4553 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4554 * [Feature-gated attributes on macro-generated macro invocations are
4555   now rejected](https://github.com/rust-lang/rust/pull/32791).
4556 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4557   This caused some minor changes to type inference.
4558
4559
4560 Version 1.9.0 (2016-05-26)
4561 ==========================
4562
4563 Language
4564 --------
4565
4566 * The `#[deprecated]` attribute when applied to an API will generate
4567   warnings when used. The warnings may be suppressed with
4568   `#[allow(deprecated)]`. [RFC 1270].
4569 * [`fn` item types are zero sized, and each `fn` names a unique
4570   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4571   `transmute` on a `fn` type will generate a warning for a few cycles,
4572   then will be converted to an error.
4573 * [Field and method resolution understand visibility, so private
4574   fields and methods cannot prevent the proper use of public fields
4575   and methods][1.9fv].
4576 * [The parser considers unicode codepoints in the
4577   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4578
4579 Stabilized APIs
4580 ---------------
4581
4582 * [`std::panic`]
4583 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4584 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4585 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4586 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4587 * [`str::is_char_boundary`]
4588 * [`<*const T>::as_ref`]
4589 * [`<*mut T>::as_ref`]
4590 * [`<*mut T>::as_mut`]
4591 * [`AsciiExt::make_ascii_uppercase`]
4592 * [`AsciiExt::make_ascii_lowercase`]
4593 * [`char::decode_utf16`]
4594 * [`char::DecodeUtf16`]
4595 * [`char::DecodeUtf16Error`]
4596 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4597 * [`BTreeSet::take`]
4598 * [`BTreeSet::replace`]
4599 * [`BTreeSet::get`]
4600 * [`HashSet::take`]
4601 * [`HashSet::replace`]
4602 * [`HashSet::get`]
4603 * [`OsString::with_capacity`]
4604 * [`OsString::clear`]
4605 * [`OsString::capacity`]
4606 * [`OsString::reserve`]
4607 * [`OsString::reserve_exact`]
4608 * [`OsStr::is_empty`]
4609 * [`OsStr::len`]
4610 * [`std::os::unix::thread`]
4611 * [`RawPthread`]
4612 * [`JoinHandleExt`]
4613 * [`JoinHandleExt::as_pthread_t`]
4614 * [`JoinHandleExt::into_pthread_t`]
4615 * [`HashSet::hasher`]
4616 * [`HashMap::hasher`]
4617 * [`CommandExt::exec`]
4618 * [`File::try_clone`]
4619 * [`SocketAddr::set_ip`]
4620 * [`SocketAddr::set_port`]
4621 * [`SocketAddrV4::set_ip`]
4622 * [`SocketAddrV4::set_port`]
4623 * [`SocketAddrV6::set_ip`]
4624 * [`SocketAddrV6::set_port`]
4625 * [`SocketAddrV6::set_flowinfo`]
4626 * [`SocketAddrV6::set_scope_id`]
4627 * [`slice::copy_from_slice`]
4628 * [`ptr::read_volatile`]
4629 * [`ptr::write_volatile`]
4630 * [`OpenOptions::create_new`]
4631 * [`TcpStream::set_nodelay`]
4632 * [`TcpStream::nodelay`]
4633 * [`TcpStream::set_ttl`]
4634 * [`TcpStream::ttl`]
4635 * [`TcpStream::set_only_v6`]
4636 * [`TcpStream::only_v6`]
4637 * [`TcpStream::take_error`]
4638 * [`TcpStream::set_nonblocking`]
4639 * [`TcpListener::set_ttl`]
4640 * [`TcpListener::ttl`]
4641 * [`TcpListener::set_only_v6`]
4642 * [`TcpListener::only_v6`]
4643 * [`TcpListener::take_error`]
4644 * [`TcpListener::set_nonblocking`]
4645 * [`UdpSocket::set_broadcast`]
4646 * [`UdpSocket::broadcast`]
4647 * [`UdpSocket::set_multicast_loop_v4`]
4648 * [`UdpSocket::multicast_loop_v4`]
4649 * [`UdpSocket::set_multicast_ttl_v4`]
4650 * [`UdpSocket::multicast_ttl_v4`]
4651 * [`UdpSocket::set_multicast_loop_v6`]
4652 * [`UdpSocket::multicast_loop_v6`]
4653 * [`UdpSocket::set_multicast_ttl_v6`]
4654 * [`UdpSocket::multicast_ttl_v6`]
4655 * [`UdpSocket::set_ttl`]
4656 * [`UdpSocket::ttl`]
4657 * [`UdpSocket::set_only_v6`]
4658 * [`UdpSocket::only_v6`]
4659 * [`UdpSocket::join_multicast_v4`]
4660 * [`UdpSocket::join_multicast_v6`]
4661 * [`UdpSocket::leave_multicast_v4`]
4662 * [`UdpSocket::leave_multicast_v6`]
4663 * [`UdpSocket::take_error`]
4664 * [`UdpSocket::connect`]
4665 * [`UdpSocket::send`]
4666 * [`UdpSocket::recv`]
4667 * [`UdpSocket::set_nonblocking`]
4668
4669 Libraries
4670 ---------
4671
4672 * [`std::sync::Once` is poisoned if its initialization function
4673   fails][1.9o].
4674 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4675 * [Most types implement `fmt::Debug`][1.9db].
4676 * [The default buffer size used by `BufReader` and `BufWriter` was
4677   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4678   used by other languages.
4679 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4680   `Duration` additionally implements `*=` and `/=`][1.9ta].
4681 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4682 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4683 * [`Chain` implements `BufRead`][1.9ch].
4684 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4685
4686 Cargo
4687 -----
4688
4689 * [Cargo can now run concurrently][1.9cc].
4690 * [Top-level overrides allow specific revisions of crates to be
4691   overridden through the entire crate graph][1.9ct].  This is intended
4692   to make upgrades easier for large projects, by allowing crates to be
4693   forked temporarily until they've been upgraded and republished.
4694 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4695 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4696   on the commandline][1.9cf]. `rustc` arguments can also be specified
4697   in the `build.rustflags` configuration key.
4698
4699 Performance
4700 -----------
4701
4702 * [The time complexity of comparing variables for equivalence during type
4703   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4704   to major compilation time improvement in some scenarios.
4705 * [`ToString` is specialized for `str`, giving it the same performance
4706   as `to_owned`][1.9ts].
4707 * [Spawning processes with `Command::output` no longer creates extra
4708   threads][1.9sp].
4709 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4710   for C-like enums][1.9cl].
4711
4712 Misc
4713 ----
4714
4715 * [Passing the `--quiet` flag to a test runner will produce
4716   much-abbreviated output][1.9q].
4717 * The Rust Project now publishes std binaries for the
4718   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4719   `i586-pc-windows-msvc` targets.
4720
4721 Compatibility Notes
4722 -------------------
4723
4724 * [`std::sync::Once` is poisoned if its initialization function
4725   fails][1.9o].
4726 * [It is illegal to define methods with the same name in overlapping
4727   inherent `impl` blocks][1.9sn].
4728 * [`fn` item types are zero sized, and each `fn` names a unique
4729   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4730   `transmute` on a `fn` type will generate a warning for a few cycles,
4731   then will be converted to an error.
4732 * [Improvements to const evaluation may trigger new errors when integer
4733   literals are out of range][1.9ce].
4734
4735
4736 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4737 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4738 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4739 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4740 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4741 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4742 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4743 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4744 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4745 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4746 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4747 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4748 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4749 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4750 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4751 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4752 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4753 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4754 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4755 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4756 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4757 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4758 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4759 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4760 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4761 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4762 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4763 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4764 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4765 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
4766 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
4767 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
4768 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
4769 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
4770 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
4771 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
4772 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
4773 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
4774 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
4775 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
4776 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
4777 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
4778 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
4779 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
4780 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
4781 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
4782 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
4783 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
4784 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
4785 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
4786 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
4787 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
4788 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
4789 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
4790 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
4791 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
4792 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
4793 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
4794 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
4795 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
4796 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4797 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4798 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4799 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4800 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4801 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4802 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
4803 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4804 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
4805 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4806 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4807 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4808 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4809 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4810 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
4811 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
4812 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
4813 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
4814 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
4815 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
4816 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
4817 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
4818 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
4819 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
4820 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
4821 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
4822 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
4823 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
4824 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
4825 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
4826 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
4827 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
4828 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
4829 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
4830 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
4831 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
4832 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
4833 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
4834 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
4835 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
4836 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
4837 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
4838 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
4839 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
4840 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
4841 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
4842 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
4843 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
4844 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
4845 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
4846
4847
4848 Version 1.8.0 (2016-04-14)
4849 ==========================
4850
4851 Language
4852 --------
4853
4854 * Rust supports overloading of compound assignment statements like
4855   `+=` by implementing the [`AddAssign`], [`SubAssign`],
4856   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
4857   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
4858   traits. [RFC 953].
4859 * Empty structs can be defined with braces, as in `struct Foo { }`, in
4860   addition to the non-braced form, `struct Foo;`. [RFC 218].
4861
4862 Libraries
4863 ---------
4864
4865 * Stabilized APIs:
4866   * [`str::encode_utf16`][] (renamed from `utf16_units`)
4867   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
4868   * [`Ref::map`]
4869   * [`RefMut::map`]
4870   * [`ptr::drop_in_place`]
4871   * [`time::Instant`]
4872   * [`time::SystemTime`]
4873   * [`Instant::now`]
4874   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
4875   * [`Instant::elapsed`]
4876   * [`SystemTime::now`]
4877   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
4878   * [`SystemTime::elapsed`]
4879   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
4880   * [`SystemTimeError`]
4881   * [`SystemTimeError::duration`]
4882   * Various impls for `SystemTimeError`
4883   * [`UNIX_EPOCH`]
4884   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
4885     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
4886     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
4887 * [The `write!` and `writeln!` macros correctly emit errors if any of
4888   their arguments can't be formatted][1.8w].
4889 * [Various I/O functions support large files on 32-bit Linux][1.8l].
4890 * [The Unix-specific `raw` modules, which contain a number of
4891   redefined C types are deprecated][1.8r], including `os::raw::unix`,
4892   `os::raw::macos`, and `os::raw::linux`. These modules defined types
4893   such as `ino_t` and `dev_t`. The inconsistency of these definitions
4894   across platforms was making it difficult to implement `std`
4895   correctly. Those that need these definitions should use the `libc`
4896   crate. [RFC 1415].
4897 * The Unix-specific `MetadataExt` traits, including
4898   `os::unix::fs::MetadataExt`, which expose values such as inode
4899   numbers [no longer return platform-specific types][1.8r], but
4900   instead return widened integers. [RFC 1415].
4901 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
4902 * [Atomic loads and stores are not volatile][1.8a].
4903 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
4904
4905 Performance
4906 -----------
4907
4908 * [Inlining hash functions lead to a 3% compile-time improvement in
4909   some workloads][1.8h].
4910 * When using jemalloc, its symbols are [unprefixed so that it
4911   overrides the libc malloc implementation][1.8h]. This means that for
4912   rustc, LLVM is now using jemalloc, which results in a 6%
4913   compile-time improvement on a specific workload.
4914 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
4915
4916 Misc
4917 ----
4918
4919 * [32-bit MSVC builds finally implement unwinding][1.8ms].
4920   i686-pc-windows-msvc is now considered a tier-1 platform.
4921 * [The `--print targets` flag prints a list of supported targets][1.8t].
4922 * [The `--print cfg` flag prints the `cfg`s defined for the current
4923   target][1.8cf].
4924 * [`rustc` can be built with an new Cargo-based build system, written
4925   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
4926   build system. To enable it configure with `configure --rustbuild`.
4927 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
4928   variants while also indicating the total number of missing variants
4929   if more than 3][1.8m].
4930 * [Executable stacks are disabled on Linux and BSD][1.8nx].
4931 * The Rust Project now publishes binary releases of the standard
4932   library for a number of tier-2 targets:
4933   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
4934   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
4935   `x86_64-rumprun-netbsd`. These can be installed with
4936   tools such as [multirust][1.8mr].
4937
4938 Cargo
4939 -----
4940
4941 * [`cargo init` creates a new Cargo project in the current
4942   directory][1.8ci].  It is otherwise like `cargo new`.
4943 * [Cargo has configuration keys for `-v` and
4944   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4945   `[term]` section of `.cargo/config`.
4946 * [Configuration keys that evaluate to strings or integers can be set
4947   via environment variables][1.8ce]. For example the `build.jobs` key
4948   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4949   precedence over config files.
4950 * [Target-specific dependencies support Rust `cfg` syntax for
4951   describing targets][1.8cfg] so that dependencies for multiple
4952   targets can be specified together. [RFC 1361].
4953 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4954   `RUSTDOC` take precedence over the `build.target-dir`,
4955   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4956 * [The child process tree is killed on Windows when Cargo is
4957   killed][1.8ck].
4958 * [The `build.target` configuration value sets the target platform,
4959   like `--target`][1.8ct].
4960
4961 Compatibility Notes
4962 -------------------
4963
4964 * [Unstable compiler flags have been further restricted][1.8u]. Since
4965   1.0 `-Z` flags have been considered unstable, and other flags that
4966   were considered unstable additionally required passing `-Z
4967   unstable-options` to access. Unlike unstable language and library
4968   features though, these options have been accessible on the stable
4969   release channel. Going forward, *new unstable flags will not be
4970   available on the stable release channel*, and old unstable flags
4971   will warn about their usage. In the future, all unstable flags will
4972   be unavailable on the stable release channel.
4973 * [It is no longer possible to `match` on empty enum variants using
4974   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4975 * The Unix-specific `MetadataExt` traits, including
4976   `os::unix::fs::MetadataExt`, which expose values such as inode
4977   numbers [no longer return platform-specific types][1.8r], but
4978   instead return widened integers. [RFC 1415].
4979 * [Modules sourced from the filesystem cannot appear within arbitrary
4980   blocks, but only within other modules][1.8mf].
4981 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4982 * On Unix, [stack overflow triggers a runtime abort instead of a
4983   SIGSEGV][1.8so].
4984 * [`Command::spawn` and its equivalents return an error if any of
4985   its command-line arguments contain interior `NUL`s][1.8n].
4986 * [Tuple and unit enum variants from other crates are in the type
4987   namespace][1.8tn].
4988 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4989   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4990   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4991   instead of `foo.lib`.
4992
4993
4994 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4995 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4996 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4997 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4998 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4999 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5000 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5001 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5002 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5003 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5004 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5005 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5006 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5007 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5008 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5009 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5010 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5011 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5012 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5013 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5014 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5015 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5016 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5017 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5018 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5019 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5020 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5021 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5022 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5023 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5024 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5025 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5026 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5027 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5028 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5029 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5030 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5031 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5032 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5033 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5034 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5035 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5036 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5037 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5038 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5039 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5040 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5041 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5042 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5043 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5044 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5045 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5046 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5047 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5048 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5049 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5050 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5051 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5052 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5053 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5054
5055
5056 Version 1.7.0 (2016-03-03)
5057 ==========================
5058
5059 Libraries
5060 ---------
5061
5062 * Stabilized APIs
5063   * `Path`
5064     * [`Path::strip_prefix`][] (renamed from relative_from)
5065     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
5066   * `Ipv4Addr`
5067     * [`Ipv4Addr::is_loopback`]
5068     * [`Ipv4Addr::is_private`]
5069     * [`Ipv4Addr::is_link_local`]
5070     * [`Ipv4Addr::is_multicast`]
5071     * [`Ipv4Addr::is_broadcast`]
5072     * [`Ipv4Addr::is_documentation`]
5073   * `Ipv6Addr`
5074     * [`Ipv6Addr::is_unspecified`]
5075     * [`Ipv6Addr::is_loopback`]
5076     * [`Ipv6Addr::is_multicast`]
5077   * `Vec`
5078     * [`Vec::as_slice`]
5079     * [`Vec::as_mut_slice`]
5080   * `String`
5081     * [`String::as_str`]
5082     * [`String::as_mut_str`]
5083   * Slices
5084     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5085     be the same length
5086     * `<[T]>::`[`sort_by_key`]
5087   * checked, saturated, and overflowing operations
5088     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5089     * [`i32::saturating_mul`]
5090     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5091     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5092     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5093     * [`u32::saturating_mul`]
5094     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5095     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5096     * and checked, saturated, and overflowing operations for other primitive types
5097   * FFI
5098     * [`ffi::IntoStringError`]
5099     * [`CString::into_string`]
5100     * [`CString::into_bytes`]
5101     * [`CString::into_bytes_with_nul`]
5102     * `From<CString> for Vec<u8>`
5103   * `IntoStringError`
5104     * [`IntoStringError::into_cstring`]
5105     * [`IntoStringError::utf8_error`]
5106     * `Error for IntoStringError`
5107   * Hashing
5108     * [`std::hash::BuildHasher`]
5109     * [`BuildHasher::Hasher`]
5110     * [`BuildHasher::build_hasher`]
5111     * [`std::hash::BuildHasherDefault`]
5112     * [`HashMap::with_hasher`]
5113     * [`HashMap::with_capacity_and_hasher`]
5114     * [`HashSet::with_hasher`]
5115     * [`HashSet::with_capacity_and_hasher`]
5116     * [`std::collections::hash_map::RandomState`]
5117     * [`RandomState::new`]
5118 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5119   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5120   from bytes is faster.
5121 * [The performance of `LineWriter` (and thus `io::stdout`) was
5122   improved by using `memchr` to search for newlines][1.7m].
5123 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5124   `f64` variants were stabilized previously.
5125 * [`BTreeMap` was rewritten to use less memory and improve the performance
5126   of insertion and iteration, the latter by as much as 5x][1.7bm].
5127 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5128   covariant over their contained type][1.7bt].
5129 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5130   over their contained type][1.7ll].
5131 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5132   searching methods.
5133 * [`Any` is implemented for unsized types][1.7a].
5134 * [`Hash` is implemented for `Duration`][1.7h].
5135
5136 Misc
5137 ----
5138
5139 * [When running tests with `--test`, rustdoc will pass `--cfg`
5140   arguments to the compiler][1.7dt].
5141 * [The compiler is built with RPATH information by default][1.7rpa].
5142   This means that it will be possible to run `rustc` when installed in
5143   unusual configurations without configuring the dynamic linker search
5144   path explicitly.
5145 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5146   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5147   over `LD_LIBRARY_PATH`.
5148
5149 Cargo
5150 -----
5151
5152 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5153   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5154 * [The `rerun-if-changed` build script directive no longer causes the
5155   build script to incorrectly run twice in certain scenarios][1.7rr].
5156
5157 Compatibility Notes
5158 -------------------
5159
5160 * Soundness fixes to the interactions between associated types and
5161   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5162   code that violates the new rules. This is a significant change that
5163   is known to break existing code, so it has emitted warnings for the
5164   new error cases since 1.4 to give crate authors time to adapt. The
5165   details of what is changing are subtle; read the RFC for more.
5166 * [Several bugs in the compiler's visibility calculations were
5167   fixed][1.7v]. Since this was found to break significant amounts of
5168   code, the new errors will be emitted as warnings for several release
5169   cycles, under the `private_in_public` lint.
5170 * Defaulted type parameters were accidentally accepted in positions
5171   that were not intended. In this release, [defaulted type parameters
5172   appearing outside of type definitions will generate a
5173   warning][1.7d], which will become an error in future releases.
5174 * [Parsing "." as a float results in an error instead of 0][1.7p].
5175   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5176 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5177
5178 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5179 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5180 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5181 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5182 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5183 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5184 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5185 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5186 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5187 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5188 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5189 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5190 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5191 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5192 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5193 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5194 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5195 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5196 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5197 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5198 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5199 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5200 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5201 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5202 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5203 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5204 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5205 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5206 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5207 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5208 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5209 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5210 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5211 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5212 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5213 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5214 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5215 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5216 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5217 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5218 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5219 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5220 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5221 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5222 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5223 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5224 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5225 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5226 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5227 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5228 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5229 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5230 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5231 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5232 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5233 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5234 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5235 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5236 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5237 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5238 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5239 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5240 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5241 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5242 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5243 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5244 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5245 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5246 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5247 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5248 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5249 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5250 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5251 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5252 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5253 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5254 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5255 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5256 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5257
5258
5259 Version 1.6.0 (2016-01-21)
5260 ==========================
5261
5262 Language
5263 --------
5264
5265 * The `#![no_std]` attribute causes a crate to not be linked to the
5266   standard library, but only the [core library][1.6co], as described
5267   in [RFC 1184]. The core library defines common types and traits but
5268   has no platform dependencies whatsoever, and is the basis for Rust
5269   software in environments that cannot support a full port of the
5270   standard library, such as operating systems. Most of the core
5271   library is now stable.
5272
5273 Libraries
5274 ---------
5275
5276 * Stabilized APIs:
5277   [`Read::read_exact`],
5278   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
5279   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5280   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5281   [`os::unix::fs::DirBuilderExt`],
5282   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5283   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5284   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5285   [`collections::hash_map::Drain`],
5286   [`collections::hash_map::HashMap::drain`],
5287   [`collections::hash_set::Drain`],
5288   [`collections::hash_set::HashSet::drain`],
5289   [`collections::binary_heap::Drain`],
5290   [`collections::binary_heap::BinaryHeap::drain`],
5291   [`Vec::extend_from_slice`][] (renamed from `push_all`),
5292   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5293   [`RwLock::into_inner`],
5294   [`Iterator::min_by_key`][] (renamed from `min_by`),
5295   [`Iterator::max_by_key`][] (renamed from `max_by`).
5296 * The [core library][1.6co] is stable, as are most of its APIs.
5297 * [The `assert_eq!` macro supports arguments that don't implement
5298   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5299   `assert!`.
5300 * Several timer functions that take duration in milliseconds [are
5301   deprecated in favor of those that take `Duration`][1.6ms]. These
5302   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5303   `thread::park_timeout_ms`.
5304 * The algorithm by which `Vec` reserves additional elements was
5305   [tweaked to not allocate excessive space][1.6a] while still growing
5306   exponentially.
5307 * `From` conversions are [implemented from integers to floats][1.6f]
5308   in cases where the conversion is lossless. Thus they are not
5309   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5310   or `f64`. They are also not implemented for `isize` and `usize`
5311   because the implementations would be platform-specific. `From` is
5312   also implemented from `f32` to `f64`.
5313 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5314 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5315 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5316 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5317   improvements.
5318 * Sorting slices that are already sorted [is 50% faster in some
5319   cases][1.6s].
5320
5321 Cargo
5322 -----
5323
5324 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5325 * Cargo build scripts can specify their dependencies by emitting the
5326   [`rerun-if-changed`][1.6rr] key.
5327 * crates.io will reject publication of crates with dependencies that
5328   have a wildcard version constraint. Crates with wildcard
5329   dependencies were seen to cause a variety of problems, as described
5330   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5331   warning.
5332 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5333   release folder.  A variety of artifacts that Cargo failed to clean
5334   are now correctly deleted.
5335
5336 Misc
5337 ----
5338
5339 * The `unreachable_code` lint [warns when a function call's argument
5340   diverges][1.6dv].
5341 * The parser indicates [failures that may be caused by
5342   confusingly-similar Unicode characters][1.6uc]
5343 * Certain macro errors [are reported at definition time][1.6m], not
5344   expansion.
5345
5346 Compatibility Notes
5347 -------------------
5348
5349 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5350   environment variable when locating crates. This was a pre-cargo
5351   feature for integrating with the package manager that was
5352   accidentally never removed.
5353 * [A number of bugs were fixed in the privacy checker][1.6p] that
5354   could cause previously-accepted code to break.
5355 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5356 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5357   struct pattern syntax (`Foo(..)`) can no longer be used to match
5358   unit structs. This is a warning now, but will become an error in
5359   future releases. Patterns that share the same name as a const are
5360   now an error.
5361 * A bug was fixed that causes [rustc not to apply default type
5362   parameters][1.6xc] when resolving certain method implementations of
5363   traits defined in other crates.
5364
5365 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5366 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5367 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5368 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5369 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5370 [1.6co]: http://doc.rust-lang.org/core/index.html
5371 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5372 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5373 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5374 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5375 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5376 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5377 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5378 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5379 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5380 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5381 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5382 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5383 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5384 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5385 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5386 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5387 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5388 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5389 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5390 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5391 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5392 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5393 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5394 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5395 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5396 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5397 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5398 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5399 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5400 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5401 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5402 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5403 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5404 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5405 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5406 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5407 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5408 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5409 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5410 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5411 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5412
5413
5414 Version 1.5.0 (2015-12-10)
5415 ==========================
5416
5417 * ~700 changes, numerous bugfixes
5418
5419 Highlights
5420 ----------
5421
5422 * Stabilized APIs:
5423   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5424   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5425   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5426   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5427   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5428   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5429   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5430   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5431   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5432   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5433   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5434   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5435   [`Path::read_link`], [`Path::symlink_metadata`],
5436   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5437   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5438   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5439   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5440   [`slice::split_first_mut`], [`slice::split_first`],
5441   [`slice::split_last_mut`], [`slice::split_last`],
5442   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5443   [`str::MatchIndices`], [`str::RMatchIndices`],
5444   [`str::match_indices`], [`str::rmatch_indices`],
5445   [`str::slice_mut_unchecked`], [`string::ParseError`].
5446 * Rust applications hosted on crates.io can be installed locally to
5447   `~/.cargo/bin` with the [`cargo install`] command. Among other
5448   things this makes it easier to augment Cargo with new subcommands:
5449   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5450   invoked as `cargo foo`.
5451 * Crates with wildcard (`*`) dependencies will [emit warnings when
5452   published][1.5w]. In 1.6 it will no longer be possible to publish
5453   crates with wildcard dependencies.
5454
5455 Breaking Changes
5456 ----------------
5457
5458 * The rules determining when a particular lifetime must outlive
5459   a particular value (known as '[dropck]') have been [modified
5460   to not rely on parametricity][1.5p].
5461 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5462   and `Arc`][1.5a]. Because these smart pointer types implement
5463   `Deref`, this causes breakage in cases where the interior type
5464   contains methods of the same name.
5465 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5466   that they could drop their content. Soundness fix.
5467 * All method invocations are [properly checked][1.5wf1] for
5468   [well-formedness][1.5wf2]. Soundness fix.
5469 * Traits whose supertraits contain `Self` are [not object
5470   safe][1.5o]. Soundness fix.
5471 * Target specifications support a [`no_default_libraries`][1.5nd]
5472   setting that controls whether `-nodefaultlibs` is passed to the
5473   linker, and in turn the `is_like_windows` setting no longer affects
5474   the `-nodefaultlibs` flag.
5475 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5476 * The `#[inline]` and `#[repr]` attributes [can only appear
5477   in valid locations][1.5at].
5478 * Native libraries linked from the local crate are [passed to
5479   the linker before native libraries from upstream crates][1.5nl].
5480 * Two rarely-used attributes, `#[no_debug]` and
5481   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5482 * Negation of unsigned integers, which has been a warning for
5483   several releases, [is now behind a feature gate and will
5484   generate errors][1.5nu].
5485 * The parser accidentally accepted visibility modifiers on
5486   enum variants, a bug [which has been fixed][1.5ev].
5487 * [A bug was fixed that allowed `use` statements to import unstable
5488   features][1.5use].
5489
5490 Language
5491 --------
5492
5493 * When evaluating expressions at compile-time that are not
5494   compile-time constants (const-evaluating expressions in non-const
5495   contexts), incorrect code such as overlong bitshifts and arithmetic
5496   overflow will [generate a warning instead of an error][1.5ce],
5497   delaying the error until runtime. This will allow the
5498   const-evaluator to be expanded in the future backwards-compatibly.
5499 * The `improper_ctypes` lint [no longer warns about using `isize` and
5500   `usize` in FFI][1.5ict].
5501
5502 Libraries
5503 ---------
5504
5505 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5506   invariant][1.5c].
5507 * `Default` is [implemented for mutable slices][1.5d].
5508 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5509 * There are now `From` conversions [between floating point
5510   types][1.5f] where the conversions are lossless.
5511 * There are now `From` conversions [between integer types][1.5i] where
5512   the conversions are lossless.
5513 * [`fs::Metadata` implements `Clone`][1.5fs].
5514 * The `parse` method [accepts a leading "+" when parsing
5515   integers][1.5pi].
5516 * [`AsMut` is implemented for `Vec`][1.5am].
5517 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5518   been optimized][1.5cf] and no longer rely on the default impl.
5519 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5520   `unsafe extern "C"` function types now [implement `Clone`,
5521   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5522   `fmt::Debug` for up to 12 arguments][1.5fp].
5523 * [Dropping `Vec`s is much faster in unoptimized builds when the
5524   element types don't implement `Drop`][1.5dv].
5525 * A bug that caused in incorrect behavior when [combining `VecDeque`
5526   with zero-sized types][1.5vdz] was resolved.
5527 * [`PartialOrd` for slices is faster][1.5po].
5528
5529 Miscellaneous
5530 -------------
5531
5532 * [Crate metadata size was reduced by 20%][1.5md].
5533 * [Improvements to code generation reduced the size of libcore by 3.3
5534   MB and rustc's memory usage by 18MB][1.5m].
5535 * [Improvements to deref translation increased performance in
5536   unoptimized builds][1.5dr].
5537 * Various errors in trait resolution [are deduplicated to only be
5538   reported once][1.5te].
5539 * Rust has preliminary [support for rumprun kernels][1.5rr].
5540 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5541
5542 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5543 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5544 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5545 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5546 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5547 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5548 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5549 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5550 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5551 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5552 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5553 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5554 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5555 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5556 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5557 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5558 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5559 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5560 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5561 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5562 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5563 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5564 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5565 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5566 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5567 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5568 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5569 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5570 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5571 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5572 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5573 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5574 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5575 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5576 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5577 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5578 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5579 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5580 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5581 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5582 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5583 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5584 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5585 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5586 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5587 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5588 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5589 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5590 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5591 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5592 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5593 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5594 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5595 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5596 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5597 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5598 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5599 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5600 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5601 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5602 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5603 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5604 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5605 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5606 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5607 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5608 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5609 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5610 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5611 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5612 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5613 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5614 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5615 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5616 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5617 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5618 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5619 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5620 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5621 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5622 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5623 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5624 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5625 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5626 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5627 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5628 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5629 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5630 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5631
5632 Version 1.4.0 (2015-10-29)
5633 ==========================
5634
5635 * ~1200 changes, numerous bugfixes
5636
5637 Highlights
5638 ----------
5639
5640 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5641   GNU) are now supported and recommended for use.
5642
5643 Breaking Changes
5644 ----------------
5645
5646 * [Several changes have been made to fix type soundness and improve
5647   the behavior of associated types][sound]. See [RFC 1214]. Although
5648   we have mostly introduced these changes as warnings this release, to
5649   become errors next release, there are still some scenarios that will
5650   see immediate breakage.
5651 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5652   line breaks in addition to `\n`][crlf].
5653 * [Loans of `'static` lifetime extend to the end of a function][stat].
5654 * [`str::parse` no longer introduces avoidable rounding error when
5655   parsing floating point numbers. Together with earlier changes to
5656   float formatting/output, "round trips" like f.to_string().parse()
5657   now preserve the value of f exactly. Additionally, leading plus
5658   signs are now accepted][fp3].
5659
5660
5661 Language
5662 --------
5663
5664 * `use` statements that import multiple items [can now rename
5665   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5666 * [Binops work correctly on fat pointers][binfat].
5667 * `pub extern crate`, which does not behave as expected, [issues a
5668   warning][pec] until a better solution is found.
5669
5670 Libraries
5671 ---------
5672
5673 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5674   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5675   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5676   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5677   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5678   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5679   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5680   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5681   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5682   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5683   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5684   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5685   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5686   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5687   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5688   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5689   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5690   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5691   [`thread::sleep`].
5692 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5693   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5694   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5695   `f64::from_str_radix`.
5696 * [Reverse-searching strings is faster with the 'two-way'
5697   algorithm][s].
5698 * [`std::io::copy` allows `?Sized` arguments][cc].
5699 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5700   [override `count`, `nth` and `last` with an O(1)
5701   implementation][it].
5702 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5703 * [`IntoRawFd` has been added to the Unix-specific prelude,
5704   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5705   prelude][pr].
5706 * [`Extend<String>` and `FromIterator<String` are both implemented for
5707   `String`][es].
5708 * [`IntoIterator` is implemented for references to `Option` and
5709   `Result`][into2].
5710 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5711   Copy`][ext] as part of [RFC 839]. This will cause type inference
5712   breakage in rare situations.
5713 * [`BinaryHeap` implements `Debug`][bh2].
5714 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5715   arrays][bm].
5716 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5717   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5718 * [String comparison is faster][faststr].
5719 * `&mut T` where `T: std::fmt::Write` [also implements
5720   `std::fmt::Write`][mutw].
5721 * [A stable regression in `VecDeque::push_back` and other
5722   capacity-altering methods that caused panics for zero-sized types
5723   was fixed][vd].
5724 * [Function pointers implement traits for up to 12 parameters][fp2].
5725
5726 Miscellaneous
5727 -------------
5728
5729 * The compiler [no longer uses the 'morestack' feature to prevent
5730   stack overflow][mm]. Instead it uses guard pages and stack
5731   probes (though stack probes are not yet implemented on any platform
5732   but Windows).
5733 * [The compiler matches traits faster when projections are involved][p].
5734 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5735   `usize`][ffi].
5736 * [Cargo now displays useful information about what its doing during
5737   `cargo update`][cu].
5738
5739 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5740 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5741 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5742 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5743 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5744 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5745 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5746 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5747 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5748 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5749 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5750 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5751 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5752 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5753 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5754 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5755 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5756 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5757 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5758 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5759 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5760 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5761 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5762 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5763 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5764 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5765 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
5766 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
5767 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
5768 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
5769 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
5770 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
5771 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
5772 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
5773 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
5774 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
5775 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
5776 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
5777 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
5778 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
5779 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
5780 [bh2]: https://github.com/rust-lang/rust/pull/28156
5781 [binfat]: https://github.com/rust-lang/rust/pull/28270
5782 [bm]: https://github.com/rust-lang/rust/pull/28197
5783 [cc]: https://github.com/rust-lang/rust/pull/27531
5784 [crlf]: https://github.com/rust-lang/rust/pull/28034
5785 [cu]: https://github.com/rust-lang/cargo/pull/1931
5786 [d]: https://github.com/rust-lang/rust/pull/27825
5787 [dep]: https://github.com/rust-lang/rust/pull/28339
5788 [es]: https://github.com/rust-lang/rust/pull/27956
5789 [ext]: https://github.com/rust-lang/rust/pull/28094
5790 [faststr]: https://github.com/rust-lang/rust/pull/28338
5791 [ffi]: https://github.com/rust-lang/rust/pull/28779
5792 [fp]: https://github.com/rust-lang/rust/pull/28268
5793 [fp2]: https://github.com/rust-lang/rust/pull/28560
5794 [fp3]: https://github.com/rust-lang/rust/pull/27307
5795 [i]: https://github.com/rust-lang/rust/pull/27451
5796 [into2]: https://github.com/rust-lang/rust/pull/28039
5797 [it]: https://github.com/rust-lang/rust/pull/27652
5798 [mm]: https://github.com/rust-lang/rust/pull/27338
5799 [mutw]: https://github.com/rust-lang/rust/pull/28368
5800 [sound]: https://github.com/rust-lang/rust/pull/27641
5801 [p]: https://github.com/rust-lang/rust/pull/27866
5802 [pec]: https://github.com/rust-lang/rust/pull/28486
5803 [pr]: https://github.com/rust-lang/rust/pull/27896
5804 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5805 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5806 [s]: https://github.com/rust-lang/rust/pull/27474
5807 [stab]: https://github.com/rust-lang/rust/pull/28339
5808 [stat]: https://github.com/rust-lang/rust/pull/28321
5809 [vd]: https://github.com/rust-lang/rust/pull/28494
5810
5811 Version 1.3.0 (2015-09-17)
5812 ==============================
5813
5814 * ~900 changes, numerous bugfixes
5815
5816 Highlights
5817 ----------
5818
5819 * The [new object lifetime defaults][nold] have been [turned
5820   on][nold2] after a cycle of warnings about the change. Now types
5821   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
5822   being interpreted as `&'a Box<Trait+'a>` to `&'a
5823   Box<Trait+'static>`.
5824 * [The Rustonomicon][nom] is a new book in the official documentation
5825   that dives into writing unsafe Rust.
5826 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
5827   timekeeping is employed by other std APIs, as well as out-of-tree
5828   time crates.
5829
5830 Breaking Changes
5831 ----------------
5832
5833 * The [new object lifetime defaults][nold] have been [turned
5834   on][nold2] after a cycle of warnings about the change.
5835 * There is a known [regression][lr] in how object lifetime elision is
5836   interpreted, the proper solution for which is undetermined.
5837 * The `#[prelude_import]` attribute, an internal implementation
5838   detail, was accidentally stabilized previously. [It has been put
5839   behind the `prelude_import` feature gate][pi]. This change is
5840   believed to break no existing code.
5841 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5842   [more sane for dynamically sized types][dst3]. Code that relied on
5843   the previous behavior is thought to be broken.
5844 * The `dropck` rules, which checks that destructors can't access
5845   destroyed values, [have been updated][dropck] to match the
5846   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
5847   cause some previously-compiling code to no longer build.
5848
5849 Language
5850 --------
5851
5852 * The [new object lifetime defaults][nold] have been [turned
5853   on][nold2] after a cycle of warnings about the change.
5854 * Semicolons may [now follow types and paths in
5855   macros](https://github.com/rust-lang/rust/pull/27000).
5856 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5857   [more sane for dynamically sized types][dst3]. Code that relied on
5858   the previous behavior is not known to exist, and suspected to be
5859   broken.
5860 * `'static` variables [may now be recursive][st].
5861 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
5862   implementations correctly.
5863 * The `dropck` rules, which checks that destructors can't access
5864   destroyed values, [have been updated][dropck] to match the
5865   [RFC][dropckrfc].
5866
5867 Libraries
5868 ---------
5869
5870 * The [`Duration`] API, [has been stabilized][ds], as well as the
5871   `std::time` module, which presently contains only `Duration`.
5872 * `Box<str>` and `Box<[T]>` both implement `Clone`.
5873 * The owned C string, [`CString`], implements [`Borrow`] and the
5874   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
5875   these allow C strings to be borrowed and cloned in generic code.
5876 * [`CStr`] implements [`Debug`].
5877 * [`AtomicPtr`] implements [`Debug`].
5878 * [`Error`] trait objects [can be downcast to their concrete types][e]
5879   in many common configurations, using the [`is`], [`downcast`],
5880   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
5881   [`Any`] trait.
5882 * Searching for substrings now [employs the two-way algorithm][search]
5883   instead of doing a naive search. This gives major speedups to a
5884   number of methods, including [`contains`][sc], [`find`][sf],
5885   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
5886   [`ends_with`][sew] are also faster.
5887 * The performance of `PartialEq` for slices is [much faster][ps].
5888 * The [`Hash`] trait offers the default method, [`hash_slice`], which
5889   is overridden and optimized by the implementations for scalars.
5890 * The [`Hasher`] trait now has a number of specialized `write_*`
5891   methods for primitive types, for efficiency.
5892 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
5893   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
5894   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
5895   of [`std::error::Error::cause`][iec] also delegates to the inner
5896   error.
5897 * [`process::Child`][pc] gained the [`id`] method, which returns a
5898   `u32` representing the platform-specific process identifier.
5899 * The [`connect`] method on slices is deprecated, replaced by the new
5900   [`join`] method (note that both of these are on the *unstable*
5901   [`SliceConcatExt`] trait, but through the magic of the prelude are
5902   available to stable code anyway).
5903 * The [`Div`] operator is implemented for [`Wrapping`] types.
5904 * [`DerefMut` is implemented for `String`][dms].
5905 * Performance of SipHash (the default hasher for `HashMap`) is
5906   [better for long data][sh].
5907 * [`AtomicPtr`] implements [`Send`].
5908 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
5909   are now [specialized to use uninitialized buffers for increased
5910   performance][rte].
5911 * Lifetime parameters of foreign functions [are now resolved
5912   properly][f].
5913
5914 Misc
5915 ----
5916
5917 * Rust can now, with some coercion, [produce programs that run on
5918   Windows XP][xp], though XP is not considered a supported platform.
5919 * Porting Rust on Windows from the GNU toolchain to MSVC continues
5920   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
5921   recommended for use in 1.3, though should be fully-functional
5922   in the [64-bit 1.4 beta][b14].
5923 * On Fedora-based systems installation will [properly configure the
5924   dynamic linker][fl].
5925 * The compiler gained many new extended error descriptions, which can
5926   be accessed with the `--explain` flag.
5927 * The `dropck` pass, which checks that destructors can't access
5928   destroyed values, [has been rewritten][dropck]. This fixes some
5929   soundness holes, and as such will cause some previously-compiling
5930   code to no longer build.
5931 * `rustc` now uses [LLVM to write archive files where possible][ar].
5932   Eventually this will eliminate the compiler's dependency on the ar
5933   utility.
5934 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
5935   supported FreeBSD on x86_64).
5936 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5937   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5938   more strict.
5939 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5940   will kill the process instead of leaking][nlp].
5941
5942 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5943 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5944 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5945 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5946 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5947 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5948 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5949 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5950 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5951 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5952 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5953 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5954 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5955 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5956 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5957 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5958 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5959 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5960 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5961 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5962 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5963 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5964 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5965 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5966 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5967 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5968 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5969 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5970 [ar]: https://github.com/rust-lang/rust/pull/26926
5971 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5972 [dms]: https://github.com/rust-lang/rust/pull/26241
5973 [dropck]: https://github.com/rust-lang/rust/pull/27261
5974 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5975 [ds]: https://github.com/rust-lang/rust/pull/26818
5976 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5977 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5978 [dst3]: https://github.com/rust-lang/rust/pull/27351
5979 [e]: https://github.com/rust-lang/rust/pull/24793
5980 [f]: https://github.com/rust-lang/rust/pull/26588
5981 [fb]: https://github.com/rust-lang/rust/pull/26959
5982 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5983 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5984 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5985 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5986 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5987 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5988 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5989 [lic]: https://github.com/rust-lang/rust/pull/26583
5990 [lnu]: https://github.com/rust-lang/rust/pull/27026
5991 [lr]: https://github.com/rust-lang/rust/issues/27248
5992 [lum]: https://github.com/rust-lang/rust/pull/26378
5993 [lur]: https://github.com/rust-lang/rust/pull/26783
5994 [nlp]: https://github.com/rust-lang/rust/pull/27176
5995 [nold2]: https://github.com/rust-lang/rust/pull/27045
5996 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5997 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5998 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5999 [pi]: https://github.com/rust-lang/rust/pull/26699
6000 [ps]: https://github.com/rust-lang/rust/pull/26884
6001 [rte]: https://github.com/rust-lang/rust/pull/26950
6002 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6003 [search]: https://github.com/rust-lang/rust/pull/26327
6004 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6005 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6006 [sh]: https://github.com/rust-lang/rust/pull/27280
6007 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6008 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6009 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6010 [st]: https://github.com/rust-lang/rust/pull/26630
6011 [win1]: https://github.com/rust-lang/rust/pull/26569
6012 [win2]: https://github.com/rust-lang/rust/pull/26741
6013 [win3]: https://github.com/rust-lang/rust/pull/26741
6014 [win4]: https://github.com/rust-lang/rust/pull/27210
6015 [xp]: https://github.com/rust-lang/rust/pull/26569
6016
6017 Version 1.2.0 (2015-08-07)
6018 ==========================
6019
6020 * ~1200 changes, numerous bugfixes
6021
6022 Highlights
6023 ----------
6024
6025 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6026   like `Rc` to contain types without a fixed size, arrays and trait
6027   objects, finally enabling use of `Rc<[T]>` and completing the
6028   implementation of DST.
6029 * [Parallel codegen][parcodegen] is now working again, which can
6030   substantially speed up large builds in debug mode; It also gets
6031   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6032   jobs). It's not enabled by default, but will be "in the near
6033   future". It can be activated with the `-C codegen-units=N` flag to
6034   `rustc`.
6035 * This is the first release with [experimental support for linking
6036   with the MSVC linker and lib C on Windows (instead of using the GNU
6037   variants via MinGW)][win]. It is yet recommended only for the most
6038   intrepid Rustaceans.
6039 * Benchmark compilations are showing a 30% improvement in
6040   bootstrapping over 1.1.
6041
6042 Breaking Changes
6043 ----------------
6044
6045 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6046   unicode case mapping, which is a previously-planned change in
6047   behavior and considered a bugfix.
6048 * [`mem::align_of`] now specifies [the *minimum alignment* for
6049   T][align], which is usually the alignment programs are interested
6050   in, and the same value reported by clang's
6051   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6052   break real code.
6053 * [The `#[packed]` attribute is no longer silently accepted by the
6054   compiler][packed]. This attribute did nothing and code that
6055   mentioned it likely did not work as intended.
6056 * Associated type defaults are [now behind the
6057   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6058   defaults *did not work*, but could be mentioned syntactically. As
6059   such this breakage has minimal impact.
6060
6061 Language
6062 --------
6063
6064 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6065   matching against dereferenceable values.
6066
6067 Libraries
6068 ---------
6069
6070 * The [`Extend`] trait, which grows a collection from an iterator, is
6071   implemented over iterators of references, for `String`, `Vec`,
6072   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6073   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6074 * The [`iter::once`] function returns an iterator that yields a single
6075   element, and [`iter::empty`] returns an iterator that yields no
6076   elements.
6077 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6078   over substring matches.
6079 * [`Cell`] and [`RefCell`] both implement `Eq`.
6080 * A number of methods for wrapping arithmetic are added to the
6081   integral types, [`wrapping_div`], [`wrapping_rem`],
6082   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6083   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6084   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6085   type.. It is illegal for the default arithmetic operations in Rust
6086   to overflow; the desire to wrap must be explicit.
6087 * The `{:#?}` formatting specifier [displays the alternate,
6088   pretty-printed][debugfmt] form of the `Debug` formatter. This
6089   feature was actually introduced prior to 1.0 with little
6090   fanfare.
6091 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6092   for writing data to formatted strings, similar to [`io::Write`].
6093 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6094   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6095   are used by code generators to emit implementations of [`Debug`].
6096 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6097   methods that convert case, following Unicode case mapping.
6098 * It is now easier to handle poisoned locks. The [`PoisonError`]
6099   type, returned by failing lock operations, exposes `into_inner`,
6100   `get_ref`, and `get_mut`, which all give access to the inner lock
6101   guard, and allow the poisoned lock to continue to operate. The
6102   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6103   poisoned lock without attempting to take the lock.
6104 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6105   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6106   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6107   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6108   `ChildStderr`.
6109 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6110   malformed input.
6111
6112 Misc
6113 ----
6114
6115 * `rustc` employs smarter heuristics for guessing at [typos].
6116 * `rustc` emits more efficient code for [no-op conversions between
6117   unsafe pointers][nop].
6118 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6119   resulting in faster compile times and smaller code.
6120
6121 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6122 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6123 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6124 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6125 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6126 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6127 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6128 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6129 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6130 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6131 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6132 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6133 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6134 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6135 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6136 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6137 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6138 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6139 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6140 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6141 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6142 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6143 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6144 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6145 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6146 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6147 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6148 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6149 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6150 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6151 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6152 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6153 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6154 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6155 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6156 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6157 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6158 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6159 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6160 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6161 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6162 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6163 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6164 [align]: https://github.com/rust-lang/rust/pull/25646
6165 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6166 [typos]: https://github.com/rust-lang/rust/pull/26087
6167 [nop]: https://github.com/rust-lang/rust/pull/26336
6168 [fat]: https://github.com/rust-lang/rust/pull/26411
6169 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6170 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6171 [packed]: https://github.com/rust-lang/rust/pull/25541
6172 [ad]: https://github.com/rust-lang/rust/pull/27382
6173 [win]: https://github.com/rust-lang/rust/pull/25350
6174
6175 Version 1.1.0 (2015-06-25)
6176 =========================
6177
6178 * ~850 changes, numerous bugfixes
6179
6180 Highlights
6181 ----------
6182
6183 * The [`std::fs` module has been expanded][fs] to expand the set of
6184   functionality exposed:
6185   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6186     don't incur a syscall on some platforms.
6187   * A `symlink_metadata` function has been added.
6188   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6189     access to all underlying information.
6190 * The compiler now contains extended explanations of many errors. When an error
6191   with an explanation occurs the compiler suggests using the `--explain` flag
6192   to read the explanation. Error explanations are also [available online][err-index].
6193 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6194   well as other work, the time to bootstrap the compiler decreased by
6195   32%.
6196
6197 Libraries
6198 ---------
6199
6200 * The [`str::split_whitespace`] method splits a string on unicode
6201   whitespace boundaries.
6202 * On both Windows and Unix, new extension traits provide conversion of
6203   I/O types to and from the underlying system handles. On Unix, these
6204   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6205   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6206   `TcpListener`, and `UpdSocket`. Further implementations for
6207   `std::process` will be stabilized later.
6208 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6209   Windows, symlinks can be created with
6210   `std::os::windows::symlink_dir` and
6211   `std::os::windows::symlink_file`.
6212 * The `mpsc::Receiver` type can now be converted into an iterator with
6213   `into_iter` on the [`IntoIterator`] trait.
6214 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6215   implementation of the [`From`] trait.
6216 * The `Debug` implementation for `RangeFull` [creates output that is
6217   more consistent with other implementations][rf].
6218 * [`Debug` is implemented for `File`][file].
6219 * The `Default` implementation for `Arc` [no longer requires `Sync +
6220   Send`][arc].
6221 * [The `Iterator` methods `count`, `nth`, and `last` have been
6222   overridden for slices to have O(1) performance instead of O(n)][si].
6223 * Incorrect handling of paths on Windows has been improved in both the
6224   compiler and the standard library.
6225 * [`AtomicPtr` gained a `Default` implementation][ap].
6226 * In accordance with Rust's policy on arithmetic overflow `abs` now
6227   [panics on overflow when debug assertions are enabled][abs].
6228 * The [`Cloned`] iterator, which was accidentally left unstable for
6229   1.0 [has been stabilized][c].
6230 * The [`Incoming`] iterator, which iterates over incoming TCP
6231   connections, and which was accidentally unnamable in 1.0, [is now
6232   properly exported][inc].
6233 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6234   `sift_up` or `sift_down` panic][bh].
6235 * The [`split_off`] method of `LinkedList` [no longer corrupts
6236   the list in certain scenarios][ll].
6237
6238 Misc
6239 ----
6240
6241 * Type checking performance [has improved notably][sk] with
6242   [multiple improvements][pre].
6243 * The compiler [suggests code changes][ch] for more errors.
6244 * rustc and it's build system have experimental support for [building
6245   toolchains against MUSL][m] instead of glibc on Linux.
6246 * The compiler defines the `target_env` cfg value, which is used for
6247   distinguishing toolchains that are otherwise for the same
6248   platform. Presently this is set to `gnu` for common GNU Linux
6249   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6250 * The [`cargo rustc`][crc] command invokes a build with custom flags
6251   to rustc.
6252 * [Android executables are always position independent][pie].
6253 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6254   with `Drop`][drop].
6255
6256 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6257 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6258 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6259 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6260 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6261 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6262 [rf]: https://github.com/rust-lang/rust/pull/24491
6263 [err-index]: https://doc.rust-lang.org/error-index.html
6264 [sk]: https://github.com/rust-lang/rust/pull/24615
6265 [pre]: https://github.com/rust-lang/rust/pull/25323
6266 [file]: https://github.com/rust-lang/rust/pull/24598
6267 [ch]: https://github.com/rust-lang/rust/pull/24683
6268 [arc]: https://github.com/rust-lang/rust/pull/24695
6269 [si]: https://github.com/rust-lang/rust/pull/24701
6270 [ap]: https://github.com/rust-lang/rust/pull/24834
6271 [m]: https://github.com/rust-lang/rust/pull/24777
6272 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6273 [crc]: https://github.com/rust-lang/cargo/pull/1568
6274 [pie]: https://github.com/rust-lang/rust/pull/24953
6275 [abs]: https://github.com/rust-lang/rust/pull/25441
6276 [c]: https://github.com/rust-lang/rust/pull/25496
6277 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6278 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6279 [inc]: https://github.com/rust-lang/rust/pull/25522
6280 [bh]: https://github.com/rust-lang/rust/pull/25856
6281 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6282 [ll]: https://github.com/rust-lang/rust/pull/26022
6283 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6284 [drop]: https://github.com/rust-lang/rust/pull/24935
6285
6286 Version 1.0.0 (2015-05-15)
6287 ========================
6288
6289 * ~1500 changes, numerous bugfixes
6290
6291 Highlights
6292 ----------
6293
6294 * The vast majority of the standard library is now `#[stable]`. It is
6295   no longer possible to use unstable features with a stable build of
6296   the compiler.
6297 * Many popular crates on [crates.io] now work on the stable release
6298   channel.
6299 * Arithmetic on basic integer types now [checks for overflow in debug
6300   builds][overflow].
6301
6302 Language
6303 --------
6304
6305 * Several [restrictions have been added to trait coherence][coh] in
6306   order to make it easier for upstream authors to change traits
6307   without breaking downstream code.
6308 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6309   improve error messages and macro behavior. For example, `0b1234` is
6310   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6311 * Trait bounds [are always invariant][inv], eliminating the need for
6312   the `PhantomFn` and `MarkerTrait` lang items, which have been
6313   removed.
6314 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6315   "foo" as bar` syntax has been replaced with `extern crate foo as
6316   bar`, and Cargo now automatically translates "-" in *package* names
6317   to underscore for the crate name.
6318 * [Lifetime shadowing is an error][lt].
6319 * [`Send` no longer implies `'static`][send-rfc].
6320 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6321   `MyType::default()`.
6322 * Primitive types [now have inherent methods][prim-inherent],
6323   obviating the need for extension traits like `SliceExt`.
6324 * Methods with `Self: Sized` in their `where` clause are [considered
6325   object-safe][self-sized], allowing many extension traits like
6326   `IteratorExt` to be merged into the traits they extended.
6327 * You can now [refer to associated types][assoc-where] whose
6328   corresponding trait bounds appear only in a `where` clause.
6329 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6330   like `Send` and `Sync` are now library-defined.
6331 * A [Reflect trait][reflect] was introduced, which means that
6332   downcasting via the `Any` trait is effectively limited to concrete
6333   types. This helps retain the potentially-important "parametricity"
6334   property: generic code cannot behave differently for different type
6335   arguments except in minor ways.
6336 * The `unsafe_destructor` feature is now deprecated in favor of the
6337   [new `dropck`][dropck]. This change is a major reduction in unsafe
6338   code.
6339
6340 Libraries
6341 ---------
6342
6343 * The `thread_local` module [has been renamed to `std::thread`][th].
6344 * The methods of `IteratorExt` [have been moved to the `Iterator`
6345   trait itself][ie].
6346 * Several traits that implement Rust's conventions for type
6347   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6348   [centralized in the `std::convert` module][con].
6349 * The `FromError` trait [was removed in favor of `From`][fe].
6350 * The basic sleep function [has moved to
6351   `std::thread::sleep_ms`][slp].
6352 * The `splitn` function now takes an `n` parameter that represents the
6353   number of items yielded by the returned iterator [instead of the
6354   number of 'splits'][spl].
6355 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6356 * [Derived implementations of `PartialOrd` now order enums according
6357   to their explicitly-assigned discriminants][po].
6358 * [Methods for searching strings are generic over `Pattern`s][pat],
6359   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6360   some others.
6361 * [In method resolution, object methods are resolved before inherent
6362   methods][meth].
6363 * [`String::from_str` has been deprecated in favor of the `From` impl,
6364   `String::from`][sf].
6365 * [`io::Error` implements `Sync`][ios].
6366 * [The `words` method on `&str` has been replaced with
6367   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6368   a word?'
6369 * The new path and IO modules are complete and `#[stable]`. This
6370   was the major library focus for this cycle.
6371 * The path API was [revised][path-normalize] to normalize `.`,
6372   adjusting the tradeoffs in favor of the most common usage.
6373 * A large number of remaining APIs in `std` were also stabilized
6374   during this cycle; about 75% of the non-deprecated API surface
6375   is now stable.
6376 * The new [string pattern API][string-pattern] landed, which makes
6377   the string slice API much more internally consistent and flexible.
6378 * A new set of [generic conversion traits][conversion] replaced
6379   many existing ad hoc traits.
6380 * Generic numeric traits were [completely removed][num-traits]. This
6381   was made possible thanks to inherent methods for primitive types,
6382   and the removal gives maximal flexibility for designing a numeric
6383   hierarchy in the future.
6384 * The `Fn` traits are now related via [inheritance][fn-inherit]
6385   and provide ergonomic [blanket implementations][fn-blanket].
6386 * The `Index` and `IndexMut` traits were changed to
6387   [take the index by value][index-value], enabling code like
6388   `hash_map["string"]` to work.
6389 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6390   `Copy` data is known to be `Clone` as well.
6391
6392 Misc
6393 ----
6394
6395 * Many errors now have extended explanations that can be accessed with
6396   the `--explain` flag to `rustc`.
6397 * Many new examples have been added to the standard library
6398   documentation.
6399 * rustdoc has received a number of improvements focused on completion
6400   and polish.
6401 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6402 * Much headway was made on ecosystem-wide CI, making it possible
6403   to [compare builds for breakage][ci-compare].
6404
6405
6406 [crates.io]: http://crates.io
6407 [clo]: https://github.com/rust-lang/rust/pull/24034
6408 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6409 [con]: https://github.com/rust-lang/rust/pull/23875
6410 [cr]: https://github.com/rust-lang/rust/pull/23419
6411 [fe]: https://github.com/rust-lang/rust/pull/23879
6412 [ie]: https://github.com/rust-lang/rust/pull/23300
6413 [inv]: https://github.com/rust-lang/rust/pull/23938
6414 [ios]: https://github.com/rust-lang/rust/pull/24133
6415 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6416 [lt]: https://github.com/rust-lang/rust/pull/24057
6417 [meth]: https://github.com/rust-lang/rust/pull/24056
6418 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6419 [po]: https://github.com/rust-lang/rust/pull/24270
6420 [sf]: https://github.com/rust-lang/rust/pull/24517
6421 [slp]: https://github.com/rust-lang/rust/pull/23949
6422 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6423 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6424 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6425 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6426 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6427 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6428 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6429 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6430 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6431 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6432 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6433 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6434 [reflect]: https://github.com/rust-lang/rust/pull/23712
6435 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6436 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6437 [index-value]: https://github.com/rust-lang/rust/pull/23601
6438 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6439 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6440 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6441 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6442 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6443 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6444
6445
6446 Version 1.0.0-alpha.2 (2015-02-20)
6447 =====================================
6448
6449 * ~1300 changes, numerous bugfixes
6450
6451 * Highlights
6452
6453     * The various I/O modules were [overhauled][io-rfc] to reduce
6454       unnecessary abstractions and provide better interoperation with
6455       the underlying platform. The old `io` module remains temporarily
6456       at `std::old_io`.
6457     * The standard library now [participates in feature gating][feat],
6458       so use of unstable libraries now requires a `#![feature(...)]`
6459       attribute. The impact of this change is [described on the
6460       forum][feat-forum]. [RFC][feat-rfc].
6461
6462 * Language
6463
6464     * `for` loops [now operate on the `IntoIterator` trait][into],
6465       which eliminates the need to call `.iter()`, etc. to iterate
6466       over collections. There are some new subtleties to remember
6467       though regarding what sort of iterators various types yield, in
6468       particular that `for foo in bar { }` yields values from a move
6469       iterator, destroying the original collection. [RFC][into-rfc].
6470     * Objects now have [default lifetime bounds][obj], so you don't
6471       have to write `Box<Trait+'static>` when you don't care about
6472       storing references. [RFC][obj-rfc].
6473     * In types that implement `Drop`, [lifetimes must outlive the
6474       value][drop]. This will soon make it possible to safely
6475       implement `Drop` for types where `#[unsafe_destructor]` is now
6476       required. Read the [gorgeous RFC][drop-rfc] for details.
6477     * The fully qualified <T as Trait>::X syntax lets you set the Self
6478       type for a trait method or associated type. [RFC][ufcs-rfc].
6479     * References to types that implement `Deref<U>` now [automatically
6480       coerce to references][deref] to the dereferenced type `U`,
6481       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6482       should eliminate many unsightly uses of `&*`, as when converting
6483       from references to vectors into references to
6484       slices. [RFC][deref-rfc].
6485     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6486       `|:|`) is obsolete and closure kind is inferred from context.
6487     * [`Self` is a keyword][Self].
6488
6489 * Libraries
6490
6491     * The `Show` and `String` formatting traits [have been
6492       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6493       their related purposes. Automatically getting a string
6494       conversion to use with `format!("{:?}", something_to_debug)` is
6495       now written `#[derive(Debug)]`.
6496     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6497       OsStr}`, provide strings in platform-specific encodings for easier
6498       interop with system APIs. [RFC][osstr-rfc].
6499     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6500       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6501       creating raw pointers.
6502
6503 * Tooling
6504
6505     * Certain long error messages of the form 'expected foo found bar'
6506       are now [split neatly across multiple
6507       lines][multiline]. Examples in the PR.
6508     * On Unix Rust can be [uninstalled][un] by running
6509       `/usr/local/lib/rustlib/uninstall.sh`.
6510     * The `#[rustc_on_unimplemented]` attribute, requiring the
6511       'on_unimplemented' feature, lets rustc [display custom error
6512       messages when a trait is expected to be implemented for a type
6513       but is not][onun].
6514
6515 * Misc
6516
6517     * Rust is tested against a [LALR grammar][lalr], which parses
6518       almost all the Rust files that rustc does.
6519
6520 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6521 [close]: https://github.com/rust-lang/rust/pull/21843
6522 [deref]: https://github.com/rust-lang/rust/pull/21351
6523 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6524 [drop]: https://github.com/rust-lang/rust/pull/21972
6525 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6526 [feat]: https://github.com/rust-lang/rust/pull/21248
6527 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6528 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6529 [fmt]: https://github.com/rust-lang/rust/pull/21457
6530 [into]: https://github.com/rust-lang/rust/pull/20790
6531 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6532 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6533 [lalr]: https://github.com/rust-lang/rust/pull/21452
6534 [multiline]: https://github.com/rust-lang/rust/pull/19870
6535 [obj]: https://github.com/rust-lang/rust/pull/22230
6536 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6537 [onun]: https://github.com/rust-lang/rust/pull/20889
6538 [osstr]: https://github.com/rust-lang/rust/pull/21488
6539 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6540 [Self]: https://github.com/rust-lang/rust/pull/22158
6541 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6542 [un]: https://github.com/rust-lang/rust/pull/22256
6543
6544
6545 Version 1.0.0-alpha (2015-01-09)
6546 ==================================
6547
6548   * ~2400 changes, numerous bugfixes
6549
6550   * Highlights
6551
6552     * The language itself is considered feature complete for 1.0,
6553       though there will be many usability improvements and bugfixes
6554       before the final release.
6555     * Nearly 50% of the public API surface of the standard library has
6556       been declared 'stable'. Those interfaces are unlikely to change
6557       before 1.0.
6558     * The long-running debate over integer types has been
6559       [settled][ints]: Rust will ship with types named `isize` and
6560       `usize`, rather than `int` and `uint`, for pointer-sized
6561       integers. Guidelines will be rolled out during the alpha cycle.
6562     * Most crates that are not `std` have been moved out of the Rust
6563       distribution into the Cargo ecosystem so they can evolve
6564       separately and don't need to be stabilized as quickly, including
6565       'time', 'getopts', 'num', 'regex', and 'term'.
6566     * Documentation continues to be expanded with more API coverage, more
6567       examples, and more in-depth explanations. The guides have been
6568       consolidated into [The Rust Programming Language][trpl].
6569     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6570     * All official Rust binary installers now come with [Cargo], the
6571       Rust package manager.
6572
6573 * Language
6574
6575     * Closures have been [completely redesigned][unboxed] to be
6576       implemented in terms of traits, can now be used as generic type
6577       bounds and thus monomorphized and inlined, or via an opaque
6578       pointer (boxed) as in the old system. The new system is often
6579       referred to as 'unboxed' closures.
6580     * Traits now support [associated types][assoc], allowing families
6581       of related types to be defined together and used generically in
6582       powerful ways.
6583     * Enum variants are [namespaced by their type names][enum].
6584     * [`where` clauses][where] provide a more versatile and attractive
6585       syntax for specifying generic bounds, though the previous syntax
6586       remains valid.
6587     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6588       numeric types.
6589     * Rust [no longer has a runtime][rt] of any description, and only
6590       supports OS threads, not green threads.
6591     * At long last, Rust has been overhauled for 'dynamically-sized
6592       types' ([DST]), which integrates 'fat pointers' (object types,
6593       arrays, and `str`) more deeply into the type system, making it
6594       more consistent.
6595     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6596       `..j` that produce range types and which, when combined with the
6597       `Index` operator and multidispatch, leads to a convenient slice
6598       notation, `[i..j]`.
6599     * The new range syntax revealed an ambiguity in the fixed-length
6600       array syntax, so now fixed length arrays [are written `[T;
6601       N]`][arrays].
6602     * The `Copy` trait is no longer implemented automatically. Unsafe
6603       pointers no longer implement `Sync` and `Send` so types
6604       containing them don't automatically either. `Sync` and `Send`
6605       are now 'unsafe traits' so one can "forcibly" implement them via
6606       `unsafe impl` if a type confirms to the requirements for them
6607       even though the internals do not (e.g. structs containing unsafe
6608       pointers like `Arc`). These changes are intended to prevent some
6609       footguns and are collectively known as [opt-in built-in
6610       traits][oibit] (though `Sync` and `Send` will soon become pure
6611       library types unknown to the compiler).
6612     * Operator traits now take their operands [by value][ops], and
6613       comparison traits can use multidispatch to compare one type
6614       against multiple other types, allowing e.g. `String` to be
6615       compared with `&str`.
6616     * `if let` and `while let` are no longer feature-gated.
6617     * Rust has adopted a more [uniform syntax for escaping unicode
6618       characters][unicode].
6619     * `macro_rules!` [has been declared stable][mac]. Though it is a
6620       flawed system it is sufficiently popular that it must be usable
6621       for 1.0. Effort has gone into [future-proofing][mac-future] it
6622       in ways that will allow other macro systems to be developed in
6623       parallel, and won't otherwise impact the evolution of the
6624       language.
6625     * The prelude has been [pared back significantly][prelude] such
6626       that it is the minimum necessary to support the most pervasive
6627       code patterns, and through [generalized where clauses][where]
6628       many of the prelude extension traits have been consolidated.
6629     * Rust's rudimentary reflection [has been removed][refl], as it
6630       incurred too much code generation for little benefit.
6631     * [Struct variants][structvars] are no longer feature-gated.
6632     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6633       known as 'higher-ranked trait bounds', this crucially allows
6634       unboxed closures to work.
6635     * Macros invocations surrounded by parens or square brackets and
6636       not terminated by a semicolon are [parsed as
6637       expressions][macros], which makes expressions like `vec![1i32,
6638       2, 3].len()` work as expected.
6639     * Trait objects now implement their traits automatically, and
6640       traits that can be coerced to objects now must be [object
6641       safe][objsafe].
6642     * Automatically deriving traits is now done with `#[derive(...)]`
6643       not `#[deriving(...)]` for [consistency with other naming
6644       conventions][derive].
6645     * Importing the containing module or enum at the same time as
6646       items or variants they contain is [now done with `self` instead
6647       of `mod`][self], as in use `foo::{self, bar}`
6648     * Glob imports are no longer feature-gated.
6649     * The `box` operator and `box` patterns have been feature-gated
6650       pending a redesign. For now unique boxes should be allocated
6651       like other containers, with `Box::new`.
6652
6653 * Libraries
6654
6655     * A [series][coll1] of [efforts][coll2] to establish
6656       [conventions][coll3] for collections types has resulted in API
6657       improvements throughout the standard library.
6658     * New [APIs for error handling][err] provide ergonomic interop
6659       between error types, and [new conventions][err-conv] describe
6660       more clearly the recommended error handling strategies in Rust.
6661     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6662       it is easier to discuss failure in the context of error handling
6663       without making clarifications as to whether you are referring to
6664       the 'fail' macro or failure more generally.
6665     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6666       syscall when available.
6667     * The 'serialize' crate has been renamed 'rustc-serialize' and
6668       moved out of the distribution to Cargo. Although it is widely
6669       used now, it is expected to be superseded in the near future.
6670     * The `Show` formatter, typically implemented with
6671       `#[derive(Show)]` is [now requested with the `{:?}`
6672       specifier][show] and is intended for use by all types, for uses
6673       such as `println!` debugging. The new `String` formatter must be
6674       implemented by hand, uses the `{}` specifier, and is intended
6675       for full-fidelity conversions of things that can logically be
6676       represented as strings.
6677
6678 * Tooling
6679
6680     * [Flexible target specification][flex] allows rustc's code
6681       generation to be configured to support otherwise-unsupported
6682       platforms.
6683     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6684       respective debuggers with Rust-appropriate pretty-printing.
6685     * The Windows installation of Rust is distributed with the
6686       MinGW components currently required to link binaries on that
6687       platform.
6688
6689 * Misc
6690
6691     * Nullable enum optimizations have been extended to more types so
6692       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6693       space than the inner types themselves.
6694     * Work has begun on supporting AArch64.
6695
6696 [Cargo]: https://crates.io
6697 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6698 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6699 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6700 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6701 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6702 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6703 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6704 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6705 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6706 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6707 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6708 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6709 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6710 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6711 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6712 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6713 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6714 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6715 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6716 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6717 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6718 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6719 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6720 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6721 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6722 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6723 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6724 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6725 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6726 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6727 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6728 [trpl]: https://doc.rust-lang.org/book/index.html
6729 [rbe]: http://rustbyexample.com/
6730
6731
6732 Version 0.12.0 (2014-10-09)
6733 =============================
6734
6735   * ~1900 changes, numerous bugfixes
6736
6737   * Highlights
6738
6739     * The introductory documentation (now called The Rust Guide) has
6740       been completely rewritten, as have a number of supplementary
6741       guides.
6742     * Rust's package manager, Cargo, continues to improve and is
6743       sometimes considered to be quite awesome.
6744     * Many API's in `std` have been reviewed and updated for
6745       consistency with the in-development Rust coding
6746       guidelines. The standard library documentation tracks
6747       stabilization progress.
6748     * Minor libraries have been moved out-of-tree to the rust-lang org
6749       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6750       be installed with Cargo.
6751     * Lifetime elision allows lifetime annotations to be left off of
6752       function declarations in many common scenarios.
6753     * Rust now works on 64-bit Windows.
6754
6755   * Language
6756     * Indexing can be overloaded with the `Index` and `IndexMut`
6757       traits.
6758     * The `if let` construct takes a branch only if the `let` pattern
6759       matches, currently behind the 'if_let' feature gate.
6760     * 'where clauses', a more flexible syntax for specifying trait
6761       bounds that is more aesthetic, have been added for traits and
6762       free functions. Where clauses will in the future make it
6763       possible to constrain associated types, which would be
6764       impossible with the existing syntax.
6765     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
6766       the 'slicing_syntax' feature gate, and can be overloaded with
6767       the `Slice` or `SliceMut` traits.
6768     * The syntax for matching of sub-slices has been changed to use a
6769       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
6770       consistency with other uses of `..` and to future-proof
6771       potential additional uses of the syntax.
6772     * The syntax for matching inclusive ranges in patterns has changed
6773       from `0..3` to `0...4` to be consistent with the exclusive range
6774       syntax for slicing.
6775     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
6776       c]`) has been put behind the 'advanced_slice_patterns' feature
6777       gate and may be removed in the future.
6778     * Components of tuples and tuple structs can be extracted using
6779       the `value.0` syntax, currently behind the `tuple_indexing`
6780       feature gate.
6781     * The `#[crate_id]` attribute is no longer supported; versioning
6782       is handled by the package manager.
6783     * Renaming crate imports are now written `extern crate foo as bar`
6784       instead of `extern crate bar = foo`.
6785     * Renaming use statements are now written `use foo as bar` instead
6786       of `use bar = foo`.
6787     * `let` and `match` bindings and argument names in macros are now
6788       hygienic.
6789     * The new, more efficient, closure types ('unboxed closures') have
6790       been added under a feature gate, 'unboxed_closures'. These will
6791       soon replace the existing closure types, once higher-ranked
6792       trait lifetimes are added to the language.
6793     * `move` has been added as a keyword, for indicating closures
6794       that capture by value.
6795     * Mutation and assignment is no longer allowed in pattern guards.
6796     * Generic structs and enums can now have trait bounds.
6797     * The `Share` trait is now called `Sync` to free up the term
6798       'shared' to refer to 'shared reference' (the default reference
6799       type.
6800     * Dynamically-sized types have been mostly implemented,
6801       unifying the behavior of fat-pointer types with the rest of the
6802       type system.
6803     * As part of dynamically-sized types, the `Sized` trait has been
6804       introduced, which qualifying types implement by default, and
6805       which type parameters expect by default. To specify that a type
6806       parameter does not need to be sized, write `<Sized? T>`. Most
6807       types are `Sized`, notable exceptions being unsized arrays
6808       (`[T]`) and trait types.
6809     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
6810     * Lifetime bounds can now be applied to type parameters and object
6811       types.
6812     * The old, reference counted GC type, `Gc<T>` which was once
6813       denoted by the `@` sigil, has finally been removed. GC will be
6814       revisited in the future.
6815
6816   * Libraries
6817     * Library documentation has been improved for a number of modules.
6818     * Bit-vectors, collections::bitv has been modernized.
6819     * The url crate is deprecated in favor of
6820       http://github.com/servo/rust-url, which can be installed with
6821       Cargo.
6822     * Most I/O stream types can be cloned and subsequently closed from
6823       a different thread.
6824     * A `std::time::Duration` type has been added for use in I/O
6825       methods that rely on timers, as well as in the 'time' crate's
6826       `Timespec` arithmetic.
6827     * The runtime I/O abstraction layer that enabled the green thread
6828       scheduler to do non-thread-blocking I/O has been removed, along
6829       with the libuv-based implementation employed by the green thread
6830       scheduler. This will greatly simplify the future I/O work.
6831     * `collections::btree` has been rewritten to have a more
6832       idiomatic and efficient design.
6833
6834   * Tooling
6835     * rustdoc output now indicates the stability levels of API's.
6836     * The `--crate-name` flag can specify the name of the crate
6837       being compiled, like `#[crate_name]`.
6838     * The `-C metadata` specifies additional metadata to hash into
6839       symbol names, and `-C extra-filename` specifies additional
6840       information to put into the output filename, for use by the
6841       package manager for versioning.
6842     * debug info generation has continued to improve and should be
6843       more reliable under both gdb and lldb.
6844     * rustc has experimental support for compiling in parallel
6845       using the `-C codegen-units` flag.
6846     * rustc no longer encodes rpath information into binaries by
6847       default.
6848
6849   * Misc
6850     * Stack usage has been optimized with LLVM lifetime annotations.
6851     * Official Rust binaries on Linux are more compatible with older
6852       kernels and distributions, built on CentOS 5.10.
6853
6854
6855 Version 0.11.0 (2014-07-02)
6856 ==========================
6857
6858   * ~1700 changes, numerous bugfixes
6859
6860   * Language
6861     * ~[T] has been removed from the language. This type is superseded by
6862       the Vec<T> type.
6863     * ~str has been removed from the language. This type is superseded by
6864       the String type.
6865     * ~T has been removed from the language. This type is superseded by the
6866       Box<T> type.
6867     * @T has been removed from the language. This type is superseded by the
6868       standard library's std::gc::Gc<T> type.
6869     * Struct fields are now all private by default.
6870     * Vector indices and shift amounts are both required to be a `uint`
6871       instead of any integral type.
6872     * Byte character, byte string, and raw byte string literals are now all
6873       supported by prefixing the normal literal with a `b`.
6874     * Multiple ABIs are no longer allowed in an ABI string
6875     * The syntax for lifetimes on closures/procedures has been tweaked
6876       slightly: `<'a>|A, B|: 'b + K -> T`
6877     * Floating point modulus has been removed from the language; however it
6878       is still provided by a library implementation.
6879     * Private enum variants are now disallowed.
6880     * The `priv` keyword has been removed from the language.
6881     * A closure can no longer be invoked through a &-pointer.
6882     * The `use foo, bar, baz;` syntax has been removed from the language.
6883     * The transmute intrinsic no longer works on type parameters.
6884     * Statics now allow blocks/items in their definition.
6885     * Trait bounds are separated from objects with + instead of : now.
6886     * Objects can no longer be read while they are mutably borrowed.
6887     * The address of a static is now marked as insignificant unless the
6888       #[inline(never)] attribute is placed it.
6889     * The #[unsafe_destructor] attribute is now behind a feature gate.
6890     * Struct literals are no longer allowed in ambiguous positions such as
6891       if, while, match, and for..in.
6892     * Declaration of lang items and intrinsics are now feature-gated by
6893       default.
6894     * Integral literals no longer default to `int`, and floating point
6895       literals no longer default to `f64`. Literals must be suffixed with an
6896       appropriate type if inference cannot determine the type of the
6897       literal.
6898     * The Box<T> type is no longer implicitly borrowed to &mut T.
6899     * Procedures are now required to not capture borrowed references.
6900
6901   * Libraries
6902     * The standard library is now a "facade" over a number of underlying
6903       libraries. This means that development on the standard library should
6904       be speedier due to smaller crates, as well as a clearer line between
6905       all dependencies.
6906     * A new library, libcore, lives under the standard library's facade
6907       which is Rust's "0-assumption" library, suitable for embedded and
6908       kernel development for example.
6909     * A regex crate has been added to the standard distribution. This crate
6910       includes statically compiled regular expressions.
6911     * The unwrap/unwrap_err methods on Result require a Show bound for
6912       better error messages.
6913     * The return types of the std::comm primitives have been centralized
6914       around the Result type.
6915     * A number of I/O primitives have gained the ability to time out their
6916       operations.
6917     * A number of I/O primitives have gained the ability to close their
6918       reading/writing halves to cancel pending operations.
6919     * Reverse iterator methods have been removed in favor of `rev()` on
6920       their forward-iteration counterparts.
6921     * A bitflags! macro has been added to enable easy interop with C and
6922       management of bit flags.
6923     * A debug_assert! macro is now provided which is disabled when
6924       `--cfg ndebug` is passed to the compiler.
6925     * A graphviz crate has been added for creating .dot files.
6926     * The std::cast module has been migrated into std::mem.
6927     * The std::local_data api has been migrated from freestanding functions
6928       to being based on methods.
6929     * The Pod trait has been renamed to Copy.
6930     * jemalloc has been added as the default allocator for types.
6931     * The API for allocating memory has been changed to use proper alignment
6932       and sized deallocation
6933     * Connecting a TcpStream or binding a TcpListener is now based on a
6934       string address and a u16 port. This allows connecting to a hostname as
6935       opposed to an IP.
6936     * The Reader trait now contains a core method, read_at_least(), which
6937       correctly handles many repeated 0-length reads.
6938     * The process-spawning API is now centered around a builder-style
6939       Command struct.
6940     * The :? printing qualifier has been moved from the standard library to
6941       an external libdebug crate.
6942     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6943       have been renamed to Eq/Ord.
6944     * The select/plural methods have been removed from format!. The escapes
6945       for { and } have also changed from \{ and \} to {{ and }},
6946       respectively.
6947     * The TaskBuilder API has been re-worked to be a true builder, and
6948       extension traits for spawning native/green tasks have been added.
6949
6950   * Tooling
6951     * All breaking changes to the language or libraries now have their
6952       commit message annotated with `[breaking-change]` to allow for easy
6953       discovery of breaking changes.
6954     * The compiler will now try to suggest how to annotate lifetimes if a
6955       lifetime-related error occurs.
6956     * Debug info continues to be improved greatly with general bug fixes and
6957       better support for situations like link time optimization (LTO).
6958     * Usage of syntax extensions when cross-compiling has been fixed.
6959     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6960       -fdata-sections and --gc-sections has been enabled by default
6961     * The compiler is now stricter about where it will load module files
6962       from when a module is declared via `mod foo;`.
6963     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6964       Syntax extensions are now discovered via a "plugin registrar" type
6965       which will be extended in the future to other various plugins.
6966     * Lints have been restructured to allow for dynamically loadable lints.
6967     * A number of rustdoc improvements:
6968       * The HTML output has been visually redesigned.
6969       * Markdown is now powered by hoedown instead of sundown.
6970       * Searching heuristics have been greatly improved.
6971       * The search index has been reduced in size by a great amount.
6972       * Cross-crate documentation via `pub use` has been greatly improved.
6973       * Primitive types are now hyperlinked and documented.
6974     * Documentation has been moved from static.rust-lang.org/doc to
6975       doc.rust-lang.org
6976     * A new sandbox, play.rust-lang.org, is available for running and
6977       sharing rust code examples on-line.
6978     * Unused attributes are now more robustly warned about.
6979     * The dead_code lint now warns about unused struct fields.
6980     * Cross-compiling to iOS is now supported.
6981     * Cross-compiling to mipsel is now supported.
6982     * Stability attributes are now inherited by default and no longer apply
6983       to intra-crate usage, only inter-crate usage.
6984     * Error message related to non-exhaustive match expressions have been
6985       greatly improved.
6986
6987
6988 Version 0.10 (2014-04-03)
6989 =========================
6990
6991   * ~1500 changes, numerous bugfixes
6992
6993   * Language
6994     * A new RFC process is now in place for modifying the language.
6995     * Patterns with `@`-pointers have been removed from the language.
6996     * Patterns with unique vectors (`~[T]`) have been removed from the
6997       language.
6998     * Patterns with unique strings (`~str`) have been removed from the
6999       language.
7000     * `@str` has been removed from the language.
7001     * `@[T]` has been removed from the language.
7002     * `@self` has been removed from the language.
7003     * `@Trait` has been removed from the language.
7004     * Headers on `~` allocations which contain `@` boxes inside the type for
7005       reference counting have been removed.
7006     * The semantics around the lifetimes of temporary expressions have changed,
7007       see #3511 and #11585 for more information.
7008     * Cross-crate syntax extensions are now possible, but feature gated. See
7009       #11151 for more information. This includes both `macro_rules!` macros as
7010       well as syntax extensions such as `format!`.
7011     * New lint modes have been added, and older ones have been turned on to be
7012       warn-by-default.
7013       * Unnecessary parentheses
7014       * Uppercase statics
7015       * Camel Case types
7016       * Uppercase variables
7017       * Publicly visible private types
7018       * `#[deriving]` with raw pointers
7019     * Unsafe functions can no longer be coerced to closures.
7020     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7021     * The `#[simd]` attribute is now behind a feature gate.
7022     * Visibility is no longer allowed on `extern crate` statements, and
7023       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7024     * Trailing commas are now allowed in argument lists and tuple patterns.
7025     * The `do` keyword has been removed, it is now a reserved keyword.
7026     * Default type parameters have been implemented, but are feature gated.
7027     * Borrowed variables through captures in closures are now considered soundly.
7028     * `extern mod` is now `extern crate`
7029     * The `Freeze` trait has been removed.
7030     * The `Share` trait has been added for types that can be shared among
7031       threads.
7032     * Labels in macros are now hygienic.
7033     * Expression/statement macro invocations can be delimited with `{}` now.
7034     * Treatment of types allowed in `static mut` locations has been tweaked.
7035     * The `*` and `.` operators are now overloadable through the `Deref` and
7036       `DerefMut` traits.
7037     * `~Trait` and `proc` no longer have `Send` bounds by default.
7038     * Partial type hints are now supported with the `_` type marker.
7039     * An `Unsafe` type was introduced for interior mutability. It is now
7040       considered undefined to transmute from `&T` to `&mut T` without using the
7041       `Unsafe` type.
7042     * The #[linkage] attribute was implemented for extern statics/functions.
7043     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7044     * `Pod` was renamed to `Copy`.
7045
7046   * Libraries
7047     * The `libextra` library has been removed. It has now been decomposed into
7048       component libraries with smaller and more focused nuggets of
7049       functionality. The full list of libraries can be found on the
7050       documentation index page.
7051     * std: `std::condition` has been removed. All I/O errors are now propagated
7052       through the `Result` type. In order to assist with error handling, a
7053       `try!` macro for unwrapping errors with an early return and a lint for
7054       unused results has been added. See #12039 for more information.
7055     * std: The `vec` module has been renamed to `slice`.
7056     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7057       This will become the only growable vector in the future.
7058     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7059       are now found at `std::io::BufferedReader` instead of
7060       `std::io::buffered::BufferedReader`.
7061     * std: `print` and `println` are no longer in the prelude, the `print!` and
7062       `println!` macros are intended to be used instead.
7063     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7064       attempts to statically prevent cycles.
7065     * std: The standard distribution is adopting the policy of pushing failure
7066       to the user rather than failing in libraries. Many functions (such as
7067       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7068     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7069       deriving mode: `#[deriving(Show)]`.
7070     * std: `ToStr` is now implemented for all types implementing `Show`.
7071     * std: The formatting trait methods now take `&self` instead of `&T`
7072     * std: The `invert()` method on iterators has been renamed to `rev()`
7073     * std: `std::num` has seen a reduction in the genericity of its traits,
7074       consolidating functionality into a few core traits.
7075     * std: Backtraces are now printed on task failure if the environment
7076       variable `RUST_BACKTRACE` is present.
7077     * std: Naming conventions for iterators have been standardized. More details
7078       can be found on the wiki's style guide.
7079     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7080       still implement the function.
7081     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7082     * std: `assert_approx_eq!` has been removed
7083     * std: The `e` and `E` formatting specifiers for floats have been added to
7084       print them in exponential notation.
7085     * std: The `Times` trait has been removed
7086     * std: Indications of variance and opting out of builtin bounds is done
7087       through marker types in `std::kinds::marker` now
7088     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7089       `#[deriving(Hash)]` is now possible.
7090     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7091     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7092     * std: `Chan::new` is now `channel()`.
7093     * std: A new synchronous channel type has been implemented.
7094     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7095     * std: `hashmap` and `trie` have been moved to `libcollections`
7096     * std: `run` has been rolled into `io::process`
7097     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7098     * std: The equality and comparison traits have seen some reorganization.
7099     * std: `rand` has moved to `librand`.
7100     * std: `to_{lower,upper}case` has been implemented for `char`.
7101     * std: Logging has been moved to `liblog`.
7102     * collections: `HashMap` has been rewritten for higher performance and less
7103       memory usage.
7104     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7105       it can be booted manually. The runtime guide has more information and
7106       examples.
7107     * native: All I/O functionality except signals has been implemented.
7108     * green: Task spawning with `libgreen` has been optimized with stack caching
7109       and various trimming of code.
7110     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7111     * sync: The `extra::sync` module has been updated to modern rust (and moved
7112       to the `sync` library), tweaking and improving various interfaces while
7113       dropping redundant functionality.
7114     * sync: A new `Barrier` type has been added to the `sync` library.
7115     * sync: An efficient mutex for native and green tasks has been implemented.
7116     * serialize: The `base64` module has seen some improvement. It treats
7117       newlines better, has non-string error values, and has seen general
7118       cleanup.
7119     * fourcc: A `fourcc!` macro was introduced
7120     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7121       hexadecimal literal.
7122
7123   * Tooling
7124     * `rustpkg` has been deprecated and removed from the main repository. Its
7125       replacement, `cargo`, is under development.
7126     * Nightly builds of rust are now available
7127     * The memory usage of rustc has been improved many times throughout this
7128       release cycle.
7129     * The build process supports disabling rpath support for the rustc binary
7130       itself.
7131     * Code generation has improved in some cases, giving more information to the
7132       LLVM optimization passes to enable more extensive optimizations.
7133     * Debuginfo compatibility with lldb on OSX has been restored.
7134     * The master branch is now gated on an android bot, making building for
7135       android much more reliable.
7136     * Output flags have been centralized into one `--emit` flag.
7137     * Crate type flags have been centralized into one `--crate-type` flag.
7138     * Codegen flags have been consolidated behind a `-C` flag.
7139     * Linking against outdated crates now has improved error messages.
7140     * Error messages with lifetimes will often suggest how to annotate the
7141       function to fix the error.
7142     * Many more types are documented in the standard library, and new guides
7143       were written.
7144     * Many `rustdoc` improvements:
7145       * code blocks are syntax highlighted.
7146       * render standalone markdown files.
7147       * the --test flag tests all code blocks by default.
7148       * exported macros are displayed.
7149       * re-exported types have their documentation inlined at the location of the
7150         first re-export.
7151       * search works across crates that have been rendered to the same output
7152         directory.
7153
7154
7155 Version 0.9 (2014-01-09)
7156 ==========================
7157
7158    * ~1800 changes, numerous bugfixes
7159
7160    * Language
7161       * The `float` type has been removed. Use `f32` or `f64` instead.
7162       * A new facility for enabling experimental features (feature gating) has
7163         been added, using the crate-level `#[feature(foo)]` attribute.
7164       * Managed boxes (@) are now behind a feature gate
7165         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7166         standard library's `Gc` or `Rc` types instead.
7167       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7168       * Jumping back to the top of a loop is now done with `continue` instead of
7169         `loop`.
7170       * Strings can no longer be mutated through index assignment.
7171       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7172         hash delimiters, as in `r###"foo"###`.
7173       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7174         called once.
7175       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7176       * `@fn`s have been removed.
7177       * `do` only works with procs in order to make it obvious what the cost
7178         of `do` is.
7179       * Single-element tuple-like structs can no longer be dereferenced to
7180         obtain the inner value. A more comprehensive solution for overloading
7181         the dereference operator will be provided in the future.
7182       * The `#[link(...)]` attribute has been replaced with
7183         `#[crate_id = "name#vers"]`.
7184       * Empty `impl`s must be terminated with empty braces and may not be
7185         terminated with a semicolon.
7186       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7187         no longer has any special meaning.
7188       * The old `fmt!` string formatting macro has been removed.
7189       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7190         `print!` and `println!`.
7191       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7192       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7193         `extern mod foo = "bar"` instead.
7194       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7195       * Macros can have attributes.
7196       * Macros can expand to items with attributes.
7197       * Macros can expand to multiple items.
7198       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7199       * Comments may be nested.
7200       * Values automatically coerce to trait objects they implement, without
7201         an explicit `as`.
7202       * Enum discriminants are no longer an entire word but as small as needed to
7203         contain all the variants. The `repr` attribute can be used to override
7204         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7205         `#[repr(C)]` to match C enums.
7206       * Non-string literals are not allowed in attributes (they never worked).
7207       * The FFI now supports variadic functions.
7208       * Octal numeric literals, as in `0o7777`.
7209       * The `concat!` syntax extension performs compile-time string concatenation.
7210       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7211         removed as Rust no longer uses segmented stacks.
7212       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7213       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7214         not `*`; ignoring remaining fields of a struct is also done with `..`,
7215         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7216       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7217       * `rustc` supports the "system" calling convention, which defaults to the
7218         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7219         "C" elsewhere.
7220       * The `type_overflow` lint (default: warn) checks literals for overflow.
7221       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7222       * The `attribute_usage` lint (default: warn) warns about unknown
7223         attributes.
7224       * The `unknown_features` lint (default: warn) warns about unknown
7225         feature gates.
7226       * The `dead_code` lint (default: warn) checks for dead code.
7227       * Rust libraries can be linked statically to one another
7228       * `#[link_args]` is behind the `link_args` feature gate.
7229       * Native libraries are now linked with `#[link(name = "foo")]`
7230       * Native libraries can be statically linked to a rust crate
7231         (`#[link(name = "foo", kind = "static")]`).
7232       * Native OS X frameworks are now officially supported
7233         (`#[link(name = "foo", kind = "framework")]`).
7234       * The `#[thread_local]` attribute creates thread-local (not task-local)
7235         variables. Currently behind the `thread_local` feature gate.
7236       * The `return` keyword may be used in closures.
7237       * Types that can be copied via a memcpy implement the `Pod` kind.
7238       * The `cfg` attribute can now be used on struct fields and enum variants.
7239
7240    * Libraries
7241       * std: The `option` and `result` API's have been overhauled to make them
7242         simpler, more consistent, and more composable.
7243       * std: The entire `std::io` module has been replaced with one that is
7244         more comprehensive and that properly interfaces with the underlying
7245         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7246         implemented.
7247       * std: `io::util` contains a number of useful implementations of
7248         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7249         `ZeroReader`, `TeeReader`.
7250       * std: The reference counted pointer type `extra::rc` moved into std.
7251       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7252         just a wrapper around it).
7253       * std: The `Either` type has been removed.
7254       * std: `fmt::Default` can be implemented for any type to provide default
7255         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7256       * std: The `rand` API continues to be tweaked.
7257       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7258         on failure in gdb, is now named `rust_fail`.
7259       * std: The `each_key` and `each_value` methods on `HashMap` have been
7260         replaced by the `keys` and `values` iterators.
7261       * std: Functions dealing with type size and alignment have moved from the
7262         `sys` module to the `mem` module.
7263       * std: The `path` module was written and API changed.
7264       * std: `str::from_utf8` has been changed to cast instead of allocate.
7265       * std: `starts_with` and `ends_with` methods added to vectors via the
7266         `ImmutableEqVector` trait, which is in the prelude.
7267       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7268         if the index is out of bounds.
7269       * std: Task failure no longer propagates between tasks, as the model was
7270         complex, expensive, and incompatible with thread-based tasks.
7271       * std: The `Any` type can be used for dynamic typing.
7272       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7273         `task::try`.
7274       * std: Methods that produce iterators generally do not have an `_iter`
7275         suffix now.
7276       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7277         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7278       * std: `util::ignore` renamed to `prelude::drop`.
7279       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7280         trait.
7281       * std: `vec::raw` has seen a lot of cleanup and API changes.
7282       * std: The standard library no longer includes any C++ code, and very
7283         minimal C, eliminating the dependency on libstdc++.
7284       * std: Runtime scheduling and I/O functionality has been factored out into
7285         extensible interfaces and is now implemented by two different crates:
7286         libnative, for native threading and I/O; and libgreen, for green threading
7287         and I/O. This paves the way for using the standard library in more limited
7288         embedded environments.
7289       * std: The `comm` module has been rewritten to be much faster, have a
7290         simpler, more consistent API, and to work for both native and green
7291         threading.
7292       * std: All libuv dependencies have been moved into the rustuv crate.
7293       * native: New implementations of runtime scheduling on top of OS threads.
7294       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7295         and other I/O.
7296       * green: The green thread scheduler and message passing types are almost
7297         entirely lock-free.
7298       * extra: The `flatpipes` module had bitrotted and was removed.
7299       * extra: All crypto functions have been removed and Rust now has a policy of
7300         not reimplementing crypto in the standard library. In the future crypto
7301         will be provided by external crates with bindings to established libraries.
7302       * extra: `c_vec` has been modernized.
7303       * extra: The `sort` module has been removed. Use the `sort` method on
7304         mutable slices.
7305
7306    * Tooling
7307       * The `rust` and `rusti` commands have been removed, due to lack of
7308         maintenance.
7309       * `rustdoc` was completely rewritten.
7310       * `rustdoc` can test code examples in documentation.
7311       * `rustpkg` can test packages with the argument, 'test'.
7312       * `rustpkg` supports arbitrary dependencies, including C libraries.
7313       * `rustc`'s support for generating debug info is improved again.
7314       * `rustc` has better error reporting for unbalanced delimiters.
7315       * `rustc`'s JIT support was removed due to bitrot.
7316       * Executables and static libraries can be built with LTO (-Z lto)
7317       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7318         build tools.
7319
7320
7321 Version 0.8 (2013-09-26)
7322 ============================
7323
7324    * ~2200 changes, numerous bugfixes
7325
7326    * Language
7327       * The `for` loop syntax has changed to work with the `Iterator` trait.
7328       * At long last, unwinding works on Windows.
7329       * Default methods are ready for use.
7330       * Many trait inheritance bugs fixed.
7331       * Owned and borrowed trait objects work more reliably.
7332       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7333       * rustc can omit emission of code for the `debug!` macro if it is passed
7334         `--cfg ndebug`
7335       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7336         for foo.rs, then foo/mod.rs, and will generate an error when both are
7337         present.
7338       * Strings no longer contain trailing nulls. The new `std::c_str` module
7339         provides new mechanisms for converting to C strings.
7340       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7341       * The FFI has been overhauled such that foreign functions are called directly,
7342         instead of through a stack-switching wrapper.
7343       * Calling a foreign function must be done through a Rust function with the
7344         `#[fixed_stack_segment]` attribute.
7345       * The `externfn!` macro can be used to declare both a foreign function and
7346         a `#[fixed_stack_segment]` wrapper at once.
7347       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7348       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7349       * `priv` is disallowed everywhere except for struct fields and enum variants.
7350       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7351       * `ref` bindings in irrefutable patterns work correctly now.
7352       * `char` is now prevented from containing invalid code points.
7353       * Casting to `bool` is no longer allowed.
7354       * `\0` is now accepted as an escape in chars and strings.
7355       * `yield` is a reserved keyword.
7356       * `typeof` is a reserved keyword.
7357       * Crates may be imported by URL with `extern mod foo = "url";`.
7358       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7359       * Static vectors can be initialized with repeating elements,
7360         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7361       * Static structs can be initialized with functional record update,
7362         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7363       * `cfg!` can be used to conditionally execute code based on the crate
7364         configuration, similarly to `#[cfg(...)]`.
7365       * The `unnecessary_qualification` lint detects unneeded module
7366         prefixes (default: allow).
7367       * Arithmetic operations have been implemented on the SIMD types in
7368         `std::unstable::simd`.
7369       * Exchange allocation headers were removed, reducing memory usage.
7370       * `format!` implements a completely new, extensible, and higher-performance
7371         string formatting system. It will replace `fmt!`.
7372       * `print!` and `println!` write formatted strings (using the `format!`
7373         extension) to stdout.
7374       * `write!` and `writeln!` write formatted strings (using the `format!`
7375         extension) to the new Writers in `std::rt::io`.
7376       * The library section in which a function or static is placed may
7377         be specified with `#[link_section = "..."]`.
7378       * The `proto!` syntax extension for defining bounded message protocols
7379         was removed.
7380       * `macro_rules!` is hygienic for `let` declarations.
7381       * The `#[export_name]` attribute specifies the name of a symbol.
7382       * `unreachable!` can be used to indicate unreachable code, and fails
7383         if executed.
7384
7385    * Libraries
7386       * std: Transitioned to the new runtime, written in Rust.
7387       * std: Added an experimental I/O library, `rt::io`, based on the new
7388         runtime.
7389       * std: A new generic `range` function was added to the prelude, replacing
7390         `uint::range` and friends.
7391       * std: `range_rev` no longer exists. Since range is an iterator it can be
7392         reversed with `range(lo, hi).invert()`.
7393       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7394         renamed to `unwrap_or`.
7395       * std: The `iterator` module was renamed to `iter`.
7396       * std: Integral types now support the `checked_add`, `checked_sub`, and
7397         `checked_mul` operations for detecting overflow.
7398       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7399         consistency.
7400       * std: Methods are standardizing on conventions for casting methods:
7401         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7402         and cheap casts.
7403       * std: The `CString` type in `c_str` provides new ways to convert to and
7404         from C strings.
7405       * std: `DoubleEndedIterator` can yield elements in two directions.
7406       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7407         two splices.
7408       * std: `str::from_bytes` renamed to `str::from_utf8`.
7409       * std: `pop_opt` and `shift_opt` methods added to vectors.
7410       * std: The task-local data interface no longer uses @, and keys are
7411         no longer function pointers.
7412       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7413       * std: Added `SharedPort` to `comm`.
7414       * std: `Eq` has a default method for `ne`; only `eq` is required
7415         in implementations.
7416       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7417         is required in implementations.
7418       * std: `is_utf8` performance is improved, impacting many string functions.
7419       * std: `os::MemoryMap` provides cross-platform mmap.
7420       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7421         are not 'in-bounds' are considered undefined.
7422       * std: Many freestanding functions in `vec` removed in favor of methods.
7423       * std: Many freestanding functions on scalar types removed in favor of
7424         methods.
7425       * std: Many options to task builders were removed since they don't make
7426         sense in the new scheduler design.
7427       * std: More containers implement `FromIterator` so can be created by the
7428         `collect` method.
7429       * std: More complete atomic types in `unstable::atomics`.
7430       * std: `comm::PortSet` removed.
7431       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7432         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7433         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7434         default implementations.
7435       * std: Various `from_str` functions were removed in favor of a generic
7436         `from_str` which is available in the prelude.
7437       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7438       * extra: `dlist`, the doubly-linked list was modernized.
7439       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7440       * extra: Added `glob` module, replacing `std::os::glob`.
7441       * extra: `rope` was removed.
7442       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7443       * extra: `net`, and `timer` were removed. The experimental replacements
7444         are `std::rt::io::net` and `std::rt::io::timer`.
7445       * extra: Iterators implemented for `SmallIntMap`.
7446       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7447       * extra: `SmallIntSet` removed. Use `BitvSet`.
7448       * extra: Performance of JSON parsing greatly improved.
7449       * extra: `semver` updated to SemVer 2.0.0.
7450       * extra: `term` handles more terminals correctly.
7451       * extra: `dbg` module removed.
7452       * extra: `par` module removed.
7453       * extra: `future` was cleaned up, with some method renames.
7454       * extra: Most free functions in `getopts` were converted to methods.
7455
7456    * Other
7457       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7458       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7459         similarly to gcc's `--march` flag.
7460       * rustc's performance compiling small crates is much better.
7461       * rustpkg has received many improvements.
7462       * rustpkg supports git tags as package IDs.
7463       * rustpkg builds into target-specific directories so it can be used for
7464         cross-compiling.
7465       * The number of concurrent test tasks is controlled by the environment
7466         variable RUST_TEST_TASKS.
7467       * The test harness can now report metrics for benchmarks.
7468       * All tools have man pages.
7469       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7470       * The runtime uses jemalloc for allocations.
7471       * Segmented stacks are temporarily disabled as part of the transition to
7472         the new runtime. Stack overflows are possible!
7473       * A new documentation backend, rustdoc_ng, is available for use. It is
7474         still invoked through the normal `rustdoc` command.
7475
7476
7477 Version 0.7 (2013-07-03)
7478 =======================
7479
7480    * ~2000 changes, numerous bugfixes
7481
7482    * Language
7483       * `impl`s no longer accept a visibility qualifier. Put them on methods
7484         instead.
7485       * The borrow checker has been rewritten with flow-sensitivity, fixing
7486         many bugs and inconveniences.
7487       * The `self` parameter no longer implicitly means `&'self self`,
7488         and can be explicitly marked with a lifetime.
7489       * Overloadable compound operators (`+=`, etc.) have been temporarily
7490         removed due to bugs.
7491       * The `for` loop protocol now requires `for`-iterators to return `bool`
7492         so they compose better.
7493       * The `Durable` trait is replaced with the `'static` bounds.
7494       * Trait default methods work more often.
7495       * Structs with the `#[packed]` attribute have byte alignment and
7496         no padding between fields.
7497       * Type parameters bound by `Copy` must now be copied explicitly with
7498         the `copy` keyword.
7499       * It is now illegal to move out of a dereferenced unsafe pointer.
7500       * `Option<~T>` is now represented as a nullable pointer.
7501       * `@mut` does dynamic borrow checks correctly.
7502       * The `main` function is only detected at the topmost level of the crate.
7503         The `#[main]` attribute is still valid anywhere.
7504       * Struct fields may no longer be mutable. Use inherited mutability.
7505       * The `#[no_send]` attribute makes a type that would otherwise be
7506         `Send`, not.
7507       * The `#[no_freeze]` attribute makes a type that would otherwise be
7508         `Freeze`, not.
7509       * Unbounded recursion will abort the process after reaching the limit
7510         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7511       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7512         are never implicitly copyable.
7513       * `#[static_assert]` makes compile-time assertions about static bools.
7514       * At long last, 'argument modes' no longer exist.
7515       * The rarely used `use mod` statement no longer exists.
7516
7517    * Syntax extensions
7518       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7519         argument list.
7520       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7521         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7522         `#[deriving(...)]`.
7523       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7524         and unsuffixed integer literals.
7525
7526    * Libraries
7527       * The `core` crate was renamed to `std`.
7528       * The `std` crate was renamed to `extra`.
7529       * More and improved documentation.
7530       * std: `iterator` module for external iterator objects.
7531       * Many old-style (internal, higher-order function) iterators replaced by
7532         implementations of `Iterator`.
7533       * std: Many old internal vector and string iterators,
7534         incl. `any`, `all`. removed.
7535       * std: The `finalize` method of `Drop` renamed to `drop`.
7536       * std: The `drop` method now takes `&mut self` instead of `&self`.
7537       * std: The prelude no longer re-exports any modules, only types and traits.
7538       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7539         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7540       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7541         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7542       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7543         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7544       * std: Many types implement `Clone`.
7545       * std: `path` type renamed to `Path`.
7546       * std: `mut` module and `Mut` type removed.
7547       * std: Many standalone functions removed in favor of methods and iterators
7548         in `vec`, `str`. In the future methods will also work as functions.
7549       * std: `reinterpret_cast` removed. Use `transmute`.
7550       * std: ascii string handling in `std::ascii`.
7551       * std: `Rand` is implemented for ~/@.
7552       * std: `run` module for spawning processes overhauled.
7553       * std: Various atomic types added to `unstable::atomic`.
7554       * std: Various types implement `Zero`.
7555       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7556       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7557       * std: Added `os::mkdir_recursive`.
7558       * std: Added `os::glob` function performs filesystems globs.
7559       * std: `FuzzyEq` renamed to `ApproxEq`.
7560       * std: `Map` now defines `pop` and `swap` methods.
7561       * std: `Cell` constructors converted to static methods.
7562       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7563       * extra: `flate` module moved from `std` to `extra`.
7564       * extra: `fileinput` module for iterating over a series of files.
7565       * extra: `Complex` number type and `complex` module.
7566       * extra: `Rational` number type and `rational` module.
7567       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7568       * extra: `term` uses terminfo now, is more correct.
7569       * extra: `arc` functions converted to methods.
7570       * extra: Implementation of fixed output size variations of SHA-2.
7571
7572    * Tooling
7573       * `unused_variable`  lint mode for unused variables (default: warn).
7574       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7575         (default: warn).
7576       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7577         (default: warn).
7578       * `dead_assignment` lint mode for unread variables (default: warn).
7579       * `unnecessary_allocation` lint mode detects some heap allocations that are
7580         immediately borrowed so could be written without allocating (default: warn).
7581       * `missing_doc` lint mode (default: allow).
7582       * `unreachable_code` lint mode (default: warn).
7583       * The `rusti` command has been rewritten and a number of bugs addressed.
7584       * rustc outputs in color on more terminals.
7585       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7586       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7587       * Compiling with `-g` will make the binary record information about
7588         dynamic borrowcheck failures for debugging.
7589       * rustdoc has a nicer stylesheet.
7590       * Various improvements to rustdoc.
7591       * Improvements to rustpkg (see the detailed release notes).
7592
7593
7594 Version 0.6 (2013-04-03)
7595 ========================
7596
7597    * ~2100 changes, numerous bugfixes
7598
7599    * Syntax changes
7600       * The self type parameter in traits is now spelled `Self`
7601       * The `self` parameter in trait and impl methods must now be explicitly
7602         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7603       * Static methods no longer require the `static` keyword and instead
7604         are distinguished by the lack of a `self` parameter
7605       * Replaced the `Durable` trait with the `'static` lifetime
7606       * The old closure type syntax with the trailing sigil has been
7607         removed in favor of the more consistent leading sigil
7608       * `super` is a keyword, and may be prefixed to paths
7609       * Trait bounds are separated with `+` instead of whitespace
7610       * Traits are implemented with `impl Trait for Type`
7611         instead of `impl Type: Trait`
7612       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7613       * The `export` keyword has finally been removed
7614       * The `move` keyword has been removed (see "Semantic changes")
7615       * The interior mutability qualifier on vectors, `[mut T]`, has been
7616         removed. Use `&mut [T]`, etc.
7617       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7618       * `fail` is no longer a keyword. Use `fail!()`
7619       * `assert` is no longer a keyword. Use `assert!()`
7620       * `log` is no longer a keyword. use `debug!`, etc.
7621       * 1-tuples may be represented as `(T,)`
7622       * Struct fields may no longer be `mut`. Use inherited mutability,
7623         `@mut T`, `core::mut` or `core::cell`
7624       * `extern mod { ... }` is no longer valid syntax for foreign
7625         function modules. Use extern blocks: `extern { ... }`
7626       * Newtype enums removed. Use tuple-structs.
7627       * Trait implementations no longer support visibility modifiers
7628       * Pattern matching over vectors improved and expanded
7629       * `const` renamed to `static` to correspond to lifetime name,
7630         and make room for future `static mut` unsafe mutable globals.
7631       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7632       * `Clone` implementations can be automatically generated with
7633         `#[deriving(Clone)]`
7634       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7635         instead of `foo as Bar`.
7636       * Fixed length vector types are now written as `[int, .. 3]`
7637         instead of `[int * 3]`.
7638       * Fixed length vector types can express the length as a constant
7639         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7640
7641    * Semantic changes
7642       * Types with owned pointers or custom destructors move by default,
7643         eliminating the `move` keyword
7644       * All foreign functions are considered unsafe
7645       * &mut is now unaliasable
7646       * Writes to borrowed @mut pointers are prevented dynamically
7647       * () has size 0
7648       * The name of the main function can be customized using #[main]
7649       * The default type of an inferred closure is &fn instead of @fn
7650       * `use` statements may no longer be "chained" - they cannot import
7651         identifiers imported by previous `use` statements
7652       * `use` statements are crate relative, importing from the "top"
7653         of the crate by default. Paths may be prefixed with `super::`
7654         or `self::` to change the search behavior.
7655       * Method visibility is inherited from the implementation declaration
7656       * Structural records have been removed
7657       * Many more types can be used in static items, including enums
7658         'static-lifetime pointers and vectors
7659       * Pattern matching over vectors improved and expanded
7660       * Typechecking of closure types has been overhauled to
7661         improve inference and eliminate unsoundness
7662       * Macros leave scope at the end of modules, unless that module is
7663         tagged with #[macro_escape]
7664
7665    * Libraries
7666       * Added big integers to `std::bigint`
7667       * Removed `core::oldcomm` module
7668       * Added pipe-based `core::comm` module
7669       * Numeric traits have been reorganized under `core::num`
7670       * `vec::slice` finally returns a slice
7671       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7672       * Containers reorganized around traits in `core::container`
7673       * `core::dvec` removed, `~[T]` is a drop-in replacement
7674       * `core::send_map` renamed to `core::hashmap`
7675       * `std::map` removed; replaced with `core::hashmap`
7676       * `std::treemap` reimplemented as an owned balanced tree
7677       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7678       * `core::trie` added as a fast ordered map for integer keys
7679       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7680       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7681         overload the comparison operators, whereas `TotalOrd` is used
7682         by certain container types
7683
7684    * Other
7685       * Replaced the 'cargo' package manager with 'rustpkg'
7686       * Added all-purpose 'rust' tool
7687       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7688       * rustc now *attempts* to offer spelling suggestions
7689       * Improved support for ARM and Android
7690       * Preliminary MIPS backend
7691       * Improved foreign function ABI implementation for x86, x86_64
7692       * Various memory usage improvements
7693       * Rust code may be embedded in foreign code under limited circumstances
7694       * Inline assembler supported by new asm!() syntax extension.
7695
7696
7697 Version 0.5 (2012-12-21)
7698 ===========================
7699
7700    * ~900 changes, numerous bugfixes
7701
7702    * Syntax changes
7703       * Removed `<-` move operator
7704       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7705       * Removed old fixed length vector syntax - `[T]/N`
7706       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7707       * Macros may now expand to items and statements
7708       * `a.b()` is always parsed as a method call, never as a field projection
7709       * `Eq` and `IterBytes` implementations can be automatically generated
7710         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7711       * Removed the special crate language for `.rc` files
7712       * Function arguments may consist of any irrefutable pattern
7713
7714    * Semantic changes
7715       * `&` and `~` pointers may point to objects
7716       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7717       * Enum variants may be structs
7718       * Destructors can be added to all nominal types with the Drop trait
7719       * Structs and nullary enum variants may be constants
7720       * Values that cannot be implicitly copied are now automatically moved
7721         without writing `move` explicitly
7722       * `&T` may now be coerced to `*T`
7723       * Coercions happen in `let` statements as well as function calls
7724       * `use` statements now take crate-relative paths
7725       * The module and type namespaces have been merged so that static
7726         method names can be resolved under the trait in which they are
7727         declared
7728
7729    * Improved support for language features
7730       * Trait inheritance works in many scenarios
7731       * More support for explicit self arguments in methods - `self`, `&self`
7732         `@self`, and `~self` all generally work as expected
7733       * Static methods work in more situations
7734       * Experimental: Traits may declare default methods for the implementations
7735         to use
7736
7737    * Libraries
7738       * New condition handling system in `core::condition`
7739       * Timsort added to `std::sort`
7740       * New priority queue, `std::priority_queue`
7741       * Pipes for serializable types, `std::flatpipes'
7742       * Serialization overhauled to be trait-based
7743       * Expanded `getopts` definitions
7744       * Moved futures to `std`
7745       * More functions are pure now
7746       * `core::comm` renamed to `oldcomm`. Still deprecated
7747       * `rustdoc` and `cargo` are libraries now
7748
7749    * Misc
7750       * Added a preliminary REPL, `rusti`
7751       * License changed from MIT to dual MIT/APL2
7752
7753
7754 Version 0.4 (2012-10-15)
7755 ==========================
7756
7757    * ~2000 changes, numerous bugfixes
7758
7759    * Syntax
7760       * All keywords are now strict and may not be used as identifiers anywhere
7761       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7762         'of', 'with', 'to', 'class'.
7763       * Classes are replaced with simpler structs
7764       * Explicit method self types
7765       * `ret` became `return` and `alt` became `match`
7766       * `import` is now `use`; `use is now `extern mod`
7767       * `extern mod { ... }` is now `extern { ... }`
7768       * `use mod` is the recommended way to import modules
7769       * `pub` and `priv` replace deprecated export lists
7770       * The syntax of `match` pattern arms now uses fat arrow (=>)
7771       * `main` no longer accepts an args vector; use `os::args` instead
7772
7773    * Semantics
7774       * Trait implementations are now coherent, ala Haskell typeclasses
7775       * Trait methods may be static
7776       * Argument modes are deprecated
7777       * Borrowed pointers are much more mature and recommended for use
7778       * Strings and vectors in the static region are stored in constant memory
7779       * Typestate was removed
7780       * Resolution rewritten to be more reliable
7781       * Support for 'dual-mode' data structures (freezing and thawing)
7782
7783    * Libraries
7784       * Most binary operators can now be overloaded via the traits in
7785         `core::ops'
7786       * `std::net::url` for representing URLs
7787       * Sendable hash maps in `core::send_map`
7788       * `core::task' gained a (currently unsafe) task-local storage API
7789
7790    * Concurrency
7791       * An efficient new intertask communication primitive called the pipe,
7792         along with a number of higher-level channel types, in `core::pipes`
7793       * `std::arc`, an atomically reference counted, immutable, shared memory
7794         type
7795       * `std::sync`, various exotic synchronization tools based on arcs and pipes
7796       * Futures are now based on pipes and sendable
7797       * More robust linked task failure
7798       * Improved task builder API
7799
7800    * Other
7801       * Improved error reporting
7802       * Preliminary JIT support
7803       * Preliminary work on precise GC
7804       * Extensive architectural improvements to rustc
7805       * Begun a transition away from buggy C++-based reflection (shape) code to
7806         Rust-based (visitor) code
7807       * All hash functions and tables converted to secure, randomized SipHash
7808
7809
7810 Version 0.3  (2012-07-12)
7811 ========================
7812
7813    * ~1900 changes, numerous bugfixes
7814
7815    * New coding conveniences
7816       * Integer-literal suffix inference
7817       * Per-item control over warnings, errors
7818       * #[cfg(windows)] and #[cfg(unix)] attributes
7819       * Documentation comments
7820       * More compact closure syntax
7821       * 'do' expressions for treating higher-order functions as
7822         control structures
7823       * *-patterns (wildcard extended to all constructor fields)
7824
7825    * Semantic cleanup
7826       * Name resolution pass and exhaustiveness checker rewritten
7827       * Region pointers and borrow checking supersede alias
7828         analysis
7829       * Init-ness checking is now provided by a region-based liveness
7830         pass instead of the typestate pass; same for last-use analysis
7831       * Extensive work on region pointers
7832
7833    * Experimental new language features
7834       * Slices and fixed-size, interior-allocated vectors
7835       * #!-comments for lang versioning, shell execution
7836       * Destructors and iface implementation for classes;
7837         type-parameterized classes and class methods
7838       * 'const' type kind for types that can be used to implement
7839         shared-memory concurrency patterns
7840
7841    * Type reflection
7842
7843    * Removal of various obsolete features
7844       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
7845                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
7846
7847       * Constructs: do-while loops ('do' repurposed), fn binding,
7848                     resources (replaced by destructors)
7849
7850    * Compiler reorganization
7851       * Syntax-layer of compiler split into separate crate
7852       * Clang (from LLVM project) integrated into build
7853       * Typechecker split into sub-modules
7854
7855    * New library code
7856       * New time functions
7857       * Extension methods for many built-in types
7858       * Arc: atomic-refcount read-only / exclusive-use shared cells
7859       * Par: parallel map and search routines
7860       * Extensive work on libuv interface
7861       * Much vector code moved to libraries
7862       * Syntax extensions: #line, #col, #file, #mod, #stringify,
7863         #include, #include_str, #include_bin
7864
7865    * Tool improvements
7866       * Cargo automatically resolves dependencies
7867
7868
7869 Version 0.2  (2012-03-29)
7870 =========================
7871
7872    * >1500 changes, numerous bugfixes
7873
7874    * New docs and doc tooling
7875
7876    * New port: FreeBSD x86_64
7877
7878    * Compilation model enhancements
7879       * Generics now specialized, multiply instantiated
7880       * Functions now inlined across separate crates
7881
7882    * Scheduling, stack and threading fixes
7883       * Noticeably improved message-passing performance
7884       * Explicit schedulers
7885       * Callbacks from C
7886       * Helgrind clean
7887
7888    * Experimental new language features
7889       * Operator overloading
7890       * Region pointers
7891       * Classes
7892
7893    * Various language extensions
7894       * C-callback function types: 'crust fn ...'
7895       * Infinite-loop construct: 'loop { ... }'
7896       * Shorten 'mutable' to 'mut'
7897       * Required mutable-local qualifier: 'let mut ...'
7898       * Basic glob-exporting: 'export foo::*;'
7899       * Alt now exhaustive, 'alt check' for runtime-checked
7900       * Block-function form of 'for' loop, with 'break' and 'ret'.
7901
7902    * New library code
7903       * AST quasi-quote syntax extension
7904       * Revived libuv interface
7905       * New modules: core::{future, iter}, std::arena
7906       * Merged per-platform std::{os*, fs*} to core::{libc, os}
7907       * Extensive cleanup, regularization in libstd, libcore
7908
7909
7910 Version 0.1  (2012-01-20)
7911 ===============================
7912
7913    * Most language features work, including:
7914       * Unique pointers, unique closures, move semantics
7915       * Interface-constrained generics
7916       * Static interface dispatch
7917       * Stack growth
7918       * Multithread task scheduling
7919       * Typestate predicates
7920       * Failure unwinding, destructors
7921       * Pattern matching and destructuring assignment
7922       * Lightweight block-lambda syntax
7923       * Preliminary macro-by-example
7924
7925    * Compiler works with the following configurations:
7926       * Linux: x86 and x86_64 hosts and targets
7927       * macOS: x86 and x86_64 hosts and targets
7928       * Windows: x86 hosts and targets
7929
7930    * Cross compilation / multi-target configuration supported.
7931
7932    * Preliminary API-documentation and package-management tools included.
7933
7934 Known issues:
7935
7936    * Documentation is incomplete.
7937
7938    * Performance is below intended target.
7939
7940    * Standard library APIs are subject to extensive change, reorganization.
7941
7942    * Language-level versioning is not yet operational - future code will
7943      break unexpectedly.