RELEASES.md

   1 Version 1.35.0 (2019-05-23)
   2 ==========================
   3
   4 Language
   5 --------
   6 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
   7   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
   8 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
   9   ```rust
  10   unsafe fn call_unsafe(func: unsafe fn()) {
  11       func()
  12   }
  13
  14   pub fn main() {
  15       unsafe { call_unsafe(|| {}); }
  16   }
  17   ```
  18
  19
  20 Compiler
  21 --------
  22 - [Added the `armv6-unknown-freebsd-gnueabihf` and
  23   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
  24 - [Added the `wasm32-unknown-wasi` target.][59464]
  25
  26
  27 Libraries
  28 ---------
  29 - [`Thread` will now show its ID in `Debug` output.][59460]
  30 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
  31 - [`alloc::System` now implements `Default`.][59451]
  32 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
  33   last field.][59076]
  34 - [`char::{ToLowercase, ToUppercase}` now
  35   implement `ExactSizeIterator`.][58778]
  36 - [All `NonZero` numeric types now implement `FromStr`.][58717]
  37 - [Removed the `Read` trait bounds
  38   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
  39 - [You can now call the `dbg!` macro without any parameters to print the file
  40   and line where it is called.][57847]
  41 - [In place ASCII case conversions are now up to 4× faster.][59283]
  42   e.g. `str::make_ascii_lowercase`
  43 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
  44   and `Send`.][58369]
  45
  46 Stabilized APIs
  47 ---------------
  48 - [`f32::copysign`]
  49 - [`f64::copysign`]
  50 - [`RefCell::replace_with`]
  51 - [`RefCell::map_split`]
  52 - [`ptr::hash`]
  53 - [`Range::contains`]
  54 - [`RangeFrom::contains`]
  55 - [`RangeTo::contains`]
  56 - [`RangeInclusive::contains`]
  57 - [`RangeToInclusive::contains`]
  58 - [`Option::copied`]
  59
  60 Cargo
  61 -----
  62 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
  63   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
  64   platform specific.
  65
  66 Misc
  67 ----
  68 - [The Rust toolchain is now available natively for musl based distros.][58575]
  69
  70 [59460]: https://github.com/rust-lang/rust/pull/59460/
  71 [59464]: https://github.com/rust-lang/rust/pull/59464/
  72 [59500]: https://github.com/rust-lang/rust/pull/59500/
  73 [59512]: https://github.com/rust-lang/rust/pull/59512/
  74 [59580]: https://github.com/rust-lang/rust/pull/59580/
  75 [59283]: https://github.com/rust-lang/rust/pull/59283/
  76 [59451]: https://github.com/rust-lang/rust/pull/59451/
  77 [59076]: https://github.com/rust-lang/rust/pull/59076/
  78 [58778]: https://github.com/rust-lang/rust/pull/58778/
  79 [58717]: https://github.com/rust-lang/rust/pull/58717/
  80 [58369]: https://github.com/rust-lang/rust/pull/58369/
  81 [58423]: https://github.com/rust-lang/rust/pull/58423/
  82 [58080]: https://github.com/rust-lang/rust/pull/58080/
  83 [57847]: https://github.com/rust-lang/rust/pull/57847/
  84 [58575]: https://github.com/rust-lang/rust/pull/58575
  85 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
  86 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
  87 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
  88 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
  89 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
  90 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
  91 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
  92 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
  93 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
  94 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
  95 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
  96 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
  97
  98 Version 1.34.2 (2019-05-14)
  99 ===========================
 100
 101 * [Destabilize the `Error::type_id` function due to a security
 102    vulnerability][60785] ([CVE-2019-12083])
 103
 104 [60785]: https://github.com/rust-lang/rust/pull/60785
 105 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
 106
 107 Version 1.34.1 (2019-04-25)
 108 ===========================
 109
 110 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
 111 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
 112 * [Fix Clippy panic when checking some macros][clippy/3805]
 113
 114 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
 115 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
 116 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
 117
 118 Version 1.34.0 (2019-04-11)
 119 ==========================
 120
 121 Language
 122 --------
 123 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
 124   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
 125   but had no effect.
 126 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
 127   `#[attr{}]` procedural macros.][57367]
 128 - [You can now write `extern crate self as foo;`][57407] to import your
 129   crate's root into the extern prelude.
 130
 131
 132 Compiler
 133 --------
 134 - [You can now target `riscv64imac-unknown-none-elf` and
 135   `riscv64gc-unknown-none-elf`.][58406]
 136 - [You can now enable linker plugin LTO optimisations with
 137   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
 138   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
 139   boundaries.
 140 - [You can now target `powerpc64-unknown-freebsd`.][57809]
 141
 142
 143 Libraries
 144 ---------
 145 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
 146   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
 147   the `Hash` trait to create an iterator.
 148 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
 149   methods.][58421] Most notably you no longer require the `Ord` trait to create
 150   an iterator.
 151 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
 152   for all numeric types.][58044]
 153 - [Indexing a `str` is now generic over all types that
 154   implement `SliceIndex<str>`.][57604]
 155 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
 156   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
 157   produce a warning if their returning type is unused.
 158 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
 159   `overflowing_pow` are now available for all numeric types.][57873] These are
 160   equivalent to methods such as `wrapping_add` for the `pow` operation.
 161
 162
 163 Stabilized APIs
 164 ---------------
 165
 166 #### std & core
 167 * [`Any::type_id`]
 168 * [`Error::type_id`]
 169 * [`atomic::AtomicI16`]
 170 * [`atomic::AtomicI32`]
 171 * [`atomic::AtomicI64`]
 172 * [`atomic::AtomicI8`]
 173 * [`atomic::AtomicU16`]
 174 * [`atomic::AtomicU32`]
 175 * [`atomic::AtomicU64`]
 176 * [`atomic::AtomicU8`]
 177 * [`convert::Infallible`]
 178 * [`convert::TryFrom`]
 179 * [`convert::TryInto`]
 180 * [`iter::from_fn`]
 181 * [`iter::successors`]
 182 * [`num::NonZeroI128`]
 183 * [`num::NonZeroI16`]
 184 * [`num::NonZeroI32`]
 185 * [`num::NonZeroI64`]
 186 * [`num::NonZeroI8`]
 187 * [`num::NonZeroIsize`]
 188 * [`slice::sort_by_cached_key`]
 189 * [`str::escape_debug`]
 190 * [`str::escape_default`]
 191 * [`str::escape_unicode`]
 192 * [`str::split_ascii_whitespace`]
 193
 194 #### std
 195 * [`Instant::checked_add`]
 196 * [`Instant::checked_sub`]
 197 * [`SystemTime::checked_add`]
 198 * [`SystemTime::checked_sub`]
 199
 200 Cargo
 201 -----
 202 - [You can now use alternative registries to crates.io.][cargo/6654]
 203
 204 Misc
 205 ----
 206 - [You can now use the `?` operator in your documentation tests without manually
 207   adding `fn main() -> Result<(), _> {}`.][56470]
 208
 209 Compatibility Notes
 210 -------------------
 211 - [`Command::before_exec` is now deprecated in favor of the
 212   unsafe method `Command::pre_exec`.][58059]
 213 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated.][57425] As you
 214   can now use `const` functions in `static` variables.
 215
 216 [58370]: https://github.com/rust-lang/rust/pull/58370/
 217 [58406]: https://github.com/rust-lang/rust/pull/58406/
 218 [58421]: https://github.com/rust-lang/rust/pull/58421/
 219 [58166]: https://github.com/rust-lang/rust/pull/58166/
 220 [58044]: https://github.com/rust-lang/rust/pull/58044/
 221 [58057]: https://github.com/rust-lang/rust/pull/58057/
 222 [58059]: https://github.com/rust-lang/rust/pull/58059/
 223 [57809]: https://github.com/rust-lang/rust/pull/57809/
 224 [57873]: https://github.com/rust-lang/rust/pull/57873/
 225 [57604]: https://github.com/rust-lang/rust/pull/57604/
 226 [57367]: https://github.com/rust-lang/rust/pull/57367/
 227 [57407]: https://github.com/rust-lang/rust/pull/57407/
 228 [57425]: https://github.com/rust-lang/rust/pull/57425/
 229 [57106]: https://github.com/rust-lang/rust/pull/57106/
 230 [56470]: https://github.com/rust-lang/rust/pull/56470/
 231 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
 232 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
 233 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
 234 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
 235 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
 236 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
 237 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
 238 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
 239 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
 240 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
 241 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
 242 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
 243 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
 244 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
 245 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
 246 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
 247 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
 248 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
 249 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
 250 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
 251 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
 252 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
 253 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
 254 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
 255 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
 256 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
 257 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
 258 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
 259 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
 260 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
 261 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
 262
 263
 264 Version 1.33.0 (2019-02-28)
 265 ==========================
 266
 267 Language
 268 --------
 269 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
 270   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
 271 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
 272   E.g. You can have match statement on a `u8` that covers `0..=255` and
 273   you would no longer be required to have a `_ => unreachable!()` case.
 274 - [You can now have multiple patterns in `if let` and `while let`
 275   expressions.][57532] You can do this with the same syntax as a `match`
 276   expression. E.g.
 277   ```rust
 278   enum Creature {
 279       Crab(String),
 280       Lobster(String),
 281       Person(String),
 282   }
 283
 284   fn main() {
 285       let state = Creature::Crab("Ferris");
 286
 287       if let Creature::Crab(name) | Creature::Person(name) = state {
 288           println!("This creature's name is: {}", name);
 289       }
 290   }
 291   ```
 292 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
 293   this feature will by default produce a warning as this behaviour can be
 294   unintuitive. E.g. `if let _ = 5 {}`
 295 - [You can now use `let` bindings, assignments, expression statements,
 296   and irrefutable pattern destructuring in const functions.][57175]
 297 - [You can now call unsafe const functions.][57067] E.g.
 298   ```rust
 299   const unsafe fn foo() -> i32 { 5 }
 300   const fn bar() -> i32 {
 301       unsafe { foo() }
 302   }
 303   ```
 304 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
 305   E.g. `#[cfg_attr(all(), must_use, optimize)]`
 306 - [You can now specify a specific alignment with the `#[repr(packed)]`
 307   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
 308   with an alignment of 2 bytes and a size of 6 bytes.
 309 - [You can now import an item from a module as an `_`.][56303] This allows you to
 310   import a trait's impls, and not have the name in the namespace. E.g.
 311   ```rust
 312   use std::io::Read as _;
 313
 314   // Allowed as there is only one `Read` in the module.
 315   pub trait Read {}
 316   ```
 317 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
 318
 319 Compiler
 320 --------
 321 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
 322   command line argument.][56351]
 323 - [The mininum required LLVM version has been bumped to 6.0.][56642]
 324 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
 325 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
 326   tier 2 support.][57130] Visit the [platform support][platform-support] page for
 327   information on Rust's platform support.
 328 - [Added support for the `thumbv7neon-linux-androideabi` and
 329   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
 330 - [Added support for the `x86_64-unknown-uefi` target.][56769]
 331
 332 Libraries
 333 ---------
 334 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
 335   functions for all numeric types.][57566]
 336 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
 337   are now `const` functions for all numeric types.][57105]
 338 - [The methods `is_positive` and `is_negative` are now `const` functions for
 339   all signed numeric types.][57105]
 340 - [The `get` method for all `NonZero` types is now `const`.][57167]
 341 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
 342   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
 343   numeric types.][57234]
 344 - [`Ipv4Addr::new` is now a `const` function][57234]
 345
 346 Stabilized APIs
 347 ---------------
 348 - [`unix::FileExt::read_exact_at`]
 349 - [`unix::FileExt::write_all_at`]
 350 - [`Option::transpose`]
 351 - [`Result::transpose`]
 352 - [`convert::identity`]
 353 - [`pin::Pin`]
 354 - [`marker::Unpin`]
 355 - [`marker::PhantomPinned`]
 356 - [`Vec::resize_with`]
 357 - [`VecDeque::resize_with`]
 358 - [`Duration::as_millis`]
 359 - [`Duration::as_micros`]
 360 - [`Duration::as_nanos`]
 361
 362
 363 Cargo
 364 -----
 365 - [You can now publish crates that require a feature flag to compile with
 366   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
 367 - [Cargo should now rebuild a crate if a file was modified during the initial
 368   build.][cargo/6484]
 369
 370 Compatibility Notes
 371 -------------------
 372 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
 373   are now deprecated in the standard library, and their usage will now produce a warning.
 374   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
 375   methods instead.
 376 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
 377   downcasting.
 378 - [Libtest no longer creates a new thread for each test when
 379   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
 380
 381 [55982]: https://github.com/rust-lang/rust/pull/55982/
 382 [56243]: https://github.com/rust-lang/rust/pull/56243
 383 [56303]: https://github.com/rust-lang/rust/pull/56303/
 384 [56351]: https://github.com/rust-lang/rust/pull/56351/
 385 [56362]: https://github.com/rust-lang/rust/pull/56362
 386 [56642]: https://github.com/rust-lang/rust/pull/56642/
 387 [56769]: https://github.com/rust-lang/rust/pull/56769/
 388 [56805]: https://github.com/rust-lang/rust/pull/56805
 389 [56947]: https://github.com/rust-lang/rust/pull/56947/
 390 [57049]: https://github.com/rust-lang/rust/pull/57049/
 391 [57067]: https://github.com/rust-lang/rust/pull/57067/
 392 [57105]: https://github.com/rust-lang/rust/pull/57105
 393 [57130]: https://github.com/rust-lang/rust/pull/57130/
 394 [57167]: https://github.com/rust-lang/rust/pull/57167/
 395 [57175]: https://github.com/rust-lang/rust/pull/57175/
 396 [57234]: https://github.com/rust-lang/rust/pull/57234/
 397 [57332]: https://github.com/rust-lang/rust/pull/57332/
 398 [57465]: https://github.com/rust-lang/rust/pull/57465/
 399 [57532]: https://github.com/rust-lang/rust/pull/57532/
 400 [57535]: https://github.com/rust-lang/rust/pull/57535/
 401 [57566]: https://github.com/rust-lang/rust/pull/57566/
 402 [57615]: https://github.com/rust-lang/rust/pull/57615/
 403 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
 404 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
 405 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
 406 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
 407 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
 408 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
 409 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
 410 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
 411 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
 412 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
 413 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
 414 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
 415 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
 416 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
 417 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
 418 [platform-support]: https://forge.rust-lang.org/platform-support.html
 419
 420 Version 1.32.0 (2019-01-17)
 421 ==========================
 422
 423 Language
 424 --------
 425 #### 2018 edition
 426 - [You can now use the `?` operator in macro definitions.][56245] The `?`
 427   operator allows you to specify zero or one repetitions similar to the `*` and
 428   `+` operators.
 429 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
 430   now always resolve to the item (`enum`, `struct`, etc.) available in the
 431   module if present, before resolving to a external crate or an item the prelude.][56759]
 432   E.g.
 433   ```rust
 434   enum Color { Red, Green, Blue }
 435
 436   use Color::*;
 437   ```
 438
 439 #### All editions
 440 - [You can now match against `PhantomData<T>` types.][55837]
 441 - [You can now match against literals in macros with the `literal`
 442   specifier.][56072] This will match against a literal of any type.
 443   E.g. `1`, `'A'`, `"Hello World"`
 444 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
 445   ```rust
 446   struct Point(i32, i32);
 447
 448   impl Point {
 449       pub fn new(x: i32, y: i32) -> Self {
 450           Self(x, y)
 451       }
 452
 453       pub fn is_origin(&self) -> bool {
 454           match self {
 455               Self(0, 0) => true,
 456               _ => false,
 457           }
 458       }
 459   }
 460   ```
 461 - [Self can also now be used in type definitions.][56366] E.g.
 462   ```rust
 463   enum List<T>
 464   where
 465       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
 466   {
 467       Nil,
 468       Cons(T, Box<Self>) // likewise here
 469   }
 470   ```
 471 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
 472   a `impl Trait` or `dyn Trait` is returned and unused in the program.
 473
 474 Compiler
 475 --------
 476 - [The default allocator has changed from jemalloc to the default allocator on
 477   your system.][55238] The compiler itself on Linux & macOS will still use
 478   jemalloc, but programs compiled with it will use the system allocator.
 479 - [Added the `aarch64-pc-windows-msvc` target.][55702]
 480
 481 Libraries
 482 ---------
 483 - [`PathBuf` now implements `FromStr`.][55148]
 484 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
 485 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
 486   easily debug expressions in your rust program. E.g.
 487   ```rust
 488   let a = 2;
 489   let b = dbg!(a * 2) + 1;
 490   //      ^-- prints: [src/main.rs:4] a * 2 = 4
 491   assert_eq!(b, 5);
 492   ```
 493
 494 The following APIs are now `const` functions and can be used in a
 495 `const` context.
 496
 497 - [`Cell::as_ptr`]
 498 - [`UnsafeCell::get`]
 499 - [`char::is_ascii`]
 500 - [`iter::empty`]
 501 - [`ManuallyDrop::new`]
 502 - [`ManuallyDrop::into_inner`]
 503 - [`RangeInclusive::start`]
 504 - [`RangeInclusive::end`]
 505 - [`NonNull::as_ptr`]
 506 - [`slice::as_ptr`]
 507 - [`str::as_ptr`]
 508 - [`Duration::as_secs`]
 509 - [`Duration::subsec_millis`]
 510 - [`Duration::subsec_micros`]
 511 - [`Duration::subsec_nanos`]
 512 - [`CStr::as_ptr`]
 513 - [`Ipv4Addr::is_unspecified`]
 514 - [`Ipv6Addr::new`]
 515 - [`Ipv6Addr::octets`]
 516
 517 Stabilized APIs
 518 ---------------
 519 - [`i8::to_be_bytes`]
 520 - [`i8::to_le_bytes`]
 521 - [`i8::to_ne_bytes`]
 522 - [`i8::from_be_bytes`]
 523 - [`i8::from_le_bytes`]
 524 - [`i8::from_ne_bytes`]
 525 - [`i16::to_be_bytes`]
 526 - [`i16::to_le_bytes`]
 527 - [`i16::to_ne_bytes`]
 528 - [`i16::from_be_bytes`]
 529 - [`i16::from_le_bytes`]
 530 - [`i16::from_ne_bytes`]
 531 - [`i32::to_be_bytes`]
 532 - [`i32::to_le_bytes`]
 533 - [`i32::to_ne_bytes`]
 534 - [`i32::from_be_bytes`]
 535 - [`i32::from_le_bytes`]
 536 - [`i32::from_ne_bytes`]
 537 - [`i64::to_be_bytes`]
 538 - [`i64::to_le_bytes`]
 539 - [`i64::to_ne_bytes`]
 540 - [`i64::from_be_bytes`]
 541 - [`i64::from_le_bytes`]
 542 - [`i64::from_ne_bytes`]
 543 - [`i128::to_be_bytes`]
 544 - [`i128::to_le_bytes`]
 545 - [`i128::to_ne_bytes`]
 546 - [`i128::from_be_bytes`]
 547 - [`i128::from_le_bytes`]
 548 - [`i128::from_ne_bytes`]
 549 - [`isize::to_be_bytes`]
 550 - [`isize::to_le_bytes`]
 551 - [`isize::to_ne_bytes`]
 552 - [`isize::from_be_bytes`]
 553 - [`isize::from_le_bytes`]
 554 - [`isize::from_ne_bytes`]
 555 - [`u8::to_be_bytes`]
 556 - [`u8::to_le_bytes`]
 557 - [`u8::to_ne_bytes`]
 558 - [`u8::from_be_bytes`]
 559 - [`u8::from_le_bytes`]
 560 - [`u8::from_ne_bytes`]
 561 - [`u16::to_be_bytes`]
 562 - [`u16::to_le_bytes`]
 563 - [`u16::to_ne_bytes`]
 564 - [`u16::from_be_bytes`]
 565 - [`u16::from_le_bytes`]
 566 - [`u16::from_ne_bytes`]
 567 - [`u32::to_be_bytes`]
 568 - [`u32::to_le_bytes`]
 569 - [`u32::to_ne_bytes`]
 570 - [`u32::from_be_bytes`]
 571 - [`u32::from_le_bytes`]
 572 - [`u32::from_ne_bytes`]
 573 - [`u64::to_be_bytes`]
 574 - [`u64::to_le_bytes`]
 575 - [`u64::to_ne_bytes`]
 576 - [`u64::from_be_bytes`]
 577 - [`u64::from_le_bytes`]
 578 - [`u64::from_ne_bytes`]
 579 - [`u128::to_be_bytes`]
 580 - [`u128::to_le_bytes`]
 581 - [`u128::to_ne_bytes`]
 582 - [`u128::from_be_bytes`]
 583 - [`u128::from_le_bytes`]
 584 - [`u128::from_ne_bytes`]
 585 - [`usize::to_be_bytes`]
 586 - [`usize::to_le_bytes`]
 587 - [`usize::to_ne_bytes`]
 588 - [`usize::from_be_bytes`]
 589 - [`usize::from_le_bytes`]
 590 - [`usize::from_ne_bytes`]
 591
 592 Cargo
 593 -----
 594 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
 595 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
 596
 597 Misc
 598 ----
 599 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
 600
 601 Compatibility Notes
 602 -------------------
 603 - [The argument types for AVX's
 604   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
 605   been changed from `*const` to `*mut` as the previous implementation
 606   was unsound.
 607
 608
 609 [55148]: https://github.com/rust-lang/rust/pull/55148/
 610 [55238]: https://github.com/rust-lang/rust/pull/55238/
 611 [55280]: https://github.com/rust-lang/rust/pull/55280/
 612 [55610]: https://github.com/rust-lang/rust/pull/55610/
 613 [55663]: https://github.com/rust-lang/rust/pull/55663/
 614 [55702]: https://github.com/rust-lang/rust/pull/55702/
 615 [55837]: https://github.com/rust-lang/rust/pull/55837/
 616 [55843]: https://github.com/rust-lang/rust/pull/55843/
 617 [56072]: https://github.com/rust-lang/rust/pull/56072/
 618 [56245]: https://github.com/rust-lang/rust/pull/56245/
 619 [56365]: https://github.com/rust-lang/rust/pull/56365/
 620 [56366]: https://github.com/rust-lang/rust/pull/56366/
 621 [56395]: https://github.com/rust-lang/rust/pull/56395/
 622 [56759]: https://github.com/rust-lang/rust/pull/56759/
 623 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
 624 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
 625 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
 626 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
 627 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
 628 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
 629 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
 630 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
 631 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
 632 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
 633 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
 634 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
 635 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
 636 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
 637 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
 638 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
 639 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
 640 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
 641 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
 642 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
 643 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
 644 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
 645 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
 646 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
 647 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
 648 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
 649 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
 650 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
 651 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
 652 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
 653 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
 654 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
 655 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
 656 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
 657 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
 658 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
 659 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
 660 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
 661 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
 662 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
 663 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
 664 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
 665 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
 666 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
 667 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
 668 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
 669 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
 670 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
 671 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
 672 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
 673 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
 674 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
 675 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
 676 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
 677 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
 678 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
 679 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
 680 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
 681 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
 682 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
 683 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
 684 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
 685 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
 686 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
 687 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
 688 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
 689 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
 690 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
 691 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
 692 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
 693 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
 694 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
 695 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
 696 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
 697 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
 698 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
 699 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
 700 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
 701 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
 702 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
 703 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
 704 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
 705 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
 706 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
 707 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
 708 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
 709 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
 710 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
 711 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
 712 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
 713 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
 714 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
 715 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
 716
 717
 718 Version 1.31.1 (2018-12-20)
 719 ===========================
 720
 721 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
 722 - [Fix broken go-to-definition in RLS][rls/1171]
 723 - [Fix infinite loop on hover in RLS][rls/1170]
 724
 725 [56562]: https://github.com/rust-lang/rust/pull/56562
 726 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
 727 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
 728
 729 Version 1.31.0 (2018-12-06)
 730 ==========================
 731
 732 Language
 733 --------
 734 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
 735 - [New lifetime elision rules now allow for eliding lifetimes in functions and
 736   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
 737   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
 738   in structs.
 739 - [You can now define and use `const` functions.][54835] These are currently
 740   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
 741   [language reference][const-reference] for what exactly is available.
 742 - [You can now use tool lints, which allow you to scope lints from external
 743   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
 744 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
 745   a crate, not just in exported functions.][54451]
 746 - [You can now use parentheses in pattern matches.][54497]
 747
 748 Compiler
 749 --------
 750 - [Updated musl to 1.1.20][54430]
 751
 752 Libraries
 753 ---------
 754 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
 755   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
 756 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
 757   into `Option<&mut T>` using the `From` trait.][53218]
 758 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
 759
 760
 761 Stabilized APIs
 762 ---------------
 763 - [`slice::align_to`]
 764 - [`slice::align_to_mut`]
 765 - [`slice::chunks_exact`]
 766 - [`slice::chunks_exact_mut`]
 767 - [`slice::rchunks`]
 768 - [`slice::rchunks_mut`]
 769 - [`slice::rchunks_exact`]
 770 - [`slice::rchunks_exact_mut`]
 771 - [`Option::replace`]
 772
 773 Cargo
 774 -----
 775 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
 776 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
 777   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
 778
 779 [52813]: https://github.com/rust-lang/rust/pull/52813/
 780 [53218]: https://github.com/rust-lang/rust/pull/53218/
 781 [53555]: https://github.com/rust-lang/rust/issues/53555/
 782 [54057]: https://github.com/rust-lang/rust/pull/54057/
 783 [54240]: https://github.com/rust-lang/rust/pull/54240/
 784 [54430]: https://github.com/rust-lang/rust/pull/54430/
 785 [54451]: https://github.com/rust-lang/rust/pull/54451/
 786 [54497]: https://github.com/rust-lang/rust/pull/54497/
 787 [54778]: https://github.com/rust-lang/rust/pull/54778/
 788 [54835]: https://github.com/rust-lang/rust/pull/54835/
 789 [54870]: https://github.com/rust-lang/rust/pull/54870/
 790 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
 791 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
 792 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
 793 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
 794 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
 795 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
 796 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
 797 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
 798 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
 799 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
 800 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
 801 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
 802 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
 803 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
 804
 805 Version 1.30.1 (2018-11-08)
 806 ===========================
 807
 808 - [Fixed overflow ICE in rustdoc][54199]
 809 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
 810
 811 [54199]: https://github.com/rust-lang/rust/pull/54199
 812 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
 813
 814 Version 1.30.0 (2018-10-25)
 815 ==========================
 816
 817 Language
 818 --------
 819 - [Procedural macros are now available.][52081] These kinds of macros allow for
 820   more powerful code generation. There is a [new chapter available][proc-macros]
 821   in the Rust Programming Language book that goes further in depth.
 822 - [You can now use keywords as identifiers using the raw identifiers
 823   syntax (`r#`),][53236] e.g. `let r#for = true;`
 824 - [Using anonymous parameters in traits is now deprecated with a warning and
 825   will be a hard error in the 2018 edition.][53272]
 826 - [You can now use `crate` in paths.][54404] This allows you to refer to the
 827   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
 828 - [Using a external crate no longer requires being prefixed with `::`.][54404]
 829   Previously, using a external crate in a module without a use statement
 830   required `let json = ::serde_json::from_str(foo);` but can now be written
 831   as `let json = serde_json::from_str(foo);`.
 832 - [You can now apply the `#[used]` attribute to static items to prevent the
 833   compiler from optimising them away, even if they appear to be unused,][51363]
 834   e.g. `#[used] static FOO: u32 = 1;`
 835 - [You can now import and reexport macros from other crates with the `use`
 836   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
 837   the root module of the crate. If your macro relies on calling other local
 838   macros, it is recommended to export with the
 839   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
 840   those macros.
 841 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
 842   using the `vis` specifier.][53370]
 843 - [Non-macro attributes now allow all forms of literals, not just
 844   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
 845   write `#[attr(true)]`.
 846 - [You can now specify a function to handle a panic in the Rust runtime with the
 847   `#[panic_handler]` attribute.][51366]
 848
 849 Compiler
 850 --------
 851 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
 852 - [Added the `aarch64-unknown-netbsd` target][53165]
 853
 854 Libraries
 855 ---------
 856 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
 857
 858 Stabilized APIs
 859 ---------------
 860 - [`Ipv4Addr::BROADCAST`]
 861 - [`Ipv4Addr::LOCALHOST`]
 862 - [`Ipv4Addr::UNSPECIFIED`]
 863 - [`Ipv6Addr::LOCALHOST`]
 864 - [`Ipv6Addr::UNSPECIFIED`]
 865 - [`Iterator::find_map`]
 866
 867   The following methods are replacement methods for `trim_left`, `trim_right`,
 868   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
 869   in 1.33.0:
 870 - [`str::trim_end_matches`]
 871 - [`str::trim_end`]
 872 - [`str::trim_start_matches`]
 873 - [`str::trim_start`]
 874
 875 Cargo
 876 ----
 877 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
 878 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
 879   equivalent to calling `rustdoc --error-format=json`.
 880 - [Cargo will now provide a progress bar for builds.][cargo/5995]
 881
 882 Misc
 883 ----
 884 - [`rustdoc` allows you to specify what edition to treat your code as with the
 885   `--edition` option.][54057]
 886 - [`rustdoc` now has the `--color` (specify whether to output color) and
 887   `--error-format` (specify error format, e.g. `json`) options.][53003]
 888 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
 889   debug symbols.][53774]
 890 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
 891   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
 892
 893 [50911]: https://github.com/rust-lang/rust/pull/50911/
 894 [51363]: https://github.com/rust-lang/rust/pull/51363/
 895 [51366]: https://github.com/rust-lang/rust/pull/51366/
 896 [52081]: https://github.com/rust-lang/rust/pull/52081/
 897 [53003]: https://github.com/rust-lang/rust/pull/53003/
 898 [53033]: https://github.com/rust-lang/rust/pull/53033/
 899 [53044]: https://github.com/rust-lang/rust/pull/53044/
 900 [53165]: https://github.com/rust-lang/rust/pull/53165/
 901 [53213]: https://github.com/rust-lang/rust/pull/53213/
 902 [53236]: https://github.com/rust-lang/rust/pull/53236/
 903 [53272]: https://github.com/rust-lang/rust/pull/53272/
 904 [53370]: https://github.com/rust-lang/rust/pull/53370/
 905 [53459]: https://github.com/rust-lang/rust/pull/53459/
 906 [53774]: https://github.com/rust-lang/rust/pull/53774/
 907 [53822]: https://github.com/rust-lang/rust/pull/53822/
 908 [54057]: https://github.com/rust-lang/rust/pull/54057/
 909 [54146]: https://github.com/rust-lang/rust/pull/54146/
 910 [54404]: https://github.com/rust-lang/rust/pull/54404/
 911 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
 912 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
 913 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
 914 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
 915
 916 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
 917 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
 918 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
 919 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
 920 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
 921 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
 922 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
 923 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
 924 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
 925 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
 926
 927
 928 Version 1.29.2 (2018-10-11)
 929 ===========================
 930
 931 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
 932 - The `rls-preview` component on the windows-gnu targets has been restored.
 933
 934 [54639]: https://github.com/rust-lang/rust/pull/54639
 935
 936
 937 Version 1.29.1 (2018-09-25)
 938 ===========================
 939
 940 Security Notes
 941 --------------
 942
 943 - The standard library's `str::repeat` function contained an out of bounds write
 944   caused by an integer overflow. This has been fixed by deterministically
 945   panicking when an overflow happens.
 946
 947   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
 948   us.
 949
 950
 951 Version 1.29.0 (2018-09-13)
 952 ==========================
 953
 954 Compiler
 955 --------
 956 - [Bumped minimum LLVM version to 5.0.][51899]
 957 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
 958 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
 959
 960 Libraries
 961 ---------
 962 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
 963 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
 964 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
 965 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
 966   for `&str`.][51178]
 967 - [`Cell<T>` now allows `T` to be unsized.][50494]
 968 - [`SocketAddr` is now stable on Redox.][52656]
 969
 970 Stabilized APIs
 971 ---------------
 972 - [`Arc::downcast`]
 973 - [`Iterator::flatten`]
 974 - [`Rc::downcast`]
 975
 976 Cargo
 977 -----
 978 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
 979   `--locked` to disable this behavior.
 980 - [`cargo-install` will now allow you to cross compile an install
 981   using `--target`.][cargo/5614]
 982 - [Added the `cargo-fix` subcommand to automatically move project code from
 983   2015 edition to 2018.][cargo/5723]
 984 - [`cargo doc` can now optionally document private types using the
 985   `--document-private-items` flag.][cargo/5543]
 986
 987 Misc
 988 ----
 989 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
 990   the specified level to that level.][52354] For example `--cap-lints warn`
 991   will demote `deny` and `forbid` lints to `warn`.
 992 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
 993   fails and `101` if there is a panic.][52197]
 994 - [A preview of clippy has been made available through rustup.][51122]
 995   You can install the preview with `rustup component add clippy-preview`.
 996
 997 Compatibility Notes
 998 -------------------
 999 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1000   Use `str::get_unchecked(begin..end)` instead.
1001 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1002   Consider using the `home_dir` function from
1003   https://crates.io/crates/dirs instead.
1004 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1005 - [`cfg` attributes and `--cfg` command line flags are now more
1006   strictly validated.][53893]
1007
1008 [53893]: https://github.com/rust-lang/rust/pull/53893/
1009 [52861]: https://github.com/rust-lang/rust/pull/52861/
1010 [52656]: https://github.com/rust-lang/rust/pull/52656/
1011 [52239]: https://github.com/rust-lang/rust/pull/52239/
1012 [52330]: https://github.com/rust-lang/rust/pull/52330/
1013 [52354]: https://github.com/rust-lang/rust/pull/52354/
1014 [52402]: https://github.com/rust-lang/rust/pull/52402/
1015 [52103]: https://github.com/rust-lang/rust/pull/52103/
1016 [52197]: https://github.com/rust-lang/rust/pull/52197/
1017 [51807]: https://github.com/rust-lang/rust/pull/51807/
1018 [51899]: https://github.com/rust-lang/rust/pull/51899/
1019 [51912]: https://github.com/rust-lang/rust/pull/51912/
1020 [51511]: https://github.com/rust-lang/rust/pull/51511/
1021 [51619]: https://github.com/rust-lang/rust/pull/51619/
1022 [51656]: https://github.com/rust-lang/rust/pull/51656/
1023 [51178]: https://github.com/rust-lang/rust/pull/51178/
1024 [51122]: https://github.com/rust-lang/rust/pull/51122
1025 [50494]: https://github.com/rust-lang/rust/pull/50494/
1026 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1027 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1028 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1029 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1030 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1031 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1032 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1033
1034
1035 Version 1.28.0 (2018-08-02)
1036 ===========================
1037
1038 Language
1039 --------
1040 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1041   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1042   the inner type across Foreign Function Interface (FFI) boundaries.
1043 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1044   and can now be used as identifiers.][51196]
1045 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1046   stable.][51241] This will allow users to specify a global allocator for
1047   their program.
1048 - [Unit test functions marked with the `#[test]` attribute can now return
1049   `Result<(), E: Debug>` in addition to `()`.][51298]
1050 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1051   allows macros to easily target lifetimes.
1052
1053 Compiler
1054 --------
1055 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1056   prioritise making smaller binary sizes. `z` is the same as `s` with the
1057   exception that it does not vectorise loops, which typically results in an even
1058   smaller binary.
1059 - [The short error format is now stable.][49546] Specified with
1060   `--error-format=short` this option will provide a more compressed output of
1061   rust error messages.
1062 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1063 - [Reduced the number of allocations in the macro parser.][50855] This can
1064   improve compile times of macro heavy crates on average by 5%.
1065
1066 Libraries
1067 ---------
1068 - [Implemented `Default` for `&mut str`.][51306]
1069 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1070 - [Implemented `Extend` for `()`.][50234]
1071 - [The `Debug` implementation of `time::Duration` should now be more easily
1072   human readable.][50364] Previously a `Duration` of one second would printed as
1073   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1074 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1075   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1076   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1077   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1078   for `PathBuf`.][50170]
1079 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1080   and `Wrapping<i128>`.][50465]
1081 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1082   possible.][51050] This can provide up to a 40% speed increase.
1083 - [Improved error messages when using `format!`.][50610]
1084
1085 Stabilized APIs
1086 ---------------
1087 - [`Iterator::step_by`]
1088 - [`Path::ancestors`]
1089 - [`SystemTime::UNIX_EPOCH`]
1090 - [`alloc::GlobalAlloc`]
1091 - [`alloc::Layout`]
1092 - [`alloc::LayoutErr`]
1093 - [`alloc::System`]
1094 - [`alloc::alloc`]
1095 - [`alloc::alloc_zeroed`]
1096 - [`alloc::dealloc`]
1097 - [`alloc::realloc`]
1098 - [`alloc::handle_alloc_error`]
1099 - [`btree_map::Entry::or_default`]
1100 - [`fmt::Alignment`]
1101 - [`hash_map::Entry::or_default`]
1102 - [`iter::repeat_with`]
1103 - [`num::NonZeroUsize`]
1104 - [`num::NonZeroU128`]
1105 - [`num::NonZeroU16`]
1106 - [`num::NonZeroU32`]
1107 - [`num::NonZeroU64`]
1108 - [`num::NonZeroU8`]
1109 - [`ops::RangeBounds`]
1110 - [`slice::SliceIndex`]
1111 - [`slice::from_mut`]
1112 - [`slice::from_ref`]
1113 - [`{Any + Send + Sync}::downcast_mut`]
1114 - [`{Any + Send + Sync}::downcast_ref`]
1115 - [`{Any + Send + Sync}::is`]
1116
1117 Cargo
1118 -----
1119 - [Cargo will now no longer allow you to publish crates with build scripts that
1120   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1121   considered to be immutable.
1122
1123 Misc
1124 ----
1125 - [The `suggestion_applicability` field in `rustc`'s json output is now
1126   stable.][50486] This will allow dev tools to check whether a code suggestion
1127   would apply to them.
1128
1129 Compatibility Notes
1130 -------------------
1131 - [Rust will consider trait objects with duplicated constraints to be the same
1132   type as without the duplicated constraint.][51276] For example the below code will
1133   now fail to compile.
1134   ```rust
1135   trait Trait {}
1136
1137   impl Trait + Send {
1138       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1139   }
1140
1141   impl Trait + Send + Send {
1142       fn test(&self) { println!("two"); }
1143   }
1144   ```
1145
1146 [49546]: https://github.com/rust-lang/rust/pull/49546/
1147 [50143]: https://github.com/rust-lang/rust/pull/50143/
1148 [50170]: https://github.com/rust-lang/rust/pull/50170/
1149 [50234]: https://github.com/rust-lang/rust/pull/50234/
1150 [50265]: https://github.com/rust-lang/rust/pull/50265/
1151 [50364]: https://github.com/rust-lang/rust/pull/50364/
1152 [50385]: https://github.com/rust-lang/rust/pull/50385/
1153 [50465]: https://github.com/rust-lang/rust/pull/50465/
1154 [50486]: https://github.com/rust-lang/rust/pull/50486/
1155 [50554]: https://github.com/rust-lang/rust/pull/50554/
1156 [50610]: https://github.com/rust-lang/rust/pull/50610/
1157 [50855]: https://github.com/rust-lang/rust/pull/50855/
1158 [51050]: https://github.com/rust-lang/rust/pull/51050/
1159 [51196]: https://github.com/rust-lang/rust/pull/51196/
1160 [51200]: https://github.com/rust-lang/rust/pull/51200/
1161 [51241]: https://github.com/rust-lang/rust/pull/51241/
1162 [51276]: https://github.com/rust-lang/rust/pull/51276/
1163 [51298]: https://github.com/rust-lang/rust/pull/51298/
1164 [51306]: https://github.com/rust-lang/rust/pull/51306/
1165 [51562]: https://github.com/rust-lang/rust/pull/51562/
1166 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1167 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1168 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1169 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1170 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1171 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1172 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1173 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1174 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1175 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1176 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1177 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1178 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1179 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1180 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1181 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1182 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1183 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1184 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1185 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1186 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1187 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1188 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1189 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1190 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1191 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1192 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1193 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1194 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1195 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1196
1197 Version 1.27.2 (2018-07-20)
1198 ===========================
1199
1200 Compatibility Notes
1201 -------------------
1202
1203 - The borrow checker was fixed to avoid potential unsoundness when using
1204   match ergonomics: [#52213][52213].
1205
1206 [52213]: https://github.com/rust-lang/rust/issues/52213
1207
1208 Version 1.27.1 (2018-07-10)
1209 ===========================
1210
1211 Security Notes
1212 --------------
1213
1214 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1215   when running, which enabled executing code as some other user on a
1216   given machine. This release fixes that vulnerability; you can read
1217   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1218
1219   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
1220
1221 Compatibility Notes
1222 -------------------
1223
1224 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1225   match ergonomics: [#51415][51415], [#49534][49534].
1226
1227 [51415]: https://github.com/rust-lang/rust/issues/51415
1228 [49534]: https://github.com/rust-lang/rust/issues/49534
1229 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1230 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1231
1232 Version 1.27.0 (2018-06-21)
1233 ==========================
1234
1235 Language
1236 --------
1237 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1238   be used as an identifier.
1239 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1240   bare `Trait` syntax, and should make it clearer when being used in tandem with
1241   `impl Trait` because it is equivalent to the following syntax:
1242   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1243   `Box<Trait> == Box<dyn Trait>`.
1244 - [Attributes on generic parameters such as types and lifetimes are
1245   now stable.][48851] e.g.
1246   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1247 - [The `#[must_use]` attribute can now also be used on functions as well as
1248   types.][48925] It provides a lint that by default warns users when the
1249   value returned by a function has not been used.
1250
1251 Compiler
1252 --------
1253 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1254
1255 Libraries
1256 ---------
1257 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1258   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1259   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1260   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1261   the `cfg` attribute.
1262 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1263   std are now available in core.][49896]
1264 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1265   to `Self`.][49630]
1266 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1267   that the operation isn't done in place.
1268 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1269   the `#[must_use]` attribute][49533] to warn about unused potentially
1270   expensive allocations.
1271
1272 Stabilized APIs
1273 ---------------
1274 - [`DoubleEndedIterator::rfind`]
1275 - [`DoubleEndedIterator::rfold`]
1276 - [`DoubleEndedIterator::try_rfold`]
1277 - [`Duration::from_micros`]
1278 - [`Duration::from_nanos`]
1279 - [`Duration::subsec_micros`]
1280 - [`Duration::subsec_millis`]
1281 - [`HashMap::remove_entry`]
1282 - [`Iterator::try_fold`]
1283 - [`Iterator::try_for_each`]
1284 - [`NonNull::cast`]
1285 - [`Option::filter`]
1286 - [`String::replace_range`]
1287 - [`Take::set_limit`]
1288 - [`hint::unreachable_unchecked`]
1289 - [`os::unix::process::parent_id`]
1290 - [`ptr::swap_nonoverlapping`]
1291 - [`slice::rsplit_mut`]
1292 - [`slice::rsplit`]
1293 - [`slice::swap_with_slice`]
1294
1295 Cargo
1296 -----
1297 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1298   `readme`, and `repository` fields.][cargo/5386]
1299 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1300 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1301   a different directory than `target` for placing compilation artifacts.
1302 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1303   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1304   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1305   where cargo would infer a binary, Cargo will produce a warning. You can
1306   disable this feature ahead of time by setting any of the following to false:
1307   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1308 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1309   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1310
1311 Misc
1312 ----
1313 - [Added “The Rustc book” into the official documentation.][49707]
1314   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1315 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1316
1317 Compatibility Notes
1318 -------------------
1319 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1320   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1321   compile, `"".is_empty()` will still compile.
1322 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1323   will only print the inner type.][48553] E.g.
1324   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1325   not `AtomicBool(true)`.
1326 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1327   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1328   alignment should cover all use cases.
1329 - The `.description()` method on the `std::error::Error` trait
1330   [has been soft-deprecated][50163]. It is no longer required to implement it.
1331
1332 [48553]: https://github.com/rust-lang/rust/pull/48553/
1333 [48851]: https://github.com/rust-lang/rust/pull/48851/
1334 [48925]: https://github.com/rust-lang/rust/pull/48925/
1335 [49533]: https://github.com/rust-lang/rust/pull/49533/
1336 [49623]: https://github.com/rust-lang/rust/pull/49623/
1337 [49630]: https://github.com/rust-lang/rust/pull/49630/
1338 [49664]: https://github.com/rust-lang/rust/pull/49664/
1339 [49699]: https://github.com/rust-lang/rust/pull/49699/
1340 [49707]: https://github.com/rust-lang/rust/pull/49707/
1341 [49719]: https://github.com/rust-lang/rust/pull/49719/
1342 [49896]: https://github.com/rust-lang/rust/pull/49896/
1343 [49968]: https://github.com/rust-lang/rust/pull/49968/
1344 [50163]: https://github.com/rust-lang/rust/pull/50163
1345 [50177]: https://github.com/rust-lang/rust/pull/50177/
1346 [50378]: https://github.com/rust-lang/rust/pull/50378/
1347 [50398]: https://github.com/rust-lang/rust/pull/50398/
1348 [50423]: https://github.com/rust-lang/rust/pull/50423/
1349 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1350 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1351 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1352 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1353 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1354 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1355 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1356 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1357 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1358 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1359 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1360 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1361 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1362 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1363 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1364 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1365 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1366 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1367 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1368 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1369 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1370 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1371 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1372 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1373 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1374 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1375 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1376 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1377 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1378 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1379
1380
1381 Version 1.26.2 (2018-06-05)
1382 ==========================
1383
1384 Compatibility Notes
1385 -------------------
1386
1387 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1388
1389 [51117]: https://github.com/rust-lang/rust/issues/51117
1390
1391
1392 Version 1.26.1 (2018-05-29)
1393 ==========================
1394
1395 Tools
1396 -----
1397
1398 - [RLS now works on Windows.][50646]
1399 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1400
1401
1402 Compatibility Notes
1403 --------
1404
1405 - [`fn main() -> impl Trait` no longer works for non-Termination
1406   trait.][50656]
1407   This reverts an accidental stabilization.
1408 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1409 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
1410
1411 [50646]: https://github.com/rust-lang/rust/issues/50646
1412 [50656]: https://github.com/rust-lang/rust/pull/50656
1413 [50812]: https://github.com/rust-lang/rust/pull/50812
1414 [50950]: https://github.com/rust-lang/rust/issues/50950
1415 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
1416
1417 Version 1.26.0 (2018-05-10)
1418 ==========================
1419
1420 Language
1421 --------
1422 - [Closures now implement `Copy` and/or `Clone` if all captured variables
1423   implement either or both traits.][49299]
1424 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
1425 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
1426   lifetime can be elided.][49458]
1427 - [`impl Trait` is now stable allowing you to have abstract types in returns
1428    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
1429   `fn open(path: impl AsRef<Path>)`.
1430 - [Pattern matching will now automatically apply dereferences.][49394]
1431 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
1432 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
1433 - [A lot of operations are now available in a const context.][46882] E.g. You
1434   can now index into constant arrays, reference and dereference into constants,
1435   and use tuple struct constructors.
1436 - [Fixed entry slice patterns are now stable.][48516] E.g.
1437   ```rust
1438   let points = [1, 2, 3, 4];
1439   match points {
1440       [1, 2, 3, 4] => println!("All points were sequential."),
1441       _ => println!("Not all points were sequential."),
1442   }
1443   ```
1444
1445
1446 Compiler
1447 --------
1448 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
1449 - [Fixed exponential projection complexity on nested types.][48296]
1450   This can provide up to a ~12% reduction in compile times for certain crates.
1451 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
1452   to remap path prefixes outputted by the compiler.
1453 - [Added `powerpc-unknown-netbsd` target.][48281]
1454
1455 Libraries
1456 ---------
1457 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
1458 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
1459   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
1460 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
1461 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
1462 - [`ascii::escape_default` is now available in libcore.][48735]
1463 - [Trailing commas are now supported in std and core macros.][48056]
1464 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
1465 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
1466
1467 Stabilized APIs
1468 ---------------
1469 - [`*const T::add`]
1470 - [`*const T::copy_to_nonoverlapping`]
1471 - [`*const T::copy_to`]
1472 - [`*const T::read_unaligned`]
1473 - [`*const T::read_volatile`]
1474 - [`*const T::read`]
1475 - [`*const T::sub`]
1476 - [`*const T::wrapping_add`]
1477 - [`*const T::wrapping_sub`]
1478 - [`*mut T::add`]
1479 - [`*mut T::copy_to_nonoverlapping`]
1480 - [`*mut T::copy_to`]
1481 - [`*mut T::read_unaligned`]
1482 - [`*mut T::read_volatile`]
1483 - [`*mut T::read`]
1484 - [`*mut T::replace`]
1485 - [`*mut T::sub`]
1486 - [`*mut T::swap`]
1487 - [`*mut T::wrapping_add`]
1488 - [`*mut T::wrapping_sub`]
1489 - [`*mut T::write_bytes`]
1490 - [`*mut T::write_unaligned`]
1491 - [`*mut T::write_volatile`]
1492 - [`*mut T::write`]
1493 - [`Box::leak`]
1494 - [`FromUtf8Error::as_bytes`]
1495 - [`LocalKey::try_with`]
1496 - [`Option::cloned`]
1497 - [`btree_map::Entry::and_modify`]
1498 - [`fs::read_to_string`]
1499 - [`fs::read`]
1500 - [`fs::write`]
1501 - [`hash_map::Entry::and_modify`]
1502 - [`iter::FusedIterator`]
1503 - [`ops::RangeInclusive`]
1504 - [`ops::RangeToInclusive`]
1505 - [`process::id`]
1506 - [`slice::rotate_left`]
1507 - [`slice::rotate_right`]
1508 - [`String::retain`]
1509
1510
1511 Cargo
1512 -----
1513 - [Cargo will now output path to custom commands when `-v` is
1514   passed with `--list`][cargo/5041]
1515 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
1516
1517 Misc
1518 ----
1519 - [The second edition of "The Rust Programming Language" book is now recommended
1520   over the first.][48404]
1521
1522 Compatibility Notes
1523 -------------------
1524
1525 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
1526   syntax is now invalid.
1527   ```
1528   use std::ops::Fn as dyn;
1529   fn g(_: Box<dyn(std::fmt::Debug)>) {}
1530   ```
1531 - [The result of dereferences are no longer promoted to `'static`.][47408]
1532   e.g.
1533   ```rust
1534   fn main() {
1535       const PAIR: &(i32, i32) = &(0, 1);
1536       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
1537   }
1538   ```
1539 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
1540 - [`".e0"` will now no longer parse as `0.0` and will instead cause
1541   an error.][48235]
1542 - [Removed hoedown from rustdoc.][48274]
1543 - [Bounds on higher-kinded lifetimes a hard error.][48326]
1544
1545 [46882]: https://github.com/rust-lang/rust/pull/46882
1546 [47379]: https://github.com/rust-lang/rust/pull/47379
1547 [47408]: https://github.com/rust-lang/rust/pull/47408
1548 [47813]: https://github.com/rust-lang/rust/pull/47813
1549 [48056]: https://github.com/rust-lang/rust/pull/48056
1550 [48125]: https://github.com/rust-lang/rust/pull/48125
1551 [48166]: https://github.com/rust-lang/rust/pull/48166
1552 [48235]: https://github.com/rust-lang/rust/pull/48235
1553 [48274]: https://github.com/rust-lang/rust/pull/48274
1554 [48281]: https://github.com/rust-lang/rust/pull/48281
1555 [48296]: https://github.com/rust-lang/rust/pull/48296
1556 [48326]: https://github.com/rust-lang/rust/pull/48326
1557 [48359]: https://github.com/rust-lang/rust/pull/48359
1558 [48404]: https://github.com/rust-lang/rust/pull/48404
1559 [48481]: https://github.com/rust-lang/rust/pull/48481
1560 [48516]: https://github.com/rust-lang/rust/pull/48516
1561 [48628]: https://github.com/rust-lang/rust/pull/48628
1562 [48629]: https://github.com/rust-lang/rust/pull/48629
1563 [48657]: https://github.com/rust-lang/rust/pull/48657
1564 [48735]: https://github.com/rust-lang/rust/pull/48735
1565 [48978]: https://github.com/rust-lang/rust/pull/48978
1566 [49101]: https://github.com/rust-lang/rust/pull/49101
1567 [49109]: https://github.com/rust-lang/rust/pull/49109
1568 [49121]: https://github.com/rust-lang/rust/pull/49121
1569 [49162]: https://github.com/rust-lang/rust/pull/49162
1570 [49184]: https://github.com/rust-lang/rust/pull/49184
1571 [49234]: https://github.com/rust-lang/rust/pull/49234
1572 [49255]: https://github.com/rust-lang/rust/pull/49255
1573 [49299]: https://github.com/rust-lang/rust/pull/49299
1574 [49305]: https://github.com/rust-lang/rust/pull/49305
1575 [49394]: https://github.com/rust-lang/rust/pull/49394
1576 [49458]: https://github.com/rust-lang/rust/pull/49458
1577 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
1578 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
1579 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
1580 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
1581 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
1582 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
1583 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
1584 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
1585 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
1586 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
1587 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
1588 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
1589 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
1590 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
1591 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
1592 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
1593 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
1594 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
1595 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
1596 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
1597 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
1598 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
1599 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
1600 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
1601 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
1602 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
1603 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
1604 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
1605 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
1606 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
1607 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
1608 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
1609 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
1610 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
1611 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
1612 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
1613 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1614 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
1615 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
1616 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
1617 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
1618 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
1619
1620
1621 Version 1.25.0 (2018-03-29)
1622 ==========================
1623
1624 Language
1625 --------
1626 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
1627 - [You can now use nested groups of imports.][47948]
1628   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
1629 - [You can now have `|` at the start of a match arm.][47947] e.g.
1630 ```rust
1631 enum Foo { A, B, C }
1632
1633 fn main() {
1634     let x = Foo::A;
1635     match x {
1636         | Foo::A
1637         | Foo::B => println!("AB"),
1638         | Foo::C => println!("C"),
1639     }
1640 }
1641 ```
1642
1643 Compiler
1644 --------
1645 - [Upgraded to LLVM 6.][47828]
1646 - [Added `-C lto=val` option.][47521]
1647 - [Added `i586-unknown-linux-musl` target][47282]
1648
1649 Libraries
1650 ---------
1651 - [Impl Send for `process::Command` on Unix.][47760]
1652 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
1653 - [`UnsafeCell::into_inner` is now safe.][47204]
1654 - [Implement libstd for CloudABI.][47268]
1655 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
1656 - [Implement `AsRef<Path>` for Component][46985]
1657 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
1658 - [Moved `Duration` to libcore.][46666]
1659
1660 Stabilized APIs
1661 ---------------
1662 - [`Location::column`]
1663 - [`ptr::NonNull`]
1664
1665 The following functions can now be used in a constant expression.
1666 eg. `static MINUTE: Duration = Duration::from_secs(60);`
1667 - [`Duration::new`][47300]
1668 - [`Duration::from_secs`][47300]
1669 - [`Duration::from_millis`][47300]
1670
1671 Cargo
1672 -----
1673 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
1674 - [`cargo new` now defaults to creating a binary crate, instead of a
1675   library crate.][cargo/5029]
1676
1677 Misc
1678 ----
1679 - [Rust by example is now shipped with new releases][46196]
1680
1681 Compatibility Notes
1682 -------------------
1683 - [Deprecated `net::lookup_host`.][47510]
1684 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
1685 - The borrow checker was sometimes incorrectly permitting overlapping borrows
1686   around indexing operations (see [#47349][47349]). This has been fixed (which also
1687   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
1688 - [Removed deprecated unstable attribute `#[simd]`.][47251]
1689
1690 [33903]: https://github.com/rust-lang/rust/pull/33903
1691 [47947]: https://github.com/rust-lang/rust/pull/47947
1692 [47948]: https://github.com/rust-lang/rust/pull/47948
1693 [47760]: https://github.com/rust-lang/rust/pull/47760
1694 [47790]: https://github.com/rust-lang/rust/pull/47790
1695 [47828]: https://github.com/rust-lang/rust/pull/47828
1696 [47398]: https://github.com/rust-lang/rust/pull/47398
1697 [47510]: https://github.com/rust-lang/rust/pull/47510
1698 [47521]: https://github.com/rust-lang/rust/pull/47521
1699 [47204]: https://github.com/rust-lang/rust/pull/47204
1700 [47251]: https://github.com/rust-lang/rust/pull/47251
1701 [47268]: https://github.com/rust-lang/rust/pull/47268
1702 [47282]: https://github.com/rust-lang/rust/pull/47282
1703 [47300]: https://github.com/rust-lang/rust/pull/47300
1704 [47349]: https://github.com/rust-lang/rust/pull/47349
1705 [46931]: https://github.com/rust-lang/rust/pull/46931
1706 [46985]: https://github.com/rust-lang/rust/pull/46985
1707 [47006]: https://github.com/rust-lang/rust/pull/47006
1708 [46830]: https://github.com/rust-lang/rust/pull/46830
1709 [46095]: https://github.com/rust-lang/rust/pull/46095
1710 [46666]: https://github.com/rust-lang/rust/pull/46666
1711 [46196]: https://github.com/rust-lang/rust/pull/46196
1712 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
1713 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
1714 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
1715 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
1716 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1717
1718
1719 Version 1.24.1 (2018-03-01)
1720 ==========================
1721
1722  - [Do not abort when unwinding through FFI][48251]
1723  - [Emit UTF-16 files for linker arguments on Windows][48318]
1724  - [Make the error index generator work again][48308]
1725  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1726
1727 [48251]: https://github.com/rust-lang/rust/issues/48251
1728 [48308]: https://github.com/rust-lang/rust/issues/48308
1729 [48318]: https://github.com/rust-lang/rust/issues/48318
1730 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1731
1732
1733 Version 1.24.0 (2018-02-15)
1734 ==========================
1735
1736 Language
1737 --------
1738 - [External `sysv64` ffi is now available.][46528]
1739   eg. `extern "sysv64" fn foo () {}`
1740
1741 Compiler
1742 --------
1743 - [rustc now uses 16 codegen units by default for release builds.][46910]
1744   For the fastest builds, utilize `codegen-units=1`.
1745 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1746 - [Add `aarch64-unknown-openbsd` support][46760]
1747
1748 Libraries
1749 ---------
1750 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1751   improvement in performance in the majority of cases.
1752 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1753   with Windows.][46798]
1754 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1755 - [impl `From<bool>` for `AtomicBool`][46293]
1756 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1757 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1758 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1759 - [float::from_bits now just uses transmute.][46012] This provides
1760   some optimisations from LLVM.
1761 - [Copied `AsciiExt` methods onto `char`][46077]
1762 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1763 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1764 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1765 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1766
1767 Stabilized APIs
1768 ---------------
1769 - [`RefCell::replace`]
1770 - [`RefCell::swap`]
1771 - [`atomic::spin_loop_hint`]
1772
1773 The following functions can now be used in a constant expression.
1774 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1775
1776 - [`AtomicBool::new`][46287]
1777 - [`AtomicUsize::new`][46287]
1778 - [`AtomicIsize::new`][46287]
1779 - [`AtomicPtr::new`][46287]
1780 - [`Cell::new`][46287]
1781 - [`{integer}::min_value`][46287]
1782 - [`{integer}::max_value`][46287]
1783 - [`mem::size_of`][46287]
1784 - [`mem::align_of`][46287]
1785 - [`ptr::null`][46287]
1786 - [`ptr::null_mut`][46287]
1787 - [`RefCell::new`][46287]
1788 - [`UnsafeCell::new`][46287]
1789
1790 Cargo
1791 -----
1792 - [Added a `workspace.default-members` config that
1793   overrides implied `--all` in virtual workspaces.][cargo/4743]
1794 - [Enable incremental by default on development builds.][cargo/4817] Also added
1795   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1796   per-project or global basis respectively.
1797
1798 Misc
1799 ----
1800
1801 Compatibility Notes
1802 -------------------
1803 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1804 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1805   in accordance with IETF RFC 4291 §2.2.
1806 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1807 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1808   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1809 - [Leading zeros in tuple struct members is now an error][47084]
1810 - [`column!()` macro is one-based instead of zero-based][46977]
1811 - [`fmt::Arguments` can no longer be shared across threads][45198]
1812 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1813 - [Cargo sets a different working directory for the compiler][cargo/4788]
1814
1815 [44884]: https://github.com/rust-lang/rust/pull/44884
1816 [45198]: https://github.com/rust-lang/rust/pull/45198
1817 [45506]: https://github.com/rust-lang/rust/pull/45506
1818 [45904]: https://github.com/rust-lang/rust/pull/45904
1819 [45990]: https://github.com/rust-lang/rust/pull/45990
1820 [46012]: https://github.com/rust-lang/rust/pull/46012
1821 [46077]: https://github.com/rust-lang/rust/pull/46077
1822 [46094]: https://github.com/rust-lang/rust/pull/46094
1823 [46284]: https://github.com/rust-lang/rust/pull/46284
1824 [46287]: https://github.com/rust-lang/rust/pull/46287
1825 [46293]: https://github.com/rust-lang/rust/pull/46293
1826 [46528]: https://github.com/rust-lang/rust/pull/46528
1827 [46671]: https://github.com/rust-lang/rust/pull/46671
1828 [46713]: https://github.com/rust-lang/rust/pull/46713
1829 [46735]: https://github.com/rust-lang/rust/pull/46735
1830 [46749]: https://github.com/rust-lang/rust/pull/46749
1831 [46760]: https://github.com/rust-lang/rust/pull/46760
1832 [46798]: https://github.com/rust-lang/rust/pull/46798
1833 [46828]: https://github.com/rust-lang/rust/pull/46828
1834 [46831]: https://github.com/rust-lang/rust/pull/46831
1835 [46833]: https://github.com/rust-lang/rust/pull/46833
1836 [46910]: https://github.com/rust-lang/rust/pull/46910
1837 [46977]: https://github.com/rust-lang/rust/pull/46977
1838 [47018]: https://github.com/rust-lang/rust/pull/47018
1839 [47080]: https://github.com/rust-lang/rust/pull/47080
1840 [47084]: https://github.com/rust-lang/rust/pull/47084
1841 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1842 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1843 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1844 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1845 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1846 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1847
1848
1849 Version 1.23.0 (2018-01-04)
1850 ==========================
1851
1852 Language
1853 --------
1854 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1855 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1856   Which should fix some confusing errors in some operations.
1857
1858 Compiler
1859 --------
1860 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1861   undefined behavior.][45920]
1862 - [rustc now suggests renaming import if names clash.][45660]
1863 - [Display errors/warnings correctly when there are zero-width or
1864   wide characters.][45711]
1865 - [rustc now avoids unnecessary copies of arguments that are
1866   simple bindings][45380] This should improve memory usage on average by 5-10%.
1867 - [Updated musl used to build musl rustc to 1.1.17][45393]
1868
1869 Libraries
1870 ---------
1871 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1872 - [Implement Hash for raw pointers to unsized types][45483]
1873 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1874 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1875 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1876 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1877   and `<*mut T>::as_mut`][44932]
1878 - [Optimized `Thread::{park, unpark}` implementation][45524]
1879 - [Improved `SliceExt::binary_search` performance.][45333]
1880 - [impl `FromIterator<()>` for `()`][45379]
1881 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1882   is now deprecated.
1883
1884 Stabilized APIs
1885 ---------------
1886
1887 Cargo
1888 -----
1889 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1890   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1891 - [Added unit test checking to `cargo check`][cargo/4592]
1892 - [Cargo now lets you install a specific version
1893   using `cargo install --version`][cargo/4637]
1894
1895 Misc
1896 ----
1897 - [Releases now ship with the Cargo book documentation.][45692]
1898 - [rustdoc now prints rendering warnings on every run.][45324]
1899
1900 Compatibility Notes
1901 -------------------
1902 - [Changes have been made to type equality to make it more correct,
1903   in rare cases this could break some code.][45853] [Tracking issue for
1904   further information][45852]
1905 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1906 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1907   Android 9, the minimum supported version is Android 14.
1908 - [Bumped the minimum LLVM to 3.9][45326]
1909
1910 [44042]: https://github.com/rust-lang/rust/pull/44042
1911 [44932]: https://github.com/rust-lang/rust/pull/44932
1912 [45267]: https://github.com/rust-lang/rust/pull/45267
1913 [45324]: https://github.com/rust-lang/rust/pull/45324
1914 [45326]: https://github.com/rust-lang/rust/pull/45326
1915 [45333]: https://github.com/rust-lang/rust/pull/45333
1916 [45379]: https://github.com/rust-lang/rust/pull/45379
1917 [45380]: https://github.com/rust-lang/rust/pull/45380
1918 [45393]: https://github.com/rust-lang/rust/pull/45393
1919 [45435]: https://github.com/rust-lang/rust/pull/45435
1920 [45483]: https://github.com/rust-lang/rust/pull/45483
1921 [45524]: https://github.com/rust-lang/rust/pull/45524
1922 [45571]: https://github.com/rust-lang/rust/pull/45571
1923 [45580]: https://github.com/rust-lang/rust/pull/45580
1924 [45610]: https://github.com/rust-lang/rust/pull/45610
1925 [45660]: https://github.com/rust-lang/rust/pull/45660
1926 [45692]: https://github.com/rust-lang/rust/pull/45692
1927 [45711]: https://github.com/rust-lang/rust/pull/45711
1928 [45772]: https://github.com/rust-lang/rust/pull/45772
1929 [45852]: https://github.com/rust-lang/rust/issues/45852
1930 [45853]: https://github.com/rust-lang/rust/pull/45853
1931 [45887]: https://github.com/rust-lang/rust/pull/45887
1932 [45920]: https://github.com/rust-lang/rust/pull/45920
1933 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1934 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1935 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1936
1937
1938 Version 1.22.1 (2017-11-22)
1939 ==========================
1940
1941 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1942
1943 [46183]: https://github.com/rust-lang/rust/pull/46183
1944
1945 Version 1.22.0 (2017-11-22)
1946 ==========================
1947
1948 Language
1949 --------
1950 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1951 - [Now accepts underscores in unicode escapes][43716]
1952 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1953 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1954
1955 Compiler
1956 --------
1957 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1958 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1959   This should decrease compile times for debug builds.
1960 - [strict memory alignment now enabled on ARMv6][45094]
1961 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1962
1963 Libraries
1964 ---------
1965 - [Allow atomic operations up to 32 bits
1966   on `armv5te_unknown_linux_gnueabi`][44978]
1967 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1968 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1969 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1970 - [Properly detect overflow in `Instant += Duration`.][44220]
1971 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1972 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1973 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1974
1975 Stabilized APIs
1976 ---------------
1977
1978 Cargo
1979 -----
1980 - [Cargo will now build multi file examples in subdirectories of the `examples`
1981   folder that have a `main.rs` file.][cargo/4496]
1982 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1983   the old format will continue to work and can be updated with `cargo update`.
1984 - [Now supports vendoring git repositories][cargo/3992]
1985
1986 Misc
1987 ----
1988 - [`libbacktrace` is now available on Apple platforms.][44251]
1989 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1990   This now lets you specify that a given code example will fail to compile.
1991
1992 Compatibility Notes
1993 -------------------
1994 - [The minimum Android version that rustc can build for has been bumped
1995   to `4.0` from `2.3`][45656]
1996 - [Allowing `T op= &T` for numeric types has broken some type
1997   inference cases][45480]
1998
1999
2000 [42526]: https://github.com/rust-lang/rust/pull/42526
2001 [43017]: https://github.com/rust-lang/rust/pull/43017
2002 [43716]: https://github.com/rust-lang/rust/pull/43716
2003 [43949]: https://github.com/rust-lang/rust/pull/43949
2004 [44015]: https://github.com/rust-lang/rust/pull/44015
2005 [44220]: https://github.com/rust-lang/rust/pull/44220
2006 [44251]: https://github.com/rust-lang/rust/pull/44251
2007 [44287]: https://github.com/rust-lang/rust/pull/44287
2008 [44303]: https://github.com/rust-lang/rust/pull/44303
2009 [44456]: https://github.com/rust-lang/rust/pull/44456
2010 [44466]: https://github.com/rust-lang/rust/pull/44466
2011 [44895]: https://github.com/rust-lang/rust/pull/44895
2012 [44966]: https://github.com/rust-lang/rust/pull/44966
2013 [44978]: https://github.com/rust-lang/rust/pull/44978
2014 [45041]: https://github.com/rust-lang/rust/pull/45041
2015 [45064]: https://github.com/rust-lang/rust/pull/45064
2016 [45075]: https://github.com/rust-lang/rust/pull/45075
2017 [45094]: https://github.com/rust-lang/rust/pull/45094
2018 [45095]: https://github.com/rust-lang/rust/pull/45095
2019 [45480]: https://github.com/rust-lang/rust/issues/45480
2020 [45656]: https://github.com/rust-lang/rust/pull/45656
2021 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2022 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2023 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2024
2025
2026
2027
2028
2029
2030 Version 1.21.0 (2017-10-12)
2031 ==========================
2032
2033 Language
2034 --------
2035 - [You can now use static references for literals.][43838]
2036   Example:
2037   ```rust
2038   fn main() {
2039       let x: &'static u32 = &0;
2040   }
2041   ```
2042 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2043   Example:
2044   ```rust
2045   my_macro!(Vec<i32>::new); // Always worked
2046   my_macro!(Vec::<i32>::new); // Now works
2047   ```
2048
2049 Compiler
2050 --------
2051 - [Upgraded jemalloc to 4.5.0][43911]
2052 - [Enabled unwinding panics on Redox][43917]
2053 - [Now runs LLVM in parallel during translation phase.][43506]
2054   This should reduce peak memory usage.
2055
2056 Libraries
2057 ---------
2058 - [Generate builtin impls for `Clone` for all arrays and tuples that
2059   are `T: Clone`][43690]
2060 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2061 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2062   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2063
2064 Stabilized APIs
2065 ---------------
2066
2067 [`std::mem::discriminant`]
2068
2069 Cargo
2070 -----
2071 - [You can now call `cargo install` with multiple package names][cargo/4216]
2072 - [Cargo commands inside a virtual workspace will now implicitly
2073   pass `--all`][cargo/4335]
2074 - [Added a `[patch]` section to `Cargo.toml` to handle
2075   prepublication dependencies][cargo/4123] [RFC 1969]
2076 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2077   like patterns][cargo/4270]
2078 - [Added the `--all-targets` option][cargo/4400]
2079 - [Using required dependencies as a feature is now deprecated and emits
2080   a warning][cargo/4364]
2081
2082
2083 Misc
2084 ----
2085 - [Cargo docs are moving][43916]
2086   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2087 - [The rustdoc book is now available][43863]
2088   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2089 - [Added a preview of RLS has been made available through rustup][44204]
2090   Install with `rustup component add rls-preview`
2091 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2092   Previously only showed `std::os::unix`.
2093
2094 Compatibility Notes
2095 -------------------
2096 - [Changes in method matching against higher-ranked types][43880] This may cause
2097   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2098 - [rustc's JSON error output's byte position start at top of file.][42973]
2099   Was previously relative to the rustc's internal `CodeMap` struct which
2100   required the unstable library `libsyntax` to correctly use.
2101 - [`unused_results` lint no longer ignores booleans][43728]
2102
2103 [42565]: https://github.com/rust-lang/rust/pull/42565
2104 [42973]: https://github.com/rust-lang/rust/pull/42973
2105 [43348]: https://github.com/rust-lang/rust/pull/43348
2106 [43459]: https://github.com/rust-lang/rust/pull/43459
2107 [43506]: https://github.com/rust-lang/rust/pull/43506
2108 [43540]: https://github.com/rust-lang/rust/pull/43540
2109 [43690]: https://github.com/rust-lang/rust/pull/43690
2110 [43728]: https://github.com/rust-lang/rust/pull/43728
2111 [43838]: https://github.com/rust-lang/rust/pull/43838
2112 [43863]: https://github.com/rust-lang/rust/pull/43863
2113 [43880]: https://github.com/rust-lang/rust/pull/43880
2114 [43911]: https://github.com/rust-lang/rust/pull/43911
2115 [43916]: https://github.com/rust-lang/rust/pull/43916
2116 [43917]: https://github.com/rust-lang/rust/pull/43917
2117 [44204]: https://github.com/rust-lang/rust/pull/44204
2118 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2119 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2120 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2121 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2122 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2123 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2124 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2125 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2126 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2127
2128 Version 1.20.0 (2017-08-31)
2129 ===========================
2130
2131 Language
2132 --------
2133 - [Associated constants are now stabilised.][42809]
2134 - [A lot of macro bugs are now fixed.][42913]
2135
2136 Compiler
2137 --------
2138
2139 - [Struct fields are now properly coerced to the expected field type.][42807]
2140 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2141   `wasm32-experimental-emscripten` target.
2142 - [Changed some of the error messages to be more helpful.][42033]
2143 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2144   it.][43170]
2145 - [rustc now reports the total number of errors on compilation failure][43015]
2146   previously this was only the number of errors in the pass that failed.
2147 - [Expansion in rustc has been sped up 29x.][42533]
2148 - [added `msp430-none-elf` target.][43099]
2149 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2150   applicable][43178]
2151 - [Fixes backtraces on Redox][43228]
2152 - [rustc now identifies different versions of same crate when absolute paths of
2153   different types match in an error message.][42826]
2154
2155 Libraries
2156 ---------
2157
2158
2159 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2160 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2161   tuples.][43011]
2162 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2163   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2164 - [Impl `Clone` for `DefaultHasher`.][42799]
2165 - [Impl `Sync` for `SyncSender`.][42397]
2166 - [Impl `FromStr` for `char`][42271]
2167 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2168   NaN.][42431]
2169 - [allow messages in the `unimplemented!()` macro.][42155]
2170   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2171 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2172 - [Upgrade to Unicode 10.0.0][42999]
2173 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2174 - [Skip the main thread's manual stack guard on Linux][43072]
2175 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2176 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2177   previously 2^15.
2178 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2179
2180 Stabilized APIs
2181 ---------------
2182
2183 - [`CStr::into_c_string`]
2184 - [`CString::as_c_str`]
2185 - [`CString::into_boxed_c_str`]
2186 - [`Chain::get_mut`]
2187 - [`Chain::get_ref`]
2188 - [`Chain::into_inner`]
2189 - [`Option::get_or_insert_with`]
2190 - [`Option::get_or_insert`]
2191 - [`OsStr::into_os_string`]
2192 - [`OsString::into_boxed_os_str`]
2193 - [`Take::get_mut`]
2194 - [`Take::get_ref`]
2195 - [`Utf8Error::error_len`]
2196 - [`char::EscapeDebug`]
2197 - [`char::escape_debug`]
2198 - [`compile_error!`]
2199 - [`f32::from_bits`]
2200 - [`f32::to_bits`]
2201 - [`f64::from_bits`]
2202 - [`f64::to_bits`]
2203 - [`mem::ManuallyDrop`]
2204 - [`slice::sort_unstable_by_key`]
2205 - [`slice::sort_unstable_by`]
2206 - [`slice::sort_unstable`]
2207 - [`str::from_boxed_utf8_unchecked`]
2208 - [`str::as_bytes_mut`]
2209 - [`str::as_bytes_mut`]
2210 - [`str::from_utf8_mut`]
2211 - [`str::from_utf8_unchecked_mut`]
2212 - [`str::get_mut`]
2213 - [`str::get_unchecked_mut`]
2214 - [`str::get_unchecked`]
2215 - [`str::get`]
2216 - [`str::into_boxed_bytes`]
2217
2218
2219 Cargo
2220 -----
2221 - [Cargo API token location moved from `~/.cargo/config` to
2222   `~/.cargo/credentials`.][cargo/3978]
2223 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2224   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2225   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2226 - [You can now specify version of a binary when installed through
2227   `cargo install` using `--vers`.][cargo/4229]
2228 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2229   failure.][cargo/4248]
2230 - [Changed the convention around which file is the crate root.][cargo/4259]
2231 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2232   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2233
2234 Compatibility Notes
2235 -------------------
2236
2237 - [Functions with `'static` in their return types will now not be as usable as
2238   if they were using lifetime parameters instead.][42417]
2239 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2240   takes the sign of NaN into account where previously didn't.][42430]
2241
2242 [42033]: https://github.com/rust-lang/rust/pull/42033
2243 [42155]: https://github.com/rust-lang/rust/pull/42155
2244 [42271]: https://github.com/rust-lang/rust/pull/42271
2245 [42397]: https://github.com/rust-lang/rust/pull/42397
2246 [42417]: https://github.com/rust-lang/rust/pull/42417
2247 [42430]: https://github.com/rust-lang/rust/pull/42430
2248 [42431]: https://github.com/rust-lang/rust/pull/42431
2249 [42533]: https://github.com/rust-lang/rust/pull/42533
2250 [42571]: https://github.com/rust-lang/rust/pull/42571
2251 [42613]: https://github.com/rust-lang/rust/pull/42613
2252 [42799]: https://github.com/rust-lang/rust/pull/42799
2253 [42807]: https://github.com/rust-lang/rust/pull/42807
2254 [42809]: https://github.com/rust-lang/rust/pull/42809
2255 [42822]: https://github.com/rust-lang/rust/pull/42822
2256 [42826]: https://github.com/rust-lang/rust/pull/42826
2257 [42854]: https://github.com/rust-lang/rust/pull/42854
2258 [42913]: https://github.com/rust-lang/rust/pull/42913
2259 [42999]: https://github.com/rust-lang/rust/pull/42999
2260 [43011]: https://github.com/rust-lang/rust/pull/43011
2261 [43015]: https://github.com/rust-lang/rust/pull/43015
2262 [43072]: https://github.com/rust-lang/rust/pull/43072
2263 [43077]: https://github.com/rust-lang/rust/pull/43077
2264 [43097]: https://github.com/rust-lang/rust/pull/43097
2265 [43099]: https://github.com/rust-lang/rust/pull/43099
2266 [43170]: https://github.com/rust-lang/rust/pull/43170
2267 [43178]: https://github.com/rust-lang/rust/pull/43178
2268 [43185]: https://github.com/rust-lang/rust/pull/43185
2269 [43228]: https://github.com/rust-lang/rust/pull/43228
2270 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2271 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2272 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2273 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2274 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2275 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2276 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2277 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2278 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2279 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2280 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2281 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2282 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2283 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2284 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2285 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2286 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2287 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2288 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2289 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2290 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2291 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2292 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2293 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2294 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2295 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2296 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2297 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2298 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2299 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2300 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2301 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2302 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2303 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2304 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2305 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2306 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2307 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2308 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2309
2310
2311 Version 1.19.0 (2017-07-20)
2312 ===========================
2313
2314 Language
2315 --------
2316
2317 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2318   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2319 - [Macro recursion limit increased to 1024 from 64.][41676]
2320 - [Added lint for detecting unused macros.][41907]
2321 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2322   For example: `let x = loop { break 7; };`
2323 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2324   contain `Copy` types and cannot have a `Drop` implementation.
2325   Example: `union Foo { bar: u8, baz: usize }`
2326 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2327   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2328
2329 Compiler
2330 --------
2331
2332 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2333 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2334   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2335   you should use `--target armv7-linux-androideabi`.
2336 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2337 - [Minor optimisation of string operations.][42037]
2338 - [Compiler error message is now `aborting due to previous error(s)` instead of
2339   `aborting due to N previous errors`][42150] This was previously inaccurate and
2340   would only count certain kinds of errors.
2341 - [The compiler now supports Visual Studio 2017][42225]
2342 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2343 - [Added a lot][42264] of [new error codes][42302]
2344 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2345   libraries with C Run-time Libraries(CRT) to be statically linked.
2346 - [Fixed various ARM codegen bugs][42740]
2347
2348 Libraries
2349 ---------
2350
2351 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2352   `Extend<Cow<'a, str>>`][41449]
2353 - [`Vec` now implements `From<&mut [T]>`][41530]
2354 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2355 - [`SplitWhitespace` now implements `Clone`][41659]
2356 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2357   1.5x faster][41764]
2358 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2359   macros, but for printing to stderr.
2360
2361 Stabilized APIs
2362 ---------------
2363
2364 - [`OsString::shrink_to_fit`]
2365 - [`cmp::Reverse`]
2366 - [`Command::envs`]
2367 - [`thread::ThreadId`]
2368
2369 Cargo
2370 -----
2371
2372 - [Build scripts can now add environment variables to the environment
2373   the crate is being compiled in.
2374   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2375 - [Subcommands now replace the current process rather than spawning a new
2376   child process][cargo/3970]
2377 - [Workspace members can now accept glob file patterns][cargo/3979]
2378 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2379   the members in a given workspace.][cargo/3988]
2380 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2381 - [Target directory path is now in the cargo metadata][cargo/4022]
2382 - [Cargo no longer checks out a local working directory for the
2383   crates.io index][cargo/4026] This should provide smaller file size for the
2384   registry, and improve cloning times, especially on Windows machines.
2385 - [Added an `--exclude` option for excluding certain packages when using the
2386   `--all` option][cargo/4031]
2387 - [Cargo will now automatically retry when receiving a 5xx error
2388   from crates.io][cargo/4032]
2389 - [The `--features` option now accepts multiple comma or space
2390   delimited values.][cargo/4084]
2391 - [Added support for custom target specific runners][cargo/3954]
2392
2393 Misc
2394 ----
2395
2396 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2397   Windows Debugger.
2398 - [Rust will now release XZ compressed packages][rust-installer/57]
2399 - [rustup will now prefer to download rust packages with
2400   XZ compression][rustup/1100] over GZip packages.
2401 - [Added the ability to escape `#` in rust documentation][41785] By adding
2402   additional `#`'s ie. `##` is now `#`
2403
2404 Compatibility Notes
2405 -------------------
2406
2407 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2408 - [`-Z` flags are now no longer allowed to be used on the stable
2409   compiler.][41751] This has been a warning for a year previous to this.
2410 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
2411   longer works][42844]. Users should migrate to the built-in `check`
2412   command, which has been available since 1.16.
2413 - [Ending a float literal with `._` is now a hard error.
2414   Example: `42._` .][41946]
2415 - [Any use of a private `extern crate` outside of its module is now a
2416   hard error.][36886] This was previously a warning.
2417 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
2418   relative while the `::` prefix makes a path absolute, but was ignored and the
2419   path was relative regardless.
2420 - [Floating point constants in match patterns is now a hard error][36890]
2421   This was previously a warning.
2422 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
2423   match patterns is now a hard error][36891] This was previously a warning.
2424 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
2425   a warning.
2426 - [From the pound escape, lines consisting of multiple `#`s are
2427   now visible][41785]
2428 - [It is an error to re-export private enum variants][42460]. This is
2429   known to break a number of crates that depend on an older version of
2430   mustache.
2431 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
2432   to use it to find the linker, and the build will fail where it did
2433   not previously][42607]
2434
2435 [36886]: https://github.com/rust-lang/rust/issues/36886
2436 [36888]: https://github.com/rust-lang/rust/issues/36888
2437 [36890]: https://github.com/rust-lang/rust/issues/36890
2438 [36891]: https://github.com/rust-lang/rust/issues/36891
2439 [36892]: https://github.com/rust-lang/rust/issues/36892
2440 [37406]: https://github.com/rust-lang/rust/issues/37406
2441 [39983]: https://github.com/rust-lang/rust/pull/39983
2442 [41145]: https://github.com/rust-lang/rust/pull/41145
2443 [41192]: https://github.com/rust-lang/rust/pull/41192
2444 [41258]: https://github.com/rust-lang/rust/pull/41258
2445 [41370]: https://github.com/rust-lang/rust/pull/41370
2446 [41449]: https://github.com/rust-lang/rust/pull/41449
2447 [41530]: https://github.com/rust-lang/rust/pull/41530
2448 [41624]: https://github.com/rust-lang/rust/pull/41624
2449 [41656]: https://github.com/rust-lang/rust/pull/41656
2450 [41659]: https://github.com/rust-lang/rust/pull/41659
2451 [41676]: https://github.com/rust-lang/rust/pull/41676
2452 [41751]: https://github.com/rust-lang/rust/pull/41751
2453 [41764]: https://github.com/rust-lang/rust/pull/41764
2454 [41785]: https://github.com/rust-lang/rust/pull/41785
2455 [41873]: https://github.com/rust-lang/rust/pull/41873
2456 [41907]: https://github.com/rust-lang/rust/pull/41907
2457 [41946]: https://github.com/rust-lang/rust/pull/41946
2458 [42016]: https://github.com/rust-lang/rust/pull/42016
2459 [42037]: https://github.com/rust-lang/rust/pull/42037
2460 [42068]: https://github.com/rust-lang/rust/pull/42068
2461 [42150]: https://github.com/rust-lang/rust/pull/42150
2462 [42162]: https://github.com/rust-lang/rust/pull/42162
2463 [42225]: https://github.com/rust-lang/rust/pull/42225
2464 [42264]: https://github.com/rust-lang/rust/pull/42264
2465 [42302]: https://github.com/rust-lang/rust/pull/42302
2466 [42460]: https://github.com/rust-lang/rust/issues/42460
2467 [42607]: https://github.com/rust-lang/rust/issues/42607
2468 [42740]: https://github.com/rust-lang/rust/pull/42740
2469 [42844]: https://github.com/rust-lang/rust/issues/42844
2470 [42948]: https://github.com/rust-lang/rust/pull/42948
2471 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
2472 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
2473 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
2474 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
2475 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
2476 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
2477 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
2478 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
2479 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
2480 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
2481 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
2482 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
2483 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
2484 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
2485 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
2486 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
2487 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
2488 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
2489 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
2490 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
2491 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
2492 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
2493
2494
2495 Version 1.18.0 (2017-06-08)
2496 ===========================
2497
2498 Language
2499 --------
2500
2501 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
2502   make the item visible to just that module tree. Also accepts the keyword
2503   `crate` to make something public to the whole crate but not users of the
2504   library. Example: `pub(crate) mod utils;`. [RFC 1422].
2505 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
2506   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
2507 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
2508   types like `Write + Send`, trailing `+` are now supported in trait objects,
2509   and better error reporting for trait objects starting with `?Sized`.
2510 - [0e+10 is now a valid floating point literal][40589]
2511 - [Now warns if you bind a lifetime parameter to 'static][40734]
2512 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
2513   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
2514   representation in some cases.][40377]
2515
2516 Compiler
2517 --------
2518
2519 - [rustc can now emit mir with `--emit mir`][39891]
2520 - [Improved LLVM IR for trivial functions][40367]
2521 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
2522 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
2523   opportunities found through profiling
2524 - [Improved backtrace formatting when panicking][38165]
2525
2526 Libraries
2527 ---------
2528
2529 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
2530   iterator hasn't been advanced the original `Vec` is reassembled with no actual
2531   iteration or reallocation.
2532 - [Simplified HashMap Bucket interface][40561] provides performance
2533   improvements for iterating and cloning.
2534 - [Specialize Vec::from_elem to use calloc][40409]
2535 - [Fixed Race condition in fs::create_dir_all][39799]
2536 - [No longer caching stdio on Windows][40516]
2537 - [Optimized insertion sort in slice][40807] insertion sort in some cases
2538   2.50%~ faster and in one case now 12.50% faster.
2539 - [Optimized `AtomicBool::fetch_nand`][41143]
2540
2541 Stabilized APIs
2542 ---------------
2543
2544 - [`Child::try_wait`]
2545 - [`HashMap::retain`]
2546 - [`HashSet::retain`]
2547 - [`PeekMut::pop`]
2548 - [`TcpStream::peek`]
2549 - [`UdpSocket::peek`]
2550 - [`UdpSocket::peek_from`]
2551
2552 Cargo
2553 -----
2554
2555 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
2556   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
2557 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
2558 - [Added Android build support][cargo/3885]
2559 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
2560   of a certain type, for example `cargo build --bins` will build all
2561   binaries.
2562 - [Added support for haiku][cargo/3952]
2563
2564 Misc
2565 ----
2566
2567 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
2568 - [Added rust-windbg script for better debugging on Windows][39983]
2569 - [Rust now uses the official cross compiler for NetBSD][40612]
2570 - [rustdoc now accepts `#` at the start of files][40828]
2571 - [Fixed jemalloc support for musl][41168]
2572
2573 Compatibility Notes
2574 -------------------
2575
2576 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
2577   always placed after the sign if it exists and before the digits. With the `#`
2578   flag the zeroes are placed after the prefix and before the digits.
2579 - [Due to the struct field optimisation][40377], using `transmute` on structs
2580   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
2581   always been undefined behavior, but is now more likely to break in practice.
2582 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
2583   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
2584   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
2585 - [Overlapping inherent `impl`s are now a hard error][40728]
2586 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
2587 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
2588   `out.asm` and `out.ll` instead of only one of the filetypes.
2589 - [ calling a function that returns `Self` will no longer work][41805] when
2590   the size of `Self` cannot be statically determined.
2591 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
2592   this has caused a few regressions namely:
2593
2594   - Changed the link order of local static/dynamic libraries (respecting the
2595     order on given rather than having the compiler reorder).
2596   - Changed how MinGW is linked, native code linked to dynamic libraries
2597     may require manually linking to the gcc support library (for the native
2598     code itself)
2599
2600 [38165]: https://github.com/rust-lang/rust/pull/38165
2601 [39799]: https://github.com/rust-lang/rust/pull/39799
2602 [39891]: https://github.com/rust-lang/rust/pull/39891
2603 [39983]: https://github.com/rust-lang/rust/pull/39983
2604 [40043]: https://github.com/rust-lang/rust/pull/40043
2605 [40241]: https://github.com/rust-lang/rust/pull/40241
2606 [40338]: https://github.com/rust-lang/rust/pull/40338
2607 [40367]: https://github.com/rust-lang/rust/pull/40367
2608 [40377]: https://github.com/rust-lang/rust/pull/40377
2609 [40409]: https://github.com/rust-lang/rust/pull/40409
2610 [40516]: https://github.com/rust-lang/rust/pull/40516
2611 [40556]: https://github.com/rust-lang/rust/pull/40556
2612 [40561]: https://github.com/rust-lang/rust/pull/40561
2613 [40589]: https://github.com/rust-lang/rust/pull/40589
2614 [40612]: https://github.com/rust-lang/rust/pull/40612
2615 [40723]: https://github.com/rust-lang/rust/pull/40723
2616 [40728]: https://github.com/rust-lang/rust/pull/40728
2617 [40731]: https://github.com/rust-lang/rust/pull/40731
2618 [40734]: https://github.com/rust-lang/rust/pull/40734
2619 [40805]: https://github.com/rust-lang/rust/pull/40805
2620 [40807]: https://github.com/rust-lang/rust/pull/40807
2621 [40828]: https://github.com/rust-lang/rust/pull/40828
2622 [40870]: https://github.com/rust-lang/rust/pull/40870
2623 [41085]: https://github.com/rust-lang/rust/pull/41085
2624 [41143]: https://github.com/rust-lang/rust/pull/41143
2625 [41168]: https://github.com/rust-lang/rust/pull/41168
2626 [41270]: https://github.com/rust-lang/rust/issues/41270
2627 [41469]: https://github.com/rust-lang/rust/pull/41469
2628 [41805]: https://github.com/rust-lang/rust/issues/41805
2629 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
2630 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
2631 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
2632 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
2633 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
2634 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
2635 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
2636 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
2637 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
2638 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
2639 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
2640 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
2641 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
2642 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
2643
2644
2645 Version 1.17.0 (2017-04-27)
2646 ===========================
2647
2648 Language
2649 --------
2650
2651 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
2652 * [Fields of structs may be initialized without duplicating the field/variable
2653   names][39761]. [RFC 1682]
2654 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
2655 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2656   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
2657   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
2658   `'b`. Soundness fix.
2659 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
2660 * [Static variables may contain references to other statics][40027]
2661
2662 Compiler
2663 --------
2664
2665 * [Exit quickly on only `--emit dep-info`][40336]
2666 * [Make `-C relocation-model` more correctly determine whether the linker
2667   creates a position-independent executable][40245]
2668 * [Add `-C overflow-checks` to directly control whether integer overflow
2669   panics][40037]
2670 * [The rustc type checker now checks items on demand instead of in a single
2671   in-order pass][40008]. This is mostly an internal refactoring in support of
2672   future work, including incremental type checking, but also resolves [RFC
2673   1647], allowing `Self` to appear in `impl` `where` clauses.
2674 * [Optimize vtable loads][39995]
2675 * [Turn off vectorization for Emscripten targets][39990]
2676 * [Provide suggestions for unknown macros imported with `use`][39953]
2677 * [Fix ICEs in path resolution][39939]
2678 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
2679 * [Add clearer error message using `&str + &str`][39116]
2680
2681 Stabilized APIs
2682 ---------------
2683
2684 * [`Arc::into_raw`]
2685 * [`Arc::from_raw`]
2686 * [`Arc::ptr_eq`]
2687 * [`Rc::into_raw`]
2688 * [`Rc::from_raw`]
2689 * [`Rc::ptr_eq`]
2690 * [`Ordering::then`]
2691 * [`Ordering::then_with`]
2692 * [`BTreeMap::range`]
2693 * [`BTreeMap::range_mut`]
2694 * [`collections::Bound`]
2695 * [`process::abort`]
2696 * [`ptr::read_unaligned`]
2697 * [`ptr::write_unaligned`]
2698 * [`Result::expect_err`]
2699 * [`Cell::swap`]
2700 * [`Cell::replace`]
2701 * [`Cell::into_inner`]
2702 * [`Cell::take`]
2703
2704 Libraries
2705 ---------
2706
2707 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
2708 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
2709 * [`String` implements `FromIterator<&char>`][40028]
2710 * `Box` [implements][40009] a number of new conversions:
2711   `From<Box<str>> for String`,
2712   `From<Box<[T]>> for Vec<T>`,
2713   `From<Box<CStr>> for CString`,
2714   `From<Box<OsStr>> for OsString`,
2715   `From<Box<Path>> for PathBuf`,
2716   `Into<Box<str>> for String`,
2717   `Into<Box<[T]>> for Vec<T>`,
2718   `Into<Box<CStr>> for CString`,
2719   `Into<Box<OsStr>> for OsString`,
2720   `Into<Box<Path>> for PathBuf`,
2721   `Default for Box<str>`,
2722   `Default for Box<CStr>`,
2723   `Default for Box<OsStr>`,
2724   `From<&CStr> for Box<CStr>`,
2725   `From<&OsStr> for Box<OsStr>`,
2726   `From<&Path> for Box<Path>`
2727 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2728 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2729 * [Slightly optimize `slice::sort`][39538]
2730 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2731 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2732   `Box<str>` implements `From<&str>`][39438]
2733 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2734   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2735 * [`format!` estimates the needed capacity before writing a string][39356]
2736 * [Support unprivileged symlink creation in Windows][38921]
2737 * [`PathBuf` implements `Default`][38764]
2738 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2739 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2740   and poor hash functions.
2741
2742 Cargo
2743 -----
2744
2745 * [Add `cargo check --all`][cargo/3731]
2746 * [Add an option to ignore SSL revocation checking][cargo/3699]
2747 * [Add `cargo run --package`][cargo/3691]
2748 * [Add `required_features`][cargo/3667]
2749 * [Assume `build.rs` is a build script][cargo/3664]
2750 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2751
2752 Misc
2753 ----
2754
2755 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2756   `rustbook`][39633]
2757 * [The "Unstable Book" documents nightly-only features][ubook]
2758 * [Improve the style of the sidebar in rustdoc output][40265]
2759 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2760 * [Fix MSP430 breakage due to `i128`][40257]
2761 * [Preliminary Solaris/SPARCv9 support][39903]
2762 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2763   run without installing the MSVC runtime.
2764 * [`rustdoc --test` includes file names in test names][39788]
2765 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2766   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2767 * [Initial support for `aarch64-unknown-freebsd`][39491]
2768 * [Initial support for `i686-unknown-netbsd`][39426]
2769 * [This release no longer includes the old makefile build system][39431]. Rust
2770   is built with a custom build system, written in Rust, and with Cargo.
2771 * [Add Debug implementations for libcollection structs][39002]
2772 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2773 * [`--test-threads=0` produces an error][38945]
2774 * [`rustup` installs documentation by default][40526]
2775 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2776   WinDbg and Visual Studio to improve the debugging experience.
2777
2778 Compatibility Notes
2779 -------------------
2780
2781 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2782   workaround, either use MSVC 2015 or run vcvars.bat.
2783 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2784   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2785   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2786   fix.
2787 * [`format!` and `Display::to_string` panic if an underlying formatting
2788   implementation returns an error][40117]. Previously the error was silently
2789   ignored. It is incorrect for `write_fmt` to return an error when writing
2790   to a string.
2791 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2792   crates were marked stable and could be accessed from the stable toolchain.
2793 * [Rust git source no longer includes vendored crates][39728]. Those that need
2794   to build with vendored crates should build from release tarballs.
2795 * [Fix inert attributes from `proc_macro_derives`][39572]
2796 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2797   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2798   build system.
2799 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2800   existing code generally ignores the type of dead-code unless a type-hint is
2801   provided; this can cause surprising inference interactions particularly around
2802   defaulting. The new code uniformly ignores the result type of dead-code.
2803 * [Tuple-struct constructors with private fields are no longer visible][38932]
2804 * [Lifetime parameters that do not appear in the arguments are now considered
2805   early-bound][38897], resolving a soundness bug (#[32330]). The
2806   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2807   April of 2016.
2808 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2809 * [Make transmuting from fn item types to pointer-sized types a hard
2810   error][34198]
2811
2812 [27787]: https://github.com/rust-lang/rust/issues/27787
2813 [32330]: https://github.com/rust-lang/rust/issues/32330
2814 [34198]: https://github.com/rust-lang/rust/pull/34198
2815 [38161]: https://github.com/rust-lang/rust/pull/38161
2816 [38368]: https://github.com/rust-lang/rust/pull/38368
2817 [38584]: https://github.com/rust-lang/rust/issues/38584
2818 [38661]: https://github.com/rust-lang/rust/pull/38661
2819 [38764]: https://github.com/rust-lang/rust/pull/38764
2820 [38864]: https://github.com/rust-lang/rust/issues/38864
2821 [38897]: https://github.com/rust-lang/rust/pull/38897
2822 [38921]: https://github.com/rust-lang/rust/pull/38921
2823 [38932]: https://github.com/rust-lang/rust/pull/38932
2824 [38945]: https://github.com/rust-lang/rust/pull/38945
2825 [38981]: https://github.com/rust-lang/rust/pull/38981
2826 [39002]: https://github.com/rust-lang/rust/pull/39002
2827 [39116]: https://github.com/rust-lang/rust/pull/39116
2828 [39193]: https://github.com/rust-lang/rust/pull/39193
2829 [39265]: https://github.com/rust-lang/rust/pull/39265
2830 [39356]: https://github.com/rust-lang/rust/pull/39356
2831 [39372]: https://github.com/rust-lang/rust/pull/39372
2832 [39426]: https://github.com/rust-lang/rust/pull/39426
2833 [39431]: https://github.com/rust-lang/rust/pull/39431
2834 [39438]: https://github.com/rust-lang/rust/pull/39438
2835 [39440]: https://github.com/rust-lang/rust/pull/39440
2836 [39485]: https://github.com/rust-lang/rust/pull/39485
2837 [39491]: https://github.com/rust-lang/rust/pull/39491
2838 [39518]: https://github.com/rust-lang/rust/pull/39518
2839 [39538]: https://github.com/rust-lang/rust/pull/39538
2840 [39572]: https://github.com/rust-lang/rust/pull/39572
2841 [39633]: https://github.com/rust-lang/rust/pull/39633
2842 [39642]: https://github.com/rust-lang/rust/pull/39642
2843 [39728]: https://github.com/rust-lang/rust/pull/39728
2844 [39761]: https://github.com/rust-lang/rust/pull/39761
2845 [39788]: https://github.com/rust-lang/rust/pull/39788
2846 [39793]: https://github.com/rust-lang/rust/pull/39793
2847 [39837]: https://github.com/rust-lang/rust/pull/39837
2848 [39843]: https://github.com/rust-lang/rust/pull/39843
2849 [39851]: https://github.com/rust-lang/rust/pull/39851
2850 [39903]: https://github.com/rust-lang/rust/pull/39903
2851 [39939]: https://github.com/rust-lang/rust/pull/39939
2852 [39953]: https://github.com/rust-lang/rust/pull/39953
2853 [39960]: https://github.com/rust-lang/rust/pull/39960
2854 [39990]: https://github.com/rust-lang/rust/pull/39990
2855 [39995]: https://github.com/rust-lang/rust/pull/39995
2856 [40008]: https://github.com/rust-lang/rust/pull/40008
2857 [40009]: https://github.com/rust-lang/rust/pull/40009
2858 [40027]: https://github.com/rust-lang/rust/pull/40027
2859 [40028]: https://github.com/rust-lang/rust/pull/40028
2860 [40037]: https://github.com/rust-lang/rust/pull/40037
2861 [40117]: https://github.com/rust-lang/rust/pull/40117
2862 [40166]: https://github.com/rust-lang/rust/pull/40166
2863 [40245]: https://github.com/rust-lang/rust/pull/40245
2864 [40257]: https://github.com/rust-lang/rust/pull/40257
2865 [40261]: https://github.com/rust-lang/rust/pull/40261
2866 [40265]: https://github.com/rust-lang/rust/pull/40265
2867 [40319]: https://github.com/rust-lang/rust/pull/40319
2868 [40336]: https://github.com/rust-lang/rust/pull/40336
2869 [40526]: https://github.com/rust-lang/rust/pull/40526
2870 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2871 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2872 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2873 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2874 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2875 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2876 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2877 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2878 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2879 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2880 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2881 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2882 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2883 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2884 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2885 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2886 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2887 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2888 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2889 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2890 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2891 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2892 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2893 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2894 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2895 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2896 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2897 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2898 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2899 [mdbook]: https://crates.io/crates/mdbook
2900 [ubook]: https://doc.rust-lang.org/unstable-book/
2901
2902
2903 Version 1.16.0 (2017-03-16)
2904 ===========================
2905
2906 Language
2907 --------
2908
2909 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2910 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2911   match patterns][38069]
2912 * [Clean up semantics of `self` in an import list][38313]
2913 * [`Self` may appear in `impl` headers][38920]
2914 * [`Self` may appear in struct expressions][39282]
2915
2916 Compiler
2917 --------
2918
2919 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2920   a `.rmeta` file containing only crate metadata][38571]. This can be
2921   used by tools like the Rust Language Service to perform
2922   metadata-only builds.
2923 * [Levenshtein based typo suggestions now work in most places, while
2924   previously they worked only for fields and sometimes for local
2925   variables][38927]. Together with the overhaul of "no
2926   resolution"/"unexpected resolution" errors (#[38154]) they result in
2927   large and systematic improvement in resolution diagnostics.
2928 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2929   `U`][38670]
2930 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2931 * [`rustc` no longer attempts to provide "consider using an explicit
2932   lifetime" suggestions][37057]. They were inaccurate.
2933
2934 Stabilized APIs
2935 ---------------
2936
2937 * [`VecDeque::truncate`]
2938 * [`VecDeque::resize`]
2939 * [`String::insert_str`]
2940 * [`Duration::checked_add`]
2941 * [`Duration::checked_sub`]
2942 * [`Duration::checked_div`]
2943 * [`Duration::checked_mul`]
2944 * [`str::replacen`]
2945 * [`str::repeat`]
2946 * [`SocketAddr::is_ipv4`]
2947 * [`SocketAddr::is_ipv6`]
2948 * [`IpAddr::is_ipv4`]
2949 * [`IpAddr::is_ipv6`]
2950 * [`Vec::dedup_by`]
2951 * [`Vec::dedup_by_key`]
2952 * [`Result::unwrap_or_default`]
2953 * [`<*const T>::wrapping_offset`]
2954 * [`<*mut T>::wrapping_offset`]
2955 * `CommandExt::creation_flags`
2956 * [`File::set_permissions`]
2957 * [`String::split_off`]
2958
2959 Libraries
2960 ---------
2961
2962 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2963   their argument by `Borrow` parameter][37761]
2964 * [All public types in std implement `Debug`][38006]
2965 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2966 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2967 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2968   Windows][38274]
2969 * [std: Fix partial writes in `LineWriter`][38062]
2970 * [std: Clamp max read/write sizes on Unix][38062]
2971 * [Use more specific panic message for `&str` slicing errors][38066]
2972 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2973   functionality cannot be achieved in std currently.
2974 * [`writeln!`, like `println!`, now accepts a form with no string
2975   or formatting arguments, to just print a newline][38469]
2976 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2977 * [Reduce the size of static data in `std_unicode::tables`][38781]
2978 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2979   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2980   `Display`][38909]
2981 * [`Duration` implements `Sum`][38712]
2982 * [`String` implements `ToSocketAddrs`][39048]
2983
2984 Cargo
2985 -----
2986
2987 * [The `cargo check` command does a type check of a project without
2988   building it][cargo/3296]
2989 * [crates.io will display CI badges from Travis and AppVeyor, if
2990   specified in Cargo.toml][cargo/3546]
2991 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2992 * [Compilation profiles accept integer values for `debug`, in addition
2993   to `true` and `false`. These are passed to `rustc` as the value to
2994   `-C debuginfo`][cargo/3534]
2995 * [Implement `cargo --version --verbose`][cargo/3604]
2996 * [All builds now output 'dep-info' build dependencies compatible with
2997   make and ninja][cargo/3557]
2998 * [Build all workspace members with `build --all`][cargo/3511]
2999 * [Document all workspace members with `doc --all`][cargo/3515]
3000 * [Path deps outside workspace are not members][cargo/3443]
3001
3002 Misc
3003 ----
3004
3005 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3006   the path to the Rust implementation][38589]
3007 * [The `armv7-linux-androideabi` target no longer enables NEON
3008   extensions, per Google's ABI guide][38413]
3009 * [The stock standard library can be compiled for Redox OS][38401]
3010 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3011   available.
3012 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3013   builds available.
3014 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3015
3016 Compatibility Notes
3017 -------------------
3018
3019 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3020   match patterns][38069]
3021 * In this release, references to uninhabited types can not be
3022   pattern-matched. This was accidentally allowed in 1.15.
3023 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3024 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3025   Windows][38274]
3026 * [Clean up semantics of `self` in an import list][38313]
3027 * Reimplemented lifetime elision. This change was almost entirely compatible
3028   with existing code, but it did close a number of small bugs and loopholes,
3029   as well as being more accepting in some other [cases][41105].
3030
3031 [37057]: https://github.com/rust-lang/rust/pull/37057
3032 [37761]: https://github.com/rust-lang/rust/pull/37761
3033 [38006]: https://github.com/rust-lang/rust/pull/38006
3034 [38051]: https://github.com/rust-lang/rust/pull/38051
3035 [38062]: https://github.com/rust-lang/rust/pull/38062
3036 [38062]: https://github.com/rust-lang/rust/pull/38622
3037 [38066]: https://github.com/rust-lang/rust/pull/38066
3038 [38069]: https://github.com/rust-lang/rust/pull/38069
3039 [38131]: https://github.com/rust-lang/rust/pull/38131
3040 [38154]: https://github.com/rust-lang/rust/pull/38154
3041 [38274]: https://github.com/rust-lang/rust/pull/38274
3042 [38304]: https://github.com/rust-lang/rust/pull/38304
3043 [38313]: https://github.com/rust-lang/rust/pull/38313
3044 [38314]: https://github.com/rust-lang/rust/pull/38314
3045 [38327]: https://github.com/rust-lang/rust/pull/38327
3046 [38401]: https://github.com/rust-lang/rust/pull/38401
3047 [38413]: https://github.com/rust-lang/rust/pull/38413
3048 [38469]: https://github.com/rust-lang/rust/pull/38469
3049 [38559]: https://github.com/rust-lang/rust/pull/38559
3050 [38571]: https://github.com/rust-lang/rust/pull/38571
3051 [38580]: https://github.com/rust-lang/rust/pull/38580
3052 [38589]: https://github.com/rust-lang/rust/pull/38589
3053 [38670]: https://github.com/rust-lang/rust/pull/38670
3054 [38712]: https://github.com/rust-lang/rust/pull/38712
3055 [38726]: https://github.com/rust-lang/rust/pull/38726
3056 [38781]: https://github.com/rust-lang/rust/pull/38781
3057 [38798]: https://github.com/rust-lang/rust/pull/38798
3058 [38909]: https://github.com/rust-lang/rust/pull/38909
3059 [38920]: https://github.com/rust-lang/rust/pull/38920
3060 [38927]: https://github.com/rust-lang/rust/pull/38927
3061 [39048]: https://github.com/rust-lang/rust/pull/39048
3062 [39282]: https://github.com/rust-lang/rust/pull/39282
3063 [39379]: https://github.com/rust-lang/rust/pull/39379
3064 [41105]: https://github.com/rust-lang/rust/issues/41105
3065 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3066 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3067 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3068 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3069 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3070 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3071 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3072 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3073 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3074 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3075 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3076 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3077 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3078 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3079 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3080 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3081 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3082 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3083 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3084 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3085 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3086 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3087 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3088 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3089 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3090 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3091 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3092 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3093 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3094 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3095
3096
3097 Version 1.15.1 (2017-02-09)
3098 ===========================
3099
3100 * [Fix IntoIter::as_mut_slice's signature][39466]
3101 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3102
3103 [39466]: https://github.com/rust-lang/rust/pull/39466
3104 [39523]: https://github.com/rust-lang/rust/pull/39523
3105
3106
3107 Version 1.15.0 (2017-02-02)
3108 ===========================
3109
3110 Language
3111 --------
3112
3113 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3114   stable. This allows popular code-generating crates like Serde and Diesel to
3115   work ergonomically. [RFC 1681].
3116 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3117   with curly braces][36868]. Part of [RFC 1506].
3118 * [A number of minor changes to name resolution have been activated][37127].
3119   They add up to more consistent semantics, allowing for future evolution of
3120   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3121   details of what is different. The breaking changes here have been transitioned
3122   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3123 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3124   bounds][38279]
3125 * [`?Sized` can be used in `where` clauses][37791]
3126 * [There is now a limit on the size of monomorphized types and it can be
3127   modified with the `#![type_size_limit]` crate attribute, similarly to
3128   the `#![recursion_limit]` attribute][37789]
3129
3130 Compiler
3131 --------
3132
3133 * [On Windows, the compiler will apply dllimport attributes when linking to
3134   extern functions][37973]. Additional attributes and flags can control which
3135   library kind is linked and its name. [RFC 1717].
3136 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3137 * [The `--test` flag works with procedural macro crates][38107]
3138 * [Fix `extern "aapcs" fn` ABI][37814]
3139 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3140 * [The `format!` expander recognizes incorrect `printf` and shell-style
3141   formatting directives and suggests the correct format][37613].
3142 * [Only report one error for all unused imports in an import list][37456]
3143
3144 Compiler Performance
3145 --------------------
3146
3147 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3148 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3149 * [Don't clone in `UnificationTable::probe`][37848]
3150 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3151 * [Use small vectors in type walker][37760]
3152 * [Macro expansion performance was improved][37701]
3153 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3154 * [Replace FNV with a faster hash function][37229]
3155
3156 Stabilized APIs
3157 ---------------
3158
3159 * [`std::iter::Iterator::min_by`]
3160 * [`std::iter::Iterator::max_by`]
3161 * [`std::os::*::fs::FileExt`]
3162 * [`std::sync::atomic::Atomic*::get_mut`]
3163 * [`std::sync::atomic::Atomic*::into_inner`]
3164 * [`std::vec::IntoIter::as_slice`]
3165 * [`std::vec::IntoIter::as_mut_slice`]
3166 * [`std::sync::mpsc::Receiver::try_iter`]
3167 * [`std::os::unix::process::CommandExt::before_exec`]
3168 * [`std::rc::Rc::strong_count`]
3169 * [`std::rc::Rc::weak_count`]
3170 * [`std::sync::Arc::strong_count`]
3171 * [`std::sync::Arc::weak_count`]
3172 * [`std::char::encode_utf8`]
3173 * [`std::char::encode_utf16`]
3174 * [`std::cell::Ref::clone`]
3175 * [`std::io::Take::into_inner`]
3176
3177 Libraries
3178 ---------
3179
3180 * [The standard sorting algorithm has been rewritten for dramatic performance
3181   improvements][38192]. It is a hybrid merge sort, drawing influences from
3182   Timsort. Previously it was a naive merge sort.
3183 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3184 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3185   performance.
3186 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3187   and `char_indices().last()`][37882]
3188 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3189 * [Chinese characters display correctly in `fmt::Debug`][37855]
3190 * [Derive `Default` for `Duration`][37699]
3191 * [Support creation of anonymous pipes on WinXP/2k][37677]
3192 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3193 * [Don't pass overlapped handles to processes][38835]
3194
3195 Cargo
3196 -----
3197
3198 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3199   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3200   should instead check the variable at runtime with `std::env`. That the value
3201   was set at build time was a bug, and incorrect when cross-compiling. This
3202   change is known to cause breakage.
3203 * [Add `--all` flag to `cargo test`][cargo/3221]
3204 * [Compile statically against the MSVC CRT][cargo/3363]
3205 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3206 * [Link OpenSSL statically on OSX][cargo/3311]
3207 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3208 * [Test for bad path overrides with summaries][cargo/3336]
3209 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3210 * [Fix retrying crate downloads for network errors][cargo/3348]
3211 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3212 * [Emit more info on --message-format=json][cargo/3319]
3213 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3214 * [Don't ignore errors in workspace manifest][cargo/3409]
3215 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3216
3217 Tooling
3218 -------
3219
3220 * [Test runners (binaries built with `--test`) now support a `--list` argument
3221   that lists the tests it contains][38185]
3222 * [Test runners now support a `--exact` argument that makes the test filter
3223   match exactly, instead of matching only a substring of the test name][38181]
3224 * [rustdoc supports a `--playground-url` flag][37763]
3225 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3226
3227 Misc
3228 ----
3229
3230 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3231   continue to be used in this release by passing `--disable-rustbuild` to the
3232   configure script, but they will be deleted soon. Note that the new build
3233   system uses a different on-disk layout that will likely affect any scripts
3234   building Rust.
3235 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3236   releases.
3237 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3238 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3239   releases.
3240
3241 Compatibility Notes
3242 -------------------
3243
3244 * [A number of minor changes to name resolution have been activated][37127].
3245   They add up to more consistent semantics, allowing for future evolution of
3246   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3247   details of what is different. The breaking changes here have been transitioned
3248   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3249 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3250   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3251   should instead check the variable at runtime with `std::env`. That the value
3252   was set at build time was a bug, and incorrect when cross-compiling. This
3253   change is known to cause breakage.
3254 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3255   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3256   1.10 and is now an error by default. It will become a hard error in the near
3257   future.
3258 * [The semantics relating modules to file system directories are changing in
3259   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3260   lint, which is a warning in this release, and will become a hard error in the
3261   future.
3262 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3263 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3264   the underlying iterator][37834]
3265
3266 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3267 [33685]: https://github.com/rust-lang/rust/issues/33685
3268 [36868]: https://github.com/rust-lang/rust/pull/36868
3269 [37127]: https://github.com/rust-lang/rust/pull/37127
3270 [37229]: https://github.com/rust-lang/rust/pull/37229
3271 [37456]: https://github.com/rust-lang/rust/pull/37456
3272 [37527]: https://github.com/rust-lang/rust/pull/37527
3273 [37602]: https://github.com/rust-lang/rust/pull/37602
3274 [37613]: https://github.com/rust-lang/rust/pull/37613
3275 [37615]: https://github.com/rust-lang/rust/pull/37615
3276 [37636]: https://github.com/rust-lang/rust/pull/37636
3277 [37627]: https://github.com/rust-lang/rust/pull/37627
3278 [37642]: https://github.com/rust-lang/rust/pull/37642
3279 [37677]: https://github.com/rust-lang/rust/pull/37677
3280 [37699]: https://github.com/rust-lang/rust/pull/37699
3281 [37701]: https://github.com/rust-lang/rust/pull/37701
3282 [37705]: https://github.com/rust-lang/rust/pull/37705
3283 [37749]: https://github.com/rust-lang/rust/pull/37749
3284 [37760]: https://github.com/rust-lang/rust/pull/37760
3285 [37763]: https://github.com/rust-lang/rust/pull/37763
3286 [37764]: https://github.com/rust-lang/rust/pull/37764
3287 [37789]: https://github.com/rust-lang/rust/pull/37789
3288 [37791]: https://github.com/rust-lang/rust/pull/37791
3289 [37814]: https://github.com/rust-lang/rust/pull/37814
3290 [37817]: https://github.com/rust-lang/rust/pull/37817
3291 [37834]: https://github.com/rust-lang/rust/pull/37834
3292 [37848]: https://github.com/rust-lang/rust/pull/37848
3293 [37855]: https://github.com/rust-lang/rust/pull/37855
3294 [37882]: https://github.com/rust-lang/rust/pull/37882
3295 [37888]: https://github.com/rust-lang/rust/pull/37888
3296 [37973]: https://github.com/rust-lang/rust/pull/37973
3297 [37979]: https://github.com/rust-lang/rust/pull/37979
3298 [38086]: https://github.com/rust-lang/rust/pull/38086
3299 [38107]: https://github.com/rust-lang/rust/pull/38107
3300 [38117]: https://github.com/rust-lang/rust/pull/38117
3301 [38134]: https://github.com/rust-lang/rust/pull/38134
3302 [38146]: https://github.com/rust-lang/rust/pull/38146
3303 [38181]: https://github.com/rust-lang/rust/pull/38181
3304 [38182]: https://github.com/rust-lang/rust/pull/38182
3305 [38185]: https://github.com/rust-lang/rust/pull/38185
3306 [38192]: https://github.com/rust-lang/rust/pull/38192
3307 [38279]: https://github.com/rust-lang/rust/pull/38279
3308 [38835]: https://github.com/rust-lang/rust/pull/38835
3309 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3310 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3311 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3312 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3313 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3314 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3315 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3316 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3317 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3318 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3319 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3320 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3321 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3322 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3323 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3324 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3325 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3326 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3327 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3328 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3329 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3330 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3331 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3332 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3333 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3334 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3335 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3336 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3337 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3338 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3339 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3340 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3341 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3342 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3343 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3344 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3345 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3346 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3347
3348
3349 Version 1.14.0 (2016-12-22)
3350 ===========================
3351
3352 Language
3353 --------
3354
3355 * [`..` matches multiple tuple fields in enum variants, structs
3356   and tuples][36843]. [RFC 1492].
3357 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3358 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3359 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3360   dereferencing][36822]
3361
3362 Compiler
3363 --------
3364
3365 * [Mark enums with non-zero discriminant as non-zero][37224]
3366 * [Lower-case `static mut` names are linted like other
3367   statics and consts][37162]
3368 * [Fix ICE on some macros in const integer positions
3369    (e.g. `[u8; m!()]`)][36819]
3370 * [Improve error message and snippet for "did you mean `x`"][36798]
3371 * [Add a panic-strategy field to the target specification][36794]
3372 * [Include LLVM version in `--version --verbose`][37200]
3373
3374 Compile-time Optimizations
3375 --------------------------
3376
3377 * [Improve macro expansion performance][37569]
3378 * [Shrink `Expr_::ExprInlineAsm`][37445]
3379 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3380 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3381 * [Avoid more allocations when compiling html5ever][37373]
3382 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3383 * [Avoid some allocations in the macro parser][37318]
3384 * [Use a faster deflate setting][37298]
3385 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3386   during interning of slices][37270]
3387 * [Optimize `write_metadata`][37267]
3388 * [Don't process obligation forest cycles when stalled][37231]
3389 * [Avoid many `CrateConfig` clones][37161]
3390 * [Optimize `Substs::super_fold_with`][37108]
3391 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3392 * [Speed up `plug_leaks`][36917]
3393
3394 Libraries
3395 ---------
3396
3397 * [`println!()`, with no arguments, prints newline][36825].
3398   Previously, an empty string was required to achieve the same.
3399 * [`Wrapping` impls standard binary and unary operators, as well as
3400    the `Sum` and `Product` iterators][37356]
3401 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3402   Vec<T>`][37326]
3403 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3404   `VecDeque` iterators][37315]
3405 * [Improve `SipHasher` performance on small values][37312]
3406 * [Add Iterator trait TrustedLen to enable better FromIterator /
3407   Extend][37306]
3408 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3409 * [`ReadDir` implements `Debug`][37221]
3410 * [Implement `RefUnwindSafe` for atomic types][37178]
3411 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
3412 * [Avoid allocations in `Decoder::read_str`][37064]
3413 * [`io::Error` implements `From<io::ErrorKind>`][37037]
3414 * [Impl `Debug` for raw pointers to unsized data][36880]
3415 * [Don't reuse `HashMap` random seeds][37470]
3416 * [The internal memory layout of `HashMap` is more cache-friendly, for
3417   significant improvements in some operations][36692]
3418 * [`HashMap` uses less memory on 32-bit architectures][36595]
3419 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
3420
3421 Cargo
3422 -----
3423
3424 * [Expose rustc cfg values to build scripts][cargo/3243]
3425 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
3426 * [Fix passing --features when testing multiple packages][cargo/3280]
3427 * [Use a single profile set per workspace][cargo/3249]
3428 * [Load `replace` sections from lock files][cargo/3220]
3429 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
3430
3431 Tooling
3432 -------
3433
3434 * [rustup is the recommended Rust installation method][1.14rustup]
3435 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
3436   S390x. These are [tier 2] platforms and may have major defects. Follow the
3437   instructions on the website to install, or add the targets to an existing
3438   installation with `rustup target add`. The new target triples are:
3439   - `mips-unknown-linux-gnu`
3440   - `mipsel-unknown-linux-gnu`
3441   - `mips64-unknown-linux-gnuabi64`
3442   - `mips64el-unknown-linux-gnuabi64 `
3443   - `powerpc-unknown-linux-gnu`
3444   - `powerpc64-unknown-linux-gnu`
3445   - `powerpc64le-unknown-linux-gnu`
3446   - `s390x-unknown-linux-gnu `
3447 * This release includes target (std) builds for ARM Linux running MUSL
3448   libc. These are [tier 2] platforms and may have major defects. Add the
3449   following triples to an existing rustup installation with `rustup target add`:
3450   - `arm-unknown-linux-musleabi`
3451   - `arm-unknown-linux-musleabihf`
3452   - `armv7-unknown-linux-musleabihf`
3453 * This release includes [experimental support for WebAssembly][1.14wasm], via
3454   the `wasm32-unknown-emscripten` target. This target is known to have major
3455   defects. Please test, report, and fix.
3456 * rustup no longer installs documentation by default. Run `rustup
3457   component add rust-docs` to install.
3458 * [Fix line stepping in debugger][37310]
3459 * [Enable line number debuginfo in releases][37280]
3460
3461 Misc
3462 ----
3463
3464 * [Disable jemalloc on aarch64/powerpc/mips][37392]
3465 * [Add support for Fuchsia OS][37313]
3466 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
3467
3468 Compatibility Notes
3469 -------------------
3470
3471 * [A number of forward-compatibility lints used by the compiler
3472   to gradually introduce language changes have been converted
3473   to deny by default][36894]:
3474   - ["use of inaccessible extern crate erroneously allowed"][36886]
3475   - ["type parameter default erroneously allowed in invalid location"][36887]
3476   - ["detects super or self keywords at the beginning of global path"][36888]
3477   - ["two overlapping inherent impls define an item with the same name
3478     were erroneously allowed"][36889]
3479   - ["floating-point constants cannot be used in patterns"][36890]
3480   - ["constants of struct or enum type can only be used in a pattern if
3481      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
3482   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
3483 * [Prohibit patterns in trait methods without bodies][37378]
3484 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
3485 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
3486 * [The `$crate` macro variable is accepted in fewer locations][37213]
3487 * [Impls specifying extra region requirements beyond the trait
3488   they implement are rejected][37167]
3489 * [Enums may not be unsized][37111]. Unsized enums are intended to
3490   work but never have. For now they are forbidden.
3491 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
3492
3493 [tier 2]: https://forge.rust-lang.org/platform-support.html
3494 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
3495 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
3496 [36430]: https://github.com/rust-lang/rust/pull/36430
3497 [36595]: https://github.com/rust-lang/rust/pull/36595
3498 [36595]: https://github.com/rust-lang/rust/pull/36595
3499 [36692]: https://github.com/rust-lang/rust/pull/36692
3500 [36767]: https://github.com/rust-lang/rust/pull/36767
3501 [36794]: https://github.com/rust-lang/rust/pull/36794
3502 [36798]: https://github.com/rust-lang/rust/pull/36798
3503 [36819]: https://github.com/rust-lang/rust/pull/36819
3504 [36822]: https://github.com/rust-lang/rust/pull/36822
3505 [36825]: https://github.com/rust-lang/rust/pull/36825
3506 [36843]: https://github.com/rust-lang/rust/pull/36843
3507 [36880]: https://github.com/rust-lang/rust/pull/36880
3508 [36886]: https://github.com/rust-lang/rust/issues/36886
3509 [36887]: https://github.com/rust-lang/rust/issues/36887
3510 [36888]: https://github.com/rust-lang/rust/issues/36888
3511 [36889]: https://github.com/rust-lang/rust/issues/36889
3512 [36890]: https://github.com/rust-lang/rust/issues/36890
3513 [36891]: https://github.com/rust-lang/rust/issues/36891
3514 [36892]: https://github.com/rust-lang/rust/issues/36892
3515 [36894]: https://github.com/rust-lang/rust/pull/36894
3516 [36917]: https://github.com/rust-lang/rust/pull/36917
3517 [36993]: https://github.com/rust-lang/rust/pull/36993
3518 [37037]: https://github.com/rust-lang/rust/pull/37037
3519 [37064]: https://github.com/rust-lang/rust/pull/37064
3520 [37094]: https://github.com/rust-lang/rust/pull/37094
3521 [37108]: https://github.com/rust-lang/rust/pull/37108
3522 [37111]: https://github.com/rust-lang/rust/pull/37111
3523 [37161]: https://github.com/rust-lang/rust/pull/37161
3524 [37162]: https://github.com/rust-lang/rust/pull/37162
3525 [37167]: https://github.com/rust-lang/rust/pull/37167
3526 [37178]: https://github.com/rust-lang/rust/pull/37178
3527 [37200]: https://github.com/rust-lang/rust/pull/37200
3528 [37213]: https://github.com/rust-lang/rust/pull/37213
3529 [37221]: https://github.com/rust-lang/rust/pull/37221
3530 [37224]: https://github.com/rust-lang/rust/pull/37224
3531 [37230]: https://github.com/rust-lang/rust/pull/37230
3532 [37231]: https://github.com/rust-lang/rust/pull/37231
3533 [37247]: https://github.com/rust-lang/rust/pull/37247
3534 [37267]: https://github.com/rust-lang/rust/pull/37267
3535 [37270]: https://github.com/rust-lang/rust/pull/37270
3536 [37273]: https://github.com/rust-lang/rust/pull/37273
3537 [37280]: https://github.com/rust-lang/rust/pull/37280
3538 [37298]: https://github.com/rust-lang/rust/pull/37298
3539 [37306]: https://github.com/rust-lang/rust/pull/37306
3540 [37310]: https://github.com/rust-lang/rust/pull/37310
3541 [37312]: https://github.com/rust-lang/rust/pull/37312
3542 [37313]: https://github.com/rust-lang/rust/pull/37313
3543 [37315]: https://github.com/rust-lang/rust/pull/37315
3544 [37318]: https://github.com/rust-lang/rust/pull/37318
3545 [37322]: https://github.com/rust-lang/rust/pull/37322
3546 [37326]: https://github.com/rust-lang/rust/pull/37326
3547 [37351]: https://github.com/rust-lang/rust/pull/37351
3548 [37356]: https://github.com/rust-lang/rust/pull/37356
3549 [37367]: https://github.com/rust-lang/rust/pull/37367
3550 [37373]: https://github.com/rust-lang/rust/pull/37373
3551 [37378]: https://github.com/rust-lang/rust/pull/37378
3552 [37389]: https://github.com/rust-lang/rust/pull/37389
3553 [37392]: https://github.com/rust-lang/rust/pull/37392
3554 [37427]: https://github.com/rust-lang/rust/pull/37427
3555 [37439]: https://github.com/rust-lang/rust/pull/37439
3556 [37445]: https://github.com/rust-lang/rust/pull/37445
3557 [37470]: https://github.com/rust-lang/rust/pull/37470
3558 [37569]: https://github.com/rust-lang/rust/pull/37569
3559 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3560 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
3561 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
3562 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
3563 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
3564 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
3565 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
3566
3567
3568 Version 1.13.0 (2016-11-10)
3569 ===========================
3570
3571 Language
3572 --------
3573
3574 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
3575   errors, like the `try!` macro, described in [RFC 0243].
3576 * [Stabilize macros in type position][36014]. Described in [RFC 873].
3577 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
3578 * [Fix `#[derive]` for empty tuple structs/variants][35728]
3579 * [Fix lifetime rules for 'if' conditions][36029]
3580 * [Avoid loading and parsing unconfigured non-inline modules][36482]
3581
3582 Compiler
3583 --------
3584
3585 * [Add the `-C link-arg` argument][36574]
3586 * [Remove the old AST-based backend from rustc_trans][35764]
3587 * [Don't enable NEON by default on armv7 Linux][35814]
3588 * [Fix debug line number info for macro expansions][35238]
3589 * [Do not emit "class method" debuginfo for types that are not
3590   DICompositeType][36008]
3591 * [Warn about multiple conflicting #[repr] hints][34623]
3592 * [When sizing DST, don't double-count nested struct prefixes][36351]
3593 * [Default RUST_MIN_STACK to 16MiB for now][36505]
3594 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
3595 * [Reject macros with empty repetitions to avoid infinite loop][36721]
3596 * [Expand macros without recursing to avoid stack overflows][36214]
3597
3598 Diagnostics
3599 -----------
3600
3601 * [Replace macro backtraces with labeled local uses][35702]
3602 * [Improve error message for misplaced doc comments][33922]
3603 * [Buffer unix and lock windows to prevent message interleaving][35975]
3604 * [Update lifetime errors to specifically note temporaries][36171]
3605 * [Special case a few colors for Windows][36178]
3606 * [Suggest `use self` when such an import resolves][36289]
3607 * [Be more specific when type parameter shadows primitive type][36338]
3608 * Many minor improvements
3609
3610 Compile-time Optimizations
3611 --------------------------
3612
3613 * [Compute and cache HIR hashes at beginning][35854]
3614 * [Don't hash types in loan paths][36004]
3615 * [Cache projections in trans][35761]
3616 * [Optimize the parser's last token handling][36527]
3617 * [Only instantiate #[inline] functions in codegen units referencing
3618   them][36524]. This leads to big improvements in cases where crates export
3619   define many inline functions without using them directly.
3620 * [Lazily allocate TypedArena's first chunk][36592]
3621 * [Don't allocate during default HashSet creation][36734]
3622
3623 Stabilized APIs
3624 ---------------
3625
3626 * [`checked_abs`]
3627 * [`wrapping_abs`]
3628 * [`overflowing_abs`]
3629 * [`RefCell::try_borrow`]
3630 * [`RefCell::try_borrow_mut`]
3631
3632 Libraries
3633 ---------
3634
3635 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
3636 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
3637   covariant][35354]
3638 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
3639 * [Implement `Debug` for `std::vec::IntoIter`][35707]
3640 * [`CString`: avoid excessive growth just to 0-terminate][35871]
3641 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
3642 * [Use arc4rand on FreeBSD][35884]
3643 * [memrchr: Correct aligned offset computation][35969]
3644 * [Improve Demangling of Rust Symbols][36059]
3645 * [Use monotonic time in condition variables][35048]
3646 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
3647 * [Implement conversion traits for `char`][35755]
3648 * [Fix illegal instruction caused by overflow in channel cloning][36104]
3649 * [Zero first byte of CString on drop][36264]
3650 * [Inherit overflow checks for sum and product][36372]
3651 * [Add missing Eq implementations][36423]
3652 * [Implement `Debug` for `DirEntry`][36631]
3653 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
3654   `errno`][36754]
3655 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3656 * [Implement more traits for `std::io::ErrorKind`][35911]
3657 * [Optimize BinaryHeap bounds checking][36072]
3658 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
3659   `extend_with_element`][36355]
3660 * [Fix overflow checking in unsigned pow()][34942]
3661
3662 Cargo
3663 -----
3664
3665 * This release includes security fixes to both curl and OpenSSL.
3666 * [Fix transitive doctests when panic=abort][cargo/3021]
3667 * [Add --all-features flag to cargo][cargo/3038]
3668 * [Reject path-based dependencies in `cargo package`][cargo/3060]
3669 * [Don't parse the home directory more than once][cargo/3078]
3670 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
3671 * [Update OpenSSL to 1.0.2j][cargo/3121]
3672 * [Add license and license_file to cargo metadata output][cargo/3110]
3673 * [Make crates-io registry URL optional in config; ignore all changes to
3674   source.crates-io][cargo/3089]
3675 * [Don't download dependencies from other platforms][cargo/3123]
3676 * [Build transitive dev-dependencies when needed][cargo/3125]
3677 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
3678 * [Avoid updating registry when adding existing deps][cargo/3144]
3679 * [Warn about path overrides that won't work][cargo/3136]
3680 * [Use workspaces during `cargo install`][cargo/3146]
3681 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
3682 * [Add --message-format flag][cargo/3000]
3683 * [Pass target environment for rustdoc][cargo/3205]
3684 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
3685 * [Update curl and curl-sys][cargo/3241]
3686 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
3687
3688 Tooling
3689 -------
3690
3691 * [rustdoc: Add the `--sysroot` argument][36586]
3692 * [rustdoc: Fix a couple of issues with the search results][35655]
3693 * [rustdoc: remove the `!` from macro URLs and titles][35234]
3694 * [gdb: Fix pretty-printing special-cased Rust types][35585]
3695 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
3696
3697 Misc
3698 ----
3699
3700 * [Remove unmaintained style guide][35124]
3701 * [Add s390x support][36369]
3702 * [Initial work at Haiku OS support][36727]
3703 * [Add mips-uclibc targets][35734]
3704 * [Crate-ify compiler-rt into compiler-builtins][35021]
3705 * [Add rustc version info (git hash + date) to dist tarball][36213]
3706 * Many documentation improvements
3707
3708 Compatibility Notes
3709 -------------------
3710
3711 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
3712 * [Deny (by default) transmuting from fn item types to pointer-sized
3713   types][34923]. Continuing the long transition to zero-sized fn items,
3714   per [RFC 401].
3715 * [Fix `#[derive]` for empty tuple structs/variants][35728].
3716   Part of [RFC 1506].
3717 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3718 * [Fix lifetime rules for 'if' conditions][36029].
3719 * [Inherit overflow checks for sum and product][36372].
3720 * [Forbid user-defined macros named "macro_rules"][36730].
3721
3722 [33922]: https://github.com/rust-lang/rust/pull/33922
3723 [34623]: https://github.com/rust-lang/rust/pull/34623
3724 [34923]: https://github.com/rust-lang/rust/pull/34923
3725 [34942]: https://github.com/rust-lang/rust/pull/34942
3726 [34982]: https://github.com/rust-lang/rust/pull/34982
3727 [35021]: https://github.com/rust-lang/rust/pull/35021
3728 [35048]: https://github.com/rust-lang/rust/pull/35048
3729 [35074]: https://github.com/rust-lang/rust/pull/35074
3730 [35124]: https://github.com/rust-lang/rust/pull/35124
3731 [35234]: https://github.com/rust-lang/rust/pull/35234
3732 [35238]: https://github.com/rust-lang/rust/pull/35238
3733 [35354]: https://github.com/rust-lang/rust/pull/35354
3734 [35559]: https://github.com/rust-lang/rust/pull/35559
3735 [35585]: https://github.com/rust-lang/rust/pull/35585
3736 [35627]: https://github.com/rust-lang/rust/pull/35627
3737 [35655]: https://github.com/rust-lang/rust/pull/35655
3738 [35702]: https://github.com/rust-lang/rust/pull/35702
3739 [35707]: https://github.com/rust-lang/rust/pull/35707
3740 [35728]: https://github.com/rust-lang/rust/pull/35728
3741 [35734]: https://github.com/rust-lang/rust/pull/35734
3742 [35755]: https://github.com/rust-lang/rust/pull/35755
3743 [35761]: https://github.com/rust-lang/rust/pull/35761
3744 [35764]: https://github.com/rust-lang/rust/pull/35764
3745 [35814]: https://github.com/rust-lang/rust/pull/35814
3746 [35854]: https://github.com/rust-lang/rust/pull/35854
3747 [35871]: https://github.com/rust-lang/rust/pull/35871
3748 [35884]: https://github.com/rust-lang/rust/pull/35884
3749 [35911]: https://github.com/rust-lang/rust/pull/35911
3750 [35969]: https://github.com/rust-lang/rust/pull/35969
3751 [35975]: https://github.com/rust-lang/rust/pull/35975
3752 [36004]: https://github.com/rust-lang/rust/pull/36004
3753 [36008]: https://github.com/rust-lang/rust/pull/36008
3754 [36014]: https://github.com/rust-lang/rust/pull/36014
3755 [36029]: https://github.com/rust-lang/rust/pull/36029
3756 [36059]: https://github.com/rust-lang/rust/pull/36059
3757 [36072]: https://github.com/rust-lang/rust/pull/36072
3758 [36101]: https://github.com/rust-lang/rust/pull/36101
3759 [36104]: https://github.com/rust-lang/rust/pull/36104
3760 [36171]: https://github.com/rust-lang/rust/pull/36171
3761 [36173]: https://github.com/rust-lang/rust/pull/36173
3762 [36178]: https://github.com/rust-lang/rust/pull/36178
3763 [36213]: https://github.com/rust-lang/rust/pull/36213
3764 [36214]: https://github.com/rust-lang/rust/pull/36214
3765 [36264]: https://github.com/rust-lang/rust/pull/36264
3766 [36266]: https://github.com/rust-lang/rust/pull/36266
3767 [36289]: https://github.com/rust-lang/rust/pull/36289
3768 [36338]: https://github.com/rust-lang/rust/pull/36338
3769 [36351]: https://github.com/rust-lang/rust/pull/36351
3770 [36355]: https://github.com/rust-lang/rust/pull/36355
3771 [36369]: https://github.com/rust-lang/rust/pull/36369
3772 [36372]: https://github.com/rust-lang/rust/pull/36372
3773 [36423]: https://github.com/rust-lang/rust/pull/36423
3774 [36482]: https://github.com/rust-lang/rust/pull/36482
3775 [36505]: https://github.com/rust-lang/rust/pull/36505
3776 [36524]: https://github.com/rust-lang/rust/pull/36524
3777 [36527]: https://github.com/rust-lang/rust/pull/36527
3778 [36551]: https://github.com/rust-lang/rust/pull/36551
3779 [36574]: https://github.com/rust-lang/rust/pull/36574
3780 [36586]: https://github.com/rust-lang/rust/pull/36586
3781 [36592]: https://github.com/rust-lang/rust/pull/36592
3782 [36631]: https://github.com/rust-lang/rust/pull/36631
3783 [36639]: https://github.com/rust-lang/rust/pull/36639
3784 [36721]: https://github.com/rust-lang/rust/pull/36721
3785 [36727]: https://github.com/rust-lang/rust/pull/36727
3786 [36730]: https://github.com/rust-lang/rust/pull/36730
3787 [36734]: https://github.com/rust-lang/rust/pull/36734
3788 [36754]: https://github.com/rust-lang/rust/pull/36754
3789 [36995]: https://github.com/rust-lang/rust/pull/36995
3790 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3791 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3792 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3793 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3794 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3795 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3796 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3797 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3798 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3799 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3800 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3801 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3802 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3803 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3804 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3805 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3806 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3807 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3808 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3809 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3810 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3811 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3812 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3813 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3814 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3815 [rustup]: https://www.rustup.rs
3816 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3817 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3818 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3819 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3820 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3821 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3822 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3823
3824
3825 Version 1.12.1 (2016-10-20)
3826 ===========================
3827
3828 Regression Fixes
3829 ----------------
3830
3831 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3832 * [Confusion with double negation and booleans][36856]
3833 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3834 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3835 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3836 * [Corrupted memory after updated to 1.12][36936]
3837 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3838 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3839 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3840
3841 [36381]: https://github.com/rust-lang/rust/issues/36381
3842 [36856]: https://github.com/rust-lang/rust/issues/36856
3843 [36875]: https://github.com/rust-lang/rust/issues/36875
3844 [36924]: https://github.com/rust-lang/rust/issues/36924
3845 [36926]: https://github.com/rust-lang/rust/issues/36926
3846 [36936]: https://github.com/rust-lang/rust/issues/36936
3847 [37026]: https://github.com/rust-lang/rust/issues/37026
3848 [37112]: https://github.com/rust-lang/rust/issues/37112
3849 [37153]: https://github.com/rust-lang/rust/issues/37153
3850
3851
3852 Version 1.12.0 (2016-09-29)
3853 ===========================
3854
3855 Highlights
3856 ----------
3857
3858 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3859   This translation pass is far simpler than the previous AST->LLVM pass, and
3860   creates opportunities to perform new optimizations directly on the MIR. It
3861   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3862 * [`rustc` presents a new, more readable error format, along with
3863   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3864   Most common editors supporting Rust have been updated to work with it. It was
3865   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3866
3867 Compiler
3868 --------
3869
3870 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3871   This translation pass is far simpler than the previous AST->LLVM pass, and
3872   creates opportunities to perform new optimizations directly on the MIR. It
3873   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3874 * [Print the Rust target name, not the LLVM target name, with
3875   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3876 * [The computation of `TypeId` is correct in some cases where it was previously
3877   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3878 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3879 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3880   `--print relocation-models`, and `--print code-models` print the available
3881   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3882   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3883 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3884   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3885   These targets produce statically-linked binaries. There are no binary release
3886   builds yet though.
3887
3888 Diagnostics
3889 -----------
3890
3891 * [`rustc` presents a new, more readable error format, along with
3892   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3893   Most common editors supporting Rust have been updated to work with it. It was
3894   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3895 * [In error descriptions, references are now described in plain English,
3896   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3897 * [In error type descriptions, unknown numeric types are named `{integer}` or
3898   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3899 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3900
3901 Language
3902 --------
3903
3904 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3905 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3906 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3907   useful](https://github.com/rust-lang/rust/pull/34908)
3908 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3909   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3910 * [Semicolons are properly required as statement delimiters inside
3911   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3912 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3913
3914 Stabilized APIs
3915 ---------------
3916
3917 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3918 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3919 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3920 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3921 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3922 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3923 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3924 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3925 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3926 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3927   Both on Unix and Windows.
3928 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3929 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3930 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3931 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3932 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3933 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3934 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3935 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3936
3937 Libraries
3938 ---------
3939
3940 * [The `format!` macro and friends now allow a single argument to be formatted
3941   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3942 * [The lifetime bounds on `[T]::binary_search_by` and
3943   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3944 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3945 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3946 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3947 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3948 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3949 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3950 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3951 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3952   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3953 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3954   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3955 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3956 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3957   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3958 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3959 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3960 * [`mpsc::sync_channel` `Receiver`s return any available message before
3961   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3962 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3963 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3964
3965 Cargo
3966 -----
3967
3968 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3969 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3970 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3971 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3972 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3973 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3974 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3975 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3976 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3977 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3978 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3979 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3980 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3981 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3982 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3983 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3984
3985 Performance
3986 -----------
3987
3988 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3989 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3990
3991 Tooling
3992 -------
3993
3994 * [Test binaries now support a `--test-threads` argument to specify the number
3995   of threads used to run tests, and which acts the same as the
3996   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3997 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3998 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3999 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4000 * [Rust releases now come with source packages that can be installed by rustup
4001   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4002   The resulting source code can be used by tools and IDES, located in the
4003   sysroot under `lib/rustlib/src`.
4004
4005 Misc
4006 ----
4007
4008 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4009 * Many minor improvements to the documentation.
4010 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4011
4012 Compatibility Notes
4013 -------------------
4014
4015 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4016   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4017 * [When formatting strings, if "precision" is specified, the "fill",
4018   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4019 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4020
4021
4022 Version 1.11.0 (2016-08-18)
4023 ===========================
4024
4025 Language
4026 --------
4027
4028 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4029 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4030 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4031 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4032 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4033
4034 Stabilized APIs
4035 ---------------
4036
4037 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4038 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4039 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4040 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4041 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4042 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4043   (in libcore - previously stabilized in libstd)
4044 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4045   (in libcore - previously stabilized in libstd)
4046 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4047   (in libcore - previously stabilized in libstd)
4048 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4049   (in libcore - previously stabilized in libstd)
4050 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4051 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4052 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4053 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4054
4055 Libraries
4056 ---------
4057
4058 * [The `thread_local!` macro supports multiple definitions in a single
4059    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4060 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4061 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4062   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4063 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4064 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4065 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4066 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4067
4068 Cargo
4069 -----
4070
4071 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4072 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4073 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4074 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4075 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4076   and `-vv` prints warnings for all crates.
4077 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4078 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4079   This provides room for expansion by arbitrary tools.
4080 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4081 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4082 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4083 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4084 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4085 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4086 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4087
4088 Performance
4089 -----------
4090
4091 * [Caching projections speeds up type check dramatically for some
4092   workloads](https://github.com/rust-lang/rust/pull/33816)
4093 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4094   This hasher is faster, but is believed to provide sufficient
4095   protection from collision attacks.
4096 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4097
4098 Rustdoc
4099 -------
4100
4101 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4102 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4103 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4104 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4105 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4106
4107 Tooling
4108 -------
4109
4110 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4111 * [When emitting debug info, rustc emits frame pointers for closures,
4112   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4113 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4114 * Many more errors have been given error codes and extended
4115   explanations
4116 * API documentation continues to be improved, with many new examples
4117
4118 Misc
4119 ----
4120
4121 * [rustc no longer hangs when dependencies recursively re-export
4122   submodules](https://github.com/rust-lang/rust/pull/34542)
4123 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4124 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4125   rewritten](https://github.com/rust-lang/rust/pull/33895)
4126 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4127   No targets use this yet, but it works toward AVR support.
4128
4129 Compatibility Notes
4130 -------------------
4131
4132 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4133 * [The new follow-set rules that place restrictions on `macro_rules!`
4134   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4135   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4136   and has been a warning since 1.10.
4137 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4138   This causes breakage in some corner cases.
4139
4140
4141 Version 1.10.0 (2016-07-07)
4142 ===========================
4143
4144 Language
4145 --------
4146
4147 * [Allow `concat_idents!` in type positions as well as in expression
4148   positions](https://github.com/rust-lang/rust/pull/33735).
4149 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4150   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4151 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4152 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4153 * [`panic!` can be converted to a runtime abort with the
4154   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4155   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4156 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4157   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4158   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4159   Note that Cargo does not yet directly support cdylibs.
4160
4161 Stabilized APIs
4162 ---------------
4163
4164 * `os::windows::fs::OpenOptionsExt::access_mode`
4165 * `os::windows::fs::OpenOptionsExt::share_mode`
4166 * `os::windows::fs::OpenOptionsExt::custom_flags`
4167 * `os::windows::fs::OpenOptionsExt::attributes`
4168 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4169 * `os::unix::fs::OpenOptionsExt::custom_flags`
4170 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4171 * `Default for sync::Weak`
4172 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4173 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4174 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4175 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4176 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4177 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4178 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4179 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4180 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4181 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4182 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4183 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4184 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4185 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4186 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4187 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4188 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4189 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4190 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4191 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4192 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4193 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4194 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4195 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4196 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4197 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4198 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4199 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4200 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4201 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4202 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4203 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4204 * Read/Write/RawFd impls for `UnixStream`
4205 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4206 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4207 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4208 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4209 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4210 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4211 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4212 * RawFd impls for `UnixListener`
4213 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4214 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4215 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4216 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4217 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4218 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4219 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4220 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4221 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4222 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4223 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4224 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4225 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4226 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4227 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4228 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4229 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4230 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4231 * RawFd impls for `UnixDatagram`
4232 * `{BTree,Hash}Map::values_mut`
4233 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4234
4235 Libraries
4236 ---------
4237
4238 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4239   The semantics of this minor method are subtle and probably not what
4240   most people want.
4241 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4242 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4243   will fall back to `/dev/urandom` temporarily to avoid blocking
4244   during early boot](https://github.com/rust-lang/rust/pull/33086).
4245 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4246 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4247 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4248 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4249 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4250 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4251   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4252
4253 Cargo
4254 -----
4255 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4256   This controls the runtime behavior of the `panic!` macro
4257   and can be either "unwind" (the default), or "abort".
4258   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4259 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4260 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4261 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4262   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4263 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4264 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4265 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4266   By default they are retried twice, which can be customized with the
4267   `net.retry` value in `.cargo/config`.
4268 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4269 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4270 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4271 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4272   Makes it possible to install multiple crates in parallel.
4273 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4274 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4275 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4276 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4277 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4278 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4279
4280 Performance
4281 -----------
4282
4283 * [rustc memory usage was reduced by refactoring the context used for
4284   type checking](https://github.com/rust-lang/rust/pull/33425).
4285 * [Speed up creation of `HashMap`s by caching the random keys used
4286   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4287 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4288 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4289 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4290   10x faster than the previous lookup tables.
4291 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4292
4293 Usability
4294 ---------
4295
4296 * Many incremental improvements to documentation and rustdoc.
4297 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4298 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4299 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4300 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4301 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4302 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4303 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4304
4305 Misc
4306 ----
4307
4308 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4309 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4310 * [`std` no longer prints backtraces on platforms where the running
4311   module must be loaded with `env::current_exe`, which can't be relied
4312   on](https://github.com/rust-lang/rust/pull/33554).
4313 * This release includes std binaries for the i586-unknown-linux-gnu,
4314   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4315   i586 target is for old x86 hardware without SSE2, and the armv7
4316   target is for Android running on modern ARM architectures.
4317 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4318   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4319 * [On Unix the runtime aborts by calling `libc::abort` instead of
4320   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4321 * [Rust is now bootstrapped from the previous release of Rust,
4322   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4323
4324 Compatibility Notes
4325 -------------------
4326
4327 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4328 * [`target_env` for Linux ARM targets is just `gnu`, not
4329   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4330 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4331 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4332 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4333   Affects how macros are parsed.
4334 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4335 * [Feature-gated attributes on macro-generated macro invocations are
4336   now rejected](https://github.com/rust-lang/rust/pull/32791).
4337 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4338   This caused some minor changes to type inference.
4339
4340
4341 Version 1.9.0 (2016-05-26)
4342 ==========================
4343
4344 Language
4345 --------
4346
4347 * The `#[deprecated]` attribute when applied to an API will generate
4348   warnings when used. The warnings may be suppressed with
4349   `#[allow(deprecated)]`. [RFC 1270].
4350 * [`fn` item types are zero sized, and each `fn` names a unique
4351   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4352   `transmute` on a `fn` type will generate a warning for a few cycles,
4353   then will be converted to an error.
4354 * [Field and method resolution understand visibility, so private
4355   fields and methods cannot prevent the proper use of public fields
4356   and methods][1.9fv].
4357 * [The parser considers unicode codepoints in the
4358   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4359
4360 Stabilized APIs
4361 ---------------
4362
4363 * [`std::panic`]
4364 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4365 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4366 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4367 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4368 * [`str::is_char_boundary`]
4369 * [`<*const T>::as_ref`]
4370 * [`<*mut T>::as_ref`]
4371 * [`<*mut T>::as_mut`]
4372 * [`AsciiExt::make_ascii_uppercase`]
4373 * [`AsciiExt::make_ascii_lowercase`]
4374 * [`char::decode_utf16`]
4375 * [`char::DecodeUtf16`]
4376 * [`char::DecodeUtf16Error`]
4377 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4378 * [`BTreeSet::take`]
4379 * [`BTreeSet::replace`]
4380 * [`BTreeSet::get`]
4381 * [`HashSet::take`]
4382 * [`HashSet::replace`]
4383 * [`HashSet::get`]
4384 * [`OsString::with_capacity`]
4385 * [`OsString::clear`]
4386 * [`OsString::capacity`]
4387 * [`OsString::reserve`]
4388 * [`OsString::reserve_exact`]
4389 * [`OsStr::is_empty`]
4390 * [`OsStr::len`]
4391 * [`std::os::unix::thread`]
4392 * [`RawPthread`]
4393 * [`JoinHandleExt`]
4394 * [`JoinHandleExt::as_pthread_t`]
4395 * [`JoinHandleExt::into_pthread_t`]
4396 * [`HashSet::hasher`]
4397 * [`HashMap::hasher`]
4398 * [`CommandExt::exec`]
4399 * [`File::try_clone`]
4400 * [`SocketAddr::set_ip`]
4401 * [`SocketAddr::set_port`]
4402 * [`SocketAddrV4::set_ip`]
4403 * [`SocketAddrV4::set_port`]
4404 * [`SocketAddrV6::set_ip`]
4405 * [`SocketAddrV6::set_port`]
4406 * [`SocketAddrV6::set_flowinfo`]
4407 * [`SocketAddrV6::set_scope_id`]
4408 * [`slice::copy_from_slice`]
4409 * [`ptr::read_volatile`]
4410 * [`ptr::write_volatile`]
4411 * [`OpenOptions::create_new`]
4412 * [`TcpStream::set_nodelay`]
4413 * [`TcpStream::nodelay`]
4414 * [`TcpStream::set_ttl`]
4415 * [`TcpStream::ttl`]
4416 * [`TcpStream::set_only_v6`]
4417 * [`TcpStream::only_v6`]
4418 * [`TcpStream::take_error`]
4419 * [`TcpStream::set_nonblocking`]
4420 * [`TcpListener::set_ttl`]
4421 * [`TcpListener::ttl`]
4422 * [`TcpListener::set_only_v6`]
4423 * [`TcpListener::only_v6`]
4424 * [`TcpListener::take_error`]
4425 * [`TcpListener::set_nonblocking`]
4426 * [`UdpSocket::set_broadcast`]
4427 * [`UdpSocket::broadcast`]
4428 * [`UdpSocket::set_multicast_loop_v4`]
4429 * [`UdpSocket::multicast_loop_v4`]
4430 * [`UdpSocket::set_multicast_ttl_v4`]
4431 * [`UdpSocket::multicast_ttl_v4`]
4432 * [`UdpSocket::set_multicast_loop_v6`]
4433 * [`UdpSocket::multicast_loop_v6`]
4434 * [`UdpSocket::set_multicast_ttl_v6`]
4435 * [`UdpSocket::multicast_ttl_v6`]
4436 * [`UdpSocket::set_ttl`]
4437 * [`UdpSocket::ttl`]
4438 * [`UdpSocket::set_only_v6`]
4439 * [`UdpSocket::only_v6`]
4440 * [`UdpSocket::join_multicast_v4`]
4441 * [`UdpSocket::join_multicast_v6`]
4442 * [`UdpSocket::leave_multicast_v4`]
4443 * [`UdpSocket::leave_multicast_v6`]
4444 * [`UdpSocket::take_error`]
4445 * [`UdpSocket::connect`]
4446 * [`UdpSocket::send`]
4447 * [`UdpSocket::recv`]
4448 * [`UdpSocket::set_nonblocking`]
4449
4450 Libraries
4451 ---------
4452
4453 * [`std::sync::Once` is poisoned if its initialization function
4454   fails][1.9o].
4455 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
4456 * [Most types implement `fmt::Debug`][1.9db].
4457 * [The default buffer size used by `BufReader` and `BufWriter` was
4458   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
4459   used by other languages.
4460 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
4461   `Duration` additionally implements `*=` and `/=`][1.9ta].
4462 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
4463 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
4464 * [`Chain` implements `BufRead`][1.9ch].
4465 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
4466
4467 Cargo
4468 -----
4469
4470 * [Cargo can now run concurrently][1.9cc].
4471 * [Top-level overrides allow specific revisions of crates to be
4472   overridden through the entire crate graph][1.9ct].  This is intended
4473   to make upgrades easier for large projects, by allowing crates to be
4474   forked temporarily until they've been upgraded and republished.
4475 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
4476 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
4477   on the commandline][1.9cf]. `rustc` arguments can also be specified
4478   in the `build.rustflags` configuration key.
4479
4480 Performance
4481 -----------
4482
4483 * [The time complexity of comparing variables for equivalence during type
4484   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
4485   to major compilation time improvement in some scenarios.
4486 * [`ToString` is specialized for `str`, giving it the same performance
4487   as `to_owned`][1.9ts].
4488 * [Spawning processes with `Command::output` no longer creates extra
4489   threads][1.9sp].
4490 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
4491   for C-like enums][1.9cl].
4492
4493 Misc
4494 ----
4495
4496 * [Passing the `--quiet` flag to a test runner will produce
4497   much-abbreviated output][1.9q].
4498 * The Rust Project now publishes std binaries for the
4499   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
4500   `i586-pc-windows-msvc` targets.
4501
4502 Compatibility Notes
4503 -------------------
4504
4505 * [`std::sync::Once` is poisoned if its initialization function
4506   fails][1.9o].
4507 * [It is illegal to define methods with the same name in overlapping
4508   inherent `impl` blocks][1.9sn].
4509 * [`fn` item types are zero sized, and each `fn` names a unique
4510   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4511   `transmute` on a `fn` type will generate a warning for a few cycles,
4512   then will be converted to an error.
4513 * [Improvements to const evaluation may trigger new errors when integer
4514   literals are out of range][1.9ce].
4515
4516
4517 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
4518 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
4519 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
4520 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
4521 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
4522 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
4523 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
4524 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
4525 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
4526 [1.9db]: https://github.com/rust-lang/rust/pull/32054
4527 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
4528 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
4529 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
4530 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
4531 [1.9o]: https://github.com/rust-lang/rust/pull/32325
4532 [1.9q]: https://github.com/rust-lang/rust/pull/31887
4533 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
4534 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
4535 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
4536 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
4537 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
4538 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
4539 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
4540 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
4541 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4542 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
4543 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
4544 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
4545 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
4546 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
4547 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
4548 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
4549 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
4550 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
4551 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
4552 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
4553 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
4554 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
4555 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
4556 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
4557 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
4558 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
4559 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
4560 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
4561 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
4562 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
4563 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
4564 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
4565 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
4566 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
4567 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
4568 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
4569 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
4570 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
4571 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
4572 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
4573 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
4574 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
4575 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
4576 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
4577 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4578 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4579 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4580 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4581 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4582 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4583 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
4584 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
4585 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
4586 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
4587 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
4588 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
4589 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
4590 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
4591 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
4592 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
4593 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
4594 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
4595 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
4596 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
4597 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
4598 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
4599 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
4600 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
4601 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
4602 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
4603 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
4604 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
4605 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
4606 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
4607 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
4608 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
4609 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
4610 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
4611 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
4612 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
4613 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
4614 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
4615 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
4616 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
4617 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
4618 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
4619 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
4620 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
4621 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
4622 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
4623 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
4624 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
4625 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
4626 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
4627
4628
4629 Version 1.8.0 (2016-04-14)
4630 ==========================
4631
4632 Language
4633 --------
4634
4635 * Rust supports overloading of compound assignment statements like
4636   `+=` by implementing the [`AddAssign`], [`SubAssign`],
4637   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
4638   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
4639   traits. [RFC 953].
4640 * Empty structs can be defined with braces, as in `struct Foo { }`, in
4641   addition to the non-braced form, `struct Foo;`. [RFC 218].
4642
4643 Libraries
4644 ---------
4645
4646 * Stabilized APIs:
4647   * [`str::encode_utf16`][] (renamed from `utf16_units`)
4648   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
4649   * [`Ref::map`]
4650   * [`RefMut::map`]
4651   * [`ptr::drop_in_place`]
4652   * [`time::Instant`]
4653   * [`time::SystemTime`]
4654   * [`Instant::now`]
4655   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
4656   * [`Instant::elapsed`]
4657   * [`SystemTime::now`]
4658   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
4659   * [`SystemTime::elapsed`]
4660   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
4661   * [`SystemTimeError`]
4662   * [`SystemTimeError::duration`]
4663   * Various impls for `SystemTimeError`
4664   * [`UNIX_EPOCH`]
4665   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
4666     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
4667     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
4668 * [The `write!` and `writeln!` macros correctly emit errors if any of
4669   their arguments can't be formatted][1.8w].
4670 * [Various I/O functions support large files on 32-bit Linux][1.8l].
4671 * [The Unix-specific `raw` modules, which contain a number of
4672   redefined C types are deprecated][1.8r], including `os::raw::unix`,
4673   `os::raw::macos`, and `os::raw::linux`. These modules defined types
4674   such as `ino_t` and `dev_t`. The inconsistency of these definitions
4675   across platforms was making it difficult to implement `std`
4676   correctly. Those that need these definitions should use the `libc`
4677   crate. [RFC 1415].
4678 * The Unix-specific `MetadataExt` traits, including
4679   `os::unix::fs::MetadataExt`, which expose values such as inode
4680   numbers [no longer return platform-specific types][1.8r], but
4681   instead return widened integers. [RFC 1415].
4682 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
4683 * [Atomic loads and stores are not volatile][1.8a].
4684 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
4685
4686 Performance
4687 -----------
4688
4689 * [Inlining hash functions lead to a 3% compile-time improvement in
4690   some workloads][1.8h].
4691 * When using jemalloc, its symbols are [unprefixed so that it
4692   overrides the libc malloc implementation][1.8h]. This means that for
4693   rustc, LLVM is now using jemalloc, which results in a 6%
4694   compile-time improvement on a specific workload.
4695 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
4696
4697 Misc
4698 ----
4699
4700 * [32-bit MSVC builds finally implement unwinding][1.8ms].
4701   i686-pc-windows-msvc is now considered a tier-1 platform.
4702 * [The `--print targets` flag prints a list of supported targets][1.8t].
4703 * [The `--print cfg` flag prints the `cfg`s defined for the current
4704   target][1.8cf].
4705 * [`rustc` can be built with an new Cargo-based build system, written
4706   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
4707   build system. To enable it configure with `configure --rustbuild`.
4708 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
4709   variants while also indicating the total number of missing variants
4710   if more than 3][1.8m].
4711 * [Executable stacks are disabled on Linux and BSD][1.8nx].
4712 * The Rust Project now publishes binary releases of the standard
4713   library for a number of tier-2 targets:
4714   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
4715   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
4716   `x86_64-rumprun-netbsd`. These can be installed with
4717   tools such as [multirust][1.8mr].
4718
4719 Cargo
4720 -----
4721
4722 * [`cargo init` creates a new Cargo project in the current
4723   directory][1.8ci].  It is otherwise like `cargo new`.
4724 * [Cargo has configuration keys for `-v` and
4725   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4726   `[term]` section of `.cargo/config`.
4727 * [Configuration keys that evaluate to strings or integers can be set
4728   via environment variables][1.8ce]. For example the `build.jobs` key
4729   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4730   precedence over config files.
4731 * [Target-specific dependencies support Rust `cfg` syntax for
4732   describing targets][1.8cfg] so that dependencies for multiple
4733   targets can be specified together. [RFC 1361].
4734 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4735   `RUSTDOC` take precedence over the `build.target-dir`,
4736   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4737 * [The child process tree is killed on Windows when Cargo is
4738   killed][1.8ck].
4739 * [The `build.target` configuration value sets the target platform,
4740   like `--target`][1.8ct].
4741
4742 Compatibility Notes
4743 -------------------
4744
4745 * [Unstable compiler flags have been further restricted][1.8u]. Since
4746   1.0 `-Z` flags have been considered unstable, and other flags that
4747   were considered unstable additionally required passing `-Z
4748   unstable-options` to access. Unlike unstable language and library
4749   features though, these options have been accessible on the stable
4750   release channel. Going forward, *new unstable flags will not be
4751   available on the stable release channel*, and old unstable flags
4752   will warn about their usage. In the future, all unstable flags will
4753   be unavailable on the stable release channel.
4754 * [It is no longer possible to `match` on empty enum variants using
4755   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4756 * The Unix-specific `MetadataExt` traits, including
4757   `os::unix::fs::MetadataExt`, which expose values such as inode
4758   numbers [no longer return platform-specific types][1.8r], but
4759   instead return widened integers. [RFC 1415].
4760 * [Modules sourced from the filesystem cannot appear within arbitrary
4761   blocks, but only within other modules][1.8mf].
4762 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4763 * On Unix, [stack overflow triggers a runtime abort instead of a
4764   SIGSEGV][1.8so].
4765 * [`Command::spawn` and its equivalents return an error if any of
4766   its command-line arguments contain interior `NUL`s][1.8n].
4767 * [Tuple and unit enum variants from other crates are in the type
4768   namespace][1.8tn].
4769 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4770   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4771   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4772   instead of `foo.lib`.
4773
4774
4775 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4776 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4777 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4778 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4779 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4780 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4781 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4782 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4783 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4784 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4785 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4786 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4787 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4788 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4789 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4790 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4791 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4792 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4793 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4794 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4795 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4796 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4797 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4798 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4799 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4800 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4801 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4802 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4803 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4804 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4805 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4806 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4807 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4808 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4809 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4810 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4811 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4812 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4813 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4814 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4815 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4816 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4817 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4818 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4819 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4820 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4821 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4822 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4823 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4824 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4825 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4826 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4827 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4828 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4829 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4830 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4831 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4832 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4833 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4834 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4835
4836
4837 Version 1.7.0 (2016-03-03)
4838 ==========================
4839
4840 Libraries
4841 ---------
4842
4843 * Stabilized APIs
4844   * `Path`
4845     * [`Path::strip_prefix`][] (renamed from relative_from)
4846     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4847   * `Ipv4Addr`
4848     * [`Ipv4Addr::is_loopback`]
4849     * [`Ipv4Addr::is_private`]
4850     * [`Ipv4Addr::is_link_local`]
4851     * [`Ipv4Addr::is_multicast`]
4852     * [`Ipv4Addr::is_broadcast`]
4853     * [`Ipv4Addr::is_documentation`]
4854   * `Ipv6Addr`
4855     * [`Ipv6Addr::is_unspecified`]
4856     * [`Ipv6Addr::is_loopback`]
4857     * [`Ipv6Addr::is_multicast`]
4858   * `Vec`
4859     * [`Vec::as_slice`]
4860     * [`Vec::as_mut_slice`]
4861   * `String`
4862     * [`String::as_str`]
4863     * [`String::as_mut_str`]
4864   * Slices
4865     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4866     be the same length
4867     * `<[T]>::`[`sort_by_key`]
4868   * checked, saturated, and overflowing operations
4869     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4870     * [`i32::saturating_mul`]
4871     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4872     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4873     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4874     * [`u32::saturating_mul`]
4875     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4876     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4877     * and checked, saturated, and overflowing operations for other primitive types
4878   * FFI
4879     * [`ffi::IntoStringError`]
4880     * [`CString::into_string`]
4881     * [`CString::into_bytes`]
4882     * [`CString::into_bytes_with_nul`]
4883     * `From<CString> for Vec<u8>`
4884   * `IntoStringError`
4885     * [`IntoStringError::into_cstring`]
4886     * [`IntoStringError::utf8_error`]
4887     * `Error for IntoStringError`
4888   * Hashing
4889     * [`std::hash::BuildHasher`]
4890     * [`BuildHasher::Hasher`]
4891     * [`BuildHasher::build_hasher`]
4892     * [`std::hash::BuildHasherDefault`]
4893     * [`HashMap::with_hasher`]
4894     * [`HashMap::with_capacity_and_hasher`]
4895     * [`HashSet::with_hasher`]
4896     * [`HashSet::with_capacity_and_hasher`]
4897     * [`std::collections::hash_map::RandomState`]
4898     * [`RandomState::new`]
4899 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4900   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4901   from bytes is faster.
4902 * [The performance of `LineWriter` (and thus `io::stdout`) was
4903   improved by using `memchr` to search for newlines][1.7m].
4904 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4905   `f64` variants were stabilized previously.
4906 * [`BTreeMap` was rewritten to use less memory and improve the performance
4907   of insertion and iteration, the latter by as much as 5x][1.7bm].
4908 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4909   covariant over their contained type][1.7bt].
4910 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4911   over their contained type][1.7ll].
4912 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4913   searching methods.
4914 * [`Any` is implemented for unsized types][1.7a].
4915 * [`Hash` is implemented for `Duration`][1.7h].
4916
4917 Misc
4918 ----
4919
4920 * [When running tests with `--test`, rustdoc will pass `--cfg`
4921   arguments to the compiler][1.7dt].
4922 * [The compiler is built with RPATH information by default][1.7rpa].
4923   This means that it will be possible to run `rustc` when installed in
4924   unusual configurations without configuring the dynamic linker search
4925   path explicitly.
4926 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4927   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4928   over `LD_LIBRARY_PATH`.
4929
4930 Cargo
4931 -----
4932
4933 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4934   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4935 * [The `rerun-if-changed` build script directive no longer causes the
4936   build script to incorrectly run twice in certain scenarios][1.7rr].
4937
4938 Compatibility Notes
4939 -------------------
4940
4941 * Soundness fixes to the interactions between associated types and
4942   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4943   code that violates the new rules. This is a significant change that
4944   is known to break existing code, so it has emitted warnings for the
4945   new error cases since 1.4 to give crate authors time to adapt. The
4946   details of what is changing are subtle; read the RFC for more.
4947 * [Several bugs in the compiler's visibility calculations were
4948   fixed][1.7v]. Since this was found to break significant amounts of
4949   code, the new errors will be emitted as warnings for several release
4950   cycles, under the `private_in_public` lint.
4951 * Defaulted type parameters were accidentally accepted in positions
4952   that were not intended. In this release, [defaulted type parameters
4953   appearing outside of type definitions will generate a
4954   warning][1.7d], which will become an error in future releases.
4955 * [Parsing "." as a float results in an error instead of 0][1.7p].
4956   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4957 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4958
4959 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4960 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4961 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4962 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4963 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4964 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4965 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4966 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4967 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4968 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4969 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4970 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4971 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4972 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4973 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4974 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4975 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4976 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4977 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4978 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4979 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4980 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4981 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4982 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4983 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4984 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4985 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4986 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4987 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4988 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4989 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4990 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4991 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4992 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4993 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4994 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4995 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4996 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4997 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4998 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4999 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5000 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5001 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5002 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5003 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5004 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5005 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5006 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5007 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5008 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5009 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5010 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5011 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5012 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5013 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5014 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5015 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5016 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5017 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5018 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5019 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5020 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5021 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5022 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5023 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5024 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5025 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5026 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5027 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5028 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5029 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5030 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5031 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5032 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5033 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5034 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5035 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5036 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5037 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5038
5039
5040 Version 1.6.0 (2016-01-21)
5041 ==========================
5042
5043 Language
5044 --------
5045
5046 * The `#![no_std]` attribute causes a crate to not be linked to the
5047   standard library, but only the [core library][1.6co], as described
5048   in [RFC 1184]. The core library defines common types and traits but
5049   has no platform dependencies whatsoever, and is the basis for Rust
5050   software in environments that cannot support a full port of the
5051   standard library, such as operating systems. Most of the core
5052   library is now stable.
5053
5054 Libraries
5055 ---------
5056
5057 * Stabilized APIs:
5058   [`Read::read_exact`],
5059   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
5060   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5061   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5062   [`os::unix::fs::DirBuilderExt`],
5063   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5064   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5065   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5066   [`collections::hash_map::Drain`],
5067   [`collections::hash_map::HashMap::drain`],
5068   [`collections::hash_set::Drain`],
5069   [`collections::hash_set::HashSet::drain`],
5070   [`collections::binary_heap::Drain`],
5071   [`collections::binary_heap::BinaryHeap::drain`],
5072   [`Vec::extend_from_slice`][] (renamed from `push_all`),
5073   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5074   [`RwLock::into_inner`],
5075   [`Iterator::min_by_key`][] (renamed from `min_by`),
5076   [`Iterator::max_by_key`][] (renamed from `max_by`).
5077 * The [core library][1.6co] is stable, as are most of its APIs.
5078 * [The `assert_eq!` macro supports arguments that don't implement
5079   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5080   `assert!`.
5081 * Several timer functions that take duration in milliseconds [are
5082   deprecated in favor of those that take `Duration`][1.6ms]. These
5083   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5084   `thread::park_timeout_ms`.
5085 * The algorithm by which `Vec` reserves additional elements was
5086   [tweaked to not allocate excessive space][1.6a] while still growing
5087   exponentially.
5088 * `From` conversions are [implemented from integers to floats][1.6f]
5089   in cases where the conversion is lossless. Thus they are not
5090   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5091   or `f64`. They are also not implemented for `isize` and `usize`
5092   because the implementations would be platform-specific. `From` is
5093   also implemented from `f32` to `f64`.
5094 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5095 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5096 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5097 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5098   improvements.
5099 * Sorting slices that are already sorted [is 50% faster in some
5100   cases][1.6s].
5101
5102 Cargo
5103 -----
5104
5105 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5106 * Cargo build scripts can specify their dependencies by emitting the
5107   [`rerun-if-changed`][1.6rr] key.
5108 * crates.io will reject publication of crates with dependencies that
5109   have a wildcard version constraint. Crates with wildcard
5110   dependencies were seen to cause a variety of problems, as described
5111   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5112   warning.
5113 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5114   release folder.  A variety of artifacts that Cargo failed to clean
5115   are now correctly deleted.
5116
5117 Misc
5118 ----
5119
5120 * The `unreachable_code` lint [warns when a function call's argument
5121   diverges][1.6dv].
5122 * The parser indicates [failures that may be caused by
5123   confusingly-similar Unicode characters][1.6uc]
5124 * Certain macro errors [are reported at definition time][1.6m], not
5125   expansion.
5126
5127 Compatibility Notes
5128 -------------------
5129
5130 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5131   environment variable when locating crates. This was a pre-cargo
5132   feature for integrating with the package manager that was
5133   accidentally never removed.
5134 * [A number of bugs were fixed in the privacy checker][1.6p] that
5135   could cause previously-accepted code to break.
5136 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5137 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5138   struct pattern syntax (`Foo(..)`) can no longer be used to match
5139   unit structs. This is a warning now, but will become an error in
5140   future releases. Patterns that share the same name as a const are
5141   now an error.
5142 * A bug was fixed that causes [rustc not to apply default type
5143   parameters][1.6xc] when resolving certain method implementations of
5144   traits defined in other crates.
5145
5146 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5147 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5148 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5149 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5150 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5151 [1.6co]: http://doc.rust-lang.org/core/index.html
5152 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5153 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5154 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5155 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5156 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5157 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5158 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5159 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5160 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5161 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5162 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5163 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5164 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5165 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5166 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5167 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5168 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5169 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5170 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5171 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5172 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5173 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5174 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5175 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5176 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5177 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5178 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5179 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5180 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5181 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5182 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5183 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5184 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5185 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5186 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5187 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5188 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5189 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5190 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5191 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5192 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5193
5194
5195 Version 1.5.0 (2015-12-10)
5196 ==========================
5197
5198 * ~700 changes, numerous bugfixes
5199
5200 Highlights
5201 ----------
5202
5203 * Stabilized APIs:
5204   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5205   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5206   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5207   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5208   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5209   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5210   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5211   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5212   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5213   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5214   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5215   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5216   [`Path::read_link`], [`Path::symlink_metadata`],
5217   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5218   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5219   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5220   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5221   [`slice::split_first_mut`], [`slice::split_first`],
5222   [`slice::split_last_mut`], [`slice::split_last`],
5223   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5224   [`str::MatchIndices`], [`str::RMatchIndices`],
5225   [`str::match_indices`], [`str::rmatch_indices`],
5226   [`str::slice_mut_unchecked`], [`string::ParseError`].
5227 * Rust applications hosted on crates.io can be installed locally to
5228   `~/.cargo/bin` with the [`cargo install`] command. Among other
5229   things this makes it easier to augment Cargo with new subcommands:
5230   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5231   invoked as `cargo foo`.
5232 * Crates with wildcard (`*`) dependencies will [emit warnings when
5233   published][1.5w]. In 1.6 it will no longer be possible to publish
5234   crates with wildcard dependencies.
5235
5236 Breaking Changes
5237 ----------------
5238
5239 * The rules determining when a particular lifetime must outlive
5240   a particular value (known as '[dropck]') have been [modified
5241   to not rely on parametricity][1.5p].
5242 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5243   and `Arc`][1.5a]. Because these smart pointer types implement
5244   `Deref`, this causes breakage in cases where the interior type
5245   contains methods of the same name.
5246 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5247   that they could drop their content. Soundness fix.
5248 * All method invocations are [properly checked][1.5wf1] for
5249   [well-formedness][1.5wf2]. Soundness fix.
5250 * Traits whose supertraits contain `Self` are [not object
5251   safe][1.5o]. Soundness fix.
5252 * Target specifications support a [`no_default_libraries`][1.5nd]
5253   setting that controls whether `-nodefaultlibs` is passed to the
5254   linker, and in turn the `is_like_windows` setting no longer affects
5255   the `-nodefaultlibs` flag.
5256 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5257 * The `#[inline]` and `#[repr]` attributes [can only appear
5258   in valid locations][1.5at].
5259 * Native libraries linked from the local crate are [passed to
5260   the linker before native libraries from upstream crates][1.5nl].
5261 * Two rarely-used attributes, `#[no_debug]` and
5262   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5263 * Negation of unsigned integers, which has been a warning for
5264   several releases, [is now behind a feature gate and will
5265   generate errors][1.5nu].
5266 * The parser accidentally accepted visibility modifiers on
5267   enum variants, a bug [which has been fixed][1.5ev].
5268 * [A bug was fixed that allowed `use` statements to import unstable
5269   features][1.5use].
5270
5271 Language
5272 --------
5273
5274 * When evaluating expressions at compile-time that are not
5275   compile-time constants (const-evaluating expressions in non-const
5276   contexts), incorrect code such as overlong bitshifts and arithmetic
5277   overflow will [generate a warning instead of an error][1.5ce],
5278   delaying the error until runtime. This will allow the
5279   const-evaluator to be expanded in the future backwards-compatibly.
5280 * The `improper_ctypes` lint [no longer warns about using `isize` and
5281   `usize` in FFI][1.5ict].
5282
5283 Libraries
5284 ---------
5285
5286 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5287   invariant][1.5c].
5288 * `Default` is [implemented for mutable slices][1.5d].
5289 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5290 * There are now `From` conversions [between floating point
5291   types][1.5f] where the conversions are lossless.
5292 * There are now `From` conversions [between integer types][1.5i] where
5293   the conversions are lossless.
5294 * [`fs::Metadata` implements `Clone`][1.5fs].
5295 * The `parse` method [accepts a leading "+" when parsing
5296   integers][1.5pi].
5297 * [`AsMut` is implemented for `Vec`][1.5am].
5298 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5299   been optimized][1.5cf] and no longer rely on the default impl.
5300 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5301   `unsafe extern "C"` function types now [implement `Clone`,
5302   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5303   `fmt::Debug` for up to 12 arguments][1.5fp].
5304 * [Dropping `Vec`s is much faster in unoptimized builds when the
5305   element types don't implement `Drop`][1.5dv].
5306 * A bug that caused in incorrect behavior when [combining `VecDeque`
5307   with zero-sized types][1.5vdz] was resolved.
5308 * [`PartialOrd` for slices is faster][1.5po].
5309
5310 Miscellaneous
5311 -------------
5312
5313 * [Crate metadata size was reduced by 20%][1.5md].
5314 * [Improvements to code generation reduced the size of libcore by 3.3
5315   MB and rustc's memory usage by 18MB][1.5m].
5316 * [Improvements to deref translation increased performance in
5317   unoptimized builds][1.5dr].
5318 * Various errors in trait resolution [are deduplicated to only be
5319   reported once][1.5te].
5320 * Rust has preliminary [support for rumprun kernels][1.5rr].
5321 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5322
5323 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5324 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5325 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5326 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5327 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5328 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5329 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5330 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5331 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5332 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5333 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5334 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5335 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5336 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5337 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5338 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5339 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5340 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5341 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5342 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5343 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5344 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5345 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5346 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5347 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5348 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5349 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5350 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5351 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5352 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5353 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5354 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5355 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5356 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5357 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5358 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5359 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5360 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5361 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5362 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5363 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5364 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5365 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5366 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5367 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5368 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5369 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5370 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5371 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5372 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5373 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5374 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5375 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5376 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5377 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5378 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5379 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5380 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5381 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5382 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5383 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5384 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5385 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5386 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5387 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5388 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5389 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5390 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5391 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5392 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5393 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5394 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5395 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5396 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5397 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5398 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5399 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5400 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5401 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5402 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5403 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5404 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5405 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5406 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5407 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5408 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5409 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
5410 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
5411 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
5412
5413 Version 1.4.0 (2015-10-29)
5414 ==========================
5415
5416 * ~1200 changes, numerous bugfixes
5417
5418 Highlights
5419 ----------
5420
5421 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
5422   GNU) are now supported and recommended for use.
5423
5424 Breaking Changes
5425 ----------------
5426
5427 * [Several changes have been made to fix type soundness and improve
5428   the behavior of associated types][sound]. See [RFC 1214]. Although
5429   we have mostly introduced these changes as warnings this release, to
5430   become errors next release, there are still some scenarios that will
5431   see immediate breakage.
5432 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
5433   line breaks in addition to `\n`][crlf].
5434 * [Loans of `'static` lifetime extend to the end of a function][stat].
5435 * [`str::parse` no longer introduces avoidable rounding error when
5436   parsing floating point numbers. Together with earlier changes to
5437   float formatting/output, "round trips" like f.to_string().parse()
5438   now preserve the value of f exactly. Additionally, leading plus
5439   signs are now accepted][fp3].
5440
5441
5442 Language
5443 --------
5444
5445 * `use` statements that import multiple items [can now rename
5446   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
5447 * [Binops work correctly on fat pointers][binfat].
5448 * `pub extern crate`, which does not behave as expected, [issues a
5449   warning][pec] until a better solution is found.
5450
5451 Libraries
5452 ---------
5453
5454 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
5455   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
5456   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
5457   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
5458   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
5459   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
5460   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
5461   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
5462   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
5463   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
5464   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
5465   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
5466   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
5467   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
5468   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
5469   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
5470   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
5471   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
5472   [`thread::sleep`].
5473 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
5474   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
5475   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
5476   `f64::from_str_radix`.
5477 * [Reverse-searching strings is faster with the 'two-way'
5478   algorithm][s].
5479 * [`std::io::copy` allows `?Sized` arguments][cc].
5480 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
5481   [override `count`, `nth` and `last` with an O(1)
5482   implementation][it].
5483 * [`Default` is implemented for arrays up to `[T; 32]`][d].
5484 * [`IntoRawFd` has been added to the Unix-specific prelude,
5485   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
5486   prelude][pr].
5487 * [`Extend<String>` and `FromIterator<String` are both implemented for
5488   `String`][es].
5489 * [`IntoIterator` is implemented for references to `Option` and
5490   `Result`][into2].
5491 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
5492   Copy`][ext] as part of [RFC 839]. This will cause type inference
5493   breakage in rare situations.
5494 * [`BinaryHeap` implements `Debug`][bh2].
5495 * [`Borrow` and `BorrowMut` are implemented for fixed-size
5496   arrays][bm].
5497 * [`extern fn`s with the "Rust" and "C" ABIs implement common
5498   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
5499 * [String comparison is faster][faststr].
5500 * `&mut T` where `T: std::fmt::Write` [also implements
5501   `std::fmt::Write`][mutw].
5502 * [A stable regression in `VecDeque::push_back` and other
5503   capacity-altering methods that caused panics for zero-sized types
5504   was fixed][vd].
5505 * [Function pointers implement traits for up to 12 parameters][fp2].
5506
5507 Miscellaneous
5508 -------------
5509
5510 * The compiler [no longer uses the 'morestack' feature to prevent
5511   stack overflow][mm]. Instead it uses guard pages and stack
5512   probes (though stack probes are not yet implemented on any platform
5513   but Windows).
5514 * [The compiler matches traits faster when projections are involved][p].
5515 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
5516   `usize`][ffi].
5517 * [Cargo now displays useful information about what its doing during
5518   `cargo update`][cu].
5519
5520 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
5521 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
5522 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
5523 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
5524 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
5525 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
5526 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
5527 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
5528 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
5529 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
5530 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
5531 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
5532 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
5533 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
5534 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
5535 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
5536 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
5537 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
5538 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5539 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5540 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5541 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5542 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
5543 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
5544 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
5545 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
5546 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
5547 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
5548 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
5549 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
5550 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
5551 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
5552 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
5553 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
5554 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
5555 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
5556 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
5557 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
5558 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
5559 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
5560 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
5561 [bh2]: https://github.com/rust-lang/rust/pull/28156
5562 [binfat]: https://github.com/rust-lang/rust/pull/28270
5563 [bm]: https://github.com/rust-lang/rust/pull/28197
5564 [cc]: https://github.com/rust-lang/rust/pull/27531
5565 [crlf]: https://github.com/rust-lang/rust/pull/28034
5566 [cu]: https://github.com/rust-lang/cargo/pull/1931
5567 [d]: https://github.com/rust-lang/rust/pull/27825
5568 [dep]: https://github.com/rust-lang/rust/pull/28339
5569 [es]: https://github.com/rust-lang/rust/pull/27956
5570 [ext]: https://github.com/rust-lang/rust/pull/28094
5571 [faststr]: https://github.com/rust-lang/rust/pull/28338
5572 [ffi]: https://github.com/rust-lang/rust/pull/28779
5573 [fp]: https://github.com/rust-lang/rust/pull/28268
5574 [fp2]: https://github.com/rust-lang/rust/pull/28560
5575 [fp3]: https://github.com/rust-lang/rust/pull/27307
5576 [i]: https://github.com/rust-lang/rust/pull/27451
5577 [into2]: https://github.com/rust-lang/rust/pull/28039
5578 [it]: https://github.com/rust-lang/rust/pull/27652
5579 [mm]: https://github.com/rust-lang/rust/pull/27338
5580 [mutw]: https://github.com/rust-lang/rust/pull/28368
5581 [sound]: https://github.com/rust-lang/rust/pull/27641
5582 [p]: https://github.com/rust-lang/rust/pull/27866
5583 [pec]: https://github.com/rust-lang/rust/pull/28486
5584 [pr]: https://github.com/rust-lang/rust/pull/27896
5585 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5586 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5587 [s]: https://github.com/rust-lang/rust/pull/27474
5588 [stab]: https://github.com/rust-lang/rust/pull/28339
5589 [stat]: https://github.com/rust-lang/rust/pull/28321
5590 [vd]: https://github.com/rust-lang/rust/pull/28494
5591
5592 Version 1.3.0 (2015-09-17)
5593 ==============================
5594
5595 * ~900 changes, numerous bugfixes
5596
5597 Highlights
5598 ----------
5599
5600 * The [new object lifetime defaults][nold] have been [turned
5601   on][nold2] after a cycle of warnings about the change. Now types
5602   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
5603   being interpreted as `&'a Box<Trait+'a>` to `&'a
5604   Box<Trait+'static>`.
5605 * [The Rustonomicon][nom] is a new book in the official documentation
5606   that dives into writing unsafe Rust.
5607 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
5608   timekeeping is employed by other std APIs, as well as out-of-tree
5609   time crates.
5610
5611 Breaking Changes
5612 ----------------
5613
5614 * The [new object lifetime defaults][nold] have been [turned
5615   on][nold2] after a cycle of warnings about the change.
5616 * There is a known [regression][lr] in how object lifetime elision is
5617   interpreted, the proper solution for which is undetermined.
5618 * The `#[prelude_import]` attribute, an internal implementation
5619   detail, was accidentally stabilized previously. [It has been put
5620   behind the `prelude_import` feature gate][pi]. This change is
5621   believed to break no existing code.
5622 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5623   [more sane for dynamically sized types][dst3]. Code that relied on
5624   the previous behavior is thought to be broken.
5625 * The `dropck` rules, which checks that destructors can't access
5626   destroyed values, [have been updated][dropck] to match the
5627   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
5628   cause some previously-compiling code to no longer build.
5629
5630 Language
5631 --------
5632
5633 * The [new object lifetime defaults][nold] have been [turned
5634   on][nold2] after a cycle of warnings about the change.
5635 * Semicolons may [now follow types and paths in
5636   macros](https://github.com/rust-lang/rust/pull/27000).
5637 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
5638   [more sane for dynamically sized types][dst3]. Code that relied on
5639   the previous behavior is not known to exist, and suspected to be
5640   broken.
5641 * `'static` variables [may now be recursive][st].
5642 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
5643   implementations correctly.
5644 * The `dropck` rules, which checks that destructors can't access
5645   destroyed values, [have been updated][dropck] to match the
5646   [RFC][dropckrfc].
5647
5648 Libraries
5649 ---------
5650
5651 * The [`Duration`] API, [has been stabilized][ds], as well as the
5652   `std::time` module, which presently contains only `Duration`.
5653 * `Box<str>` and `Box<[T]>` both implement `Clone`.
5654 * The owned C string, [`CString`], implements [`Borrow`] and the
5655   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
5656   these allow C strings to be borrowed and cloned in generic code.
5657 * [`CStr`] implements [`Debug`].
5658 * [`AtomicPtr`] implements [`Debug`].
5659 * [`Error`] trait objects [can be downcast to their concrete types][e]
5660   in many common configurations, using the [`is`], [`downcast`],
5661   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
5662   [`Any`] trait.
5663 * Searching for substrings now [employs the two-way algorithm][search]
5664   instead of doing a naive search. This gives major speedups to a
5665   number of methods, including [`contains`][sc], [`find`][sf],
5666   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
5667   [`ends_with`][sew] are also faster.
5668 * The performance of `PartialEq` for slices is [much faster][ps].
5669 * The [`Hash`] trait offers the default method, [`hash_slice`], which
5670   is overridden and optimized by the implementations for scalars.
5671 * The [`Hasher`] trait now has a number of specialized `write_*`
5672   methods for primitive types, for efficiency.
5673 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
5674   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
5675   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
5676   of [`std::error::Error::cause`][iec] also delegates to the inner
5677   error.
5678 * [`process::Child`][pc] gained the [`id`] method, which returns a
5679   `u32` representing the platform-specific process identifier.
5680 * The [`connect`] method on slices is deprecated, replaced by the new
5681   [`join`] method (note that both of these are on the *unstable*
5682   [`SliceConcatExt`] trait, but through the magic of the prelude are
5683   available to stable code anyway).
5684 * The [`Div`] operator is implemented for [`Wrapping`] types.
5685 * [`DerefMut` is implemented for `String`][dms].
5686 * Performance of SipHash (the default hasher for `HashMap`) is
5687   [better for long data][sh].
5688 * [`AtomicPtr`] implements [`Send`].
5689 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
5690   are now [specialized to use uninitialized buffers for increased
5691   performance][rte].
5692 * Lifetime parameters of foreign functions [are now resolved
5693   properly][f].
5694
5695 Misc
5696 ----
5697
5698 * Rust can now, with some coercion, [produce programs that run on
5699   Windows XP][xp], though XP is not considered a supported platform.
5700 * Porting Rust on Windows from the GNU toolchain to MSVC continues
5701   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
5702   recommended for use in 1.3, though should be fully-functional
5703   in the [64-bit 1.4 beta][b14].
5704 * On Fedora-based systems installation will [properly configure the
5705   dynamic linker][fl].
5706 * The compiler gained many new extended error descriptions, which can
5707   be accessed with the `--explain` flag.
5708 * The `dropck` pass, which checks that destructors can't access
5709   destroyed values, [has been rewritten][dropck]. This fixes some
5710   soundness holes, and as such will cause some previously-compiling
5711   code to no longer build.
5712 * `rustc` now uses [LLVM to write archive files where possible][ar].
5713   Eventually this will eliminate the compiler's dependency on the ar
5714   utility.
5715 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
5716   supported FreeBSD on x86_64).
5717 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5718   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5719   more strict.
5720 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5721   will kill the process instead of leaking][nlp].
5722
5723 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5724 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5725 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5726 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5727 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5728 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5729 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5730 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5731 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5732 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5733 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5734 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5735 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5736 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5737 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5738 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5739 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5740 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5741 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5742 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5743 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5744 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5745 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5746 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5747 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5748 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5749 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5750 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5751 [ar]: https://github.com/rust-lang/rust/pull/26926
5752 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5753 [dms]: https://github.com/rust-lang/rust/pull/26241
5754 [dropck]: https://github.com/rust-lang/rust/pull/27261
5755 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5756 [ds]: https://github.com/rust-lang/rust/pull/26818
5757 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5758 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5759 [dst3]: https://github.com/rust-lang/rust/pull/27351
5760 [e]: https://github.com/rust-lang/rust/pull/24793
5761 [f]: https://github.com/rust-lang/rust/pull/26588
5762 [fb]: https://github.com/rust-lang/rust/pull/26959
5763 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5764 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5765 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5766 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5767 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5768 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5769 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5770 [lic]: https://github.com/rust-lang/rust/pull/26583
5771 [lnu]: https://github.com/rust-lang/rust/pull/27026
5772 [lr]: https://github.com/rust-lang/rust/issues/27248
5773 [lum]: https://github.com/rust-lang/rust/pull/26378
5774 [lur]: https://github.com/rust-lang/rust/pull/26783
5775 [nlp]: https://github.com/rust-lang/rust/pull/27176
5776 [nold2]: https://github.com/rust-lang/rust/pull/27045
5777 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5778 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5779 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5780 [pi]: https://github.com/rust-lang/rust/pull/26699
5781 [ps]: https://github.com/rust-lang/rust/pull/26884
5782 [rte]: https://github.com/rust-lang/rust/pull/26950
5783 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5784 [search]: https://github.com/rust-lang/rust/pull/26327
5785 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5786 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5787 [sh]: https://github.com/rust-lang/rust/pull/27280
5788 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5789 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5790 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5791 [st]: https://github.com/rust-lang/rust/pull/26630
5792 [win1]: https://github.com/rust-lang/rust/pull/26569
5793 [win2]: https://github.com/rust-lang/rust/pull/26741
5794 [win3]: https://github.com/rust-lang/rust/pull/26741
5795 [win4]: https://github.com/rust-lang/rust/pull/27210
5796 [xp]: https://github.com/rust-lang/rust/pull/26569
5797
5798 Version 1.2.0 (2015-08-07)
5799 ==========================
5800
5801 * ~1200 changes, numerous bugfixes
5802
5803 Highlights
5804 ----------
5805
5806 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5807   like `Rc` to contain types without a fixed size, arrays and trait
5808   objects, finally enabling use of `Rc<[T]>` and completing the
5809   implementation of DST.
5810 * [Parallel codegen][parcodegen] is now working again, which can
5811   substantially speed up large builds in debug mode; It also gets
5812   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5813   jobs). It's not enabled by default, but will be "in the near
5814   future". It can be activated with the `-C codegen-units=N` flag to
5815   `rustc`.
5816 * This is the first release with [experimental support for linking
5817   with the MSVC linker and lib C on Windows (instead of using the GNU
5818   variants via MinGW)][win]. It is yet recommended only for the most
5819   intrepid Rustaceans.
5820 * Benchmark compilations are showing a 30% improvement in
5821   bootstrapping over 1.1.
5822
5823 Breaking Changes
5824 ----------------
5825
5826 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5827   unicode case mapping, which is a previously-planned change in
5828   behavior and considered a bugfix.
5829 * [`mem::align_of`] now specifies [the *minimum alignment* for
5830   T][align], which is usually the alignment programs are interested
5831   in, and the same value reported by clang's
5832   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5833   break real code.
5834 * [The `#[packed]` attribute is no longer silently accepted by the
5835   compiler][packed]. This attribute did nothing and code that
5836   mentioned it likely did not work as intended.
5837 * Associated type defaults are [now behind the
5838   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5839   defaults *did not work*, but could be mentioned syntactically. As
5840   such this breakage has minimal impact.
5841
5842 Language
5843 --------
5844
5845 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5846   matching against dereferenceable values.
5847
5848 Libraries
5849 ---------
5850
5851 * The [`Extend`] trait, which grows a collection from an iterator, is
5852   implemented over iterators of references, for `String`, `Vec`,
5853   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5854   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5855 * The [`iter::once`] function returns an iterator that yields a single
5856   element, and [`iter::empty`] returns an iterator that yields no
5857   elements.
5858 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5859   over substring matches.
5860 * [`Cell`] and [`RefCell`] both implement `Eq`.
5861 * A number of methods for wrapping arithmetic are added to the
5862   integral types, [`wrapping_div`], [`wrapping_rem`],
5863   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5864   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5865   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5866   type.. It is illegal for the default arithmetic operations in Rust
5867   to overflow; the desire to wrap must be explicit.
5868 * The `{:#?}` formatting specifier [displays the alternate,
5869   pretty-printed][debugfmt] form of the `Debug` formatter. This
5870   feature was actually introduced prior to 1.0 with little
5871   fanfare.
5872 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5873   for writing data to formatted strings, similar to [`io::Write`].
5874 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5875   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5876   are used by code generators to emit implementations of [`Debug`].
5877 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5878   methods that convert case, following Unicode case mapping.
5879 * It is now easier to handle poisoned locks. The [`PoisonError`]
5880   type, returned by failing lock operations, exposes `into_inner`,
5881   `get_ref`, and `get_mut`, which all give access to the inner lock
5882   guard, and allow the poisoned lock to continue to operate. The
5883   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5884   poisoned lock without attempting to take the lock.
5885 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5886   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5887   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5888   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5889   `ChildStderr`.
5890 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5891   malformed input.
5892
5893 Misc
5894 ----
5895
5896 * `rustc` employs smarter heuristics for guessing at [typos].
5897 * `rustc` emits more efficient code for [no-op conversions between
5898   unsafe pointers][nop].
5899 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5900   resulting in faster compile times and smaller code.
5901
5902 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5903 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5904 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5905 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5906 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5907 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5908 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5909 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5910 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5911 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5912 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5913 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5914 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5915 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5916 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5917 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5918 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5919 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5920 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5921 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5922 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5923 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5924 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5925 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5926 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5927 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5928 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5929 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5930 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5931 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5932 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5933 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5934 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5935 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5936 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5937 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5938 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5939 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5940 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5941 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5942 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5943 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5944 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5945 [align]: https://github.com/rust-lang/rust/pull/25646
5946 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5947 [typos]: https://github.com/rust-lang/rust/pull/26087
5948 [nop]: https://github.com/rust-lang/rust/pull/26336
5949 [fat]: https://github.com/rust-lang/rust/pull/26411
5950 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5951 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5952 [packed]: https://github.com/rust-lang/rust/pull/25541
5953 [ad]: https://github.com/rust-lang/rust/pull/27382
5954 [win]: https://github.com/rust-lang/rust/pull/25350
5955
5956 Version 1.1.0 (2015-06-25)
5957 =========================
5958
5959 * ~850 changes, numerous bugfixes
5960
5961 Highlights
5962 ----------
5963
5964 * The [`std::fs` module has been expanded][fs] to expand the set of
5965   functionality exposed:
5966   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5967     don't incur a syscall on some platforms.
5968   * A `symlink_metadata` function has been added.
5969   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5970     access to all underlying information.
5971 * The compiler now contains extended explanations of many errors. When an error
5972   with an explanation occurs the compiler suggests using the `--explain` flag
5973   to read the explanation. Error explanations are also [available online][err-index].
5974 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5975   well as other work, the time to bootstrap the compiler decreased by
5976   32%.
5977
5978 Libraries
5979 ---------
5980
5981 * The [`str::split_whitespace`] method splits a string on unicode
5982   whitespace boundaries.
5983 * On both Windows and Unix, new extension traits provide conversion of
5984   I/O types to and from the underlying system handles. On Unix, these
5985   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5986   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5987   `TcpListener`, and `UpdSocket`. Further implementations for
5988   `std::process` will be stabilized later.
5989 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5990   Windows, symlinks can be created with
5991   `std::os::windows::symlink_dir` and
5992   `std::os::windows::symlink_file`.
5993 * The `mpsc::Receiver` type can now be converted into an iterator with
5994   `into_iter` on the [`IntoIterator`] trait.
5995 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5996   implementation of the [`From`] trait.
5997 * The `Debug` implementation for `RangeFull` [creates output that is
5998   more consistent with other implementations][rf].
5999 * [`Debug` is implemented for `File`][file].
6000 * The `Default` implementation for `Arc` [no longer requires `Sync +
6001   Send`][arc].
6002 * [The `Iterator` methods `count`, `nth`, and `last` have been
6003   overridden for slices to have O(1) performance instead of O(n)][si].
6004 * Incorrect handling of paths on Windows has been improved in both the
6005   compiler and the standard library.
6006 * [`AtomicPtr` gained a `Default` implementation][ap].
6007 * In accordance with Rust's policy on arithmetic overflow `abs` now
6008   [panics on overflow when debug assertions are enabled][abs].
6009 * The [`Cloned`] iterator, which was accidentally left unstable for
6010   1.0 [has been stabilized][c].
6011 * The [`Incoming`] iterator, which iterates over incoming TCP
6012   connections, and which was accidentally unnamable in 1.0, [is now
6013   properly exported][inc].
6014 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6015   `sift_up` or `sift_down` panic][bh].
6016 * The [`split_off`] method of `LinkedList` [no longer corrupts
6017   the list in certain scenarios][ll].
6018
6019 Misc
6020 ----
6021
6022 * Type checking performance [has improved notably][sk] with
6023   [multiple improvements][pre].
6024 * The compiler [suggests code changes][ch] for more errors.
6025 * rustc and it's build system have experimental support for [building
6026   toolchains against MUSL][m] instead of glibc on Linux.
6027 * The compiler defines the `target_env` cfg value, which is used for
6028   distinguishing toolchains that are otherwise for the same
6029   platform. Presently this is set to `gnu` for common GNU Linux
6030   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6031 * The [`cargo rustc`][crc] command invokes a build with custom flags
6032   to rustc.
6033 * [Android executables are always position independent][pie].
6034 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6035   with `Drop`][drop].
6036
6037 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6038 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6039 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6040 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6041 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6042 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6043 [rf]: https://github.com/rust-lang/rust/pull/24491
6044 [err-index]: https://doc.rust-lang.org/error-index.html
6045 [sk]: https://github.com/rust-lang/rust/pull/24615
6046 [pre]: https://github.com/rust-lang/rust/pull/25323
6047 [file]: https://github.com/rust-lang/rust/pull/24598
6048 [ch]: https://github.com/rust-lang/rust/pull/24683
6049 [arc]: https://github.com/rust-lang/rust/pull/24695
6050 [si]: https://github.com/rust-lang/rust/pull/24701
6051 [ap]: https://github.com/rust-lang/rust/pull/24834
6052 [m]: https://github.com/rust-lang/rust/pull/24777
6053 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6054 [crc]: https://github.com/rust-lang/cargo/pull/1568
6055 [pie]: https://github.com/rust-lang/rust/pull/24953
6056 [abs]: https://github.com/rust-lang/rust/pull/25441
6057 [c]: https://github.com/rust-lang/rust/pull/25496
6058 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6059 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6060 [inc]: https://github.com/rust-lang/rust/pull/25522
6061 [bh]: https://github.com/rust-lang/rust/pull/25856
6062 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6063 [ll]: https://github.com/rust-lang/rust/pull/26022
6064 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6065 [drop]: https://github.com/rust-lang/rust/pull/24935
6066
6067 Version 1.0.0 (2015-05-15)
6068 ========================
6069
6070 * ~1500 changes, numerous bugfixes
6071
6072 Highlights
6073 ----------
6074
6075 * The vast majority of the standard library is now `#[stable]`. It is
6076   no longer possible to use unstable features with a stable build of
6077   the compiler.
6078 * Many popular crates on [crates.io] now work on the stable release
6079   channel.
6080 * Arithmetic on basic integer types now [checks for overflow in debug
6081   builds][overflow].
6082
6083 Language
6084 --------
6085
6086 * Several [restrictions have been added to trait coherence][coh] in
6087   order to make it easier for upstream authors to change traits
6088   without breaking downstream code.
6089 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6090   improve error messages and macro behavior. For example, `0b1234` is
6091   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6092 * Trait bounds [are always invariant][inv], eliminating the need for
6093   the `PhantomFn` and `MarkerTrait` lang items, which have been
6094   removed.
6095 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6096   "foo" as bar` syntax has been replaced with `extern crate foo as
6097   bar`, and Cargo now automatically translates "-" in *package* names
6098   to underscore for the crate name.
6099 * [Lifetime shadowing is an error][lt].
6100 * [`Send` no longer implies `'static`][send-rfc].
6101 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6102   `MyType::default()`.
6103 * Primitive types [now have inherent methods][prim-inherent],
6104   obviating the need for extension traits like `SliceExt`.
6105 * Methods with `Self: Sized` in their `where` clause are [considered
6106   object-safe][self-sized], allowing many extension traits like
6107   `IteratorExt` to be merged into the traits they extended.
6108 * You can now [refer to associated types][assoc-where] whose
6109   corresponding trait bounds appear only in a `where` clause.
6110 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6111   like `Send` and `Sync` are now library-defined.
6112 * A [Reflect trait][reflect] was introduced, which means that
6113   downcasting via the `Any` trait is effectively limited to concrete
6114   types. This helps retain the potentially-important "parametricity"
6115   property: generic code cannot behave differently for different type
6116   arguments except in minor ways.
6117 * The `unsafe_destructor` feature is now deprecated in favor of the
6118   [new `dropck`][dropck]. This change is a major reduction in unsafe
6119   code.
6120
6121 Libraries
6122 ---------
6123
6124 * The `thread_local` module [has been renamed to `std::thread`][th].
6125 * The methods of `IteratorExt` [have been moved to the `Iterator`
6126   trait itself][ie].
6127 * Several traits that implement Rust's conventions for type
6128   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6129   [centralized in the `std::convert` module][con].
6130 * The `FromError` trait [was removed in favor of `From`][fe].
6131 * The basic sleep function [has moved to
6132   `std::thread::sleep_ms`][slp].
6133 * The `splitn` function now takes an `n` parameter that represents the
6134   number of items yielded by the returned iterator [instead of the
6135   number of 'splits'][spl].
6136 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6137 * [Derived implementations of `PartialOrd` now order enums according
6138   to their explicitly-assigned discriminants][po].
6139 * [Methods for searching strings are generic over `Pattern`s][pat],
6140   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6141   some others.
6142 * [In method resolution, object methods are resolved before inherent
6143   methods][meth].
6144 * [`String::from_str` has been deprecated in favor of the `From` impl,
6145   `String::from`][sf].
6146 * [`io::Error` implements `Sync`][ios].
6147 * [The `words` method on `&str` has been replaced with
6148   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6149   a word?'
6150 * The new path and IO modules are complete and `#[stable]`. This
6151   was the major library focus for this cycle.
6152 * The path API was [revised][path-normalize] to normalize `.`,
6153   adjusting the tradeoffs in favor of the most common usage.
6154 * A large number of remaining APIs in `std` were also stabilized
6155   during this cycle; about 75% of the non-deprecated API surface
6156   is now stable.
6157 * The new [string pattern API][string-pattern] landed, which makes
6158   the string slice API much more internally consistent and flexible.
6159 * A new set of [generic conversion traits][conversion] replaced
6160   many existing ad hoc traits.
6161 * Generic numeric traits were [completely removed][num-traits]. This
6162   was made possible thanks to inherent methods for primitive types,
6163   and the removal gives maximal flexibility for designing a numeric
6164   hierarchy in the future.
6165 * The `Fn` traits are now related via [inheritance][fn-inherit]
6166   and provide ergonomic [blanket implementations][fn-blanket].
6167 * The `Index` and `IndexMut` traits were changed to
6168   [take the index by value][index-value], enabling code like
6169   `hash_map["string"]` to work.
6170 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6171   `Copy` data is known to be `Clone` as well.
6172
6173 Misc
6174 ----
6175
6176 * Many errors now have extended explanations that can be accessed with
6177   the `--explain` flag to `rustc`.
6178 * Many new examples have been added to the standard library
6179   documentation.
6180 * rustdoc has received a number of improvements focused on completion
6181   and polish.
6182 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6183 * Much headway was made on ecosystem-wide CI, making it possible
6184   to [compare builds for breakage][ci-compare].
6185
6186
6187 [crates.io]: http://crates.io
6188 [clo]: https://github.com/rust-lang/rust/pull/24034
6189 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6190 [con]: https://github.com/rust-lang/rust/pull/23875
6191 [cr]: https://github.com/rust-lang/rust/pull/23419
6192 [fe]: https://github.com/rust-lang/rust/pull/23879
6193 [ie]: https://github.com/rust-lang/rust/pull/23300
6194 [inv]: https://github.com/rust-lang/rust/pull/23938
6195 [ios]: https://github.com/rust-lang/rust/pull/24133
6196 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6197 [lt]: https://github.com/rust-lang/rust/pull/24057
6198 [meth]: https://github.com/rust-lang/rust/pull/24056
6199 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6200 [po]: https://github.com/rust-lang/rust/pull/24270
6201 [sf]: https://github.com/rust-lang/rust/pull/24517
6202 [slp]: https://github.com/rust-lang/rust/pull/23949
6203 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6204 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6205 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6206 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6207 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6208 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6209 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6210 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6211 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6212 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6213 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6214 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6215 [reflect]: https://github.com/rust-lang/rust/pull/23712
6216 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6217 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6218 [index-value]: https://github.com/rust-lang/rust/pull/23601
6219 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6220 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6221 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6222 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6223 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6224 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6225
6226
6227 Version 1.0.0-alpha.2 (2015-02-20)
6228 =====================================
6229
6230 * ~1300 changes, numerous bugfixes
6231
6232 * Highlights
6233
6234     * The various I/O modules were [overhauled][io-rfc] to reduce
6235       unnecessary abstractions and provide better interoperation with
6236       the underlying platform. The old `io` module remains temporarily
6237       at `std::old_io`.
6238     * The standard library now [participates in feature gating][feat],
6239       so use of unstable libraries now requires a `#![feature(...)]`
6240       attribute. The impact of this change is [described on the
6241       forum][feat-forum]. [RFC][feat-rfc].
6242
6243 * Language
6244
6245     * `for` loops [now operate on the `IntoIterator` trait][into],
6246       which eliminates the need to call `.iter()`, etc. to iterate
6247       over collections. There are some new subtleties to remember
6248       though regarding what sort of iterators various types yield, in
6249       particular that `for foo in bar { }` yields values from a move
6250       iterator, destroying the original collection. [RFC][into-rfc].
6251     * Objects now have [default lifetime bounds][obj], so you don't
6252       have to write `Box<Trait+'static>` when you don't care about
6253       storing references. [RFC][obj-rfc].
6254     * In types that implement `Drop`, [lifetimes must outlive the
6255       value][drop]. This will soon make it possible to safely
6256       implement `Drop` for types where `#[unsafe_destructor]` is now
6257       required. Read the [gorgeous RFC][drop-rfc] for details.
6258     * The fully qualified <T as Trait>::X syntax lets you set the Self
6259       type for a trait method or associated type. [RFC][ufcs-rfc].
6260     * References to types that implement `Deref<U>` now [automatically
6261       coerce to references][deref] to the dereferenced type `U`,
6262       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6263       should eliminate many unsightly uses of `&*`, as when converting
6264       from references to vectors into references to
6265       slices. [RFC][deref-rfc].
6266     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6267       `|:|`) is obsolete and closure kind is inferred from context.
6268     * [`Self` is a keyword][Self].
6269
6270 * Libraries
6271
6272     * The `Show` and `String` formatting traits [have been
6273       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6274       their related purposes. Automatically getting a string
6275       conversion to use with `format!("{:?}", something_to_debug)` is
6276       now written `#[derive(Debug)]`.
6277     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6278       OsStr}`, provide strings in platform-specific encodings for easier
6279       interop with system APIs. [RFC][osstr-rfc].
6280     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6281       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6282       creating raw pointers.
6283
6284 * Tooling
6285
6286     * Certain long error messages of the form 'expected foo found bar'
6287       are now [split neatly across multiple
6288       lines][multiline]. Examples in the PR.
6289     * On Unix Rust can be [uninstalled][un] by running
6290       `/usr/local/lib/rustlib/uninstall.sh`.
6291     * The `#[rustc_on_unimplemented]` attribute, requiring the
6292       'on_unimplemented' feature, lets rustc [display custom error
6293       messages when a trait is expected to be implemented for a type
6294       but is not][onun].
6295
6296 * Misc
6297
6298     * Rust is tested against a [LALR grammar][lalr], which parses
6299       almost all the Rust files that rustc does.
6300
6301 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6302 [close]: https://github.com/rust-lang/rust/pull/21843
6303 [deref]: https://github.com/rust-lang/rust/pull/21351
6304 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6305 [drop]: https://github.com/rust-lang/rust/pull/21972
6306 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6307 [feat]: https://github.com/rust-lang/rust/pull/21248
6308 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6309 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6310 [fmt]: https://github.com/rust-lang/rust/pull/21457
6311 [into]: https://github.com/rust-lang/rust/pull/20790
6312 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6313 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6314 [lalr]: https://github.com/rust-lang/rust/pull/21452
6315 [multiline]: https://github.com/rust-lang/rust/pull/19870
6316 [obj]: https://github.com/rust-lang/rust/pull/22230
6317 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6318 [onun]: https://github.com/rust-lang/rust/pull/20889
6319 [osstr]: https://github.com/rust-lang/rust/pull/21488
6320 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6321 [Self]: https://github.com/rust-lang/rust/pull/22158
6322 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6323 [un]: https://github.com/rust-lang/rust/pull/22256
6324
6325
6326 Version 1.0.0-alpha (2015-01-09)
6327 ==================================
6328
6329   * ~2400 changes, numerous bugfixes
6330
6331   * Highlights
6332
6333     * The language itself is considered feature complete for 1.0,
6334       though there will be many usability improvements and bugfixes
6335       before the final release.
6336     * Nearly 50% of the public API surface of the standard library has
6337       been declared 'stable'. Those interfaces are unlikely to change
6338       before 1.0.
6339     * The long-running debate over integer types has been
6340       [settled][ints]: Rust will ship with types named `isize` and
6341       `usize`, rather than `int` and `uint`, for pointer-sized
6342       integers. Guidelines will be rolled out during the alpha cycle.
6343     * Most crates that are not `std` have been moved out of the Rust
6344       distribution into the Cargo ecosystem so they can evolve
6345       separately and don't need to be stabilized as quickly, including
6346       'time', 'getopts', 'num', 'regex', and 'term'.
6347     * Documentation continues to be expanded with more API coverage, more
6348       examples, and more in-depth explanations. The guides have been
6349       consolidated into [The Rust Programming Language][trpl].
6350     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6351     * All official Rust binary installers now come with [Cargo], the
6352       Rust package manager.
6353
6354 * Language
6355
6356     * Closures have been [completely redesigned][unboxed] to be
6357       implemented in terms of traits, can now be used as generic type
6358       bounds and thus monomorphized and inlined, or via an opaque
6359       pointer (boxed) as in the old system. The new system is often
6360       referred to as 'unboxed' closures.
6361     * Traits now support [associated types][assoc], allowing families
6362       of related types to be defined together and used generically in
6363       powerful ways.
6364     * Enum variants are [namespaced by their type names][enum].
6365     * [`where` clauses][where] provide a more versatile and attractive
6366       syntax for specifying generic bounds, though the previous syntax
6367       remains valid.
6368     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6369       numeric types.
6370     * Rust [no longer has a runtime][rt] of any description, and only
6371       supports OS threads, not green threads.
6372     * At long last, Rust has been overhauled for 'dynamically-sized
6373       types' ([DST]), which integrates 'fat pointers' (object types,
6374       arrays, and `str`) more deeply into the type system, making it
6375       more consistent.
6376     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6377       `..j` that produce range types and which, when combined with the
6378       `Index` operator and multidispatch, leads to a convenient slice
6379       notation, `[i..j]`.
6380     * The new range syntax revealed an ambiguity in the fixed-length
6381       array syntax, so now fixed length arrays [are written `[T;
6382       N]`][arrays].
6383     * The `Copy` trait is no longer implemented automatically. Unsafe
6384       pointers no longer implement `Sync` and `Send` so types
6385       containing them don't automatically either. `Sync` and `Send`
6386       are now 'unsafe traits' so one can "forcibly" implement them via
6387       `unsafe impl` if a type confirms to the requirements for them
6388       even though the internals do not (e.g. structs containing unsafe
6389       pointers like `Arc`). These changes are intended to prevent some
6390       footguns and are collectively known as [opt-in built-in
6391       traits][oibit] (though `Sync` and `Send` will soon become pure
6392       library types unknown to the compiler).
6393     * Operator traits now take their operands [by value][ops], and
6394       comparison traits can use multidispatch to compare one type
6395       against multiple other types, allowing e.g. `String` to be
6396       compared with `&str`.
6397     * `if let` and `while let` are no longer feature-gated.
6398     * Rust has adopted a more [uniform syntax for escaping unicode
6399       characters][unicode].
6400     * `macro_rules!` [has been declared stable][mac]. Though it is a
6401       flawed system it is sufficiently popular that it must be usable
6402       for 1.0. Effort has gone into [future-proofing][mac-future] it
6403       in ways that will allow other macro systems to be developed in
6404       parallel, and won't otherwise impact the evolution of the
6405       language.
6406     * The prelude has been [pared back significantly][prelude] such
6407       that it is the minimum necessary to support the most pervasive
6408       code patterns, and through [generalized where clauses][where]
6409       many of the prelude extension traits have been consolidated.
6410     * Rust's rudimentary reflection [has been removed][refl], as it
6411       incurred too much code generation for little benefit.
6412     * [Struct variants][structvars] are no longer feature-gated.
6413     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
6414       known as 'higher-ranked trait bounds', this crucially allows
6415       unboxed closures to work.
6416     * Macros invocations surrounded by parens or square brackets and
6417       not terminated by a semicolon are [parsed as
6418       expressions][macros], which makes expressions like `vec![1i32,
6419       2, 3].len()` work as expected.
6420     * Trait objects now implement their traits automatically, and
6421       traits that can be coerced to objects now must be [object
6422       safe][objsafe].
6423     * Automatically deriving traits is now done with `#[derive(...)]`
6424       not `#[deriving(...)]` for [consistency with other naming
6425       conventions][derive].
6426     * Importing the containing module or enum at the same time as
6427       items or variants they contain is [now done with `self` instead
6428       of `mod`][self], as in use `foo::{self, bar}`
6429     * Glob imports are no longer feature-gated.
6430     * The `box` operator and `box` patterns have been feature-gated
6431       pending a redesign. For now unique boxes should be allocated
6432       like other containers, with `Box::new`.
6433
6434 * Libraries
6435
6436     * A [series][coll1] of [efforts][coll2] to establish
6437       [conventions][coll3] for collections types has resulted in API
6438       improvements throughout the standard library.
6439     * New [APIs for error handling][err] provide ergonomic interop
6440       between error types, and [new conventions][err-conv] describe
6441       more clearly the recommended error handling strategies in Rust.
6442     * The `fail!` macro has been renamed to [`panic!`][panic] so that
6443       it is easier to discuss failure in the context of error handling
6444       without making clarifications as to whether you are referring to
6445       the 'fail' macro or failure more generally.
6446     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
6447       syscall when available.
6448     * The 'serialize' crate has been renamed 'rustc-serialize' and
6449       moved out of the distribution to Cargo. Although it is widely
6450       used now, it is expected to be superseded in the near future.
6451     * The `Show` formatter, typically implemented with
6452       `#[derive(Show)]` is [now requested with the `{:?}`
6453       specifier][show] and is intended for use by all types, for uses
6454       such as `println!` debugging. The new `String` formatter must be
6455       implemented by hand, uses the `{}` specifier, and is intended
6456       for full-fidelity conversions of things that can logically be
6457       represented as strings.
6458
6459 * Tooling
6460
6461     * [Flexible target specification][flex] allows rustc's code
6462       generation to be configured to support otherwise-unsupported
6463       platforms.
6464     * Rust comes with rust-gdb and rust-lldb scripts that launch their
6465       respective debuggers with Rust-appropriate pretty-printing.
6466     * The Windows installation of Rust is distributed with the
6467       MinGW components currently required to link binaries on that
6468       platform.
6469
6470 * Misc
6471
6472     * Nullable enum optimizations have been extended to more types so
6473       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
6474       space than the inner types themselves.
6475     * Work has begun on supporting AArch64.
6476
6477 [Cargo]: https://crates.io
6478 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
6479 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
6480 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
6481 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
6482 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
6483 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
6484 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
6485 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
6486 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
6487 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
6488 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
6489 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
6490 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
6491 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
6492 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
6493 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
6494 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
6495 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
6496 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
6497 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
6498 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
6499 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
6500 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
6501 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
6502 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
6503 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
6504 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
6505 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
6506 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
6507 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
6508 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
6509 [trpl]: https://doc.rust-lang.org/book/index.html
6510 [rbe]: http://rustbyexample.com/
6511
6512
6513 Version 0.12.0 (2014-10-09)
6514 =============================
6515
6516   * ~1900 changes, numerous bugfixes
6517
6518   * Highlights
6519
6520     * The introductory documentation (now called The Rust Guide) has
6521       been completely rewritten, as have a number of supplementary
6522       guides.
6523     * Rust's package manager, Cargo, continues to improve and is
6524       sometimes considered to be quite awesome.
6525     * Many API's in `std` have been reviewed and updated for
6526       consistency with the in-development Rust coding
6527       guidelines. The standard library documentation tracks
6528       stabilization progress.
6529     * Minor libraries have been moved out-of-tree to the rust-lang org
6530       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
6531       be installed with Cargo.
6532     * Lifetime elision allows lifetime annotations to be left off of
6533       function declarations in many common scenarios.
6534     * Rust now works on 64-bit Windows.
6535
6536   * Language
6537     * Indexing can be overloaded with the `Index` and `IndexMut`
6538       traits.
6539     * The `if let` construct takes a branch only if the `let` pattern
6540       matches, currently behind the 'if_let' feature gate.
6541     * 'where clauses', a more flexible syntax for specifying trait
6542       bounds that is more aesthetic, have been added for traits and
6543       free functions. Where clauses will in the future make it
6544       possible to constrain associated types, which would be
6545       impossible with the existing syntax.
6546     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
6547       the 'slicing_syntax' feature gate, and can be overloaded with
6548       the `Slice` or `SliceMut` traits.
6549     * The syntax for matching of sub-slices has been changed to use a
6550       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
6551       consistency with other uses of `..` and to future-proof
6552       potential additional uses of the syntax.
6553     * The syntax for matching inclusive ranges in patterns has changed
6554       from `0..3` to `0...4` to be consistent with the exclusive range
6555       syntax for slicing.
6556     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
6557       c]`) has been put behind the 'advanced_slice_patterns' feature
6558       gate and may be removed in the future.
6559     * Components of tuples and tuple structs can be extracted using
6560       the `value.0` syntax, currently behind the `tuple_indexing`
6561       feature gate.
6562     * The `#[crate_id]` attribute is no longer supported; versioning
6563       is handled by the package manager.
6564     * Renaming crate imports are now written `extern crate foo as bar`
6565       instead of `extern crate bar = foo`.
6566     * Renaming use statements are now written `use foo as bar` instead
6567       of `use bar = foo`.
6568     * `let` and `match` bindings and argument names in macros are now
6569       hygienic.
6570     * The new, more efficient, closure types ('unboxed closures') have
6571       been added under a feature gate, 'unboxed_closures'. These will
6572       soon replace the existing closure types, once higher-ranked
6573       trait lifetimes are added to the language.
6574     * `move` has been added as a keyword, for indicating closures
6575       that capture by value.
6576     * Mutation and assignment is no longer allowed in pattern guards.
6577     * Generic structs and enums can now have trait bounds.
6578     * The `Share` trait is now called `Sync` to free up the term
6579       'shared' to refer to 'shared reference' (the default reference
6580       type.
6581     * Dynamically-sized types have been mostly implemented,
6582       unifying the behavior of fat-pointer types with the rest of the
6583       type system.
6584     * As part of dynamically-sized types, the `Sized` trait has been
6585       introduced, which qualifying types implement by default, and
6586       which type parameters expect by default. To specify that a type
6587       parameter does not need to be sized, write `<Sized? T>`. Most
6588       types are `Sized`, notable exceptions being unsized arrays
6589       (`[T]`) and trait types.
6590     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
6591     * Lifetime bounds can now be applied to type parameters and object
6592       types.
6593     * The old, reference counted GC type, `Gc<T>` which was once
6594       denoted by the `@` sigil, has finally been removed. GC will be
6595       revisited in the future.
6596
6597   * Libraries
6598     * Library documentation has been improved for a number of modules.
6599     * Bit-vectors, collections::bitv has been modernized.
6600     * The url crate is deprecated in favor of
6601       http://github.com/servo/rust-url, which can be installed with
6602       Cargo.
6603     * Most I/O stream types can be cloned and subsequently closed from
6604       a different thread.
6605     * A `std::time::Duration` type has been added for use in I/O
6606       methods that rely on timers, as well as in the 'time' crate's
6607       `Timespec` arithmetic.
6608     * The runtime I/O abstraction layer that enabled the green thread
6609       scheduler to do non-thread-blocking I/O has been removed, along
6610       with the libuv-based implementation employed by the green thread
6611       scheduler. This will greatly simplify the future I/O work.
6612     * `collections::btree` has been rewritten to have a more
6613       idiomatic and efficient design.
6614
6615   * Tooling
6616     * rustdoc output now indicates the stability levels of API's.
6617     * The `--crate-name` flag can specify the name of the crate
6618       being compiled, like `#[crate_name]`.
6619     * The `-C metadata` specifies additional metadata to hash into
6620       symbol names, and `-C extra-filename` specifies additional
6621       information to put into the output filename, for use by the
6622       package manager for versioning.
6623     * debug info generation has continued to improve and should be
6624       more reliable under both gdb and lldb.
6625     * rustc has experimental support for compiling in parallel
6626       using the `-C codegen-units` flag.
6627     * rustc no longer encodes rpath information into binaries by
6628       default.
6629
6630   * Misc
6631     * Stack usage has been optimized with LLVM lifetime annotations.
6632     * Official Rust binaries on Linux are more compatible with older
6633       kernels and distributions, built on CentOS 5.10.
6634
6635
6636 Version 0.11.0 (2014-07-02)
6637 ==========================
6638
6639   * ~1700 changes, numerous bugfixes
6640
6641   * Language
6642     * ~[T] has been removed from the language. This type is superseded by
6643       the Vec<T> type.
6644     * ~str has been removed from the language. This type is superseded by
6645       the String type.
6646     * ~T has been removed from the language. This type is superseded by the
6647       Box<T> type.
6648     * @T has been removed from the language. This type is superseded by the
6649       standard library's std::gc::Gc<T> type.
6650     * Struct fields are now all private by default.
6651     * Vector indices and shift amounts are both required to be a `uint`
6652       instead of any integral type.
6653     * Byte character, byte string, and raw byte string literals are now all
6654       supported by prefixing the normal literal with a `b`.
6655     * Multiple ABIs are no longer allowed in an ABI string
6656     * The syntax for lifetimes on closures/procedures has been tweaked
6657       slightly: `<'a>|A, B|: 'b + K -> T`
6658     * Floating point modulus has been removed from the language; however it
6659       is still provided by a library implementation.
6660     * Private enum variants are now disallowed.
6661     * The `priv` keyword has been removed from the language.
6662     * A closure can no longer be invoked through a &-pointer.
6663     * The `use foo, bar, baz;` syntax has been removed from the language.
6664     * The transmute intrinsic no longer works on type parameters.
6665     * Statics now allow blocks/items in their definition.
6666     * Trait bounds are separated from objects with + instead of : now.
6667     * Objects can no longer be read while they are mutably borrowed.
6668     * The address of a static is now marked as insignificant unless the
6669       #[inline(never)] attribute is placed it.
6670     * The #[unsafe_destructor] attribute is now behind a feature gate.
6671     * Struct literals are no longer allowed in ambiguous positions such as
6672       if, while, match, and for..in.
6673     * Declaration of lang items and intrinsics are now feature-gated by
6674       default.
6675     * Integral literals no longer default to `int`, and floating point
6676       literals no longer default to `f64`. Literals must be suffixed with an
6677       appropriate type if inference cannot determine the type of the
6678       literal.
6679     * The Box<T> type is no longer implicitly borrowed to &mut T.
6680     * Procedures are now required to not capture borrowed references.
6681
6682   * Libraries
6683     * The standard library is now a "facade" over a number of underlying
6684       libraries. This means that development on the standard library should
6685       be speedier due to smaller crates, as well as a clearer line between
6686       all dependencies.
6687     * A new library, libcore, lives under the standard library's facade
6688       which is Rust's "0-assumption" library, suitable for embedded and
6689       kernel development for example.
6690     * A regex crate has been added to the standard distribution. This crate
6691       includes statically compiled regular expressions.
6692     * The unwrap/unwrap_err methods on Result require a Show bound for
6693       better error messages.
6694     * The return types of the std::comm primitives have been centralized
6695       around the Result type.
6696     * A number of I/O primitives have gained the ability to time out their
6697       operations.
6698     * A number of I/O primitives have gained the ability to close their
6699       reading/writing halves to cancel pending operations.
6700     * Reverse iterator methods have been removed in favor of `rev()` on
6701       their forward-iteration counterparts.
6702     * A bitflags! macro has been added to enable easy interop with C and
6703       management of bit flags.
6704     * A debug_assert! macro is now provided which is disabled when
6705       `--cfg ndebug` is passed to the compiler.
6706     * A graphviz crate has been added for creating .dot files.
6707     * The std::cast module has been migrated into std::mem.
6708     * The std::local_data api has been migrated from freestanding functions
6709       to being based on methods.
6710     * The Pod trait has been renamed to Copy.
6711     * jemalloc has been added as the default allocator for types.
6712     * The API for allocating memory has been changed to use proper alignment
6713       and sized deallocation
6714     * Connecting a TcpStream or binding a TcpListener is now based on a
6715       string address and a u16 port. This allows connecting to a hostname as
6716       opposed to an IP.
6717     * The Reader trait now contains a core method, read_at_least(), which
6718       correctly handles many repeated 0-length reads.
6719     * The process-spawning API is now centered around a builder-style
6720       Command struct.
6721     * The :? printing qualifier has been moved from the standard library to
6722       an external libdebug crate.
6723     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6724       have been renamed to Eq/Ord.
6725     * The select/plural methods have been removed from format!. The escapes
6726       for { and } have also changed from \{ and \} to {{ and }},
6727       respectively.
6728     * The TaskBuilder API has been re-worked to be a true builder, and
6729       extension traits for spawning native/green tasks have been added.
6730
6731   * Tooling
6732     * All breaking changes to the language or libraries now have their
6733       commit message annotated with `[breaking-change]` to allow for easy
6734       discovery of breaking changes.
6735     * The compiler will now try to suggest how to annotate lifetimes if a
6736       lifetime-related error occurs.
6737     * Debug info continues to be improved greatly with general bug fixes and
6738       better support for situations like link time optimization (LTO).
6739     * Usage of syntax extensions when cross-compiling has been fixed.
6740     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6741       -fdata-sections and --gc-sections has been enabled by default
6742     * The compiler is now stricter about where it will load module files
6743       from when a module is declared via `mod foo;`.
6744     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6745       Syntax extensions are now discovered via a "plugin registrar" type
6746       which will be extended in the future to other various plugins.
6747     * Lints have been restructured to allow for dynamically loadable lints.
6748     * A number of rustdoc improvements:
6749       * The HTML output has been visually redesigned.
6750       * Markdown is now powered by hoedown instead of sundown.
6751       * Searching heuristics have been greatly improved.
6752       * The search index has been reduced in size by a great amount.
6753       * Cross-crate documentation via `pub use` has been greatly improved.
6754       * Primitive types are now hyperlinked and documented.
6755     * Documentation has been moved from static.rust-lang.org/doc to
6756       doc.rust-lang.org
6757     * A new sandbox, play.rust-lang.org, is available for running and
6758       sharing rust code examples on-line.
6759     * Unused attributes are now more robustly warned about.
6760     * The dead_code lint now warns about unused struct fields.
6761     * Cross-compiling to iOS is now supported.
6762     * Cross-compiling to mipsel is now supported.
6763     * Stability attributes are now inherited by default and no longer apply
6764       to intra-crate usage, only inter-crate usage.
6765     * Error message related to non-exhaustive match expressions have been
6766       greatly improved.
6767
6768
6769 Version 0.10 (2014-04-03)
6770 =========================
6771
6772   * ~1500 changes, numerous bugfixes
6773
6774   * Language
6775     * A new RFC process is now in place for modifying the language.
6776     * Patterns with `@`-pointers have been removed from the language.
6777     * Patterns with unique vectors (`~[T]`) have been removed from the
6778       language.
6779     * Patterns with unique strings (`~str`) have been removed from the
6780       language.
6781     * `@str` has been removed from the language.
6782     * `@[T]` has been removed from the language.
6783     * `@self` has been removed from the language.
6784     * `@Trait` has been removed from the language.
6785     * Headers on `~` allocations which contain `@` boxes inside the type for
6786       reference counting have been removed.
6787     * The semantics around the lifetimes of temporary expressions have changed,
6788       see #3511 and #11585 for more information.
6789     * Cross-crate syntax extensions are now possible, but feature gated. See
6790       #11151 for more information. This includes both `macro_rules!` macros as
6791       well as syntax extensions such as `format!`.
6792     * New lint modes have been added, and older ones have been turned on to be
6793       warn-by-default.
6794       * Unnecessary parentheses
6795       * Uppercase statics
6796       * Camel Case types
6797       * Uppercase variables
6798       * Publicly visible private types
6799       * `#[deriving]` with raw pointers
6800     * Unsafe functions can no longer be coerced to closures.
6801     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6802     * The `#[simd]` attribute is now behind a feature gate.
6803     * Visibility is no longer allowed on `extern crate` statements, and
6804       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6805     * Trailing commas are now allowed in argument lists and tuple patterns.
6806     * The `do` keyword has been removed, it is now a reserved keyword.
6807     * Default type parameters have been implemented, but are feature gated.
6808     * Borrowed variables through captures in closures are now considered soundly.
6809     * `extern mod` is now `extern crate`
6810     * The `Freeze` trait has been removed.
6811     * The `Share` trait has been added for types that can be shared among
6812       threads.
6813     * Labels in macros are now hygienic.
6814     * Expression/statement macro invocations can be delimited with `{}` now.
6815     * Treatment of types allowed in `static mut` locations has been tweaked.
6816     * The `*` and `.` operators are now overloadable through the `Deref` and
6817       `DerefMut` traits.
6818     * `~Trait` and `proc` no longer have `Send` bounds by default.
6819     * Partial type hints are now supported with the `_` type marker.
6820     * An `Unsafe` type was introduced for interior mutability. It is now
6821       considered undefined to transmute from `&T` to `&mut T` without using the
6822       `Unsafe` type.
6823     * The #[linkage] attribute was implemented for extern statics/functions.
6824     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6825     * `Pod` was renamed to `Copy`.
6826
6827   * Libraries
6828     * The `libextra` library has been removed. It has now been decomposed into
6829       component libraries with smaller and more focused nuggets of
6830       functionality. The full list of libraries can be found on the
6831       documentation index page.
6832     * std: `std::condition` has been removed. All I/O errors are now propagated
6833       through the `Result` type. In order to assist with error handling, a
6834       `try!` macro for unwrapping errors with an early return and a lint for
6835       unused results has been added. See #12039 for more information.
6836     * std: The `vec` module has been renamed to `slice`.
6837     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6838       This will become the only growable vector in the future.
6839     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6840       are now found at `std::io::BufferedReader` instead of
6841       `std::io::buffered::BufferedReader`.
6842     * std: `print` and `println` are no longer in the prelude, the `print!` and
6843       `println!` macros are intended to be used instead.
6844     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6845       attempts to statically prevent cycles.
6846     * std: The standard distribution is adopting the policy of pushing failure
6847       to the user rather than failing in libraries. Many functions (such as
6848       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6849     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6850       deriving mode: `#[deriving(Show)]`.
6851     * std: `ToStr` is now implemented for all types implementing `Show`.
6852     * std: The formatting trait methods now take `&self` instead of `&T`
6853     * std: The `invert()` method on iterators has been renamed to `rev()`
6854     * std: `std::num` has seen a reduction in the genericity of its traits,
6855       consolidating functionality into a few core traits.
6856     * std: Backtraces are now printed on task failure if the environment
6857       variable `RUST_BACKTRACE` is present.
6858     * std: Naming conventions for iterators have been standardized. More details
6859       can be found on the wiki's style guide.
6860     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6861       still implement the function.
6862     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6863     * std: `assert_approx_eq!` has been removed
6864     * std: The `e` and `E` formatting specifiers for floats have been added to
6865       print them in exponential notation.
6866     * std: The `Times` trait has been removed
6867     * std: Indications of variance and opting out of builtin bounds is done
6868       through marker types in `std::kinds::marker` now
6869     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6870       `#[deriving(Hash)]` is now possible.
6871     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6872     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6873     * std: `Chan::new` is now `channel()`.
6874     * std: A new synchronous channel type has been implemented.
6875     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6876     * std: `hashmap` and `trie` have been moved to `libcollections`
6877     * std: `run` has been rolled into `io::process`
6878     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6879     * std: The equality and comparison traits have seen some reorganization.
6880     * std: `rand` has moved to `librand`.
6881     * std: `to_{lower,upper}case` has been implemented for `char`.
6882     * std: Logging has been moved to `liblog`.
6883     * collections: `HashMap` has been rewritten for higher performance and less
6884       memory usage.
6885     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6886       it can be booted manually. The runtime guide has more information and
6887       examples.
6888     * native: All I/O functionality except signals has been implemented.
6889     * green: Task spawning with `libgreen` has been optimized with stack caching
6890       and various trimming of code.
6891     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6892     * sync: The `extra::sync` module has been updated to modern rust (and moved
6893       to the `sync` library), tweaking and improving various interfaces while
6894       dropping redundant functionality.
6895     * sync: A new `Barrier` type has been added to the `sync` library.
6896     * sync: An efficient mutex for native and green tasks has been implemented.
6897     * serialize: The `base64` module has seen some improvement. It treats
6898       newlines better, has non-string error values, and has seen general
6899       cleanup.
6900     * fourcc: A `fourcc!` macro was introduced
6901     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6902       hexadecimal literal.
6903
6904   * Tooling
6905     * `rustpkg` has been deprecated and removed from the main repository. Its
6906       replacement, `cargo`, is under development.
6907     * Nightly builds of rust are now available
6908     * The memory usage of rustc has been improved many times throughout this
6909       release cycle.
6910     * The build process supports disabling rpath support for the rustc binary
6911       itself.
6912     * Code generation has improved in some cases, giving more information to the
6913       LLVM optimization passes to enable more extensive optimizations.
6914     * Debuginfo compatibility with lldb on OSX has been restored.
6915     * The master branch is now gated on an android bot, making building for
6916       android much more reliable.
6917     * Output flags have been centralized into one `--emit` flag.
6918     * Crate type flags have been centralized into one `--crate-type` flag.
6919     * Codegen flags have been consolidated behind a `-C` flag.
6920     * Linking against outdated crates now has improved error messages.
6921     * Error messages with lifetimes will often suggest how to annotate the
6922       function to fix the error.
6923     * Many more types are documented in the standard library, and new guides
6924       were written.
6925     * Many `rustdoc` improvements:
6926       * code blocks are syntax highlighted.
6927       * render standalone markdown files.
6928       * the --test flag tests all code blocks by default.
6929       * exported macros are displayed.
6930       * re-exported types have their documentation inlined at the location of the
6931         first re-export.
6932       * search works across crates that have been rendered to the same output
6933         directory.
6934
6935
6936 Version 0.9 (2014-01-09)
6937 ==========================
6938
6939    * ~1800 changes, numerous bugfixes
6940
6941    * Language
6942       * The `float` type has been removed. Use `f32` or `f64` instead.
6943       * A new facility for enabling experimental features (feature gating) has
6944         been added, using the crate-level `#[feature(foo)]` attribute.
6945       * Managed boxes (@) are now behind a feature gate
6946         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6947         standard library's `Gc` or `Rc` types instead.
6948       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6949       * Jumping back to the top of a loop is now done with `continue` instead of
6950         `loop`.
6951       * Strings can no longer be mutated through index assignment.
6952       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6953         hash delimiters, as in `r###"foo"###`.
6954       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6955         called once.
6956       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6957       * `@fn`s have been removed.
6958       * `do` only works with procs in order to make it obvious what the cost
6959         of `do` is.
6960       * Single-element tuple-like structs can no longer be dereferenced to
6961         obtain the inner value. A more comprehensive solution for overloading
6962         the dereference operator will be provided in the future.
6963       * The `#[link(...)]` attribute has been replaced with
6964         `#[crate_id = "name#vers"]`.
6965       * Empty `impl`s must be terminated with empty braces and may not be
6966         terminated with a semicolon.
6967       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6968         no longer has any special meaning.
6969       * The old `fmt!` string formatting macro has been removed.
6970       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6971         `print!` and `println!`.
6972       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6973       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6974         `extern mod foo = "bar"` instead.
6975       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6976       * Macros can have attributes.
6977       * Macros can expand to items with attributes.
6978       * Macros can expand to multiple items.
6979       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6980       * Comments may be nested.
6981       * Values automatically coerce to trait objects they implement, without
6982         an explicit `as`.
6983       * Enum discriminants are no longer an entire word but as small as needed to
6984         contain all the variants. The `repr` attribute can be used to override
6985         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6986         `#[repr(C)]` to match C enums.
6987       * Non-string literals are not allowed in attributes (they never worked).
6988       * The FFI now supports variadic functions.
6989       * Octal numeric literals, as in `0o7777`.
6990       * The `concat!` syntax extension performs compile-time string concatenation.
6991       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6992         removed as Rust no longer uses segmented stacks.
6993       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6994       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6995         not `*`; ignoring remaining fields of a struct is also done with `..`,
6996         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6997       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6998       * `rustc` supports the "system" calling convention, which defaults to the
6999         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7000         "C" elsewhere.
7001       * The `type_overflow` lint (default: warn) checks literals for overflow.
7002       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7003       * The `attribute_usage` lint (default: warn) warns about unknown
7004         attributes.
7005       * The `unknown_features` lint (default: warn) warns about unknown
7006         feature gates.
7007       * The `dead_code` lint (default: warn) checks for dead code.
7008       * Rust libraries can be linked statically to one another
7009       * `#[link_args]` is behind the `link_args` feature gate.
7010       * Native libraries are now linked with `#[link(name = "foo")]`
7011       * Native libraries can be statically linked to a rust crate
7012         (`#[link(name = "foo", kind = "static")]`).
7013       * Native OS X frameworks are now officially supported
7014         (`#[link(name = "foo", kind = "framework")]`).
7015       * The `#[thread_local]` attribute creates thread-local (not task-local)
7016         variables. Currently behind the `thread_local` feature gate.
7017       * The `return` keyword may be used in closures.
7018       * Types that can be copied via a memcpy implement the `Pod` kind.
7019       * The `cfg` attribute can now be used on struct fields and enum variants.
7020
7021    * Libraries
7022       * std: The `option` and `result` API's have been overhauled to make them
7023         simpler, more consistent, and more composable.
7024       * std: The entire `std::io` module has been replaced with one that is
7025         more comprehensive and that properly interfaces with the underlying
7026         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7027         implemented.
7028       * std: `io::util` contains a number of useful implementations of
7029         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7030         `ZeroReader`, `TeeReader`.
7031       * std: The reference counted pointer type `extra::rc` moved into std.
7032       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7033         just a wrapper around it).
7034       * std: The `Either` type has been removed.
7035       * std: `fmt::Default` can be implemented for any type to provide default
7036         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7037       * std: The `rand` API continues to be tweaked.
7038       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7039         on failure in gdb, is now named `rust_fail`.
7040       * std: The `each_key` and `each_value` methods on `HashMap` have been
7041         replaced by the `keys` and `values` iterators.
7042       * std: Functions dealing with type size and alignment have moved from the
7043         `sys` module to the `mem` module.
7044       * std: The `path` module was written and API changed.
7045       * std: `str::from_utf8` has been changed to cast instead of allocate.
7046       * std: `starts_with` and `ends_with` methods added to vectors via the
7047         `ImmutableEqVector` trait, which is in the prelude.
7048       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7049         if the index is out of bounds.
7050       * std: Task failure no longer propagates between tasks, as the model was
7051         complex, expensive, and incompatible with thread-based tasks.
7052       * std: The `Any` type can be used for dynamic typing.
7053       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7054         `task::try`.
7055       * std: Methods that produce iterators generally do not have an `_iter`
7056         suffix now.
7057       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7058         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7059       * std: `util::ignore` renamed to `prelude::drop`.
7060       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7061         trait.
7062       * std: `vec::raw` has seen a lot of cleanup and API changes.
7063       * std: The standard library no longer includes any C++ code, and very
7064         minimal C, eliminating the dependency on libstdc++.
7065       * std: Runtime scheduling and I/O functionality has been factored out into
7066         extensible interfaces and is now implemented by two different crates:
7067         libnative, for native threading and I/O; and libgreen, for green threading
7068         and I/O. This paves the way for using the standard library in more limited
7069         embedded environments.
7070       * std: The `comm` module has been rewritten to be much faster, have a
7071         simpler, more consistent API, and to work for both native and green
7072         threading.
7073       * std: All libuv dependencies have been moved into the rustuv crate.
7074       * native: New implementations of runtime scheduling on top of OS threads.
7075       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7076         and other I/O.
7077       * green: The green thread scheduler and message passing types are almost
7078         entirely lock-free.
7079       * extra: The `flatpipes` module had bitrotted and was removed.
7080       * extra: All crypto functions have been removed and Rust now has a policy of
7081         not reimplementing crypto in the standard library. In the future crypto
7082         will be provided by external crates with bindings to established libraries.
7083       * extra: `c_vec` has been modernized.
7084       * extra: The `sort` module has been removed. Use the `sort` method on
7085         mutable slices.
7086
7087    * Tooling
7088       * The `rust` and `rusti` commands have been removed, due to lack of
7089         maintenance.
7090       * `rustdoc` was completely rewritten.
7091       * `rustdoc` can test code examples in documentation.
7092       * `rustpkg` can test packages with the argument, 'test'.
7093       * `rustpkg` supports arbitrary dependencies, including C libraries.
7094       * `rustc`'s support for generating debug info is improved again.
7095       * `rustc` has better error reporting for unbalanced delimiters.
7096       * `rustc`'s JIT support was removed due to bitrot.
7097       * Executables and static libraries can be built with LTO (-Z lto)
7098       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7099         build tools.
7100
7101
7102 Version 0.8 (2013-09-26)
7103 ============================
7104
7105    * ~2200 changes, numerous bugfixes
7106
7107    * Language
7108       * The `for` loop syntax has changed to work with the `Iterator` trait.
7109       * At long last, unwinding works on Windows.
7110       * Default methods are ready for use.
7111       * Many trait inheritance bugs fixed.
7112       * Owned and borrowed trait objects work more reliably.
7113       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7114       * rustc can omit emission of code for the `debug!` macro if it is passed
7115         `--cfg ndebug`
7116       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7117         for foo.rs, then foo/mod.rs, and will generate an error when both are
7118         present.
7119       * Strings no longer contain trailing nulls. The new `std::c_str` module
7120         provides new mechanisms for converting to C strings.
7121       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7122       * The FFI has been overhauled such that foreign functions are called directly,
7123         instead of through a stack-switching wrapper.
7124       * Calling a foreign function must be done through a Rust function with the
7125         `#[fixed_stack_segment]` attribute.
7126       * The `externfn!` macro can be used to declare both a foreign function and
7127         a `#[fixed_stack_segment]` wrapper at once.
7128       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7129       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7130       * `priv` is disallowed everywhere except for struct fields and enum variants.
7131       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7132       * `ref` bindings in irrefutable patterns work correctly now.
7133       * `char` is now prevented from containing invalid code points.
7134       * Casting to `bool` is no longer allowed.
7135       * `\0` is now accepted as an escape in chars and strings.
7136       * `yield` is a reserved keyword.
7137       * `typeof` is a reserved keyword.
7138       * Crates may be imported by URL with `extern mod foo = "url";`.
7139       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7140       * Static vectors can be initialized with repeating elements,
7141         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7142       * Static structs can be initialized with functional record update,
7143         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7144       * `cfg!` can be used to conditionally execute code based on the crate
7145         configuration, similarly to `#[cfg(...)]`.
7146       * The `unnecessary_qualification` lint detects unneeded module
7147         prefixes (default: allow).
7148       * Arithmetic operations have been implemented on the SIMD types in
7149         `std::unstable::simd`.
7150       * Exchange allocation headers were removed, reducing memory usage.
7151       * `format!` implements a completely new, extensible, and higher-performance
7152         string formatting system. It will replace `fmt!`.
7153       * `print!` and `println!` write formatted strings (using the `format!`
7154         extension) to stdout.
7155       * `write!` and `writeln!` write formatted strings (using the `format!`
7156         extension) to the new Writers in `std::rt::io`.
7157       * The library section in which a function or static is placed may
7158         be specified with `#[link_section = "..."]`.
7159       * The `proto!` syntax extension for defining bounded message protocols
7160         was removed.
7161       * `macro_rules!` is hygienic for `let` declarations.
7162       * The `#[export_name]` attribute specifies the name of a symbol.
7163       * `unreachable!` can be used to indicate unreachable code, and fails
7164         if executed.
7165
7166    * Libraries
7167       * std: Transitioned to the new runtime, written in Rust.
7168       * std: Added an experimental I/O library, `rt::io`, based on the new
7169         runtime.
7170       * std: A new generic `range` function was added to the prelude, replacing
7171         `uint::range` and friends.
7172       * std: `range_rev` no longer exists. Since range is an iterator it can be
7173         reversed with `range(lo, hi).invert()`.
7174       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7175         renamed to `unwrap_or`.
7176       * std: The `iterator` module was renamed to `iter`.
7177       * std: Integral types now support the `checked_add`, `checked_sub`, and
7178         `checked_mul` operations for detecting overflow.
7179       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7180         consistency.
7181       * std: Methods are standardizing on conventions for casting methods:
7182         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7183         and cheap casts.
7184       * std: The `CString` type in `c_str` provides new ways to convert to and
7185         from C strings.
7186       * std: `DoubleEndedIterator` can yield elements in two directions.
7187       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7188         two splices.
7189       * std: `str::from_bytes` renamed to `str::from_utf8`.
7190       * std: `pop_opt` and `shift_opt` methods added to vectors.
7191       * std: The task-local data interface no longer uses @, and keys are
7192         no longer function pointers.
7193       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7194       * std: Added `SharedPort` to `comm`.
7195       * std: `Eq` has a default method for `ne`; only `eq` is required
7196         in implementations.
7197       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7198         is required in implementations.
7199       * std: `is_utf8` performance is improved, impacting many string functions.
7200       * std: `os::MemoryMap` provides cross-platform mmap.
7201       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7202         are not 'in-bounds' are considered undefined.
7203       * std: Many freestanding functions in `vec` removed in favor of methods.
7204       * std: Many freestanding functions on scalar types removed in favor of
7205         methods.
7206       * std: Many options to task builders were removed since they don't make
7207         sense in the new scheduler design.
7208       * std: More containers implement `FromIterator` so can be created by the
7209         `collect` method.
7210       * std: More complete atomic types in `unstable::atomics`.
7211       * std: `comm::PortSet` removed.
7212       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7213         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7214         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7215         default implementations.
7216       * std: Various `from_str` functions were removed in favor of a generic
7217         `from_str` which is available in the prelude.
7218       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7219       * extra: `dlist`, the doubly-linked list was modernized.
7220       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7221       * extra: Added `glob` module, replacing `std::os::glob`.
7222       * extra: `rope` was removed.
7223       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7224       * extra: `net`, and `timer` were removed. The experimental replacements
7225         are `std::rt::io::net` and `std::rt::io::timer`.
7226       * extra: Iterators implemented for `SmallIntMap`.
7227       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7228       * extra: `SmallIntSet` removed. Use `BitvSet`.
7229       * extra: Performance of JSON parsing greatly improved.
7230       * extra: `semver` updated to SemVer 2.0.0.
7231       * extra: `term` handles more terminals correctly.
7232       * extra: `dbg` module removed.
7233       * extra: `par` module removed.
7234       * extra: `future` was cleaned up, with some method renames.
7235       * extra: Most free functions in `getopts` were converted to methods.
7236
7237    * Other
7238       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7239       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7240         similarly to gcc's `--march` flag.
7241       * rustc's performance compiling small crates is much better.
7242       * rustpkg has received many improvements.
7243       * rustpkg supports git tags as package IDs.
7244       * rustpkg builds into target-specific directories so it can be used for
7245         cross-compiling.
7246       * The number of concurrent test tasks is controlled by the environment
7247         variable RUST_TEST_TASKS.
7248       * The test harness can now report metrics for benchmarks.
7249       * All tools have man pages.
7250       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7251       * The runtime uses jemalloc for allocations.
7252       * Segmented stacks are temporarily disabled as part of the transition to
7253         the new runtime. Stack overflows are possible!
7254       * A new documentation backend, rustdoc_ng, is available for use. It is
7255         still invoked through the normal `rustdoc` command.
7256
7257
7258 Version 0.7 (2013-07-03)
7259 =======================
7260
7261    * ~2000 changes, numerous bugfixes
7262
7263    * Language
7264       * `impl`s no longer accept a visibility qualifier. Put them on methods
7265         instead.
7266       * The borrow checker has been rewritten with flow-sensitivity, fixing
7267         many bugs and inconveniences.
7268       * The `self` parameter no longer implicitly means `&'self self`,
7269         and can be explicitly marked with a lifetime.
7270       * Overloadable compound operators (`+=`, etc.) have been temporarily
7271         removed due to bugs.
7272       * The `for` loop protocol now requires `for`-iterators to return `bool`
7273         so they compose better.
7274       * The `Durable` trait is replaced with the `'static` bounds.
7275       * Trait default methods work more often.
7276       * Structs with the `#[packed]` attribute have byte alignment and
7277         no padding between fields.
7278       * Type parameters bound by `Copy` must now be copied explicitly with
7279         the `copy` keyword.
7280       * It is now illegal to move out of a dereferenced unsafe pointer.
7281       * `Option<~T>` is now represented as a nullable pointer.
7282       * `@mut` does dynamic borrow checks correctly.
7283       * The `main` function is only detected at the topmost level of the crate.
7284         The `#[main]` attribute is still valid anywhere.
7285       * Struct fields may no longer be mutable. Use inherited mutability.
7286       * The `#[no_send]` attribute makes a type that would otherwise be
7287         `Send`, not.
7288       * The `#[no_freeze]` attribute makes a type that would otherwise be
7289         `Freeze`, not.
7290       * Unbounded recursion will abort the process after reaching the limit
7291         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7292       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7293         are never implicitly copyable.
7294       * `#[static_assert]` makes compile-time assertions about static bools.
7295       * At long last, 'argument modes' no longer exist.
7296       * The rarely used `use mod` statement no longer exists.
7297
7298    * Syntax extensions
7299       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7300         argument list.
7301       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7302         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7303         `#[deriving(...)]`.
7304       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7305         and unsuffixed integer literals.
7306
7307    * Libraries
7308       * The `core` crate was renamed to `std`.
7309       * The `std` crate was renamed to `extra`.
7310       * More and improved documentation.
7311       * std: `iterator` module for external iterator objects.
7312       * Many old-style (internal, higher-order function) iterators replaced by
7313         implementations of `Iterator`.
7314       * std: Many old internal vector and string iterators,
7315         incl. `any`, `all`. removed.
7316       * std: The `finalize` method of `Drop` renamed to `drop`.
7317       * std: The `drop` method now takes `&mut self` instead of `&self`.
7318       * std: The prelude no longer re-exports any modules, only types and traits.
7319       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7320         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7321       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7322         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7323       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7324         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7325       * std: Many types implement `Clone`.
7326       * std: `path` type renamed to `Path`.
7327       * std: `mut` module and `Mut` type removed.
7328       * std: Many standalone functions removed in favor of methods and iterators
7329         in `vec`, `str`. In the future methods will also work as functions.
7330       * std: `reinterpret_cast` removed. Use `transmute`.
7331       * std: ascii string handling in `std::ascii`.
7332       * std: `Rand` is implemented for ~/@.
7333       * std: `run` module for spawning processes overhauled.
7334       * std: Various atomic types added to `unstable::atomic`.
7335       * std: Various types implement `Zero`.
7336       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7337       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7338       * std: Added `os::mkdir_recursive`.
7339       * std: Added `os::glob` function performs filesystems globs.
7340       * std: `FuzzyEq` renamed to `ApproxEq`.
7341       * std: `Map` now defines `pop` and `swap` methods.
7342       * std: `Cell` constructors converted to static methods.
7343       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7344       * extra: `flate` module moved from `std` to `extra`.
7345       * extra: `fileinput` module for iterating over a series of files.
7346       * extra: `Complex` number type and `complex` module.
7347       * extra: `Rational` number type and `rational` module.
7348       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7349       * extra: `term` uses terminfo now, is more correct.
7350       * extra: `arc` functions converted to methods.
7351       * extra: Implementation of fixed output size variations of SHA-2.
7352
7353    * Tooling
7354       * `unused_variable`  lint mode for unused variables (default: warn).
7355       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7356         (default: warn).
7357       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7358         (default: warn).
7359       * `dead_assignment` lint mode for unread variables (default: warn).
7360       * `unnecessary_allocation` lint mode detects some heap allocations that are
7361         immediately borrowed so could be written without allocating (default: warn).
7362       * `missing_doc` lint mode (default: allow).
7363       * `unreachable_code` lint mode (default: warn).
7364       * The `rusti` command has been rewritten and a number of bugs addressed.
7365       * rustc outputs in color on more terminals.
7366       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7367       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7368       * Compiling with `-g` will make the binary record information about
7369         dynamic borrowcheck failures for debugging.
7370       * rustdoc has a nicer stylesheet.
7371       * Various improvements to rustdoc.
7372       * Improvements to rustpkg (see the detailed release notes).
7373
7374
7375 Version 0.6 (2013-04-03)
7376 ========================
7377
7378    * ~2100 changes, numerous bugfixes
7379
7380    * Syntax changes
7381       * The self type parameter in traits is now spelled `Self`
7382       * The `self` parameter in trait and impl methods must now be explicitly
7383         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7384       * Static methods no longer require the `static` keyword and instead
7385         are distinguished by the lack of a `self` parameter
7386       * Replaced the `Durable` trait with the `'static` lifetime
7387       * The old closure type syntax with the trailing sigil has been
7388         removed in favor of the more consistent leading sigil
7389       * `super` is a keyword, and may be prefixed to paths
7390       * Trait bounds are separated with `+` instead of whitespace
7391       * Traits are implemented with `impl Trait for Type`
7392         instead of `impl Type: Trait`
7393       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7394       * The `export` keyword has finally been removed
7395       * The `move` keyword has been removed (see "Semantic changes")
7396       * The interior mutability qualifier on vectors, `[mut T]`, has been
7397         removed. Use `&mut [T]`, etc.
7398       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7399       * `fail` is no longer a keyword. Use `fail!()`
7400       * `assert` is no longer a keyword. Use `assert!()`
7401       * `log` is no longer a keyword. use `debug!`, etc.
7402       * 1-tuples may be represented as `(T,)`
7403       * Struct fields may no longer be `mut`. Use inherited mutability,
7404         `@mut T`, `core::mut` or `core::cell`
7405       * `extern mod { ... }` is no longer valid syntax for foreign
7406         function modules. Use extern blocks: `extern { ... }`
7407       * Newtype enums removed. Use tuple-structs.
7408       * Trait implementations no longer support visibility modifiers
7409       * Pattern matching over vectors improved and expanded
7410       * `const` renamed to `static` to correspond to lifetime name,
7411         and make room for future `static mut` unsafe mutable globals.
7412       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
7413       * `Clone` implementations can be automatically generated with
7414         `#[deriving(Clone)]`
7415       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
7416         instead of `foo as Bar`.
7417       * Fixed length vector types are now written as `[int, .. 3]`
7418         instead of `[int * 3]`.
7419       * Fixed length vector types can express the length as a constant
7420         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
7421
7422    * Semantic changes
7423       * Types with owned pointers or custom destructors move by default,
7424         eliminating the `move` keyword
7425       * All foreign functions are considered unsafe
7426       * &mut is now unaliasable
7427       * Writes to borrowed @mut pointers are prevented dynamically
7428       * () has size 0
7429       * The name of the main function can be customized using #[main]
7430       * The default type of an inferred closure is &fn instead of @fn
7431       * `use` statements may no longer be "chained" - they cannot import
7432         identifiers imported by previous `use` statements
7433       * `use` statements are crate relative, importing from the "top"
7434         of the crate by default. Paths may be prefixed with `super::`
7435         or `self::` to change the search behavior.
7436       * Method visibility is inherited from the implementation declaration
7437       * Structural records have been removed
7438       * Many more types can be used in static items, including enums
7439         'static-lifetime pointers and vectors
7440       * Pattern matching over vectors improved and expanded
7441       * Typechecking of closure types has been overhauled to
7442         improve inference and eliminate unsoundness
7443       * Macros leave scope at the end of modules, unless that module is
7444         tagged with #[macro_escape]
7445
7446    * Libraries
7447       * Added big integers to `std::bigint`
7448       * Removed `core::oldcomm` module
7449       * Added pipe-based `core::comm` module
7450       * Numeric traits have been reorganized under `core::num`
7451       * `vec::slice` finally returns a slice
7452       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
7453       * Containers reorganized around traits in `core::container`
7454       * `core::dvec` removed, `~[T]` is a drop-in replacement
7455       * `core::send_map` renamed to `core::hashmap`
7456       * `std::map` removed; replaced with `core::hashmap`
7457       * `std::treemap` reimplemented as an owned balanced tree
7458       * `std::deque` and `std::smallintmap` reimplemented as owned containers
7459       * `core::trie` added as a fast ordered map for integer keys
7460       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
7461       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
7462         overload the comparison operators, whereas `TotalOrd` is used
7463         by certain container types
7464
7465    * Other
7466       * Replaced the 'cargo' package manager with 'rustpkg'
7467       * Added all-purpose 'rust' tool
7468       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
7469       * rustc now *attempts* to offer spelling suggestions
7470       * Improved support for ARM and Android
7471       * Preliminary MIPS backend
7472       * Improved foreign function ABI implementation for x86, x86_64
7473       * Various memory usage improvements
7474       * Rust code may be embedded in foreign code under limited circumstances
7475       * Inline assembler supported by new asm!() syntax extension.
7476
7477
7478 Version 0.5 (2012-12-21)
7479 ===========================
7480
7481    * ~900 changes, numerous bugfixes
7482
7483    * Syntax changes
7484       * Removed `<-` move operator
7485       * Completed the transition from the `#fmt` extension syntax to `fmt!`
7486       * Removed old fixed length vector syntax - `[T]/N`
7487       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
7488       * Macros may now expand to items and statements
7489       * `a.b()` is always parsed as a method call, never as a field projection
7490       * `Eq` and `IterBytes` implementations can be automatically generated
7491         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
7492       * Removed the special crate language for `.rc` files
7493       * Function arguments may consist of any irrefutable pattern
7494
7495    * Semantic changes
7496       * `&` and `~` pointers may point to objects
7497       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
7498       * Enum variants may be structs
7499       * Destructors can be added to all nominal types with the Drop trait
7500       * Structs and nullary enum variants may be constants
7501       * Values that cannot be implicitly copied are now automatically moved
7502         without writing `move` explicitly
7503       * `&T` may now be coerced to `*T`
7504       * Coercions happen in `let` statements as well as function calls
7505       * `use` statements now take crate-relative paths
7506       * The module and type namespaces have been merged so that static
7507         method names can be resolved under the trait in which they are
7508         declared
7509
7510    * Improved support for language features
7511       * Trait inheritance works in many scenarios
7512       * More support for explicit self arguments in methods - `self`, `&self`
7513         `@self`, and `~self` all generally work as expected
7514       * Static methods work in more situations
7515       * Experimental: Traits may declare default methods for the implementations
7516         to use
7517
7518    * Libraries
7519       * New condition handling system in `core::condition`
7520       * Timsort added to `std::sort`
7521       * New priority queue, `std::priority_queue`
7522       * Pipes for serializable types, `std::flatpipes'
7523       * Serialization overhauled to be trait-based
7524       * Expanded `getopts` definitions
7525       * Moved futures to `std`
7526       * More functions are pure now
7527       * `core::comm` renamed to `oldcomm`. Still deprecated
7528       * `rustdoc` and `cargo` are libraries now
7529
7530    * Misc
7531       * Added a preliminary REPL, `rusti`
7532       * License changed from MIT to dual MIT/APL2
7533
7534
7535 Version 0.4 (2012-10-15)
7536 ==========================
7537
7538    * ~2000 changes, numerous bugfixes
7539
7540    * Syntax
7541       * All keywords are now strict and may not be used as identifiers anywhere
7542       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
7543         'of', 'with', 'to', 'class'.
7544       * Classes are replaced with simpler structs
7545       * Explicit method self types
7546       * `ret` became `return` and `alt` became `match`
7547       * `import` is now `use`; `use is now `extern mod`
7548       * `extern mod { ... }` is now `extern { ... }`
7549       * `use mod` is the recommended way to import modules
7550       * `pub` and `priv` replace deprecated export lists
7551       * The syntax of `match` pattern arms now uses fat arrow (=>)
7552       * `main` no longer accepts an args vector; use `os::args` instead
7553
7554    * Semantics
7555       * Trait implementations are now coherent, ala Haskell typeclasses
7556       * Trait methods may be static
7557       * Argument modes are deprecated
7558       * Borrowed pointers are much more mature and recommended for use
7559       * Strings and vectors in the static region are stored in constant memory
7560       * Typestate was removed
7561       * Resolution rewritten to be more reliable
7562       * Support for 'dual-mode' data structures (freezing and thawing)
7563
7564    * Libraries
7565       * Most binary operators can now be overloaded via the traits in
7566         `core::ops'
7567       * `std::net::url` for representing URLs
7568       * Sendable hash maps in `core::send_map`
7569       * `core::task' gained a (currently unsafe) task-local storage API
7570
7571    * Concurrency
7572       * An efficient new intertask communication primitive called the pipe,
7573         along with a number of higher-level channel types, in `core::pipes`
7574       * `std::arc`, an atomically reference counted, immutable, shared memory
7575         type
7576       * `std::sync`, various exotic synchronization tools based on arcs and pipes
7577       * Futures are now based on pipes and sendable
7578       * More robust linked task failure
7579       * Improved task builder API
7580
7581    * Other
7582       * Improved error reporting
7583       * Preliminary JIT support
7584       * Preliminary work on precise GC
7585       * Extensive architectural improvements to rustc
7586       * Begun a transition away from buggy C++-based reflection (shape) code to
7587         Rust-based (visitor) code
7588       * All hash functions and tables converted to secure, randomized SipHash
7589
7590
7591 Version 0.3  (2012-07-12)
7592 ========================
7593
7594    * ~1900 changes, numerous bugfixes
7595
7596    * New coding conveniences
7597       * Integer-literal suffix inference
7598       * Per-item control over warnings, errors
7599       * #[cfg(windows)] and #[cfg(unix)] attributes
7600       * Documentation comments
7601       * More compact closure syntax
7602       * 'do' expressions for treating higher-order functions as
7603         control structures
7604       * *-patterns (wildcard extended to all constructor fields)
7605
7606    * Semantic cleanup
7607       * Name resolution pass and exhaustiveness checker rewritten
7608       * Region pointers and borrow checking supersede alias
7609         analysis
7610       * Init-ness checking is now provided by a region-based liveness
7611         pass instead of the typestate pass; same for last-use analysis
7612       * Extensive work on region pointers
7613
7614    * Experimental new language features
7615       * Slices and fixed-size, interior-allocated vectors
7616       * #!-comments for lang versioning, shell execution
7617       * Destructors and iface implementation for classes;
7618         type-parameterized classes and class methods
7619       * 'const' type kind for types that can be used to implement
7620         shared-memory concurrency patterns
7621
7622    * Type reflection
7623
7624    * Removal of various obsolete features
7625       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
7626                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
7627
7628       * Constructs: do-while loops ('do' repurposed), fn binding,
7629                     resources (replaced by destructors)
7630
7631    * Compiler reorganization
7632       * Syntax-layer of compiler split into separate crate
7633       * Clang (from LLVM project) integrated into build
7634       * Typechecker split into sub-modules
7635
7636    * New library code
7637       * New time functions
7638       * Extension methods for many built-in types
7639       * Arc: atomic-refcount read-only / exclusive-use shared cells
7640       * Par: parallel map and search routines
7641       * Extensive work on libuv interface
7642       * Much vector code moved to libraries
7643       * Syntax extensions: #line, #col, #file, #mod, #stringify,
7644         #include, #include_str, #include_bin
7645
7646    * Tool improvements
7647       * Cargo automatically resolves dependencies
7648
7649
7650 Version 0.2  (2012-03-29)
7651 =========================
7652
7653    * >1500 changes, numerous bugfixes
7654
7655    * New docs and doc tooling
7656
7657    * New port: FreeBSD x86_64
7658
7659    * Compilation model enhancements
7660       * Generics now specialized, multiply instantiated
7661       * Functions now inlined across separate crates
7662
7663    * Scheduling, stack and threading fixes
7664       * Noticeably improved message-passing performance
7665       * Explicit schedulers
7666       * Callbacks from C
7667       * Helgrind clean
7668
7669    * Experimental new language features
7670       * Operator overloading
7671       * Region pointers
7672       * Classes
7673
7674    * Various language extensions
7675       * C-callback function types: 'crust fn ...'
7676       * Infinite-loop construct: 'loop { ... }'
7677       * Shorten 'mutable' to 'mut'
7678       * Required mutable-local qualifier: 'let mut ...'
7679       * Basic glob-exporting: 'export foo::*;'
7680       * Alt now exhaustive, 'alt check' for runtime-checked
7681       * Block-function form of 'for' loop, with 'break' and 'ret'.
7682
7683    * New library code
7684       * AST quasi-quote syntax extension
7685       * Revived libuv interface
7686       * New modules: core::{future, iter}, std::arena
7687       * Merged per-platform std::{os*, fs*} to core::{libc, os}
7688       * Extensive cleanup, regularization in libstd, libcore
7689
7690
7691 Version 0.1  (2012-01-20)
7692 ===============================
7693
7694    * Most language features work, including:
7695       * Unique pointers, unique closures, move semantics
7696       * Interface-constrained generics
7697       * Static interface dispatch
7698       * Stack growth
7699       * Multithread task scheduling
7700       * Typestate predicates
7701       * Failure unwinding, destructors
7702       * Pattern matching and destructuring assignment
7703       * Lightweight block-lambda syntax
7704       * Preliminary macro-by-example
7705
7706    * Compiler works with the following configurations:
7707       * Linux: x86 and x86_64 hosts and targets
7708       * macOS: x86 and x86_64 hosts and targets
7709       * Windows: x86 hosts and targets
7710
7711    * Cross compilation / multi-target configuration supported.
7712
7713    * Preliminary API-documentation and package-management tools included.
7714
7715 Known issues:
7716
7717    * Documentation is incomplete.
7718
7719    * Performance is below intended target.
7720
7721    * Standard library APIs are subject to extensive change, reorganization.
7722
7723    * Language-level versioning is not yet operational - future code will
7724      break unexpectedly.