RELEASES.md

   1 Version 1.31.0 (2018-12-06)
   2 ==========================
   3
   4 Language
   5 --------
   6 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
   7 - [New lifetime elision rules now allow for eliding lifetimes in functions and
   8   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
   9   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
  10   in structs.
  11 - [You can now define and use `const` functions.][54835] These are currently
  12   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
  13   [language reference][const-reference] for what exactly is available.
  14 - [You can now use tool lints, which allow you to scope lints from external
  15   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
  16 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
  17   a crate, not just in exported functions.][54451]
  18 - [You can now use parentheses in pattern matches.][54497]
  19
  20 Compiler
  21 --------
  22 - [Updated musl to 1.1.20][54430]
  23
  24 Libraries
  25 ---------
  26 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
  27   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
  28 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
  29   into `Option<&mut T>` using the `From` trait.][53218]
  30 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
  31
  32
  33 Stabilized APIs
  34 ---------------
  35 - [`slice::align_to`]
  36 - [`slice::align_to_mut`]
  37 - [`slice::chunks_exact`]
  38 - [`slice::chunks_exact_mut`]
  39 - [`slice::rchunks`]
  40 - [`slice::rchunks_mut`]
  41 - [`slice::rchunks_exact`]
  42 - [`slice::rchunks_exact_mut`]
  43 - [`Option::replace`]
  44
  45 Cargo
  46 -----
  47 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
  48
  49 [52813]: https://github.com/rust-lang/rust/pull/52813/
  50 [53218]: https://github.com/rust-lang/rust/pull/53218/
  51 [53555]: https://github.com/rust-lang/rust/issues/53555/
  52 [54057]: https://github.com/rust-lang/rust/pull/54057/
  53 [54240]: https://github.com/rust-lang/rust/pull/54240/
  54 [54430]: https://github.com/rust-lang/rust/pull/54430/
  55 [54451]: https://github.com/rust-lang/rust/pull/54451/
  56 [54497]: https://github.com/rust-lang/rust/pull/54497/
  57 [54778]: https://github.com/rust-lang/rust/pull/54778/
  58 [54835]: https://github.com/rust-lang/rust/pull/54835/
  59 [54870]: https://github.com/rust-lang/rust/pull/54870/
  60 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
  61 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
  62 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
  63 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
  64 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
  65 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
  66 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
  67 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
  68 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
  69 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
  70 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
  71 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
  72
  73
  74 Version 1.30.0 (2018-10-25)
  75 ==========================
  76
  77 Language
  78 --------
  79 - [Procedural macros are now available.][52081] These kinds of macros allow for
  80   more powerful code generation. There is a [new chapter available][proc-macros]
  81   in the Rust Programming Language book that goes further in depth.
  82 - [You can now use keywords as identifiers using the raw identifiers
  83   syntax (`r#`),][53236] e.g. `let r#for = true;`
  84 - [Using anonymous parameters in traits is now deprecated with a warning and
  85   will be a hard error in the 2018 edition.][53272]
  86 - [You can now use `crate` in paths.][54404] This allows you to refer to the
  87   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
  88 - [Using a external crate no longer requires being prefixed with `::`.][54404]
  89   Previously, using a external crate in a module without a use statement
  90   required `let json = ::serde_json::from_str(foo);` but can now be written
  91   as `let json = serde_json::from_str(foo);`.
  92 - [You can now apply the `#[used]` attribute to static items to prevent the
  93   compiler from optimising them away, even if they appear to be unused,][51363]
  94   e.g. `#[used] static FOO: u32 = 1;`
  95 - [You can now import and reexport macros from other crates with the `use`
  96   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
  97   the root module of the crate. If your macro relies on calling other local
  98   macros, it is recommended to export with the
  99   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
 100   those macros.
 101 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
 102   using the `vis` specifier.][53370]
 103 - [Non-macro attributes now allow all forms of literals, not just
 104   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
 105   write `#[attr(true)]`.
 106 - [You can now specify a function to handle a panic in the Rust runtime with the
 107   `#[panic_handler]` attribute.][51366]
 108
 109 Compiler
 110 --------
 111 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
 112 - [Added the `aarch64-unknown-netbsd` target][53165]
 113
 114 Libraries
 115 ---------
 116 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
 117
 118 Stabilized APIs
 119 ---------------
 120 - [`Ipv4Addr::BROADCAST`]
 121 - [`Ipv4Addr::LOCALHOST`]
 122 - [`Ipv4Addr::UNSPECIFIED`]
 123 - [`Ipv6Addr::LOCALHOST`]
 124 - [`Ipv6Addr::UNSPECIFIED`]
 125 - [`Iterator::find_map`]
 126
 127   The following methods are replacement methods for `trim_left`, `trim_right`,
 128   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
 129   in 1.33.0:
 130 - [`str::trim_end_matches`]
 131 - [`str::trim_end`]
 132 - [`str::trim_start_matches`]
 133 - [`str::trim_start`]
 134
 135 Cargo
 136 ----
 137 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
 138 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
 139   equivalent to calling `rustdoc --error-format=json`.
 140 - [Cargo will now provide a progress bar for builds.][cargo/5995]
 141
 142 Misc
 143 ----
 144 - [`rustdoc` allows you to specify what edition to treat your code as with the
 145   `--edition` option.][54057]
 146 - [`rustdoc` now has the `--color` (specify whether to output color) and
 147   `--error-format` (specify error format, e.g. `json`) options.][53003]
 148 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
 149   debug symbols.][53774]
 150 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
 151   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
 152
 153 [50911]: https://github.com/rust-lang/rust/pull/50911/
 154 [51363]: https://github.com/rust-lang/rust/pull/51363/
 155 [51366]: https://github.com/rust-lang/rust/pull/51366/
 156 [52081]: https://github.com/rust-lang/rust/pull/52081/
 157 [53003]: https://github.com/rust-lang/rust/pull/53003/
 158 [53033]: https://github.com/rust-lang/rust/pull/53033/
 159 [53044]: https://github.com/rust-lang/rust/pull/53044/
 160 [53165]: https://github.com/rust-lang/rust/pull/53165/
 161 [53213]: https://github.com/rust-lang/rust/pull/53213/
 162 [53236]: https://github.com/rust-lang/rust/pull/53236/
 163 [53272]: https://github.com/rust-lang/rust/pull/53272/
 164 [53370]: https://github.com/rust-lang/rust/pull/53370/
 165 [53459]: https://github.com/rust-lang/rust/pull/53459/
 166 [53774]: https://github.com/rust-lang/rust/pull/53774/
 167 [53822]: https://github.com/rust-lang/rust/pull/53822/
 168 [54057]: https://github.com/rust-lang/rust/pull/54057/
 169 [54146]: https://github.com/rust-lang/rust/pull/54146/
 170 [54404]: https://github.com/rust-lang/rust/pull/54404/
 171 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
 172 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
 173 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
 174 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
 175
 176 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
 177 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
 178 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
 179 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
 180 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
 181 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
 182 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
 183 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
 184 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
 185 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
 186
 187
 188 Version 1.29.2 (2018-10-11)
 189 ===========================
 190
 191 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
 192 - The `rls-preview` component on the windows-gnu targets has been restored.
 193
 194 [54639]: https://github.com/rust-lang/rust/pull/54639
 195
 196
 197 Version 1.29.1 (2018-09-25)
 198 ===========================
 199
 200 Security Notes
 201 --------------
 202
 203 - The standard library's `str::repeat` function contained an out of bounds write
 204   caused by an integer overflow. This has been fixed by deterministically
 205   panicking when an overflow happens.
 206
 207   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
 208   us.
 209
 210
 211 Version 1.29.0 (2018-09-13)
 212 ==========================
 213
 214 Compiler
 215 --------
 216 - [Bumped minimum LLVM version to 5.0.][51899]
 217 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
 218 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
 219
 220 Libraries
 221 ---------
 222 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
 223 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
 224 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
 225 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
 226   for `&str`.][51178]
 227 - [`Cell<T>` now allows `T` to be unsized.][50494]
 228 - [`SocketAddr` is now stable on Redox.][52656]
 229
 230 Stabilized APIs
 231 ---------------
 232 - [`Arc::downcast`]
 233 - [`Iterator::flatten`]
 234 - [`Rc::downcast`]
 235
 236 Cargo
 237 -----
 238 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
 239   `--locked` to disable this behavior.
 240 - [`cargo-install` will now allow you to cross compile an install
 241   using `--target`.][cargo/5614]
 242 - [Added the `cargo-fix` subcommand to automatically move project code from
 243   2015 edition to 2018.][cargo/5723]
 244 - [`cargo doc` can now optionally document private types using the
 245   `--document-private-items` flag.][cargo/5543]
 246
 247 Misc
 248 ----
 249 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
 250   the specified level to that level.][52354] For example `--cap-lints warn`
 251   will demote `deny` and `forbid` lints to `warn`.
 252 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
 253   fails and `101` if there is a panic.][52197]
 254 - [A preview of clippy has been made available through rustup.][51122]
 255   You can install the preview with `rustup component add clippy-preview`.
 256
 257 Compatibility Notes
 258 -------------------
 259 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
 260   Use `str::get_unchecked(begin..end)` instead.
 261 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
 262   Consider using the `home_dir` function from
 263   https://crates.io/crates/dirs instead.
 264 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
 265 - [`cfg` attributes and `--cfg` command line flags are now more
 266   strictly validated.][53893]
 267
 268 [53893]: https://github.com/rust-lang/rust/pull/53893/
 269 [52861]: https://github.com/rust-lang/rust/pull/52861/
 270 [52656]: https://github.com/rust-lang/rust/pull/52656/
 271 [52239]: https://github.com/rust-lang/rust/pull/52239/
 272 [52330]: https://github.com/rust-lang/rust/pull/52330/
 273 [52354]: https://github.com/rust-lang/rust/pull/52354/
 274 [52402]: https://github.com/rust-lang/rust/pull/52402/
 275 [52103]: https://github.com/rust-lang/rust/pull/52103/
 276 [52197]: https://github.com/rust-lang/rust/pull/52197/
 277 [51807]: https://github.com/rust-lang/rust/pull/51807/
 278 [51899]: https://github.com/rust-lang/rust/pull/51899/
 279 [51912]: https://github.com/rust-lang/rust/pull/51912/
 280 [51511]: https://github.com/rust-lang/rust/pull/51511/
 281 [51619]: https://github.com/rust-lang/rust/pull/51619/
 282 [51656]: https://github.com/rust-lang/rust/pull/51656/
 283 [51178]: https://github.com/rust-lang/rust/pull/51178/
 284 [51122]: https://github.com/rust-lang/rust/pull/51122
 285 [50494]: https://github.com/rust-lang/rust/pull/50494/
 286 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
 287 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
 288 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
 289 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
 290 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
 291 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
 292 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
 293
 294
 295 Version 1.28.0 (2018-08-02)
 296 ===========================
 297
 298 Language
 299 --------
 300 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
 301   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
 302   the inner type across Foreign Function Interface (FFI) boundaries.
 303 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
 304   and can now be used as identifiers.][51196]
 305 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
 306   stable.][51241] This will allow users to specify a global allocator for
 307   their program.
 308 - [Unit test functions marked with the `#[test]` attribute can now return
 309   `Result<(), E: Debug>` in addition to `()`.][51298]
 310 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
 311   allows macros to easily target lifetimes.
 312
 313 Compiler
 314 --------
 315 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
 316   prioritise making smaller binary sizes. `z` is the same as `s` with the
 317   exception that it does not vectorise loops, which typically results in an even
 318   smaller binary.
 319 - [The short error format is now stable.][49546] Specified with
 320   `--error-format=short` this option will provide a more compressed output of
 321   rust error messages.
 322 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
 323 - [Reduced the number of allocations in the macro parser.][50855] This can
 324   improve compile times of macro heavy crates on average by 5%.
 325
 326 Libraries
 327 ---------
 328 - [Implemented `Default` for `&mut str`.][51306]
 329 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
 330 - [Implemented `Extend` for `()`.][50234]
 331 - [The `Debug` implementation of `time::Duration` should now be more easily
 332   human readable.][50364] Previously a `Duration` of one second would printed as
 333   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
 334 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
 335   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
 336   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
 337   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
 338   for `PathBuf`.][50170]
 339 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
 340   and `Wrapping<i128>`.][50465]
 341 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
 342   possible.][51050] This can provide up to a 40% speed increase.
 343 - [Improved error messages when using `format!`.][50610]
 344
 345 Stabilized APIs
 346 ---------------
 347 - [`Iterator::step_by`]
 348 - [`Path::ancestors`]
 349 - [`SystemTime::UNIX_EPOCH`]
 350 - [`alloc::GlobalAlloc`]
 351 - [`alloc::Layout`]
 352 - [`alloc::LayoutErr`]
 353 - [`alloc::System`]
 354 - [`alloc::alloc`]
 355 - [`alloc::alloc_zeroed`]
 356 - [`alloc::dealloc`]
 357 - [`alloc::realloc`]
 358 - [`alloc::handle_alloc_error`]
 359 - [`btree_map::Entry::or_default`]
 360 - [`fmt::Alignment`]
 361 - [`hash_map::Entry::or_default`]
 362 - [`iter::repeat_with`]
 363 - [`num::NonZeroUsize`]
 364 - [`num::NonZeroU128`]
 365 - [`num::NonZeroU16`]
 366 - [`num::NonZeroU32`]
 367 - [`num::NonZeroU64`]
 368 - [`num::NonZeroU8`]
 369 - [`ops::RangeBounds`]
 370 - [`slice::SliceIndex`]
 371 - [`slice::from_mut`]
 372 - [`slice::from_ref`]
 373 - [`{Any + Send + Sync}::downcast_mut`]
 374 - [`{Any + Send + Sync}::downcast_ref`]
 375 - [`{Any + Send + Sync}::is`]
 376
 377 Cargo
 378 -----
 379 - [Cargo will now no longer allow you to publish crates with build scripts that
 380   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
 381   considered to be immutable.
 382
 383 Misc
 384 ----
 385 - [The `suggestion_applicability` field in `rustc`'s json output is now
 386   stable.][50486] This will allow dev tools to check whether a code suggestion
 387   would apply to them.
 388
 389 Compatibility Notes
 390 -------------------
 391 - [Rust will consider trait objects with duplicated constraints to be the same
 392   type as without the duplicated constraint.][51276] For example the below code will
 393   now fail to compile.
 394   ```rust
 395   trait Trait {}
 396
 397   impl Trait + Send {
 398       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
 399   }
 400
 401   impl Trait + Send + Send {
 402       fn test(&self) { println!("two"); }
 403   }
 404   ```
 405
 406 [49546]: https://github.com/rust-lang/rust/pull/49546/
 407 [50143]: https://github.com/rust-lang/rust/pull/50143/
 408 [50170]: https://github.com/rust-lang/rust/pull/50170/
 409 [50234]: https://github.com/rust-lang/rust/pull/50234/
 410 [50265]: https://github.com/rust-lang/rust/pull/50265/
 411 [50364]: https://github.com/rust-lang/rust/pull/50364/
 412 [50385]: https://github.com/rust-lang/rust/pull/50385/
 413 [50465]: https://github.com/rust-lang/rust/pull/50465/
 414 [50486]: https://github.com/rust-lang/rust/pull/50486/
 415 [50554]: https://github.com/rust-lang/rust/pull/50554/
 416 [50610]: https://github.com/rust-lang/rust/pull/50610/
 417 [50855]: https://github.com/rust-lang/rust/pull/50855/
 418 [51050]: https://github.com/rust-lang/rust/pull/51050/
 419 [51196]: https://github.com/rust-lang/rust/pull/51196/
 420 [51200]: https://github.com/rust-lang/rust/pull/51200/
 421 [51241]: https://github.com/rust-lang/rust/pull/51241/
 422 [51276]: https://github.com/rust-lang/rust/pull/51276/
 423 [51298]: https://github.com/rust-lang/rust/pull/51298/
 424 [51306]: https://github.com/rust-lang/rust/pull/51306/
 425 [51562]: https://github.com/rust-lang/rust/pull/51562/
 426 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
 427 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
 428 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
 429 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
 430 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
 431 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
 432 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
 433 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
 434 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
 435 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
 436 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
 437 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
 438 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
 439 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
 440 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
 441 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
 442 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
 443 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
 444 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
 445 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
 446 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
 447 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
 448 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
 449 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
 450 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
 451 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
 452 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
 453 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
 454 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
 455 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
 456
 457 Version 1.27.2 (2018-07-20)
 458 ===========================
 459
 460 Compatibility Notes
 461 -------------------
 462
 463 - The borrow checker was fixed to avoid potential unsoundness when using
 464   match ergonomics: [#52213][52213].
 465
 466 [52213]: https://github.com/rust-lang/rust/issues/52213
 467
 468 Version 1.27.1 (2018-07-10)
 469 ===========================
 470
 471 Security Notes
 472 --------------
 473
 474 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
 475   when running, which enabled executing code as some other user on a
 476   given machine. This release fixes that vulnerability; you can read
 477   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
 478
 479   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
 480
 481 Compatibility Notes
 482 -------------------
 483
 484 - The borrow checker was fixed to avoid an additional potential unsoundness when using
 485   match ergonomics: [#51415][51415], [#49534][49534].
 486
 487 [51415]: https://github.com/rust-lang/rust/issues/51415
 488 [49534]: https://github.com/rust-lang/rust/issues/49534
 489 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
 490 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
 491
 492 Version 1.27.0 (2018-06-21)
 493 ==========================
 494
 495 Language
 496 --------
 497 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
 498   be used as an identifier.
 499 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
 500   bare `Trait` syntax, and should make it clearer when being used in tandem with
 501   `impl Trait` because it is equivalent to the following syntax:
 502   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
 503   `Box<Trait> == Box<dyn Trait>`.
 504 - [Attributes on generic parameters such as types and lifetimes are
 505   now stable.][48851] e.g.
 506   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
 507 - [The `#[must_use]` attribute can now also be used on functions as well as
 508   types.][48925] It provides a lint that by default warns users when the
 509   value returned by a function has not been used.
 510
 511 Compiler
 512 --------
 513 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
 514
 515 Libraries
 516 ---------
 517 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
 518   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
 519   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
 520   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
 521   the `cfg` attribute.
 522 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
 523   std are now available in core.][49896]
 524 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
 525   to `Self`.][49630]
 526 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
 527   that the operation isn't done in place.
 528 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
 529   the `#[must_use]` attribute][49533] to warn about unused potentially
 530   expensive allocations.
 531
 532 Stabilized APIs
 533 ---------------
 534 - [`DoubleEndedIterator::rfind`]
 535 - [`DoubleEndedIterator::rfold`]
 536 - [`DoubleEndedIterator::try_rfold`]
 537 - [`Duration::from_micros`]
 538 - [`Duration::from_nanos`]
 539 - [`Duration::subsec_micros`]
 540 - [`Duration::subsec_millis`]
 541 - [`HashMap::remove_entry`]
 542 - [`Iterator::try_fold`]
 543 - [`Iterator::try_for_each`]
 544 - [`NonNull::cast`]
 545 - [`Option::filter`]
 546 - [`String::replace_range`]
 547 - [`Take::set_limit`]
 548 - [`hint::unreachable_unchecked`]
 549 - [`os::unix::process::parent_id`]
 550 - [`ptr::swap_nonoverlapping`]
 551 - [`slice::rsplit_mut`]
 552 - [`slice::rsplit`]
 553 - [`slice::swap_with_slice`]
 554
 555 Cargo
 556 -----
 557 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
 558   `readme`, and `repository` fields.][cargo/5386]
 559 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
 560 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
 561   a different directory than `target` for placing compilation artifacts.
 562 - [Cargo will be adding automatic target inference for binaries, benchmarks,
 563   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
 564   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
 565   where cargo would infer a binary, Cargo will produce a warning. You can
 566   disable this feature ahead of time by setting any of the following to false:
 567   `autobins`, `autobenches`, `autoexamples`, `autotests`.
 568 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
 569   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
 570
 571 Misc
 572 ----
 573 - [Added “The Rustc book” into the official documentation.][49707]
 574   [“The Rustc book”] documents and teaches how to use the rustc compiler.
 575 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
 576
 577 Compatibility Notes
 578 -------------------
 579 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
 580   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
 581   compile, `"".is_empty()` will still compile.
 582 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
 583   will only print the inner type.][48553] E.g.
 584   `print!("{:?}", AtomicBool::new(true))` will print `true`,
 585   not `AtomicBool(true)`.
 586 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
 587   could enter higher numbers but they were not supported by LLVM. Up to 512MB
 588   alignment should cover all use cases.
 589 - The `.description()` method on the `std::error::Error` trait
 590   [has been soft-deprecated][50163]. It is no longer required to implement it.
 591
 592 [48553]: https://github.com/rust-lang/rust/pull/48553/
 593 [48851]: https://github.com/rust-lang/rust/pull/48851/
 594 [48925]: https://github.com/rust-lang/rust/pull/48925/
 595 [49533]: https://github.com/rust-lang/rust/pull/49533/
 596 [49623]: https://github.com/rust-lang/rust/pull/49623/
 597 [49630]: https://github.com/rust-lang/rust/pull/49630/
 598 [49664]: https://github.com/rust-lang/rust/pull/49664/
 599 [49699]: https://github.com/rust-lang/rust/pull/49699/
 600 [49707]: https://github.com/rust-lang/rust/pull/49707/
 601 [49719]: https://github.com/rust-lang/rust/pull/49719/
 602 [49896]: https://github.com/rust-lang/rust/pull/49896/
 603 [49968]: https://github.com/rust-lang/rust/pull/49968/
 604 [50163]: https://github.com/rust-lang/rust/pull/50163
 605 [50177]: https://github.com/rust-lang/rust/pull/50177/
 606 [50378]: https://github.com/rust-lang/rust/pull/50378/
 607 [50398]: https://github.com/rust-lang/rust/pull/50398/
 608 [50423]: https://github.com/rust-lang/rust/pull/50423/
 609 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
 610 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
 611 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
 612 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
 613 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
 614 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
 615 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
 616 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
 617 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
 618 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
 619 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
 620 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
 621 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
 622 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
 623 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
 624 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
 625 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
 626 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
 627 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
 628 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
 629 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
 630 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
 631 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
 632 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
 633 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
 634 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
 635 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
 636 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
 637 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
 638 [“The Rustc book”]: https://doc.rust-lang.org/rustc
 639
 640
 641 Version 1.26.2 (2018-06-05)
 642 ==========================
 643
 644 Compatibility Notes
 645 -------------------
 646
 647 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
 648
 649 [51117]: https://github.com/rust-lang/rust/issues/51117
 650
 651
 652 Version 1.26.1 (2018-05-29)
 653 ==========================
 654
 655 Tools
 656 -----
 657
 658 - [RLS now works on Windows.][50646]
 659 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
 660
 661
 662 Compatibility Notes
 663 --------
 664
 665 - [`fn main() -> impl Trait` no longer works for non-Termination
 666   trait.][50656]
 667   This reverts an accidental stabilization.
 668 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
 669 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
 670
 671 [50646]: https://github.com/rust-lang/rust/issues/50646
 672 [50656]: https://github.com/rust-lang/rust/pull/50656
 673 [50812]: https://github.com/rust-lang/rust/pull/50812
 674 [50950]: https://github.com/rust-lang/rust/issues/50950
 675 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
 676
 677 Version 1.26.0 (2018-05-10)
 678 ==========================
 679
 680 Language
 681 --------
 682 - [Closures now implement `Copy` and/or `Clone` if all captured variables
 683   implement either or both traits.][49299]
 684 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
 685 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
 686   lifetime can be elided.][49458]
 687 - [`impl Trait` is now stable allowing you to have abstract types in returns
 688    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
 689   `fn open(path: impl AsRef<Path>)`.
 690 - [Pattern matching will now automatically apply dereferences.][49394]
 691 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
 692 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
 693 - [A lot of operations are now available in a const context.][46882] E.g. You
 694   can now index into constant arrays, reference and dereference into constants,
 695   and use tuple struct constructors.
 696 - [Fixed entry slice patterns are now stable.][48516] E.g.
 697   ```rust
 698   let points = [1, 2, 3, 4];
 699   match points {
 700       [1, 2, 3, 4] => println!("All points were sequential."),
 701       _ => println!("Not all points were sequential."),
 702   }
 703   ```
 704
 705
 706 Compiler
 707 --------
 708 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
 709 - [Fixed exponential projection complexity on nested types.][48296]
 710   This can provide up to a ~12% reduction in compile times for certain crates.
 711 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
 712   to remap path prefixes outputted by the compiler.
 713 - [Added `powerpc-unknown-netbsd` target.][48281]
 714
 715 Libraries
 716 ---------
 717 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
 718 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
 719   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
 720 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
 721 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
 722 - [`ascii::escape_default` is now available in libcore.][48735]
 723 - [Trailing commas are now supported in std and core macros.][48056]
 724 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
 725 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
 726
 727 Stabilized APIs
 728 ---------------
 729 - [`*const T::add`]
 730 - [`*const T::copy_to_nonoverlapping`]
 731 - [`*const T::copy_to`]
 732 - [`*const T::read_unaligned`]
 733 - [`*const T::read_volatile`]
 734 - [`*const T::read`]
 735 - [`*const T::sub`]
 736 - [`*const T::wrapping_add`]
 737 - [`*const T::wrapping_sub`]
 738 - [`*mut T::add`]
 739 - [`*mut T::copy_to_nonoverlapping`]
 740 - [`*mut T::copy_to`]
 741 - [`*mut T::read_unaligned`]
 742 - [`*mut T::read_volatile`]
 743 - [`*mut T::read`]
 744 - [`*mut T::replace`]
 745 - [`*mut T::sub`]
 746 - [`*mut T::swap`]
 747 - [`*mut T::wrapping_add`]
 748 - [`*mut T::wrapping_sub`]
 749 - [`*mut T::write_bytes`]
 750 - [`*mut T::write_unaligned`]
 751 - [`*mut T::write_volatile`]
 752 - [`*mut T::write`]
 753 - [`Box::leak`]
 754 - [`FromUtf8Error::as_bytes`]
 755 - [`LocalKey::try_with`]
 756 - [`Option::cloned`]
 757 - [`btree_map::Entry::and_modify`]
 758 - [`fs::read_to_string`]
 759 - [`fs::read`]
 760 - [`fs::write`]
 761 - [`hash_map::Entry::and_modify`]
 762 - [`iter::FusedIterator`]
 763 - [`ops::RangeInclusive`]
 764 - [`ops::RangeToInclusive`]
 765 - [`process::id`]
 766 - [`slice::rotate_left`]
 767 - [`slice::rotate_right`]
 768 - [`String::retain`]
 769
 770
 771 Cargo
 772 -----
 773 - [Cargo will now output path to custom commands when `-v` is
 774   passed with `--list`][cargo/5041]
 775 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
 776
 777 Misc
 778 ----
 779 - [The second edition of "The Rust Programming Language" book is now recommended
 780   over the first.][48404]
 781
 782 Compatibility Notes
 783 -------------------
 784
 785 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
 786   syntax is now invalid.
 787   ```
 788   use std::ops::Fn as dyn;
 789   fn g(_: Box<dyn(std::fmt::Debug)>) {}
 790   ```
 791 - [The result of dereferences are no longer promoted to `'static`.][47408]
 792   e.g.
 793   ```rust
 794   fn main() {
 795       const PAIR: &(i32, i32) = &(0, 1);
 796       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
 797   }
 798   ```
 799 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
 800 - [`".e0"` will now no longer parse as `0.0` and will instead cause
 801   an error.][48235]
 802 - [Removed hoedown from rustdoc.][48274]
 803 - [Bounds on higher-kinded lifetimes a hard error.][48326]
 804
 805 [46882]: https://github.com/rust-lang/rust/pull/46882
 806 [47379]: https://github.com/rust-lang/rust/pull/47379
 807 [47408]: https://github.com/rust-lang/rust/pull/47408
 808 [47813]: https://github.com/rust-lang/rust/pull/47813
 809 [48056]: https://github.com/rust-lang/rust/pull/48056
 810 [48125]: https://github.com/rust-lang/rust/pull/48125
 811 [48166]: https://github.com/rust-lang/rust/pull/48166
 812 [48235]: https://github.com/rust-lang/rust/pull/48235
 813 [48274]: https://github.com/rust-lang/rust/pull/48274
 814 [48281]: https://github.com/rust-lang/rust/pull/48281
 815 [48296]: https://github.com/rust-lang/rust/pull/48296
 816 [48326]: https://github.com/rust-lang/rust/pull/48326
 817 [48359]: https://github.com/rust-lang/rust/pull/48359
 818 [48404]: https://github.com/rust-lang/rust/pull/48404
 819 [48481]: https://github.com/rust-lang/rust/pull/48481
 820 [48516]: https://github.com/rust-lang/rust/pull/48516
 821 [48628]: https://github.com/rust-lang/rust/pull/48628
 822 [48629]: https://github.com/rust-lang/rust/pull/48629
 823 [48657]: https://github.com/rust-lang/rust/pull/48657
 824 [48735]: https://github.com/rust-lang/rust/pull/48735
 825 [48978]: https://github.com/rust-lang/rust/pull/48978
 826 [49101]: https://github.com/rust-lang/rust/pull/49101
 827 [49109]: https://github.com/rust-lang/rust/pull/49109
 828 [49121]: https://github.com/rust-lang/rust/pull/49121
 829 [49162]: https://github.com/rust-lang/rust/pull/49162
 830 [49184]: https://github.com/rust-lang/rust/pull/49184
 831 [49234]: https://github.com/rust-lang/rust/pull/49234
 832 [49255]: https://github.com/rust-lang/rust/pull/49255
 833 [49299]: https://github.com/rust-lang/rust/pull/49299
 834 [49305]: https://github.com/rust-lang/rust/pull/49305
 835 [49394]: https://github.com/rust-lang/rust/pull/49394
 836 [49458]: https://github.com/rust-lang/rust/pull/49458
 837 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
 838 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
 839 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
 840 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
 841 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
 842 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
 843 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
 844 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
 845 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
 846 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
 847 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
 848 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
 849 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
 850 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
 851 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
 852 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
 853 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
 854 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
 855 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
 856 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
 857 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
 858 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
 859 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
 860 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
 861 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
 862 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
 863 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
 864 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
 865 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
 866 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
 867 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
 868 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
 869 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
 870 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
 871 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
 872 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
 873 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
 874 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
 875 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
 876 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
 877 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
 878 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
 879
 880
 881 Version 1.25.0 (2018-03-29)
 882 ==========================
 883
 884 Language
 885 --------
 886 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
 887 - [You can now use nested groups of imports.][47948]
 888   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
 889 - [You can now have `|` at the start of a match arm.][47947] e.g.
 890 ```rust
 891 enum Foo { A, B, C }
 892
 893 fn main() {
 894     let x = Foo::A;
 895     match x {
 896         | Foo::A
 897         | Foo::B => println!("AB"),
 898         | Foo::C => println!("C"),
 899     }
 900 }
 901 ```
 902
 903 Compiler
 904 --------
 905 - [Upgraded to LLVM 6.][47828]
 906 - [Added `-C lto=val` option.][47521]
 907 - [Added `i586-unknown-linux-musl` target][47282]
 908
 909 Libraries
 910 ---------
 911 - [Impl Send for `process::Command` on Unix.][47760]
 912 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
 913 - [`UnsafeCell::into_inner` is now safe.][47204]
 914 - [Implement libstd for CloudABI.][47268]
 915 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
 916 - [Implement `AsRef<Path>` for Component][46985]
 917 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
 918 - [Moved `Duration` to libcore.][46666]
 919
 920 Stabilized APIs
 921 ---------------
 922 - [`Location::column`]
 923 - [`ptr::NonNull`]
 924
 925 The following functions can now be used in a constant expression.
 926 eg. `static MINUTE: Duration = Duration::from_secs(60);`
 927 - [`Duration::new`][47300]
 928 - [`Duration::from_secs`][47300]
 929 - [`Duration::from_millis`][47300]
 930
 931 Cargo
 932 -----
 933 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
 934 - [`cargo new` now defaults to creating a binary crate, instead of a
 935   library crate.][cargo/5029]
 936
 937 Misc
 938 ----
 939 - [Rust by example is now shipped with new releases][46196]
 940
 941 Compatibility Notes
 942 -------------------
 943 - [Deprecated `net::lookup_host`.][47510]
 944 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
 945 - The borrow checker was sometimes incorrectly permitting overlapping borrows
 946   around indexing operations (see [#47349][47349]). This has been fixed (which also
 947   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
 948 - [Removed deprecated unstable attribute `#[simd]`.][47251]
 949
 950 [33903]: https://github.com/rust-lang/rust/pull/33903
 951 [47947]: https://github.com/rust-lang/rust/pull/47947
 952 [47948]: https://github.com/rust-lang/rust/pull/47948
 953 [47760]: https://github.com/rust-lang/rust/pull/47760
 954 [47790]: https://github.com/rust-lang/rust/pull/47790
 955 [47828]: https://github.com/rust-lang/rust/pull/47828
 956 [47398]: https://github.com/rust-lang/rust/pull/47398
 957 [47510]: https://github.com/rust-lang/rust/pull/47510
 958 [47521]: https://github.com/rust-lang/rust/pull/47521
 959 [47204]: https://github.com/rust-lang/rust/pull/47204
 960 [47251]: https://github.com/rust-lang/rust/pull/47251
 961 [47268]: https://github.com/rust-lang/rust/pull/47268
 962 [47282]: https://github.com/rust-lang/rust/pull/47282
 963 [47300]: https://github.com/rust-lang/rust/pull/47300
 964 [47349]: https://github.com/rust-lang/rust/pull/47349
 965 [46931]: https://github.com/rust-lang/rust/pull/46931
 966 [46985]: https://github.com/rust-lang/rust/pull/46985
 967 [47006]: https://github.com/rust-lang/rust/pull/47006
 968 [46830]: https://github.com/rust-lang/rust/pull/46830
 969 [46095]: https://github.com/rust-lang/rust/pull/46095
 970 [46666]: https://github.com/rust-lang/rust/pull/46666
 971 [46196]: https://github.com/rust-lang/rust/pull/46196
 972 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
 973 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
 974 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
 975 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
 976 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
 977
 978
 979 Version 1.24.1 (2018-03-01)
 980 ==========================
 981
 982  - [Do not abort when unwinding through FFI][48251]
 983  - [Emit UTF-16 files for linker arguments on Windows][48318]
 984  - [Make the error index generator work again][48308]
 985  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
 986
 987 [48251]: https://github.com/rust-lang/rust/issues/48251
 988 [48308]: https://github.com/rust-lang/rust/issues/48308
 989 [48318]: https://github.com/rust-lang/rust/issues/48318
 990 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
 991
 992
 993 Version 1.24.0 (2018-02-15)
 994 ==========================
 995
 996 Language
 997 --------
 998 - [External `sysv64` ffi is now available.][46528]
 999   eg. `extern "sysv64" fn foo () {}`
1000
1001 Compiler
1002 --------
1003 - [rustc now uses 16 codegen units by default for release builds.][46910]
1004   For the fastest builds, utilize `codegen-units=1`.
1005 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1006 - [Add `aarch64-unknown-openbsd` support][46760]
1007
1008 Libraries
1009 ---------
1010 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1011   improvement in performance in the majority of cases.
1012 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1013   with Windows.][46798]
1014 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1015 - [impl `From<bool>` for `AtomicBool`][46293]
1016 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1017 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1018 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1019 - [float::from_bits now just uses transmute.][46012] This provides
1020   some optimisations from LLVM.
1021 - [Copied `AsciiExt` methods onto `char`][46077]
1022 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1023 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1024 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1025 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1026
1027 Stabilized APIs
1028 ---------------
1029 - [`RefCell::replace`]
1030 - [`RefCell::swap`]
1031 - [`atomic::spin_loop_hint`]
1032
1033 The following functions can now be used in a constant expression.
1034 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1035
1036 - [`AtomicBool::new`][46287]
1037 - [`AtomicUsize::new`][46287]
1038 - [`AtomicIsize::new`][46287]
1039 - [`AtomicPtr::new`][46287]
1040 - [`Cell::new`][46287]
1041 - [`{integer}::min_value`][46287]
1042 - [`{integer}::max_value`][46287]
1043 - [`mem::size_of`][46287]
1044 - [`mem::align_of`][46287]
1045 - [`ptr::null`][46287]
1046 - [`ptr::null_mut`][46287]
1047 - [`RefCell::new`][46287]
1048 - [`UnsafeCell::new`][46287]
1049
1050 Cargo
1051 -----
1052 - [Added a `workspace.default-members` config that
1053   overrides implied `--all` in virtual workspaces.][cargo/4743]
1054 - [Enable incremental by default on development builds.][cargo/4817] Also added
1055   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1056   per-project or global basis respectively.
1057
1058 Misc
1059 ----
1060
1061 Compatibility Notes
1062 -------------------
1063 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1064 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1065   in accordance with IETF RFC 4291 §2.2.
1066 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1067 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1068   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1069 - [Leading zeros in tuple struct members is now an error][47084]
1070 - [`column!()` macro is one-based instead of zero-based][46977]
1071 - [`fmt::Arguments` can no longer be shared across threads][45198]
1072 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1073 - [Cargo sets a different working directory for the compiler][cargo/4788]
1074
1075 [44884]: https://github.com/rust-lang/rust/pull/44884
1076 [45198]: https://github.com/rust-lang/rust/pull/45198
1077 [45506]: https://github.com/rust-lang/rust/pull/45506
1078 [45904]: https://github.com/rust-lang/rust/pull/45904
1079 [45990]: https://github.com/rust-lang/rust/pull/45990
1080 [46012]: https://github.com/rust-lang/rust/pull/46012
1081 [46077]: https://github.com/rust-lang/rust/pull/46077
1082 [46094]: https://github.com/rust-lang/rust/pull/46094
1083 [46284]: https://github.com/rust-lang/rust/pull/46284
1084 [46287]: https://github.com/rust-lang/rust/pull/46287
1085 [46293]: https://github.com/rust-lang/rust/pull/46293
1086 [46528]: https://github.com/rust-lang/rust/pull/46528
1087 [46671]: https://github.com/rust-lang/rust/pull/46671
1088 [46713]: https://github.com/rust-lang/rust/pull/46713
1089 [46735]: https://github.com/rust-lang/rust/pull/46735
1090 [46749]: https://github.com/rust-lang/rust/pull/46749
1091 [46760]: https://github.com/rust-lang/rust/pull/46760
1092 [46798]: https://github.com/rust-lang/rust/pull/46798
1093 [46828]: https://github.com/rust-lang/rust/pull/46828
1094 [46831]: https://github.com/rust-lang/rust/pull/46831
1095 [46833]: https://github.com/rust-lang/rust/pull/46833
1096 [46910]: https://github.com/rust-lang/rust/pull/46910
1097 [46977]: https://github.com/rust-lang/rust/pull/46977
1098 [47018]: https://github.com/rust-lang/rust/pull/47018
1099 [47080]: https://github.com/rust-lang/rust/pull/47080
1100 [47084]: https://github.com/rust-lang/rust/pull/47084
1101 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1102 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1103 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1104 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1105 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1106 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1107
1108
1109 Version 1.23.0 (2018-01-04)
1110 ==========================
1111
1112 Language
1113 --------
1114 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1115 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1116   Which should fix some confusing errors in some operations.
1117
1118 Compiler
1119 --------
1120 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1121   undefined behavior.][45920]
1122 - [rustc now suggests renaming import if names clash.][45660]
1123 - [Display errors/warnings correctly when there are zero-width or
1124   wide characters.][45711]
1125 - [rustc now avoids unnecessary copies of arguments that are
1126   simple bindings][45380] This should improve memory usage on average by 5-10%.
1127 - [Updated musl used to build musl rustc to 1.1.17][45393]
1128
1129 Libraries
1130 ---------
1131 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1132 - [Implement Hash for raw pointers to unsized types][45483]
1133 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1134 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1135 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1136 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1137   and `<*mut T>::as_mut`][44932]
1138 - [Optimized `Thread::{park, unpark}` implementation][45524]
1139 - [Improved `SliceExt::binary_search` performance.][45333]
1140 - [impl `FromIterator<()>` for `()`][45379]
1141 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1142   is now deprecated.
1143
1144 Stabilized APIs
1145 ---------------
1146
1147 Cargo
1148 -----
1149 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1150   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1151 - [Added unit test checking to `cargo check`][cargo/4592]
1152 - [Cargo now lets you install a specific version
1153   using `cargo install --version`][cargo/4637]
1154
1155 Misc
1156 ----
1157 - [Releases now ship with the Cargo book documentation.][45692]
1158 - [rustdoc now prints rendering warnings on every run.][45324]
1159
1160 Compatibility Notes
1161 -------------------
1162 - [Changes have been made to type equality to make it more correct,
1163   in rare cases this could break some code.][45853] [Tracking issue for
1164   further information][45852]
1165 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1166 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1167   Android 9, the minimum supported version is Android 14.
1168 - [Bumped the minimum LLVM to 3.9][45326]
1169
1170 [44042]: https://github.com/rust-lang/rust/pull/44042
1171 [44932]: https://github.com/rust-lang/rust/pull/44932
1172 [45267]: https://github.com/rust-lang/rust/pull/45267
1173 [45324]: https://github.com/rust-lang/rust/pull/45324
1174 [45326]: https://github.com/rust-lang/rust/pull/45326
1175 [45333]: https://github.com/rust-lang/rust/pull/45333
1176 [45379]: https://github.com/rust-lang/rust/pull/45379
1177 [45380]: https://github.com/rust-lang/rust/pull/45380
1178 [45393]: https://github.com/rust-lang/rust/pull/45393
1179 [45435]: https://github.com/rust-lang/rust/pull/45435
1180 [45483]: https://github.com/rust-lang/rust/pull/45483
1181 [45524]: https://github.com/rust-lang/rust/pull/45524
1182 [45571]: https://github.com/rust-lang/rust/pull/45571
1183 [45580]: https://github.com/rust-lang/rust/pull/45580
1184 [45610]: https://github.com/rust-lang/rust/pull/45610
1185 [45660]: https://github.com/rust-lang/rust/pull/45660
1186 [45692]: https://github.com/rust-lang/rust/pull/45692
1187 [45711]: https://github.com/rust-lang/rust/pull/45711
1188 [45772]: https://github.com/rust-lang/rust/pull/45772
1189 [45852]: https://github.com/rust-lang/rust/issues/45852
1190 [45853]: https://github.com/rust-lang/rust/pull/45853
1191 [45887]: https://github.com/rust-lang/rust/pull/45887
1192 [45920]: https://github.com/rust-lang/rust/pull/45920
1193 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1194 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1195 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1196
1197
1198 Version 1.22.1 (2017-11-22)
1199 ==========================
1200
1201 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1202
1203 [46183]: https://github.com/rust-lang/rust/pull/46183
1204
1205 Version 1.22.0 (2017-11-22)
1206 ==========================
1207
1208 Language
1209 --------
1210 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1211 - [Now accepts underscores in unicode escapes][43716]
1212 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1213 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1214
1215 Compiler
1216 --------
1217 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1218 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1219   This should decrease compile times for debug builds.
1220 - [strict memory alignment now enabled on ARMv6][45094]
1221 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1222
1223 Libraries
1224 ---------
1225 - [Allow atomic operations up to 32 bits
1226   on `armv5te_unknown_linux_gnueabi`][44978]
1227 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1228 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1229 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1230 - [Properly detect overflow in `Instant += Duration`.][44220]
1231 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1232 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1233 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1234
1235 Stabilized APIs
1236 ---------------
1237
1238 Cargo
1239 -----
1240 - [Cargo will now build multi file examples in subdirectories of the `examples`
1241   folder that have a `main.rs` file.][cargo/4496]
1242 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1243   the old format will continue to work and can be updated with `cargo update`.
1244 - [Now supports vendoring git repositories][cargo/3992]
1245
1246 Misc
1247 ----
1248 - [`libbacktrace` is now available on Apple platforms.][44251]
1249 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1250   This now lets you specify that a given code example will fail to compile.
1251
1252 Compatibility Notes
1253 -------------------
1254 - [The minimum Android version that rustc can build for has been bumped
1255   to `4.0` from `2.3`][45656]
1256 - [Allowing `T op= &T` for numeric types has broken some type
1257   inference cases][45480]
1258
1259
1260 [42526]: https://github.com/rust-lang/rust/pull/42526
1261 [43017]: https://github.com/rust-lang/rust/pull/43017
1262 [43716]: https://github.com/rust-lang/rust/pull/43716
1263 [43949]: https://github.com/rust-lang/rust/pull/43949
1264 [44015]: https://github.com/rust-lang/rust/pull/44015
1265 [44220]: https://github.com/rust-lang/rust/pull/44220
1266 [44251]: https://github.com/rust-lang/rust/pull/44251
1267 [44287]: https://github.com/rust-lang/rust/pull/44287
1268 [44303]: https://github.com/rust-lang/rust/pull/44303
1269 [44456]: https://github.com/rust-lang/rust/pull/44456
1270 [44466]: https://github.com/rust-lang/rust/pull/44466
1271 [44895]: https://github.com/rust-lang/rust/pull/44895
1272 [44966]: https://github.com/rust-lang/rust/pull/44966
1273 [44978]: https://github.com/rust-lang/rust/pull/44978
1274 [45041]: https://github.com/rust-lang/rust/pull/45041
1275 [45064]: https://github.com/rust-lang/rust/pull/45064
1276 [45075]: https://github.com/rust-lang/rust/pull/45075
1277 [45094]: https://github.com/rust-lang/rust/pull/45094
1278 [45095]: https://github.com/rust-lang/rust/pull/45095
1279 [45480]: https://github.com/rust-lang/rust/issues/45480
1280 [45656]: https://github.com/rust-lang/rust/pull/45656
1281 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1282 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1283 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1284
1285
1286
1287
1288
1289
1290 Version 1.21.0 (2017-10-12)
1291 ==========================
1292
1293 Language
1294 --------
1295 - [You can now use static references for literals.][43838]
1296   Example:
1297   ```rust
1298   fn main() {
1299       let x: &'static u32 = &0;
1300   }
1301   ```
1302 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1303   Example:
1304   ```rust
1305   my_macro!(Vec<i32>::new); // Always worked
1306   my_macro!(Vec::<i32>::new); // Now works
1307   ```
1308
1309 Compiler
1310 --------
1311 - [Upgraded jemalloc to 4.5.0][43911]
1312 - [Enabled unwinding panics on Redox][43917]
1313 - [Now runs LLVM in parallel during translation phase.][43506]
1314   This should reduce peak memory usage.
1315
1316 Libraries
1317 ---------
1318 - [Generate builtin impls for `Clone` for all arrays and tuples that
1319   are `T: Clone`][43690]
1320 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1321 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1322   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1323
1324 Stabilized APIs
1325 ---------------
1326
1327 [`std::mem::discriminant`]
1328
1329 Cargo
1330 -----
1331 - [You can now call `cargo install` with multiple package names][cargo/4216]
1332 - [Cargo commands inside a virtual workspace will now implicitly
1333   pass `--all`][cargo/4335]
1334 - [Added a `[patch]` section to `Cargo.toml` to handle
1335   prepublication dependencies][cargo/4123] [RFC 1969]
1336 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1337   like patterns][cargo/4270]
1338 - [Added the `--all-targets` option][cargo/4400]
1339 - [Using required dependencies as a feature is now deprecated and emits
1340   a warning][cargo/4364]
1341
1342
1343 Misc
1344 ----
1345 - [Cargo docs are moving][43916]
1346   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1347 - [The rustdoc book is now available][43863]
1348   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1349 - [Added a preview of RLS has been made available through rustup][44204]
1350   Install with `rustup component add rls-preview`
1351 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1352   Previously only showed `std::os::unix`.
1353
1354 Compatibility Notes
1355 -------------------
1356 - [Changes in method matching against higher-ranked types][43880] This may cause
1357   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1358 - [rustc's JSON error output's byte position start at top of file.][42973]
1359   Was previously relative to the rustc's internal `CodeMap` struct which
1360   required the unstable library `libsyntax` to correctly use.
1361 - [`unused_results` lint no longer ignores booleans][43728]
1362
1363 [42565]: https://github.com/rust-lang/rust/pull/42565
1364 [42973]: https://github.com/rust-lang/rust/pull/42973
1365 [43348]: https://github.com/rust-lang/rust/pull/43348
1366 [43459]: https://github.com/rust-lang/rust/pull/43459
1367 [43506]: https://github.com/rust-lang/rust/pull/43506
1368 [43540]: https://github.com/rust-lang/rust/pull/43540
1369 [43690]: https://github.com/rust-lang/rust/pull/43690
1370 [43728]: https://github.com/rust-lang/rust/pull/43728
1371 [43838]: https://github.com/rust-lang/rust/pull/43838
1372 [43863]: https://github.com/rust-lang/rust/pull/43863
1373 [43880]: https://github.com/rust-lang/rust/pull/43880
1374 [43911]: https://github.com/rust-lang/rust/pull/43911
1375 [43916]: https://github.com/rust-lang/rust/pull/43916
1376 [43917]: https://github.com/rust-lang/rust/pull/43917
1377 [44204]: https://github.com/rust-lang/rust/pull/44204
1378 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1379 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1380 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1381 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1382 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1383 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1384 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1385 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1386 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1387
1388 Version 1.20.0 (2017-08-31)
1389 ===========================
1390
1391 Language
1392 --------
1393 - [Associated constants are now stabilised.][42809]
1394 - [A lot of macro bugs are now fixed.][42913]
1395
1396 Compiler
1397 --------
1398
1399 - [Struct fields are now properly coerced to the expected field type.][42807]
1400 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1401   `wasm32-experimental-emscripten` target.
1402 - [Changed some of the error messages to be more helpful.][42033]
1403 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1404   it.][43170]
1405 - [rustc now reports the total number of errors on compilation failure][43015]
1406   previously this was only the number of errors in the pass that failed.
1407 - [Expansion in rustc has been sped up 29x.][42533]
1408 - [added `msp430-none-elf` target.][43099]
1409 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1410   applicable][43178]
1411 - [Fixes backtraces on Redox][43228]
1412 - [rustc now identifies different versions of same crate when absolute paths of
1413   different types match in an error message.][42826]
1414
1415 Libraries
1416 ---------
1417
1418
1419 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1420 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1421   tuples.][43011]
1422 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1423   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1424 - [Impl `Clone` for `DefaultHasher`.][42799]
1425 - [Impl `Sync` for `SyncSender`.][42397]
1426 - [Impl `FromStr` for `char`][42271]
1427 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1428   NaN.][42431]
1429 - [allow messages in the `unimplemented!()` macro.][42155]
1430   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1431 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1432 - [Upgrade to Unicode 10.0.0][42999]
1433 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1434 - [Skip the main thread's manual stack guard on Linux][43072]
1435 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1436 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1437   previously 2^15.
1438 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1439
1440 Stabilized APIs
1441 ---------------
1442
1443 - [`CStr::into_c_string`]
1444 - [`CString::as_c_str`]
1445 - [`CString::into_boxed_c_str`]
1446 - [`Chain::get_mut`]
1447 - [`Chain::get_ref`]
1448 - [`Chain::into_inner`]
1449 - [`Option::get_or_insert_with`]
1450 - [`Option::get_or_insert`]
1451 - [`OsStr::into_os_string`]
1452 - [`OsString::into_boxed_os_str`]
1453 - [`Take::get_mut`]
1454 - [`Take::get_ref`]
1455 - [`Utf8Error::error_len`]
1456 - [`char::EscapeDebug`]
1457 - [`char::escape_debug`]
1458 - [`compile_error!`]
1459 - [`f32::from_bits`]
1460 - [`f32::to_bits`]
1461 - [`f64::from_bits`]
1462 - [`f64::to_bits`]
1463 - [`mem::ManuallyDrop`]
1464 - [`slice::sort_unstable_by_key`]
1465 - [`slice::sort_unstable_by`]
1466 - [`slice::sort_unstable`]
1467 - [`str::from_boxed_utf8_unchecked`]
1468 - [`str::as_bytes_mut`]
1469 - [`str::as_bytes_mut`]
1470 - [`str::from_utf8_mut`]
1471 - [`str::from_utf8_unchecked_mut`]
1472 - [`str::get_mut`]
1473 - [`str::get_unchecked_mut`]
1474 - [`str::get_unchecked`]
1475 - [`str::get`]
1476 - [`str::into_boxed_bytes`]
1477
1478
1479 Cargo
1480 -----
1481 - [Cargo API token location moved from `~/.cargo/config` to
1482   `~/.cargo/credentials`.][cargo/3978]
1483 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1484   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1485   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1486 - [You can now specify version of a binary when installed through
1487   `cargo install` using `--vers`.][cargo/4229]
1488 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1489   failure.][cargo/4248]
1490 - [Changed the convention around which file is the crate root.][cargo/4259]
1491 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1492   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1493
1494 Compatibility Notes
1495 -------------------
1496
1497 - [Functions with `'static` in their return types will now not be as usable as
1498   if they were using lifetime parameters instead.][42417]
1499 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1500   takes the sign of NaN into account where previously didn't.][42430]
1501
1502 [42033]: https://github.com/rust-lang/rust/pull/42033
1503 [42155]: https://github.com/rust-lang/rust/pull/42155
1504 [42271]: https://github.com/rust-lang/rust/pull/42271
1505 [42397]: https://github.com/rust-lang/rust/pull/42397
1506 [42417]: https://github.com/rust-lang/rust/pull/42417
1507 [42430]: https://github.com/rust-lang/rust/pull/42430
1508 [42431]: https://github.com/rust-lang/rust/pull/42431
1509 [42533]: https://github.com/rust-lang/rust/pull/42533
1510 [42571]: https://github.com/rust-lang/rust/pull/42571
1511 [42613]: https://github.com/rust-lang/rust/pull/42613
1512 [42799]: https://github.com/rust-lang/rust/pull/42799
1513 [42807]: https://github.com/rust-lang/rust/pull/42807
1514 [42809]: https://github.com/rust-lang/rust/pull/42809
1515 [42822]: https://github.com/rust-lang/rust/pull/42822
1516 [42826]: https://github.com/rust-lang/rust/pull/42826
1517 [42854]: https://github.com/rust-lang/rust/pull/42854
1518 [42913]: https://github.com/rust-lang/rust/pull/42913
1519 [42999]: https://github.com/rust-lang/rust/pull/42999
1520 [43011]: https://github.com/rust-lang/rust/pull/43011
1521 [43015]: https://github.com/rust-lang/rust/pull/43015
1522 [43072]: https://github.com/rust-lang/rust/pull/43072
1523 [43077]: https://github.com/rust-lang/rust/pull/43077
1524 [43097]: https://github.com/rust-lang/rust/pull/43097
1525 [43099]: https://github.com/rust-lang/rust/pull/43099
1526 [43170]: https://github.com/rust-lang/rust/pull/43170
1527 [43178]: https://github.com/rust-lang/rust/pull/43178
1528 [43185]: https://github.com/rust-lang/rust/pull/43185
1529 [43228]: https://github.com/rust-lang/rust/pull/43228
1530 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1531 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1532 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1533 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1534 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1535 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1536 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1537 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1538 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1539 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1540 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1541 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1542 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1543 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1544 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1545 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1546 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1547 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1548 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1549 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1550 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1551 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1552 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1553 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1554 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1555 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1556 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1557 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1558 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1559 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1560 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1561 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1562 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1563 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1564 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1565 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1566 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1567 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1568 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1569
1570
1571 Version 1.19.0 (2017-07-20)
1572 ===========================
1573
1574 Language
1575 --------
1576
1577 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1578   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1579 - [Macro recursion limit increased to 1024 from 64.][41676]
1580 - [Added lint for detecting unused macros.][41907]
1581 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1582   For example: `let x = loop { break 7; };`
1583 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1584   contain `Copy` types and cannot have a `Drop` implementation.
1585   Example: `union Foo { bar: u8, baz: usize }`
1586 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1587   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1588
1589 Compiler
1590 --------
1591
1592 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1593 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1594   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1595   you should use `--target armv7-linux-androideabi`.
1596 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1597 - [Minor optimisation of string operations.][42037]
1598 - [Compiler error message is now `aborting due to previous error(s)` instead of
1599   `aborting due to N previous errors`][42150] This was previously inaccurate and
1600   would only count certain kinds of errors.
1601 - [The compiler now supports Visual Studio 2017][42225]
1602 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1603 - [Added a lot][42264] of [new error codes][42302]
1604 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1605   libraries with C Run-time Libraries(CRT) to be statically linked.
1606 - [Fixed various ARM codegen bugs][42740]
1607
1608 Libraries
1609 ---------
1610
1611 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1612   `Extend<Cow<'a, str>>`][41449]
1613 - [`Vec` now implements `From<&mut [T]>`][41530]
1614 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1615 - [`SplitWhitespace` now implements `Clone`][41659]
1616 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1617   1.5x faster][41764]
1618 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1619   macros, but for printing to stderr.
1620
1621 Stabilized APIs
1622 ---------------
1623
1624 - [`OsString::shrink_to_fit`]
1625 - [`cmp::Reverse`]
1626 - [`Command::envs`]
1627 - [`thread::ThreadId`]
1628
1629 Cargo
1630 -----
1631
1632 - [Build scripts can now add environment variables to the environment
1633   the crate is being compiled in.
1634   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1635 - [Subcommands now replace the current process rather than spawning a new
1636   child process][cargo/3970]
1637 - [Workspace members can now accept glob file patterns][cargo/3979]
1638 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1639   the members in a given workspace.][cargo/3988]
1640 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1641 - [Target directory path is now in the cargo metadata][cargo/4022]
1642 - [Cargo no longer checks out a local working directory for the
1643   crates.io index][cargo/4026] This should provide smaller file size for the
1644   registry, and improve cloning times, especially on Windows machines.
1645 - [Added an `--exclude` option for excluding certain packages when using the
1646   `--all` option][cargo/4031]
1647 - [Cargo will now automatically retry when receiving a 5xx error
1648   from crates.io][cargo/4032]
1649 - [The `--features` option now accepts multiple comma or space
1650   delimited values.][cargo/4084]
1651 - [Added support for custom target specific runners][cargo/3954]
1652
1653 Misc
1654 ----
1655
1656 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1657   Windows Debugger.
1658 - [Rust will now release XZ compressed packages][rust-installer/57]
1659 - [rustup will now prefer to download rust packages with
1660   XZ compression][rustup/1100] over GZip packages.
1661 - [Added the ability to escape `#` in rust documentation][41785] By adding
1662   additional `#`'s ie. `##` is now `#`
1663
1664 Compatibility Notes
1665 -------------------
1666
1667 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1668 - [`-Z` flags are now no longer allowed to be used on the stable
1669   compiler.][41751] This has been a warning for a year previous to this.
1670 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1671   longer works][42844]. Users should migrate to the built-in `check`
1672   command, which has been available since 1.16.
1673 - [Ending a float literal with `._` is now a hard error.
1674   Example: `42._` .][41946]
1675 - [Any use of a private `extern crate` outside of its module is now a
1676   hard error.][36886] This was previously a warning.
1677 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1678   relative while the `::` prefix makes a path absolute, but was ignored and the
1679   path was relative regardless.
1680 - [Floating point constants in match patterns is now a hard error][36890]
1681   This was previously a warning.
1682 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1683   match patterns is now a hard error][36891] This was previously a warning.
1684 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1685   a warning.
1686 - [From the pound escape, lines consisting of multiple `#`s are
1687   now visible][41785]
1688 - [It is an error to re-export private enum variants][42460]. This is
1689   known to break a number of crates that depend on an older version of
1690   mustache.
1691 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1692   to use it to find the linker, and the build will fail where it did
1693   not previously][42607]
1694
1695 [36886]: https://github.com/rust-lang/rust/issues/36886
1696 [36888]: https://github.com/rust-lang/rust/issues/36888
1697 [36890]: https://github.com/rust-lang/rust/issues/36890
1698 [36891]: https://github.com/rust-lang/rust/issues/36891
1699 [36892]: https://github.com/rust-lang/rust/issues/36892
1700 [37406]: https://github.com/rust-lang/rust/issues/37406
1701 [39983]: https://github.com/rust-lang/rust/pull/39983
1702 [41145]: https://github.com/rust-lang/rust/pull/41145
1703 [41192]: https://github.com/rust-lang/rust/pull/41192
1704 [41258]: https://github.com/rust-lang/rust/pull/41258
1705 [41370]: https://github.com/rust-lang/rust/pull/41370
1706 [41449]: https://github.com/rust-lang/rust/pull/41449
1707 [41530]: https://github.com/rust-lang/rust/pull/41530
1708 [41624]: https://github.com/rust-lang/rust/pull/41624
1709 [41656]: https://github.com/rust-lang/rust/pull/41656
1710 [41659]: https://github.com/rust-lang/rust/pull/41659
1711 [41676]: https://github.com/rust-lang/rust/pull/41676
1712 [41751]: https://github.com/rust-lang/rust/pull/41751
1713 [41764]: https://github.com/rust-lang/rust/pull/41764
1714 [41785]: https://github.com/rust-lang/rust/pull/41785
1715 [41873]: https://github.com/rust-lang/rust/pull/41873
1716 [41907]: https://github.com/rust-lang/rust/pull/41907
1717 [41946]: https://github.com/rust-lang/rust/pull/41946
1718 [42016]: https://github.com/rust-lang/rust/pull/42016
1719 [42037]: https://github.com/rust-lang/rust/pull/42037
1720 [42068]: https://github.com/rust-lang/rust/pull/42068
1721 [42150]: https://github.com/rust-lang/rust/pull/42150
1722 [42162]: https://github.com/rust-lang/rust/pull/42162
1723 [42225]: https://github.com/rust-lang/rust/pull/42225
1724 [42264]: https://github.com/rust-lang/rust/pull/42264
1725 [42302]: https://github.com/rust-lang/rust/pull/42302
1726 [42460]: https://github.com/rust-lang/rust/issues/42460
1727 [42607]: https://github.com/rust-lang/rust/issues/42607
1728 [42740]: https://github.com/rust-lang/rust/pull/42740
1729 [42844]: https://github.com/rust-lang/rust/issues/42844
1730 [42948]: https://github.com/rust-lang/rust/pull/42948
1731 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1732 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1733 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1734 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1735 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1736 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1737 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1738 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1739 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1740 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1741 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1742 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1743 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1744 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1745 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1746 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1747 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1748 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1749 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1750 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1751 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1752 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1753
1754
1755 Version 1.18.0 (2017-06-08)
1756 ===========================
1757
1758 Language
1759 --------
1760
1761 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1762   make the item visible to just that module tree. Also accepts the keyword
1763   `crate` to make something public to the whole crate but not users of the
1764   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1765 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1766   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1767 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1768   types like `Write + Send`, trailing `+` are now supported in trait objects,
1769   and better error reporting for trait objects starting with `?Sized`.
1770 - [0e+10 is now a valid floating point literal][40589]
1771 - [Now warns if you bind a lifetime parameter to 'static][40734]
1772 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1773   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1774   representation in some cases.][40377]
1775
1776 Compiler
1777 --------
1778
1779 - [rustc can now emit mir with `--emit mir`][39891]
1780 - [Improved LLVM IR for trivial functions][40367]
1781 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1782 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1783   opportunities found through profiling
1784 - [Improved backtrace formatting when panicking][38165]
1785
1786 Libraries
1787 ---------
1788
1789 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1790   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1791   iteration or reallocation.
1792 - [Simplified HashMap Bucket interface][40561] provides performance
1793   improvements for iterating and cloning.
1794 - [Specialize Vec::from_elem to use calloc][40409]
1795 - [Fixed Race condition in fs::create_dir_all][39799]
1796 - [No longer caching stdio on Windows][40516]
1797 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1798   2.50%~ faster and in one case now 12.50% faster.
1799 - [Optimized `AtomicBool::fetch_nand`][41143]
1800
1801 Stabilized APIs
1802 ---------------
1803
1804 - [`Child::try_wait`]
1805 - [`HashMap::retain`]
1806 - [`HashSet::retain`]
1807 - [`PeekMut::pop`]
1808 - [`TcpStream::peek`]
1809 - [`UdpSocket::peek`]
1810 - [`UdpSocket::peek_from`]
1811
1812 Cargo
1813 -----
1814
1815 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1816   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1817 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1818 - [Added Android build support][cargo/3885]
1819 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1820   of a certain type, for example `cargo build --bins` will build all
1821   binaries.
1822 - [Added support for haiku][cargo/3952]
1823
1824 Misc
1825 ----
1826
1827 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1828 - [Added rust-windbg script for better debugging on Windows][39983]
1829 - [Rust now uses the official cross compiler for NetBSD][40612]
1830 - [rustdoc now accepts `#` at the start of files][40828]
1831 - [Fixed jemalloc support for musl][41168]
1832
1833 Compatibility Notes
1834 -------------------
1835
1836 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1837   always placed after the sign if it exists and before the digits. With the `#`
1838   flag the zeroes are placed after the prefix and before the digits.
1839 - [Due to the struct field optimisation][40377], using `transmute` on structs
1840   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1841   always been undefined behavior, but is now more likely to break in practice.
1842 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1843   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1844   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1845 - [Overlapping inherent `impl`s are now a hard error][40728]
1846 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1847 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1848   `out.asm` and `out.ll` instead of only one of the filetypes.
1849 - [ calling a function that returns `Self` will no longer work][41805] when
1850   the size of `Self` cannot be statically determined.
1851 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1852   this has caused a few regressions namely:
1853
1854   - Changed the link order of local static/dynamic libraries (respecting the
1855     order on given rather than having the compiler reorder).
1856   - Changed how MinGW is linked, native code linked to dynamic libraries
1857     may require manually linking to the gcc support library (for the native
1858     code itself)
1859
1860 [38165]: https://github.com/rust-lang/rust/pull/38165
1861 [39799]: https://github.com/rust-lang/rust/pull/39799
1862 [39891]: https://github.com/rust-lang/rust/pull/39891
1863 [39983]: https://github.com/rust-lang/rust/pull/39983
1864 [40043]: https://github.com/rust-lang/rust/pull/40043
1865 [40241]: https://github.com/rust-lang/rust/pull/40241
1866 [40338]: https://github.com/rust-lang/rust/pull/40338
1867 [40367]: https://github.com/rust-lang/rust/pull/40367
1868 [40377]: https://github.com/rust-lang/rust/pull/40377
1869 [40409]: https://github.com/rust-lang/rust/pull/40409
1870 [40516]: https://github.com/rust-lang/rust/pull/40516
1871 [40556]: https://github.com/rust-lang/rust/pull/40556
1872 [40561]: https://github.com/rust-lang/rust/pull/40561
1873 [40589]: https://github.com/rust-lang/rust/pull/40589
1874 [40612]: https://github.com/rust-lang/rust/pull/40612
1875 [40723]: https://github.com/rust-lang/rust/pull/40723
1876 [40728]: https://github.com/rust-lang/rust/pull/40728
1877 [40731]: https://github.com/rust-lang/rust/pull/40731
1878 [40734]: https://github.com/rust-lang/rust/pull/40734
1879 [40805]: https://github.com/rust-lang/rust/pull/40805
1880 [40807]: https://github.com/rust-lang/rust/pull/40807
1881 [40828]: https://github.com/rust-lang/rust/pull/40828
1882 [40870]: https://github.com/rust-lang/rust/pull/40870
1883 [41085]: https://github.com/rust-lang/rust/pull/41085
1884 [41143]: https://github.com/rust-lang/rust/pull/41143
1885 [41168]: https://github.com/rust-lang/rust/pull/41168
1886 [41270]: https://github.com/rust-lang/rust/issues/41270
1887 [41469]: https://github.com/rust-lang/rust/pull/41469
1888 [41805]: https://github.com/rust-lang/rust/issues/41805
1889 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1890 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1891 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1892 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1893 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1894 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1895 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1896 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1897 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1898 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1899 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1900 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1901 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1902 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1903
1904
1905 Version 1.17.0 (2017-04-27)
1906 ===========================
1907
1908 Language
1909 --------
1910
1911 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1912 * [Fields of structs may be initialized without duplicating the field/variable
1913   names][39761]. [RFC 1682]
1914 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1915 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1916   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1917   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1918   `'b`. Soundness fix.
1919 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1920 * [Static variables may contain references to other statics][40027]
1921
1922 Compiler
1923 --------
1924
1925 * [Exit quickly on only `--emit dep-info`][40336]
1926 * [Make `-C relocation-model` more correctly determine whether the linker
1927   creates a position-independent executable][40245]
1928 * [Add `-C overflow-checks` to directly control whether integer overflow
1929   panics][40037]
1930 * [The rustc type checker now checks items on demand instead of in a single
1931   in-order pass][40008]. This is mostly an internal refactoring in support of
1932   future work, including incremental type checking, but also resolves [RFC
1933   1647], allowing `Self` to appear in `impl` `where` clauses.
1934 * [Optimize vtable loads][39995]
1935 * [Turn off vectorization for Emscripten targets][39990]
1936 * [Provide suggestions for unknown macros imported with `use`][39953]
1937 * [Fix ICEs in path resolution][39939]
1938 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1939 * [Add clearer error message using `&str + &str`][39116]
1940
1941 Stabilized APIs
1942 ---------------
1943
1944 * [`Arc::into_raw`]
1945 * [`Arc::from_raw`]
1946 * [`Arc::ptr_eq`]
1947 * [`Rc::into_raw`]
1948 * [`Rc::from_raw`]
1949 * [`Rc::ptr_eq`]
1950 * [`Ordering::then`]
1951 * [`Ordering::then_with`]
1952 * [`BTreeMap::range`]
1953 * [`BTreeMap::range_mut`]
1954 * [`collections::Bound`]
1955 * [`process::abort`]
1956 * [`ptr::read_unaligned`]
1957 * [`ptr::write_unaligned`]
1958 * [`Result::expect_err`]
1959 * [`Cell::swap`]
1960 * [`Cell::replace`]
1961 * [`Cell::into_inner`]
1962 * [`Cell::take`]
1963
1964 Libraries
1965 ---------
1966
1967 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1968 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1969 * [`String` implements `FromIterator<&char>`][40028]
1970 * `Box` [implements][40009] a number of new conversions:
1971   `From<Box<str>> for String`,
1972   `From<Box<[T]>> for Vec<T>`,
1973   `From<Box<CStr>> for CString`,
1974   `From<Box<OsStr>> for OsString`,
1975   `From<Box<Path>> for PathBuf`,
1976   `Into<Box<str>> for String`,
1977   `Into<Box<[T]>> for Vec<T>`,
1978   `Into<Box<CStr>> for CString`,
1979   `Into<Box<OsStr>> for OsString`,
1980   `Into<Box<Path>> for PathBuf`,
1981   `Default for Box<str>`,
1982   `Default for Box<CStr>`,
1983   `Default for Box<OsStr>`,
1984   `From<&CStr> for Box<CStr>`,
1985   `From<&OsStr> for Box<OsStr>`,
1986   `From<&Path> for Box<Path>`
1987 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
1988 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
1989 * [Slightly optimize `slice::sort`][39538]
1990 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
1991 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
1992   `Box<str>` implements `From<&str>`][39438]
1993 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
1994   `From<(I, u16)> where I: Into<IpAddr>`][39372]
1995 * [`format!` estimates the needed capacity before writing a string][39356]
1996 * [Support unprivileged symlink creation in Windows][38921]
1997 * [`PathBuf` implements `Default`][38764]
1998 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
1999 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2000   and poor hash functions.
2001
2002 Cargo
2003 -----
2004
2005 * [Add `cargo check --all`][cargo/3731]
2006 * [Add an option to ignore SSL revocation checking][cargo/3699]
2007 * [Add `cargo run --package`][cargo/3691]
2008 * [Add `required_features`][cargo/3667]
2009 * [Assume `build.rs` is a build script][cargo/3664]
2010 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2011
2012 Misc
2013 ----
2014
2015 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2016   `rustbook`][39633]
2017 * [The "Unstable Book" documents nightly-only features][ubook]
2018 * [Improve the style of the sidebar in rustdoc output][40265]
2019 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2020 * [Fix MSP430 breakage due to `i128`][40257]
2021 * [Preliminary Solaris/SPARCv9 support][39903]
2022 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2023   run without installing the MSVC runtime.
2024 * [`rustdoc --test` includes file names in test names][39788]
2025 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2026   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2027 * [Initial support for `aarch64-unknown-freebsd`][39491]
2028 * [Initial support for `i686-unknown-netbsd`][39426]
2029 * [This release no longer includes the old makefile build system][39431]. Rust
2030   is built with a custom build system, written in Rust, and with Cargo.
2031 * [Add Debug implementations for libcollection structs][39002]
2032 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2033 * [`--test-threads=0` produces an error][38945]
2034 * [`rustup` installs documentation by default][40526]
2035 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2036   WinDbg and Visual Studio to improve the debugging experience.
2037
2038 Compatibility Notes
2039 -------------------
2040
2041 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2042   workaround, either use MSVC 2015 or run vcvars.bat.
2043 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2044   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2045   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2046   fix.
2047 * [`format!` and `Display::to_string` panic if an underlying formatting
2048   implementation returns an error][40117]. Previously the error was silently
2049   ignored. It is incorrect for `write_fmt` to return an error when writing
2050   to a string.
2051 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2052   crates were marked stable and could be accessed from the stable toolchain.
2053 * [Rust git source no longer includes vendored crates][39728]. Those that need
2054   to build with vendored crates should build from release tarballs.
2055 * [Fix inert attributes from `proc_macro_derives`][39572]
2056 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2057   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2058   build system.
2059 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2060   existing code generally ignores the type of dead-code unless a type-hint is
2061   provided; this can cause surprising inference interactions particularly around
2062   defaulting. The new code uniformly ignores the result type of dead-code.
2063 * [Tuple-struct constructors with private fields are no longer visible][38932]
2064 * [Lifetime parameters that do not appear in the arguments are now considered
2065   early-bound][38897], resolving a soundness bug (#[32330]). The
2066   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2067   April of 2016.
2068 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2069 * [Make transmuting from fn item types to pointer-sized types a hard
2070   error][34198]
2071
2072 [27787]: https://github.com/rust-lang/rust/issues/27787
2073 [32330]: https://github.com/rust-lang/rust/issues/32330
2074 [34198]: https://github.com/rust-lang/rust/pull/34198
2075 [38161]: https://github.com/rust-lang/rust/pull/38161
2076 [38368]: https://github.com/rust-lang/rust/pull/38368
2077 [38584]: https://github.com/rust-lang/rust/issues/38584
2078 [38661]: https://github.com/rust-lang/rust/pull/38661
2079 [38764]: https://github.com/rust-lang/rust/pull/38764
2080 [38864]: https://github.com/rust-lang/rust/issues/38864
2081 [38897]: https://github.com/rust-lang/rust/pull/38897
2082 [38921]: https://github.com/rust-lang/rust/pull/38921
2083 [38932]: https://github.com/rust-lang/rust/pull/38932
2084 [38945]: https://github.com/rust-lang/rust/pull/38945
2085 [38981]: https://github.com/rust-lang/rust/pull/38981
2086 [39002]: https://github.com/rust-lang/rust/pull/39002
2087 [39116]: https://github.com/rust-lang/rust/pull/39116
2088 [39193]: https://github.com/rust-lang/rust/pull/39193
2089 [39265]: https://github.com/rust-lang/rust/pull/39265
2090 [39356]: https://github.com/rust-lang/rust/pull/39356
2091 [39372]: https://github.com/rust-lang/rust/pull/39372
2092 [39426]: https://github.com/rust-lang/rust/pull/39426
2093 [39431]: https://github.com/rust-lang/rust/pull/39431
2094 [39438]: https://github.com/rust-lang/rust/pull/39438
2095 [39440]: https://github.com/rust-lang/rust/pull/39440
2096 [39485]: https://github.com/rust-lang/rust/pull/39485
2097 [39491]: https://github.com/rust-lang/rust/pull/39491
2098 [39518]: https://github.com/rust-lang/rust/pull/39518
2099 [39538]: https://github.com/rust-lang/rust/pull/39538
2100 [39572]: https://github.com/rust-lang/rust/pull/39572
2101 [39633]: https://github.com/rust-lang/rust/pull/39633
2102 [39642]: https://github.com/rust-lang/rust/pull/39642
2103 [39728]: https://github.com/rust-lang/rust/pull/39728
2104 [39761]: https://github.com/rust-lang/rust/pull/39761
2105 [39788]: https://github.com/rust-lang/rust/pull/39788
2106 [39793]: https://github.com/rust-lang/rust/pull/39793
2107 [39837]: https://github.com/rust-lang/rust/pull/39837
2108 [39843]: https://github.com/rust-lang/rust/pull/39843
2109 [39851]: https://github.com/rust-lang/rust/pull/39851
2110 [39903]: https://github.com/rust-lang/rust/pull/39903
2111 [39939]: https://github.com/rust-lang/rust/pull/39939
2112 [39953]: https://github.com/rust-lang/rust/pull/39953
2113 [39960]: https://github.com/rust-lang/rust/pull/39960
2114 [39990]: https://github.com/rust-lang/rust/pull/39990
2115 [39995]: https://github.com/rust-lang/rust/pull/39995
2116 [40008]: https://github.com/rust-lang/rust/pull/40008
2117 [40009]: https://github.com/rust-lang/rust/pull/40009
2118 [40027]: https://github.com/rust-lang/rust/pull/40027
2119 [40028]: https://github.com/rust-lang/rust/pull/40028
2120 [40037]: https://github.com/rust-lang/rust/pull/40037
2121 [40117]: https://github.com/rust-lang/rust/pull/40117
2122 [40166]: https://github.com/rust-lang/rust/pull/40166
2123 [40245]: https://github.com/rust-lang/rust/pull/40245
2124 [40257]: https://github.com/rust-lang/rust/pull/40257
2125 [40261]: https://github.com/rust-lang/rust/pull/40261
2126 [40265]: https://github.com/rust-lang/rust/pull/40265
2127 [40319]: https://github.com/rust-lang/rust/pull/40319
2128 [40336]: https://github.com/rust-lang/rust/pull/40336
2129 [40526]: https://github.com/rust-lang/rust/pull/40526
2130 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2131 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2132 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2133 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2134 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2135 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2136 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2137 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2138 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2139 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2140 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2141 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2142 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2143 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2144 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2145 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2146 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2147 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2148 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2149 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2150 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2151 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2152 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2153 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2154 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2155 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2156 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2157 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2158 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2159 [mdbook]: https://crates.io/crates/mdbook
2160 [ubook]: https://doc.rust-lang.org/unstable-book/
2161
2162
2163 Version 1.16.0 (2017-03-16)
2164 ===========================
2165
2166 Language
2167 --------
2168
2169 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2170 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2171   match patterns][38069]
2172 * [Clean up semantics of `self` in an import list][38313]
2173 * [`Self` may appear in `impl` headers][38920]
2174 * [`Self` may appear in struct expressions][39282]
2175
2176 Compiler
2177 --------
2178
2179 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2180   a `.rmeta` file containing only crate metadata][38571]. This can be
2181   used by tools like the Rust Language Service to perform
2182   metadata-only builds.
2183 * [Levenshtein based typo suggestions now work in most places, while
2184   previously they worked only for fields and sometimes for local
2185   variables][38927]. Together with the overhaul of "no
2186   resolution"/"unexpected resolution" errors (#[38154]) they result in
2187   large and systematic improvement in resolution diagnostics.
2188 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2189   `U`][38670]
2190 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2191 * [`rustc` no longer attempts to provide "consider using an explicit
2192   lifetime" suggestions][37057]. They were inaccurate.
2193
2194 Stabilized APIs
2195 ---------------
2196
2197 * [`VecDeque::truncate`]
2198 * [`VecDeque::resize`]
2199 * [`String::insert_str`]
2200 * [`Duration::checked_add`]
2201 * [`Duration::checked_sub`]
2202 * [`Duration::checked_div`]
2203 * [`Duration::checked_mul`]
2204 * [`str::replacen`]
2205 * [`str::repeat`]
2206 * [`SocketAddr::is_ipv4`]
2207 * [`SocketAddr::is_ipv6`]
2208 * [`IpAddr::is_ipv4`]
2209 * [`IpAddr::is_ipv6`]
2210 * [`Vec::dedup_by`]
2211 * [`Vec::dedup_by_key`]
2212 * [`Result::unwrap_or_default`]
2213 * [`<*const T>::wrapping_offset`]
2214 * [`<*mut T>::wrapping_offset`]
2215 * `CommandExt::creation_flags`
2216 * [`File::set_permissions`]
2217 * [`String::split_off`]
2218
2219 Libraries
2220 ---------
2221
2222 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2223   their argument by `Borrow` parameter][37761]
2224 * [All public types in std implement `Debug`][38006]
2225 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2226 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2227 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2228   Windows][38274]
2229 * [std: Fix partial writes in `LineWriter`][38062]
2230 * [std: Clamp max read/write sizes on Unix][38062]
2231 * [Use more specific panic message for `&str` slicing errors][38066]
2232 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2233   functionality cannot be achieved in std currently.
2234 * [`writeln!`, like `println!`, now accepts a form with no string
2235   or formatting arguments, to just print a newline][38469]
2236 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2237 * [Reduce the size of static data in `std_unicode::tables`][38781]
2238 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2239   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2240   `Display`][38909]
2241 * [`Duration` implements `Sum`][38712]
2242 * [`String` implements `ToSocketAddrs`][39048]
2243
2244 Cargo
2245 -----
2246
2247 * [The `cargo check` command does a type check of a project without
2248   building it][cargo/3296]
2249 * [crates.io will display CI badges from Travis and AppVeyor, if
2250   specified in Cargo.toml][cargo/3546]
2251 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2252 * [Compilation profiles accept integer values for `debug`, in addition
2253   to `true` and `false`. These are passed to `rustc` as the value to
2254   `-C debuginfo`][cargo/3534]
2255 * [Implement `cargo --version --verbose`][cargo/3604]
2256 * [All builds now output 'dep-info' build dependencies compatible with
2257   make and ninja][cargo/3557]
2258 * [Build all workspace members with `build --all`][cargo/3511]
2259 * [Document all workspace members with `doc --all`][cargo/3515]
2260 * [Path deps outside workspace are not members][cargo/3443]
2261
2262 Misc
2263 ----
2264
2265 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2266   the path to the Rust implementation][38589]
2267 * [The `armv7-linux-androideabi` target no longer enables NEON
2268   extensions, per Google's ABI guide][38413]
2269 * [The stock standard library can be compiled for Redox OS][38401]
2270 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2271   available.
2272 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2273   builds available.
2274 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2275
2276 Compatibility Notes
2277 -------------------
2278
2279 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2280   match patterns][38069]
2281 * In this release, references to uninhabited types can not be
2282   pattern-matched. This was accidentally allowed in 1.15.
2283 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2284 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2285   Windows][38274]
2286 * [Clean up semantics of `self` in an import list][38313]
2287 * Reimplemented lifetime elision. This change was almost entirely compatible
2288   with existing code, but it did close a number of small bugs and loopholes,
2289   as well as being more accepting in some other [cases][41105].
2290
2291 [37057]: https://github.com/rust-lang/rust/pull/37057
2292 [37761]: https://github.com/rust-lang/rust/pull/37761
2293 [38006]: https://github.com/rust-lang/rust/pull/38006
2294 [38051]: https://github.com/rust-lang/rust/pull/38051
2295 [38062]: https://github.com/rust-lang/rust/pull/38062
2296 [38062]: https://github.com/rust-lang/rust/pull/38622
2297 [38066]: https://github.com/rust-lang/rust/pull/38066
2298 [38069]: https://github.com/rust-lang/rust/pull/38069
2299 [38131]: https://github.com/rust-lang/rust/pull/38131
2300 [38154]: https://github.com/rust-lang/rust/pull/38154
2301 [38274]: https://github.com/rust-lang/rust/pull/38274
2302 [38304]: https://github.com/rust-lang/rust/pull/38304
2303 [38313]: https://github.com/rust-lang/rust/pull/38313
2304 [38314]: https://github.com/rust-lang/rust/pull/38314
2305 [38327]: https://github.com/rust-lang/rust/pull/38327
2306 [38401]: https://github.com/rust-lang/rust/pull/38401
2307 [38413]: https://github.com/rust-lang/rust/pull/38413
2308 [38469]: https://github.com/rust-lang/rust/pull/38469
2309 [38559]: https://github.com/rust-lang/rust/pull/38559
2310 [38571]: https://github.com/rust-lang/rust/pull/38571
2311 [38580]: https://github.com/rust-lang/rust/pull/38580
2312 [38589]: https://github.com/rust-lang/rust/pull/38589
2313 [38670]: https://github.com/rust-lang/rust/pull/38670
2314 [38712]: https://github.com/rust-lang/rust/pull/38712
2315 [38726]: https://github.com/rust-lang/rust/pull/38726
2316 [38781]: https://github.com/rust-lang/rust/pull/38781
2317 [38798]: https://github.com/rust-lang/rust/pull/38798
2318 [38909]: https://github.com/rust-lang/rust/pull/38909
2319 [38920]: https://github.com/rust-lang/rust/pull/38920
2320 [38927]: https://github.com/rust-lang/rust/pull/38927
2321 [39048]: https://github.com/rust-lang/rust/pull/39048
2322 [39282]: https://github.com/rust-lang/rust/pull/39282
2323 [39379]: https://github.com/rust-lang/rust/pull/39379
2324 [41105]: https://github.com/rust-lang/rust/issues/41105
2325 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2326 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2327 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2328 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2329 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2330 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2331 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2332 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2333 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2334 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2335 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2336 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2337 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2338 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2339 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2340 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2341 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2342 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2343 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2344 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2345 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2346 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2347 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2348 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2349 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2350 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2351 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2352 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2353 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2354 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2355
2356
2357 Version 1.15.1 (2017-02-09)
2358 ===========================
2359
2360 * [Fix IntoIter::as_mut_slice's signature][39466]
2361 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2362
2363 [39466]: https://github.com/rust-lang/rust/pull/39466
2364 [39523]: https://github.com/rust-lang/rust/pull/39523
2365
2366
2367 Version 1.15.0 (2017-02-02)
2368 ===========================
2369
2370 Language
2371 --------
2372
2373 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2374   stable. This allows popular code-generating crates like Serde and Diesel to
2375   work ergonomically. [RFC 1681].
2376 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2377   with curly braces][36868]. Part of [RFC 1506].
2378 * [A number of minor changes to name resolution have been activated][37127].
2379   They add up to more consistent semantics, allowing for future evolution of
2380   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2381   details of what is different. The breaking changes here have been transitioned
2382   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2383 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2384   bounds][38279]
2385 * [`?Sized` can be used in `where` clauses][37791]
2386 * [There is now a limit on the size of monomorphized types and it can be
2387   modified with the `#![type_size_limit]` crate attribute, similarly to
2388   the `#![recursion_limit]` attribute][37789]
2389
2390 Compiler
2391 --------
2392
2393 * [On Windows, the compiler will apply dllimport attributes when linking to
2394   extern functions][37973]. Additional attributes and flags can control which
2395   library kind is linked and its name. [RFC 1717].
2396 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2397 * [The `--test` flag works with procedural macro crates][38107]
2398 * [Fix `extern "aapcs" fn` ABI][37814]
2399 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2400 * [The `format!` expander recognizes incorrect `printf` and shell-style
2401   formatting directives and suggests the correct format][37613].
2402 * [Only report one error for all unused imports in an import list][37456]
2403
2404 Compiler Performance
2405 --------------------
2406
2407 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2408 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2409 * [Don't clone in `UnificationTable::probe`][37848]
2410 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2411 * [Use small vectors in type walker][37760]
2412 * [Macro expansion performance was improved][37701]
2413 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2414 * [Replace FNV with a faster hash function][37229]
2415
2416 Stabilized APIs
2417 ---------------
2418
2419 * [`std::iter::Iterator::min_by`]
2420 * [`std::iter::Iterator::max_by`]
2421 * [`std::os::*::fs::FileExt`]
2422 * [`std::sync::atomic::Atomic*::get_mut`]
2423 * [`std::sync::atomic::Atomic*::into_inner`]
2424 * [`std::vec::IntoIter::as_slice`]
2425 * [`std::vec::IntoIter::as_mut_slice`]
2426 * [`std::sync::mpsc::Receiver::try_iter`]
2427 * [`std::os::unix::process::CommandExt::before_exec`]
2428 * [`std::rc::Rc::strong_count`]
2429 * [`std::rc::Rc::weak_count`]
2430 * [`std::sync::Arc::strong_count`]
2431 * [`std::sync::Arc::weak_count`]
2432 * [`std::char::encode_utf8`]
2433 * [`std::char::encode_utf16`]
2434 * [`std::cell::Ref::clone`]
2435 * [`std::io::Take::into_inner`]
2436
2437 Libraries
2438 ---------
2439
2440 * [The standard sorting algorithm has been rewritten for dramatic performance
2441   improvements][38192]. It is a hybrid merge sort, drawing influences from
2442   Timsort. Previously it was a naive merge sort.
2443 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2444 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2445   performance.
2446 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2447   and `char_indices().last()`][37882]
2448 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2449 * [Chinese characters display correctly in `fmt::Debug`][37855]
2450 * [Derive `Default` for `Duration`][37699]
2451 * [Support creation of anonymous pipes on WinXP/2k][37677]
2452 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2453 * [Don't pass overlapped handles to processes][38835]
2454
2455 Cargo
2456 -----
2457
2458 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2459   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2460   should instead check the variable at runtime with `std::env`. That the value
2461   was set at build time was a bug, and incorrect when cross-compiling. This
2462   change is known to cause breakage.
2463 * [Add `--all` flag to `cargo test`][cargo/3221]
2464 * [Compile statically against the MSVC CRT][cargo/3363]
2465 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2466 * [Link OpenSSL statically on OSX][cargo/3311]
2467 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2468 * [Test for bad path overrides with summaries][cargo/3336]
2469 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2470 * [Fix retrying crate downloads for network errors][cargo/3348]
2471 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2472 * [Emit more info on --message-format=json][cargo/3319]
2473 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2474 * [Don't ignore errors in workspace manifest][cargo/3409]
2475 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2476
2477 Tooling
2478 -------
2479
2480 * [Test runners (binaries built with `--test`) now support a `--list` argument
2481   that lists the tests it contains][38185]
2482 * [Test runners now support a `--exact` argument that makes the test filter
2483   match exactly, instead of matching only a substring of the test name][38181]
2484 * [rustdoc supports a `--playground-url` flag][37763]
2485 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2486
2487 Misc
2488 ----
2489
2490 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2491   continue to be used in this release by passing `--disable-rustbuild` to the
2492   configure script, but they will be deleted soon. Note that the new build
2493   system uses a different on-disk layout that will likely affect any scripts
2494   building Rust.
2495 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2496   releases.
2497 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2498 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2499   releases.
2500
2501 Compatibility Notes
2502 -------------------
2503
2504 * [A number of minor changes to name resolution have been activated][37127].
2505   They add up to more consistent semantics, allowing for future evolution of
2506   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2507   details of what is different. The breaking changes here have been transitioned
2508   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2509 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2510   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2511   should instead check the variable at runtime with `std::env`. That the value
2512   was set at build time was a bug, and incorrect when cross-compiling. This
2513   change is known to cause breakage.
2514 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2515   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2516   1.10 and is now an error by default. It will become a hard error in the near
2517   future.
2518 * [The semantics relating modules to file system directories are changing in
2519   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2520   lint, which is a warning in this release, and will become a hard error in the
2521   future.
2522 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2523 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2524   the underlying iterator][37834]
2525
2526 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2527 [33685]: https://github.com/rust-lang/rust/issues/33685
2528 [36868]: https://github.com/rust-lang/rust/pull/36868
2529 [37127]: https://github.com/rust-lang/rust/pull/37127
2530 [37229]: https://github.com/rust-lang/rust/pull/37229
2531 [37456]: https://github.com/rust-lang/rust/pull/37456
2532 [37527]: https://github.com/rust-lang/rust/pull/37527
2533 [37602]: https://github.com/rust-lang/rust/pull/37602
2534 [37613]: https://github.com/rust-lang/rust/pull/37613
2535 [37615]: https://github.com/rust-lang/rust/pull/37615
2536 [37636]: https://github.com/rust-lang/rust/pull/37636
2537 [37627]: https://github.com/rust-lang/rust/pull/37627
2538 [37642]: https://github.com/rust-lang/rust/pull/37642
2539 [37677]: https://github.com/rust-lang/rust/pull/37677
2540 [37699]: https://github.com/rust-lang/rust/pull/37699
2541 [37701]: https://github.com/rust-lang/rust/pull/37701
2542 [37705]: https://github.com/rust-lang/rust/pull/37705
2543 [37749]: https://github.com/rust-lang/rust/pull/37749
2544 [37760]: https://github.com/rust-lang/rust/pull/37760
2545 [37763]: https://github.com/rust-lang/rust/pull/37763
2546 [37764]: https://github.com/rust-lang/rust/pull/37764
2547 [37789]: https://github.com/rust-lang/rust/pull/37789
2548 [37791]: https://github.com/rust-lang/rust/pull/37791
2549 [37814]: https://github.com/rust-lang/rust/pull/37814
2550 [37817]: https://github.com/rust-lang/rust/pull/37817
2551 [37834]: https://github.com/rust-lang/rust/pull/37834
2552 [37848]: https://github.com/rust-lang/rust/pull/37848
2553 [37855]: https://github.com/rust-lang/rust/pull/37855
2554 [37882]: https://github.com/rust-lang/rust/pull/37882
2555 [37888]: https://github.com/rust-lang/rust/pull/37888
2556 [37973]: https://github.com/rust-lang/rust/pull/37973
2557 [37979]: https://github.com/rust-lang/rust/pull/37979
2558 [38086]: https://github.com/rust-lang/rust/pull/38086
2559 [38107]: https://github.com/rust-lang/rust/pull/38107
2560 [38117]: https://github.com/rust-lang/rust/pull/38117
2561 [38134]: https://github.com/rust-lang/rust/pull/38134
2562 [38146]: https://github.com/rust-lang/rust/pull/38146
2563 [38181]: https://github.com/rust-lang/rust/pull/38181
2564 [38182]: https://github.com/rust-lang/rust/pull/38182
2565 [38185]: https://github.com/rust-lang/rust/pull/38185
2566 [38192]: https://github.com/rust-lang/rust/pull/38192
2567 [38279]: https://github.com/rust-lang/rust/pull/38279
2568 [38835]: https://github.com/rust-lang/rust/pull/38835
2569 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2570 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2571 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2572 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2573 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2574 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2575 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2576 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2577 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2578 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2579 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2580 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2581 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2582 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2583 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2584 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2585 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2586 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2587 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2588 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2589 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2590 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2591 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2592 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2593 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2594 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2595 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2596 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2597 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2598 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2599 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2600 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2601 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2602 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2603 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2604 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2605 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2606 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2607
2608
2609 Version 1.14.0 (2016-12-22)
2610 ===========================
2611
2612 Language
2613 --------
2614
2615 * [`..` matches multiple tuple fields in enum variants, structs
2616   and tuples][36843]. [RFC 1492].
2617 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2618 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2619 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2620   dereferencing][36822]
2621
2622 Compiler
2623 --------
2624
2625 * [Mark enums with non-zero discriminant as non-zero][37224]
2626 * [Lower-case `static mut` names are linted like other
2627   statics and consts][37162]
2628 * [Fix ICE on some macros in const integer positions
2629    (e.g. `[u8; m!()]`)][36819]
2630 * [Improve error message and snippet for "did you mean `x`"][36798]
2631 * [Add a panic-strategy field to the target specification][36794]
2632 * [Include LLVM version in `--version --verbose`][37200]
2633
2634 Compile-time Optimizations
2635 --------------------------
2636
2637 * [Improve macro expansion performance][37569]
2638 * [Shrink `Expr_::ExprInlineAsm`][37445]
2639 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2640 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2641 * [Avoid more allocations when compiling html5ever][37373]
2642 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2643 * [Avoid some allocations in the macro parser][37318]
2644 * [Use a faster deflate setting][37298]
2645 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2646   during interning of slices][37270]
2647 * [Optimize `write_metadata`][37267]
2648 * [Don't process obligation forest cycles when stalled][37231]
2649 * [Avoid many `CrateConfig` clones][37161]
2650 * [Optimize `Substs::super_fold_with`][37108]
2651 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2652 * [Speed up `plug_leaks`][36917]
2653
2654 Libraries
2655 ---------
2656
2657 * [`println!()`, with no arguments, prints newline][36825].
2658   Previously, an empty string was required to achieve the same.
2659 * [`Wrapping` impls standard binary and unary operators, as well as
2660    the `Sum` and `Product` iterators][37356]
2661 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2662   Vec<T>`][37326]
2663 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2664   `VecDeque` iterators][37315]
2665 * [Improve `SipHasher` performance on small values][37312]
2666 * [Add Iterator trait TrustedLen to enable better FromIterator /
2667   Extend][37306]
2668 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2669 * [`ReadDir` implements `Debug`][37221]
2670 * [Implement `RefUnwindSafe` for atomic types][37178]
2671 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2672 * [Avoid allocations in `Decoder::read_str`][37064]
2673 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2674 * [Impl `Debug` for raw pointers to unsized data][36880]
2675 * [Don't reuse `HashMap` random seeds][37470]
2676 * [The internal memory layout of `HashMap` is more cache-friendly, for
2677   significant improvements in some operations][36692]
2678 * [`HashMap` uses less memory on 32-bit architectures][36595]
2679 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2680
2681 Cargo
2682 -----
2683
2684 * [Expose rustc cfg values to build scripts][cargo/3243]
2685 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2686 * [Fix passing --features when testing multiple packages][cargo/3280]
2687 * [Use a single profile set per workspace][cargo/3249]
2688 * [Load `replace` sections from lock files][cargo/3220]
2689 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2690
2691 Tooling
2692 -------
2693
2694 * [rustup is the recommended Rust installation method][1.14rustup]
2695 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2696   S390x. These are [tier 2] platforms and may have major defects. Follow the
2697   instructions on the website to install, or add the targets to an existing
2698   installation with `rustup target add`. The new target triples are:
2699   - `mips-unknown-linux-gnu`
2700   - `mipsel-unknown-linux-gnu`
2701   - `mips64-unknown-linux-gnuabi64`
2702   - `mips64el-unknown-linux-gnuabi64 `
2703   - `powerpc-unknown-linux-gnu`
2704   - `powerpc64-unknown-linux-gnu`
2705   - `powerpc64le-unknown-linux-gnu`
2706   - `s390x-unknown-linux-gnu `
2707 * This release includes target (std) builds for ARM Linux running MUSL
2708   libc. These are [tier 2] platforms and may have major defects. Add the
2709   following triples to an existing rustup installation with `rustup target add`:
2710   - `arm-unknown-linux-musleabi`
2711   - `arm-unknown-linux-musleabihf`
2712   - `armv7-unknown-linux-musleabihf`
2713 * This release includes [experimental support for WebAssembly][1.14wasm], via
2714   the `wasm32-unknown-emscripten` target. This target is known to have major
2715   defects. Please test, report, and fix.
2716 * rustup no longer installs documentation by default. Run `rustup
2717   component add rust-docs` to install.
2718 * [Fix line stepping in debugger][37310]
2719 * [Enable line number debuginfo in releases][37280]
2720
2721 Misc
2722 ----
2723
2724 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2725 * [Add support for Fuchsia OS][37313]
2726 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2727
2728 Compatibility Notes
2729 -------------------
2730
2731 * [A number of forward-compatibility lints used by the compiler
2732   to gradually introduce language changes have been converted
2733   to deny by default][36894]:
2734   - ["use of inaccessible extern crate erroneously allowed"][36886]
2735   - ["type parameter default erroneously allowed in invalid location"][36887]
2736   - ["detects super or self keywords at the beginning of global path"][36888]
2737   - ["two overlapping inherent impls define an item with the same name
2738     were erroneously allowed"][36889]
2739   - ["floating-point constants cannot be used in patterns"][36890]
2740   - ["constants of struct or enum type can only be used in a pattern if
2741      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2742   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2743 * [Prohibit patterns in trait methods without bodies][37378]
2744 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2745 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2746 * [The `$crate` macro variable is accepted in fewer locations][37213]
2747 * [Impls specifying extra region requirements beyond the trait
2748   they implement are rejected][37167]
2749 * [Enums may not be unsized][37111]. Unsized enums are intended to
2750   work but never have. For now they are forbidden.
2751 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2752
2753 [tier 2]: https://forge.rust-lang.org/platform-support.html
2754 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2755 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2756 [36430]: https://github.com/rust-lang/rust/pull/36430
2757 [36595]: https://github.com/rust-lang/rust/pull/36595
2758 [36595]: https://github.com/rust-lang/rust/pull/36595
2759 [36692]: https://github.com/rust-lang/rust/pull/36692
2760 [36767]: https://github.com/rust-lang/rust/pull/36767
2761 [36794]: https://github.com/rust-lang/rust/pull/36794
2762 [36798]: https://github.com/rust-lang/rust/pull/36798
2763 [36819]: https://github.com/rust-lang/rust/pull/36819
2764 [36822]: https://github.com/rust-lang/rust/pull/36822
2765 [36825]: https://github.com/rust-lang/rust/pull/36825
2766 [36843]: https://github.com/rust-lang/rust/pull/36843
2767 [36880]: https://github.com/rust-lang/rust/pull/36880
2768 [36886]: https://github.com/rust-lang/rust/issues/36886
2769 [36887]: https://github.com/rust-lang/rust/issues/36887
2770 [36888]: https://github.com/rust-lang/rust/issues/36888
2771 [36889]: https://github.com/rust-lang/rust/issues/36889
2772 [36890]: https://github.com/rust-lang/rust/issues/36890
2773 [36891]: https://github.com/rust-lang/rust/issues/36891
2774 [36892]: https://github.com/rust-lang/rust/issues/36892
2775 [36894]: https://github.com/rust-lang/rust/pull/36894
2776 [36917]: https://github.com/rust-lang/rust/pull/36917
2777 [36993]: https://github.com/rust-lang/rust/pull/36993
2778 [37037]: https://github.com/rust-lang/rust/pull/37037
2779 [37064]: https://github.com/rust-lang/rust/pull/37064
2780 [37094]: https://github.com/rust-lang/rust/pull/37094
2781 [37108]: https://github.com/rust-lang/rust/pull/37108
2782 [37111]: https://github.com/rust-lang/rust/pull/37111
2783 [37161]: https://github.com/rust-lang/rust/pull/37161
2784 [37162]: https://github.com/rust-lang/rust/pull/37162
2785 [37167]: https://github.com/rust-lang/rust/pull/37167
2786 [37178]: https://github.com/rust-lang/rust/pull/37178
2787 [37200]: https://github.com/rust-lang/rust/pull/37200
2788 [37213]: https://github.com/rust-lang/rust/pull/37213
2789 [37221]: https://github.com/rust-lang/rust/pull/37221
2790 [37224]: https://github.com/rust-lang/rust/pull/37224
2791 [37230]: https://github.com/rust-lang/rust/pull/37230
2792 [37231]: https://github.com/rust-lang/rust/pull/37231
2793 [37247]: https://github.com/rust-lang/rust/pull/37247
2794 [37267]: https://github.com/rust-lang/rust/pull/37267
2795 [37270]: https://github.com/rust-lang/rust/pull/37270
2796 [37273]: https://github.com/rust-lang/rust/pull/37273
2797 [37280]: https://github.com/rust-lang/rust/pull/37280
2798 [37298]: https://github.com/rust-lang/rust/pull/37298
2799 [37306]: https://github.com/rust-lang/rust/pull/37306
2800 [37310]: https://github.com/rust-lang/rust/pull/37310
2801 [37312]: https://github.com/rust-lang/rust/pull/37312
2802 [37313]: https://github.com/rust-lang/rust/pull/37313
2803 [37315]: https://github.com/rust-lang/rust/pull/37315
2804 [37318]: https://github.com/rust-lang/rust/pull/37318
2805 [37322]: https://github.com/rust-lang/rust/pull/37322
2806 [37326]: https://github.com/rust-lang/rust/pull/37326
2807 [37351]: https://github.com/rust-lang/rust/pull/37351
2808 [37356]: https://github.com/rust-lang/rust/pull/37356
2809 [37367]: https://github.com/rust-lang/rust/pull/37367
2810 [37373]: https://github.com/rust-lang/rust/pull/37373
2811 [37378]: https://github.com/rust-lang/rust/pull/37378
2812 [37389]: https://github.com/rust-lang/rust/pull/37389
2813 [37392]: https://github.com/rust-lang/rust/pull/37392
2814 [37427]: https://github.com/rust-lang/rust/pull/37427
2815 [37439]: https://github.com/rust-lang/rust/pull/37439
2816 [37445]: https://github.com/rust-lang/rust/pull/37445
2817 [37470]: https://github.com/rust-lang/rust/pull/37470
2818 [37569]: https://github.com/rust-lang/rust/pull/37569
2819 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2820 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2821 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2822 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2823 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2824 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2825 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2826
2827
2828 Version 1.13.0 (2016-11-10)
2829 ===========================
2830
2831 Language
2832 --------
2833
2834 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2835   errors, like the `try!` macro, described in [RFC 0243].
2836 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2837 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2838 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2839 * [Fix lifetime rules for 'if' conditions][36029]
2840 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2841
2842 Compiler
2843 --------
2844
2845 * [Add the `-C link-arg` argument][36574]
2846 * [Remove the old AST-based backend from rustc_trans][35764]
2847 * [Don't enable NEON by default on armv7 Linux][35814]
2848 * [Fix debug line number info for macro expansions][35238]
2849 * [Do not emit "class method" debuginfo for types that are not
2850   DICompositeType][36008]
2851 * [Warn about multiple conflicting #[repr] hints][34623]
2852 * [When sizing DST, don't double-count nested struct prefixes][36351]
2853 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2854 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2855 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2856 * [Expand macros without recursing to avoid stack overflows][36214]
2857
2858 Diagnostics
2859 -----------
2860
2861 * [Replace macro backtraces with labeled local uses][35702]
2862 * [Improve error message for misplaced doc comments][33922]
2863 * [Buffer unix and lock windows to prevent message interleaving][35975]
2864 * [Update lifetime errors to specifically note temporaries][36171]
2865 * [Special case a few colors for Windows][36178]
2866 * [Suggest `use self` when such an import resolves][36289]
2867 * [Be more specific when type parameter shadows primitive type][36338]
2868 * Many minor improvements
2869
2870 Compile-time Optimizations
2871 --------------------------
2872
2873 * [Compute and cache HIR hashes at beginning][35854]
2874 * [Don't hash types in loan paths][36004]
2875 * [Cache projections in trans][35761]
2876 * [Optimize the parser's last token handling][36527]
2877 * [Only instantiate #[inline] functions in codegen units referencing
2878   them][36524]. This leads to big improvements in cases where crates export
2879   define many inline functions without using them directly.
2880 * [Lazily allocate TypedArena's first chunk][36592]
2881 * [Don't allocate during default HashSet creation][36734]
2882
2883 Stabilized APIs
2884 ---------------
2885
2886 * [`checked_abs`]
2887 * [`wrapping_abs`]
2888 * [`overflowing_abs`]
2889 * [`RefCell::try_borrow`]
2890 * [`RefCell::try_borrow_mut`]
2891
2892 Libraries
2893 ---------
2894
2895 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2896 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2897   covariant][35354]
2898 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2899 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2900 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2901 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2902 * [Use arc4rand on FreeBSD][35884]
2903 * [memrchr: Correct aligned offset computation][35969]
2904 * [Improve Demangling of Rust Symbols][36059]
2905 * [Use monotonic time in condition variables][35048]
2906 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2907 * [Implement conversion traits for `char`][35755]
2908 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2909 * [Zero first byte of CString on drop][36264]
2910 * [Inherit overflow checks for sum and product][36372]
2911 * [Add missing Eq implementations][36423]
2912 * [Implement `Debug` for `DirEntry`][36631]
2913 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2914   `errno`][36754]
2915 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2916 * [Implement more traits for `std::io::ErrorKind`][35911]
2917 * [Optimize BinaryHeap bounds checking][36072]
2918 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2919   `extend_with_element`][36355]
2920 * [Fix overflow checking in unsigned pow()][34942]
2921
2922 Cargo
2923 -----
2924
2925 * This release includes security fixes to both curl and OpenSSL.
2926 * [Fix transitive doctests when panic=abort][cargo/3021]
2927 * [Add --all-features flag to cargo][cargo/3038]
2928 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2929 * [Don't parse the home directory more than once][cargo/3078]
2930 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2931 * [Update OpenSSL to 1.0.2j][cargo/3121]
2932 * [Add license and license_file to cargo metadata output][cargo/3110]
2933 * [Make crates-io registry URL optional in config; ignore all changes to
2934   source.crates-io][cargo/3089]
2935 * [Don't download dependencies from other platforms][cargo/3123]
2936 * [Build transitive dev-dependencies when needed][cargo/3125]
2937 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2938 * [Avoid updating registry when adding existing deps][cargo/3144]
2939 * [Warn about path overrides that won't work][cargo/3136]
2940 * [Use workspaces during `cargo install`][cargo/3146]
2941 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2942 * [Add --message-format flag][cargo/3000]
2943 * [Pass target environment for rustdoc][cargo/3205]
2944 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2945 * [Update curl and curl-sys][cargo/3241]
2946 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2947
2948 Tooling
2949 -------
2950
2951 * [rustdoc: Add the `--sysroot` argument][36586]
2952 * [rustdoc: Fix a couple of issues with the search results][35655]
2953 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2954 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2955 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2956
2957 Misc
2958 ----
2959
2960 * [Remove unmaintained style guide][35124]
2961 * [Add s390x support][36369]
2962 * [Initial work at Haiku OS support][36727]
2963 * [Add mips-uclibc targets][35734]
2964 * [Crate-ify compiler-rt into compiler-builtins][35021]
2965 * [Add rustc version info (git hash + date) to dist tarball][36213]
2966 * Many documentation improvements
2967
2968 Compatibility Notes
2969 -------------------
2970
2971 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2972 * [Deny (by default) transmuting from fn item types to pointer-sized
2973   types][34923]. Continuing the long transition to zero-sized fn items,
2974   per [RFC 401].
2975 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2976   Part of [RFC 1506].
2977 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2978 * [Fix lifetime rules for 'if' conditions][36029].
2979 * [Inherit overflow checks for sum and product][36372].
2980 * [Forbid user-defined macros named "macro_rules"][36730].
2981
2982 [33922]: https://github.com/rust-lang/rust/pull/33922
2983 [34623]: https://github.com/rust-lang/rust/pull/34623
2984 [34923]: https://github.com/rust-lang/rust/pull/34923
2985 [34942]: https://github.com/rust-lang/rust/pull/34942
2986 [34982]: https://github.com/rust-lang/rust/pull/34982
2987 [35021]: https://github.com/rust-lang/rust/pull/35021
2988 [35048]: https://github.com/rust-lang/rust/pull/35048
2989 [35074]: https://github.com/rust-lang/rust/pull/35074
2990 [35124]: https://github.com/rust-lang/rust/pull/35124
2991 [35234]: https://github.com/rust-lang/rust/pull/35234
2992 [35238]: https://github.com/rust-lang/rust/pull/35238
2993 [35354]: https://github.com/rust-lang/rust/pull/35354
2994 [35559]: https://github.com/rust-lang/rust/pull/35559
2995 [35585]: https://github.com/rust-lang/rust/pull/35585
2996 [35627]: https://github.com/rust-lang/rust/pull/35627
2997 [35655]: https://github.com/rust-lang/rust/pull/35655
2998 [35702]: https://github.com/rust-lang/rust/pull/35702
2999 [35707]: https://github.com/rust-lang/rust/pull/35707
3000 [35728]: https://github.com/rust-lang/rust/pull/35728
3001 [35734]: https://github.com/rust-lang/rust/pull/35734
3002 [35755]: https://github.com/rust-lang/rust/pull/35755
3003 [35761]: https://github.com/rust-lang/rust/pull/35761
3004 [35764]: https://github.com/rust-lang/rust/pull/35764
3005 [35814]: https://github.com/rust-lang/rust/pull/35814
3006 [35854]: https://github.com/rust-lang/rust/pull/35854
3007 [35871]: https://github.com/rust-lang/rust/pull/35871
3008 [35884]: https://github.com/rust-lang/rust/pull/35884
3009 [35911]: https://github.com/rust-lang/rust/pull/35911
3010 [35969]: https://github.com/rust-lang/rust/pull/35969
3011 [35975]: https://github.com/rust-lang/rust/pull/35975
3012 [36004]: https://github.com/rust-lang/rust/pull/36004
3013 [36008]: https://github.com/rust-lang/rust/pull/36008
3014 [36014]: https://github.com/rust-lang/rust/pull/36014
3015 [36029]: https://github.com/rust-lang/rust/pull/36029
3016 [36059]: https://github.com/rust-lang/rust/pull/36059
3017 [36072]: https://github.com/rust-lang/rust/pull/36072
3018 [36101]: https://github.com/rust-lang/rust/pull/36101
3019 [36104]: https://github.com/rust-lang/rust/pull/36104
3020 [36171]: https://github.com/rust-lang/rust/pull/36171
3021 [36173]: https://github.com/rust-lang/rust/pull/36173
3022 [36178]: https://github.com/rust-lang/rust/pull/36178
3023 [36213]: https://github.com/rust-lang/rust/pull/36213
3024 [36214]: https://github.com/rust-lang/rust/pull/36214
3025 [36264]: https://github.com/rust-lang/rust/pull/36264
3026 [36266]: https://github.com/rust-lang/rust/pull/36266
3027 [36289]: https://github.com/rust-lang/rust/pull/36289
3028 [36338]: https://github.com/rust-lang/rust/pull/36338
3029 [36351]: https://github.com/rust-lang/rust/pull/36351
3030 [36355]: https://github.com/rust-lang/rust/pull/36355
3031 [36369]: https://github.com/rust-lang/rust/pull/36369
3032 [36372]: https://github.com/rust-lang/rust/pull/36372
3033 [36423]: https://github.com/rust-lang/rust/pull/36423
3034 [36482]: https://github.com/rust-lang/rust/pull/36482
3035 [36505]: https://github.com/rust-lang/rust/pull/36505
3036 [36524]: https://github.com/rust-lang/rust/pull/36524
3037 [36527]: https://github.com/rust-lang/rust/pull/36527
3038 [36551]: https://github.com/rust-lang/rust/pull/36551
3039 [36574]: https://github.com/rust-lang/rust/pull/36574
3040 [36586]: https://github.com/rust-lang/rust/pull/36586
3041 [36592]: https://github.com/rust-lang/rust/pull/36592
3042 [36631]: https://github.com/rust-lang/rust/pull/36631
3043 [36639]: https://github.com/rust-lang/rust/pull/36639
3044 [36721]: https://github.com/rust-lang/rust/pull/36721
3045 [36727]: https://github.com/rust-lang/rust/pull/36727
3046 [36730]: https://github.com/rust-lang/rust/pull/36730
3047 [36734]: https://github.com/rust-lang/rust/pull/36734
3048 [36754]: https://github.com/rust-lang/rust/pull/36754
3049 [36995]: https://github.com/rust-lang/rust/pull/36995
3050 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3051 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3052 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3053 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3054 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3055 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3056 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3057 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3058 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3059 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3060 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3061 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3062 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3063 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3064 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3065 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3066 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3067 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3068 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3069 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3070 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3071 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3072 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3073 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3074 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3075 [rustup]: https://www.rustup.rs
3076 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3077 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3078 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3079 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3080 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3081 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3082 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3083
3084
3085 Version 1.12.1 (2016-10-20)
3086 ===========================
3087
3088 Regression Fixes
3089 ----------------
3090
3091 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3092 * [Confusion with double negation and booleans][36856]
3093 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3094 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3095 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3096 * [Corrupted memory after updated to 1.12][36936]
3097 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3098 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3099 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3100
3101 [36381]: https://github.com/rust-lang/rust/issues/36381
3102 [36856]: https://github.com/rust-lang/rust/issues/36856
3103 [36875]: https://github.com/rust-lang/rust/issues/36875
3104 [36924]: https://github.com/rust-lang/rust/issues/36924
3105 [36926]: https://github.com/rust-lang/rust/issues/36926
3106 [36936]: https://github.com/rust-lang/rust/issues/36936
3107 [37026]: https://github.com/rust-lang/rust/issues/37026
3108 [37112]: https://github.com/rust-lang/rust/issues/37112
3109 [37153]: https://github.com/rust-lang/rust/issues/37153
3110
3111
3112 Version 1.12.0 (2016-09-29)
3113 ===========================
3114
3115 Highlights
3116 ----------
3117
3118 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3119   This translation pass is far simpler than the previous AST->LLVM pass, and
3120   creates opportunities to perform new optimizations directly on the MIR. It
3121   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3122 * [`rustc` presents a new, more readable error format, along with
3123   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3124   Most common editors supporting Rust have been updated to work with it. It was
3125   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3126
3127 Compiler
3128 --------
3129
3130 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3131   This translation pass is far simpler than the previous AST->LLVM pass, and
3132   creates opportunities to perform new optimizations directly on the MIR. It
3133   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3134 * [Print the Rust target name, not the LLVM target name, with
3135   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3136 * [The computation of `TypeId` is correct in some cases where it was previously
3137   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3138 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3139 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3140   `--print relocation-models`, and `--print code-models` print the available
3141   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3142   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3143 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3144   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3145   These targets produce statically-linked binaries. There are no binary release
3146   builds yet though.
3147
3148 Diagnostics
3149 -----------
3150
3151 * [`rustc` presents a new, more readable error format, along with
3152   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3153   Most common editors supporting Rust have been updated to work with it. It was
3154   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3155 * [In error descriptions, references are now described in plain English,
3156   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3157 * [In error type descriptions, unknown numeric types are named `{integer}` or
3158   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3159 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3160
3161 Language
3162 --------
3163
3164 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3165 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3166 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3167   useful](https://github.com/rust-lang/rust/pull/34908)
3168 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3169   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3170 * [Semicolons are properly required as statement delimiters inside
3171   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3172 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3173
3174 Stabilized APIs
3175 ---------------
3176
3177 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3178 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3179 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3180 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3181 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3182 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3183 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3184 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3185 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3186 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3187   Both on Unix and Windows.
3188 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3189 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3190 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3191 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3192 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3193 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3194 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3195 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3196
3197 Libraries
3198 ---------
3199
3200 * [The `format!` macro and friends now allow a single argument to be formatted
3201   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3202 * [The lifetime bounds on `[T]::binary_search_by` and
3203   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3204 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3205 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3206 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3207 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3208 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3209 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3210 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3211 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3212   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3213 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3214   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3215 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3216 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3217   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3218 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3219 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3220 * [`mpsc::sync_channel` `Receiver`s return any available message before
3221   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3222 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3223 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3224
3225 Cargo
3226 -----
3227
3228 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3229 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3230 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3231 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3232 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3233 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3234 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3235 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3236 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3237 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3238 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3239 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3240 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3241 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3242 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3243 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3244
3245 Performance
3246 -----------
3247
3248 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3249 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3250
3251 Tooling
3252 -------
3253
3254 * [Test binaries now support a `--test-threads` argument to specify the number
3255   of threads used to run tests, and which acts the same as the
3256   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3257 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3258 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3259 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3260 * [Rust releases now come with source packages that can be installed by rustup
3261   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3262   The resulting source code can be used by tools and IDES, located in the
3263   sysroot under `lib/rustlib/src`.
3264
3265 Misc
3266 ----
3267
3268 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3269 * Many minor improvements to the documentation.
3270 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3271
3272 Compatibility Notes
3273 -------------------
3274
3275 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3276   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3277 * [When formatting strings, if "precision" is specified, the "fill",
3278   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3279 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3280
3281
3282 Version 1.11.0 (2016-08-18)
3283 ===========================
3284
3285 Language
3286 --------
3287
3288 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3289 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3290 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3291 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3292 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3293
3294 Stabilized APIs
3295 ---------------
3296
3297 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3298 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3299 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3300 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3301 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3302 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3303   (in libcore - previously stabilized in libstd)
3304 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3305   (in libcore - previously stabilized in libstd)
3306 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3307   (in libcore - previously stabilized in libstd)
3308 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3309   (in libcore - previously stabilized in libstd)
3310 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3311 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3312 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3313 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3314
3315 Libraries
3316 ---------
3317
3318 * [The `thread_local!` macro supports multiple definitions in a single
3319    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3320 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3321 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3322   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3323 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3324 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3325 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3326 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3327
3328 Cargo
3329 -----
3330
3331 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3332 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3333 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3334 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3335 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3336   and `-vv` prints warnings for all crates.
3337 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3338 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3339   This provides room for expansion by arbitrary tools.
3340 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3341 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3342 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3343 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3344 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3345 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3346 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3347
3348 Performance
3349 -----------
3350
3351 * [Caching projections speeds up type check dramatically for some
3352   workloads](https://github.com/rust-lang/rust/pull/33816)
3353 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3354   This hasher is faster, but is believed to provide sufficient
3355   protection from collision attacks.
3356 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3357
3358 Rustdoc
3359 -------
3360
3361 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3362 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3363 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3364 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3365 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3366
3367 Tooling
3368 -------
3369
3370 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3371 * [When emitting debug info, rustc emits frame pointers for closures,
3372   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3373 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3374 * Many more errors have been given error codes and extended
3375   explanations
3376 * API documentation continues to be improved, with many new examples
3377
3378 Misc
3379 ----
3380
3381 * [rustc no longer hangs when dependencies recursively re-export
3382   submodules](https://github.com/rust-lang/rust/pull/34542)
3383 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3384 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3385   rewritten](https://github.com/rust-lang/rust/pull/33895)
3386 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3387   No targets use this yet, but it works toward AVR support.
3388
3389 Compatibility Notes
3390 -------------------
3391
3392 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3393 * [The new follow-set rules that place restrictions on `macro_rules!`
3394   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3395   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3396   and has been a warning since 1.10.
3397 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3398   This causes breakage in some corner cases.
3399
3400
3401 Version 1.10.0 (2016-07-07)
3402 ===========================
3403
3404 Language
3405 --------
3406
3407 * [Allow `concat_idents!` in type positions as well as in expression
3408   positions](https://github.com/rust-lang/rust/pull/33735).
3409 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3410   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3411 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3412 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3413 * [`panic!` can be converted to a runtime abort with the
3414   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3415   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3416 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3417   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3418   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3419   Note that Cargo does not yet directly support cdylibs.
3420
3421 Stabilized APIs
3422 ---------------
3423
3424 * `os::windows::fs::OpenOptionsExt::access_mode`
3425 * `os::windows::fs::OpenOptionsExt::share_mode`
3426 * `os::windows::fs::OpenOptionsExt::custom_flags`
3427 * `os::windows::fs::OpenOptionsExt::attributes`
3428 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3429 * `os::unix::fs::OpenOptionsExt::custom_flags`
3430 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3431 * `Default for sync::Weak`
3432 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3433 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3434 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3435 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3436 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3437 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3438 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3439 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3440 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3441 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3442 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3443 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3444 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3445 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3446 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3447 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3448 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3449 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3450 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3451 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3452 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3453 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3454 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3455 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3456 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3457 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3458 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3459 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3460 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3461 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3462 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3463 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3464 * Read/Write/RawFd impls for `UnixStream`
3465 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3466 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3467 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3468 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3469 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3470 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3471 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3472 * RawFd impls for `UnixListener`
3473 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3474 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3475 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3476 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3477 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3478 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3479 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3480 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3481 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3482 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3483 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3484 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3485 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3486 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3487 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3488 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3489 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3490 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3491 * RawFd impls for `UnixDatagram`
3492 * `{BTree,Hash}Map::values_mut`
3493 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3494
3495 Libraries
3496 ---------
3497
3498 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3499   The semantics of this minor method are subtle and probably not what
3500   most people want.
3501 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3502 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3503   will fall back to `/dev/urandom` temporarily to avoid blocking
3504   during early boot](https://github.com/rust-lang/rust/pull/33086).
3505 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3506 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3507 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3508 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3509 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3510 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3511   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3512
3513 Cargo
3514 -----
3515 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3516   This controls the runtime behavior of the `panic!` macro
3517   and can be either "unwind" (the default), or "abort".
3518   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3519 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3520 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3521 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3522   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3523 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3524 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3525 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3526   By default they are retried twice, which can be customized with the
3527   `net.retry` value in `.cargo/config`.
3528 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3529 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3530 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3531 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3532   Makes it possible to install multiple crates in parallel.
3533 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3534 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3535 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3536 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3537 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3538 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3539
3540 Performance
3541 -----------
3542
3543 * [rustc memory usage was reduced by refactoring the context used for
3544   type checking](https://github.com/rust-lang/rust/pull/33425).
3545 * [Speed up creation of `HashMap`s by caching the random keys used
3546   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3547 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3548 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3549 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3550   10x faster than the previous lookup tables.
3551 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3552
3553 Usability
3554 ---------
3555
3556 * Many incremental improvements to documentation and rustdoc.
3557 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3558 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3559 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3560 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3561 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3562 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3563 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3564
3565 Misc
3566 ----
3567
3568 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3569 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3570 * [`std` no longer prints backtraces on platforms where the running
3571   module must be loaded with `env::current_exe`, which can't be relied
3572   on](https://github.com/rust-lang/rust/pull/33554).
3573 * This release includes std binaries for the i586-unknown-linux-gnu,
3574   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3575   i586 target is for old x86 hardware without SSE2, and the armv7
3576   target is for Android running on modern ARM architectures.
3577 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3578   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3579 * [On Unix the runtime aborts by calling `libc::abort` instead of
3580   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3581 * [Rust is now bootstrapped from the previous release of Rust,
3582   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3583
3584 Compatibility Notes
3585 -------------------
3586
3587 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3588 * [`target_env` for Linux ARM targets is just `gnu`, not
3589   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3590 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3591 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3592 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3593   Affects how macros are parsed.
3594 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3595 * [Feature-gated attributes on macro-generated macro invocations are
3596   now rejected](https://github.com/rust-lang/rust/pull/32791).
3597 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3598   This caused some minor changes to type inference.
3599
3600
3601 Version 1.9.0 (2016-05-26)
3602 ==========================
3603
3604 Language
3605 --------
3606
3607 * The `#[deprecated]` attribute when applied to an API will generate
3608   warnings when used. The warnings may be suppressed with
3609   `#[allow(deprecated)]`. [RFC 1270].
3610 * [`fn` item types are zero sized, and each `fn` names a unique
3611   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3612   `transmute` on a `fn` type will generate a warning for a few cycles,
3613   then will be converted to an error.
3614 * [Field and method resolution understand visibility, so private
3615   fields and methods cannot prevent the proper use of public fields
3616   and methods][1.9fv].
3617 * [The parser considers unicode codepoints in the
3618   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3619
3620 Stabilized APIs
3621 ---------------
3622
3623 * [`std::panic`]
3624 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3625 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3626 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3627 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3628 * [`str::is_char_boundary`]
3629 * [`<*const T>::as_ref`]
3630 * [`<*mut T>::as_ref`]
3631 * [`<*mut T>::as_mut`]
3632 * [`AsciiExt::make_ascii_uppercase`]
3633 * [`AsciiExt::make_ascii_lowercase`]
3634 * [`char::decode_utf16`]
3635 * [`char::DecodeUtf16`]
3636 * [`char::DecodeUtf16Error`]
3637 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3638 * [`BTreeSet::take`]
3639 * [`BTreeSet::replace`]
3640 * [`BTreeSet::get`]
3641 * [`HashSet::take`]
3642 * [`HashSet::replace`]
3643 * [`HashSet::get`]
3644 * [`OsString::with_capacity`]
3645 * [`OsString::clear`]
3646 * [`OsString::capacity`]
3647 * [`OsString::reserve`]
3648 * [`OsString::reserve_exact`]
3649 * [`OsStr::is_empty`]
3650 * [`OsStr::len`]
3651 * [`std::os::unix::thread`]
3652 * [`RawPthread`]
3653 * [`JoinHandleExt`]
3654 * [`JoinHandleExt::as_pthread_t`]
3655 * [`JoinHandleExt::into_pthread_t`]
3656 * [`HashSet::hasher`]
3657 * [`HashMap::hasher`]
3658 * [`CommandExt::exec`]
3659 * [`File::try_clone`]
3660 * [`SocketAddr::set_ip`]
3661 * [`SocketAddr::set_port`]
3662 * [`SocketAddrV4::set_ip`]
3663 * [`SocketAddrV4::set_port`]
3664 * [`SocketAddrV6::set_ip`]
3665 * [`SocketAddrV6::set_port`]
3666 * [`SocketAddrV6::set_flowinfo`]
3667 * [`SocketAddrV6::set_scope_id`]
3668 * [`slice::copy_from_slice`]
3669 * [`ptr::read_volatile`]
3670 * [`ptr::write_volatile`]
3671 * [`OpenOptions::create_new`]
3672 * [`TcpStream::set_nodelay`]
3673 * [`TcpStream::nodelay`]
3674 * [`TcpStream::set_ttl`]
3675 * [`TcpStream::ttl`]
3676 * [`TcpStream::set_only_v6`]
3677 * [`TcpStream::only_v6`]
3678 * [`TcpStream::take_error`]
3679 * [`TcpStream::set_nonblocking`]
3680 * [`TcpListener::set_ttl`]
3681 * [`TcpListener::ttl`]
3682 * [`TcpListener::set_only_v6`]
3683 * [`TcpListener::only_v6`]
3684 * [`TcpListener::take_error`]
3685 * [`TcpListener::set_nonblocking`]
3686 * [`UdpSocket::set_broadcast`]
3687 * [`UdpSocket::broadcast`]
3688 * [`UdpSocket::set_multicast_loop_v4`]
3689 * [`UdpSocket::multicast_loop_v4`]
3690 * [`UdpSocket::set_multicast_ttl_v4`]
3691 * [`UdpSocket::multicast_ttl_v4`]
3692 * [`UdpSocket::set_multicast_loop_v6`]
3693 * [`UdpSocket::multicast_loop_v6`]
3694 * [`UdpSocket::set_multicast_ttl_v6`]
3695 * [`UdpSocket::multicast_ttl_v6`]
3696 * [`UdpSocket::set_ttl`]
3697 * [`UdpSocket::ttl`]
3698 * [`UdpSocket::set_only_v6`]
3699 * [`UdpSocket::only_v6`]
3700 * [`UdpSocket::join_multicast_v4`]
3701 * [`UdpSocket::join_multicast_v6`]
3702 * [`UdpSocket::leave_multicast_v4`]
3703 * [`UdpSocket::leave_multicast_v6`]
3704 * [`UdpSocket::take_error`]
3705 * [`UdpSocket::connect`]
3706 * [`UdpSocket::send`]
3707 * [`UdpSocket::recv`]
3708 * [`UdpSocket::set_nonblocking`]
3709
3710 Libraries
3711 ---------
3712
3713 * [`std::sync::Once` is poisoned if its initialization function
3714   fails][1.9o].
3715 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3716 * [Most types implement `fmt::Debug`][1.9db].
3717 * [The default buffer size used by `BufReader` and `BufWriter` was
3718   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3719   used by other languages.
3720 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3721   `Duration` additionally implements `*=` and `/=`][1.9ta].
3722 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3723 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3724 * [`Chain` implements `BufRead`][1.9ch].
3725 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3726
3727 Cargo
3728 -----
3729
3730 * [Cargo can now run concurrently][1.9cc].
3731 * [Top-level overrides allow specific revisions of crates to be
3732   overridden through the entire crate graph][1.9ct].  This is intended
3733   to make upgrades easier for large projects, by allowing crates to be
3734   forked temporarily until they've been upgraded and republished.
3735 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3736 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3737   on the commandline][1.9cf]. `rustc` arguments can also be specified
3738   in the `build.rustflags` configuration key.
3739
3740 Performance
3741 -----------
3742
3743 * [The time complexity of comparing variables for equivalence during type
3744   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3745   to major compilation time improvement in some scenarios.
3746 * [`ToString` is specialized for `str`, giving it the same performance
3747   as `to_owned`][1.9ts].
3748 * [Spawning processes with `Command::output` no longer creates extra
3749   threads][1.9sp].
3750 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3751   for C-like enums][1.9cl].
3752
3753 Misc
3754 ----
3755
3756 * [Passing the `--quiet` flag to a test runner will produce
3757   much-abbreviated output][1.9q].
3758 * The Rust Project now publishes std binaries for the
3759   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3760   `i586-pc-windows-msvc` targets.
3761
3762 Compatibility Notes
3763 -------------------
3764
3765 * [`std::sync::Once` is poisoned if its initialization function
3766   fails][1.9o].
3767 * [It is illegal to define methods with the same name in overlapping
3768   inherent `impl` blocks][1.9sn].
3769 * [`fn` item types are zero sized, and each `fn` names a unique
3770   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3771   `transmute` on a `fn` type will generate a warning for a few cycles,
3772   then will be converted to an error.
3773 * [Improvements to const evaluation may trigger new errors when integer
3774   literals are out of range][1.9ce].
3775
3776
3777 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3778 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3779 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3780 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3781 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3782 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3783 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3784 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3785 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3786 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3787 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3788 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3789 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3790 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3791 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3792 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3793 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3794 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3795 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3796 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3797 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3798 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3799 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3800 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3801 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3802 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3803 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3804 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3805 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3806 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3807 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3808 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3809 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3810 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3811 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3812 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3813 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3814 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3815 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3816 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3817 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3818 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3819 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3820 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3821 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3822 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3823 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3824 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3825 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3826 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3827 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3828 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3829 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3830 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3831 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3832 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3833 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3834 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3835 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3836 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3837 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3838 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3839 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3840 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3841 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3842 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3843 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3844 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3845 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3846 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3847 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3848 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3849 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3850 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3851 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3852 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3853 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3854 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3855 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3856 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3857 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3858 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3859 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3860 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3861 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3862 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3863 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3864 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3865 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3866 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3867 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3868 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3869 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3870 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3871 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3872 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3873 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3874 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3875 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3876 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3877 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3878 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3879 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3880 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3881 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3882 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3883 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3884 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3885 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3886 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3887
3888
3889 Version 1.8.0 (2016-04-14)
3890 ==========================
3891
3892 Language
3893 --------
3894
3895 * Rust supports overloading of compound assignment statements like
3896   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3897   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3898   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3899   traits. [RFC 953].
3900 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3901   addition to the non-braced form, `struct Foo;`. [RFC 218].
3902
3903 Libraries
3904 ---------
3905
3906 * Stabilized APIs:
3907   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3908   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3909   * [`Ref::map`]
3910   * [`RefMut::map`]
3911   * [`ptr::drop_in_place`]
3912   * [`time::Instant`]
3913   * [`time::SystemTime`]
3914   * [`Instant::now`]
3915   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3916   * [`Instant::elapsed`]
3917   * [`SystemTime::now`]
3918   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3919   * [`SystemTime::elapsed`]
3920   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3921   * [`SystemTimeError`]
3922   * [`SystemTimeError::duration`]
3923   * Various impls for `SystemTimeError`
3924   * [`UNIX_EPOCH`]
3925   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3926     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3927     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3928 * [The `write!` and `writeln!` macros correctly emit errors if any of
3929   their arguments can't be formatted][1.8w].
3930 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3931 * [The Unix-specific `raw` modules, which contain a number of
3932   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3933   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3934   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3935   across platforms was making it difficult to implement `std`
3936   correctly. Those that need these definitions should use the `libc`
3937   crate. [RFC 1415].
3938 * The Unix-specific `MetadataExt` traits, including
3939   `os::unix::fs::MetadataExt`, which expose values such as inode
3940   numbers [no longer return platform-specific types][1.8r], but
3941   instead return widened integers. [RFC 1415].
3942 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3943 * [Atomic loads and stores are not volatile][1.8a].
3944 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3945
3946 Performance
3947 -----------
3948
3949 * [Inlining hash functions lead to a 3% compile-time improvement in
3950   some workloads][1.8h].
3951 * When using jemalloc, its symbols are [unprefixed so that it
3952   overrides the libc malloc implementation][1.8h]. This means that for
3953   rustc, LLVM is now using jemalloc, which results in a 6%
3954   compile-time improvement on a specific workload.
3955 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3956
3957 Misc
3958 ----
3959
3960 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3961   i686-pc-windows-msvc is now considered a tier-1 platform.
3962 * [The `--print targets` flag prints a list of supported targets][1.8t].
3963 * [The `--print cfg` flag prints the `cfg`s defined for the current
3964   target][1.8cf].
3965 * [`rustc` can be built with an new Cargo-based build system, written
3966   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3967   build system. To enable it configure with `configure --rustbuild`.
3968 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3969   variants while also indicating the total number of missing variants
3970   if more than 3][1.8m].
3971 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3972 * The Rust Project now publishes binary releases of the standard
3973   library for a number of tier-2 targets:
3974   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3975   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3976   `x86_64-rumprun-netbsd`. These can be installed with
3977   tools such as [multirust][1.8mr].
3978
3979 Cargo
3980 -----
3981
3982 * [`cargo init` creates a new Cargo project in the current
3983   directory][1.8ci].  It is otherwise like `cargo new`.
3984 * [Cargo has configuration keys for `-v` and
3985   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3986   `[term]` section of `.cargo/config`.
3987 * [Configuration keys that evaluate to strings or integers can be set
3988   via environment variables][1.8ce]. For example the `build.jobs` key
3989   can be set via `CARGO_BUILD_JOBS`. Environment variables take
3990   precedence over config files.
3991 * [Target-specific dependencies support Rust `cfg` syntax for
3992   describing targets][1.8cfg] so that dependencies for multiple
3993   targets can be specified together. [RFC 1361].
3994 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
3995   `RUSTDOC` take precedence over the `build.target-dir`,
3996   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
3997 * [The child process tree is killed on Windows when Cargo is
3998   killed][1.8ck].
3999 * [The `build.target` configuration value sets the target platform,
4000   like `--target`][1.8ct].
4001
4002 Compatibility Notes
4003 -------------------
4004
4005 * [Unstable compiler flags have been further restricted][1.8u]. Since
4006   1.0 `-Z` flags have been considered unstable, and other flags that
4007   were considered unstable additionally required passing `-Z
4008   unstable-options` to access. Unlike unstable language and library
4009   features though, these options have been accessible on the stable
4010   release channel. Going forward, *new unstable flags will not be
4011   available on the stable release channel*, and old unstable flags
4012   will warn about their usage. In the future, all unstable flags will
4013   be unavailable on the stable release channel.
4014 * [It is no longer possible to `match` on empty enum variants using
4015   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4016 * The Unix-specific `MetadataExt` traits, including
4017   `os::unix::fs::MetadataExt`, which expose values such as inode
4018   numbers [no longer return platform-specific types][1.8r], but
4019   instead return widened integers. [RFC 1415].
4020 * [Modules sourced from the filesystem cannot appear within arbitrary
4021   blocks, but only within other modules][1.8mf].
4022 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4023 * On Unix, [stack overflow triggers a runtime abort instead of a
4024   SIGSEGV][1.8so].
4025 * [`Command::spawn` and its equivalents return an error if any of
4026   its command-line arguments contain interior `NUL`s][1.8n].
4027 * [Tuple and unit enum variants from other crates are in the type
4028   namespace][1.8tn].
4029 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4030   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4031   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4032   instead of `foo.lib`.
4033
4034
4035 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4036 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4037 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4038 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4039 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4040 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4041 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4042 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4043 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4044 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4045 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4046 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4047 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4048 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4049 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4050 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4051 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4052 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4053 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4054 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4055 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4056 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4057 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4058 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4059 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4060 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4061 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4062 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4063 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4064 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4065 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4066 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4067 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4068 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4069 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4070 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4071 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4072 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4073 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4074 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4075 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4076 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4077 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4078 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4079 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4080 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4081 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4082 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4083 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4084 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4085 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4086 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4087 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4088 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4089 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4090 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4091 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4092 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4093 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4094 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4095
4096
4097 Version 1.7.0 (2016-03-03)
4098 ==========================
4099
4100 Libraries
4101 ---------
4102
4103 * Stabilized APIs
4104   * `Path`
4105     * [`Path::strip_prefix`][] (renamed from relative_from)
4106     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4107   * `Ipv4Addr`
4108     * [`Ipv4Addr::is_loopback`]
4109     * [`Ipv4Addr::is_private`]
4110     * [`Ipv4Addr::is_link_local`]
4111     * [`Ipv4Addr::is_multicast`]
4112     * [`Ipv4Addr::is_broadcast`]
4113     * [`Ipv4Addr::is_documentation`]
4114   * `Ipv6Addr`
4115     * [`Ipv6Addr::is_unspecified`]
4116     * [`Ipv6Addr::is_loopback`]
4117     * [`Ipv6Addr::is_multicast`]
4118   * `Vec`
4119     * [`Vec::as_slice`]
4120     * [`Vec::as_mut_slice`]
4121   * `String`
4122     * [`String::as_str`]
4123     * [`String::as_mut_str`]
4124   * Slices
4125     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4126     be the same length
4127     * `<[T]>::`[`sort_by_key`]
4128   * checked, saturated, and overflowing operations
4129     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4130     * [`i32::saturating_mul`]
4131     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4132     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4133     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4134     * [`u32::saturating_mul`]
4135     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4136     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4137     * and checked, saturated, and overflowing operations for other primitive types
4138   * FFI
4139     * [`ffi::IntoStringError`]
4140     * [`CString::into_string`]
4141     * [`CString::into_bytes`]
4142     * [`CString::into_bytes_with_nul`]
4143     * `From<CString> for Vec<u8>`
4144   * `IntoStringError`
4145     * [`IntoStringError::into_cstring`]
4146     * [`IntoStringError::utf8_error`]
4147     * `Error for IntoStringError`
4148   * Hashing
4149     * [`std::hash::BuildHasher`]
4150     * [`BuildHasher::Hasher`]
4151     * [`BuildHasher::build_hasher`]
4152     * [`std::hash::BuildHasherDefault`]
4153     * [`HashMap::with_hasher`]
4154     * [`HashMap::with_capacity_and_hasher`]
4155     * [`HashSet::with_hasher`]
4156     * [`HashSet::with_capacity_and_hasher`]
4157     * [`std::collections::hash_map::RandomState`]
4158     * [`RandomState::new`]
4159 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4160   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4161   from bytes is faster.
4162 * [The performance of `LineWriter` (and thus `io::stdout`) was
4163   improved by using `memchr` to search for newlines][1.7m].
4164 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4165   `f64` variants were stabilized previously.
4166 * [`BTreeMap` was rewritten to use less memory and improve the performance
4167   of insertion and iteration, the latter by as much as 5x][1.7bm].
4168 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4169   covariant over their contained type][1.7bt].
4170 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4171   over their contained type][1.7ll].
4172 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4173   searching methods.
4174 * [`Any` is implemented for unsized types][1.7a].
4175 * [`Hash` is implemented for `Duration`][1.7h].
4176
4177 Misc
4178 ----
4179
4180 * [When running tests with `--test`, rustdoc will pass `--cfg`
4181   arguments to the compiler][1.7dt].
4182 * [The compiler is built with RPATH information by default][1.7rpa].
4183   This means that it will be possible to run `rustc` when installed in
4184   unusual configurations without configuring the dynamic linker search
4185   path explicitly.
4186 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4187   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4188   over `LD_LIBRARY_PATH`.
4189
4190 Cargo
4191 -----
4192
4193 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4194   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4195 * [The `rerun-if-changed` build script directive no longer causes the
4196   build script to incorrectly run twice in certain scenarios][1.7rr].
4197
4198 Compatibility Notes
4199 -------------------
4200
4201 * Soundness fixes to the interactions between associated types and
4202   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4203   code that violates the new rules. This is a significant change that
4204   is known to break existing code, so it has emitted warnings for the
4205   new error cases since 1.4 to give crate authors time to adapt. The
4206   details of what is changing are subtle; read the RFC for more.
4207 * [Several bugs in the compiler's visibility calculations were
4208   fixed][1.7v]. Since this was found to break significant amounts of
4209   code, the new errors will be emitted as warnings for several release
4210   cycles, under the `private_in_public` lint.
4211 * Defaulted type parameters were accidentally accepted in positions
4212   that were not intended. In this release, [defaulted type parameters
4213   appearing outside of type definitions will generate a
4214   warning][1.7d], which will become an error in future releases.
4215 * [Parsing "." as a float results in an error instead of 0][1.7p].
4216   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4217 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4218
4219 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4220 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4221 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4222 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4223 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4224 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4225 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4226 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4227 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4228 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4229 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4230 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4231 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4232 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4233 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4234 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4235 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4236 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4237 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4238 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4239 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4240 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4241 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4242 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4243 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4244 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4245 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4246 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4247 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4248 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4249 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4250 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4251 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4252 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4253 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4254 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4255 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4256 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4257 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4258 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4259 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4260 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4261 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4262 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4263 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4264 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4265 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4266 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4267 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4268 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4269 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4270 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4271 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4272 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4273 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4274 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4275 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4276 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4277 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4278 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4279 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4280 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4281 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4282 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4283 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4284 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4285 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4286 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4287 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4288 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4289 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4290 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4291 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4292 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4293 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4294 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4295 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4296 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4297 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4298
4299
4300 Version 1.6.0 (2016-01-21)
4301 ==========================
4302
4303 Language
4304 --------
4305
4306 * The `#![no_std]` attribute causes a crate to not be linked to the
4307   standard library, but only the [core library][1.6co], as described
4308   in [RFC 1184]. The core library defines common types and traits but
4309   has no platform dependencies whatsoever, and is the basis for Rust
4310   software in environments that cannot support a full port of the
4311   standard library, such as operating systems. Most of the core
4312   library is now stable.
4313
4314 Libraries
4315 ---------
4316
4317 * Stabilized APIs:
4318   [`Read::read_exact`],
4319   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4320   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4321   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4322   [`os::unix::fs::DirBuilderExt`],
4323   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4324   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4325   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4326   [`collections::hash_map::Drain`],
4327   [`collections::hash_map::HashMap::drain`],
4328   [`collections::hash_set::Drain`],
4329   [`collections::hash_set::HashSet::drain`],
4330   [`collections::binary_heap::Drain`],
4331   [`collections::binary_heap::BinaryHeap::drain`],
4332   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4333   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4334   [`RwLock::into_inner`],
4335   [`Iterator::min_by_key`][] (renamed from `min_by`),
4336   [`Iterator::max_by_key`][] (renamed from `max_by`).
4337 * The [core library][1.6co] is stable, as are most of its APIs.
4338 * [The `assert_eq!` macro supports arguments that don't implement
4339   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4340   `assert!`.
4341 * Several timer functions that take duration in milliseconds [are
4342   deprecated in favor of those that take `Duration`][1.6ms]. These
4343   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4344   `thread::park_timeout_ms`.
4345 * The algorithm by which `Vec` reserves additional elements was
4346   [tweaked to not allocate excessive space][1.6a] while still growing
4347   exponentially.
4348 * `From` conversions are [implemented from integers to floats][1.6f]
4349   in cases where the conversion is lossless. Thus they are not
4350   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4351   or `f64`. They are also not implemented for `isize` and `usize`
4352   because the implementations would be platform-specific. `From` is
4353   also implemented from `f32` to `f64`.
4354 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4355 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4356 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4357 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4358   improvements.
4359 * Sorting slices that are already sorted [is 50% faster in some
4360   cases][1.6s].
4361
4362 Cargo
4363 -----
4364
4365 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4366 * Cargo build scripts can specify their dependencies by emitting the
4367   [`rerun-if-changed`][1.6rr] key.
4368 * crates.io will reject publication of crates with dependencies that
4369   have a wildcard version constraint. Crates with wildcard
4370   dependencies were seen to cause a variety of problems, as described
4371   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4372   warning.
4373 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4374   release folder.  A variety of artifacts that Cargo failed to clean
4375   are now correctly deleted.
4376
4377 Misc
4378 ----
4379
4380 * The `unreachable_code` lint [warns when a function call's argument
4381   diverges][1.6dv].
4382 * The parser indicates [failures that may be caused by
4383   confusingly-similar Unicode characters][1.6uc]
4384 * Certain macro errors [are reported at definition time][1.6m], not
4385   expansion.
4386
4387 Compatibility Notes
4388 -------------------
4389
4390 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4391   environment variable when locating crates. This was a pre-cargo
4392   feature for integrating with the package manager that was
4393   accidentally never removed.
4394 * [A number of bugs were fixed in the privacy checker][1.6p] that
4395   could cause previously-accepted code to break.
4396 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4397 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4398   struct pattern syntax (`Foo(..)`) can no longer be used to match
4399   unit structs. This is a warning now, but will become an error in
4400   future releases. Patterns that share the same name as a const are
4401   now an error.
4402 * A bug was fixed that causes [rustc not to apply default type
4403   parameters][1.6xc] when resolving certain method implementations of
4404   traits defined in other crates.
4405
4406 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4407 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4408 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4409 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4410 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4411 [1.6co]: http://doc.rust-lang.org/core/index.html
4412 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4413 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4414 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4415 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4416 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4417 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4418 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4419 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4420 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4421 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4422 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4423 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4424 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4425 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4426 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4427 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4428 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4429 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4430 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4431 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4432 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4433 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4434 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4435 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4436 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4437 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4438 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4439 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4440 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4441 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4442 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4443 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4444 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4445 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4446 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4447 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4448 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4449 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4450 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4451 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4452 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4453
4454
4455 Version 1.5.0 (2015-12-10)
4456 ==========================
4457
4458 * ~700 changes, numerous bugfixes
4459
4460 Highlights
4461 ----------
4462
4463 * Stabilized APIs:
4464   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4465   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4466   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4467   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4468   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4469   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4470   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4471   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4472   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4473   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4474   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4475   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4476   [`Path::read_link`], [`Path::symlink_metadata`],
4477   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4478   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4479   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4480   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4481   [`slice::split_first_mut`], [`slice::split_first`],
4482   [`slice::split_last_mut`], [`slice::split_last`],
4483   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4484   [`str::MatchIndices`], [`str::RMatchIndices`],
4485   [`str::match_indices`], [`str::rmatch_indices`],
4486   [`str::slice_mut_unchecked`], [`string::ParseError`].
4487 * Rust applications hosted on crates.io can be installed locally to
4488   `~/.cargo/bin` with the [`cargo install`] command. Among other
4489   things this makes it easier to augment Cargo with new subcommands:
4490   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4491   invoked as `cargo foo`.
4492 * Crates with wildcard (`*`) dependencies will [emit warnings when
4493   published][1.5w]. In 1.6 it will no longer be possible to publish
4494   crates with wildcard dependencies.
4495
4496 Breaking Changes
4497 ----------------
4498
4499 * The rules determining when a particular lifetime must outlive
4500   a particular value (known as '[dropck]') have been [modified
4501   to not rely on parametricity][1.5p].
4502 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4503   and `Arc`][1.5a]. Because these smart pointer types implement
4504   `Deref`, this causes breakage in cases where the interior type
4505   contains methods of the same name.
4506 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4507   that they could drop their content. Soundness fix.
4508 * All method invocations are [properly checked][1.5wf1] for
4509   [well-formedness][1.5wf2]. Soundness fix.
4510 * Traits whose supertraits contain `Self` are [not object
4511   safe][1.5o]. Soundness fix.
4512 * Target specifications support a [`no_default_libraries`][1.5nd]
4513   setting that controls whether `-nodefaultlibs` is passed to the
4514   linker, and in turn the `is_like_windows` setting no longer affects
4515   the `-nodefaultlibs` flag.
4516 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4517 * The `#[inline]` and `#[repr]` attributes [can only appear
4518   in valid locations][1.5at].
4519 * Native libraries linked from the local crate are [passed to
4520   the linker before native libraries from upstream crates][1.5nl].
4521 * Two rarely-used attributes, `#[no_debug]` and
4522   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4523 * Negation of unsigned integers, which has been a warning for
4524   several releases, [is now behind a feature gate and will
4525   generate errors][1.5nu].
4526 * The parser accidentally accepted visibility modifiers on
4527   enum variants, a bug [which has been fixed][1.5ev].
4528 * [A bug was fixed that allowed `use` statements to import unstable
4529   features][1.5use].
4530
4531 Language
4532 --------
4533
4534 * When evaluating expressions at compile-time that are not
4535   compile-time constants (const-evaluating expressions in non-const
4536   contexts), incorrect code such as overlong bitshifts and arithmetic
4537   overflow will [generate a warning instead of an error][1.5ce],
4538   delaying the error until runtime. This will allow the
4539   const-evaluator to be expanded in the future backwards-compatibly.
4540 * The `improper_ctypes` lint [no longer warns about using `isize` and
4541   `usize` in FFI][1.5ict].
4542
4543 Libraries
4544 ---------
4545
4546 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4547   invariant][1.5c].
4548 * `Default` is [implemented for mutable slices][1.5d].
4549 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4550 * There are now `From` conversions [between floating point
4551   types][1.5f] where the conversions are lossless.
4552 * There are now `From` conversions [between integer types][1.5i] where
4553   the conversions are lossless.
4554 * [`fs::Metadata` implements `Clone`][1.5fs].
4555 * The `parse` method [accepts a leading "+" when parsing
4556   integers][1.5pi].
4557 * [`AsMut` is implemented for `Vec`][1.5am].
4558 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4559   been optimized][1.5cf] and no longer rely on the default impl.
4560 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4561   `unsafe extern "C"` function types now [implement `Clone`,
4562   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4563   `fmt::Debug` for up to 12 arguments][1.5fp].
4564 * [Dropping `Vec`s is much faster in unoptimized builds when the
4565   element types don't implement `Drop`][1.5dv].
4566 * A bug that caused in incorrect behavior when [combining `VecDeque`
4567   with zero-sized types][1.5vdz] was resolved.
4568 * [`PartialOrd` for slices is faster][1.5po].
4569
4570 Miscellaneous
4571 -------------
4572
4573 * [Crate metadata size was reduced by 20%][1.5md].
4574 * [Improvements to code generation reduced the size of libcore by 3.3
4575   MB and rustc's memory usage by 18MB][1.5m].
4576 * [Improvements to deref translation increased performance in
4577   unoptimized builds][1.5dr].
4578 * Various errors in trait resolution [are deduplicated to only be
4579   reported once][1.5te].
4580 * Rust has preliminary [support for rumprun kernels][1.5rr].
4581 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4582
4583 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4584 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4585 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4586 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4587 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4588 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4589 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4590 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4591 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4592 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4593 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4594 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4595 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4596 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4597 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4598 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4599 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4600 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4601 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4602 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4603 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4604 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4605 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4606 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4607 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4608 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4609 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4610 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4611 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4612 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4613 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4614 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4615 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4616 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4617 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4618 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4619 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4620 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4621 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4622 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4623 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4624 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4625 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4626 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4627 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4628 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4629 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4630 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4631 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4632 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4633 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4634 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4635 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4636 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4637 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4638 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4639 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4640 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4641 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4642 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4643 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4644 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4645 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4646 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4647 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4648 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4649 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4650 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4651 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4652 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4653 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4654 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4655 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4656 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4657 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4658 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4659 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4660 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4661 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4662 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4663 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4664 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4665 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4666 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4667 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4668 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4669 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4670 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4671 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4672
4673 Version 1.4.0 (2015-10-29)
4674 ==========================
4675
4676 * ~1200 changes, numerous bugfixes
4677
4678 Highlights
4679 ----------
4680
4681 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4682   GNU) are now supported and recommended for use.
4683
4684 Breaking Changes
4685 ----------------
4686
4687 * [Several changes have been made to fix type soundness and improve
4688   the behavior of associated types][sound]. See [RFC 1214]. Although
4689   we have mostly introduced these changes as warnings this release, to
4690   become errors next release, there are still some scenarios that will
4691   see immediate breakage.
4692 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4693   line breaks in addition to `\n`][crlf].
4694 * [Loans of `'static` lifetime extend to the end of a function][stat].
4695 * [`str::parse` no longer introduces avoidable rounding error when
4696   parsing floating point numbers. Together with earlier changes to
4697   float formatting/output, "round trips" like f.to_string().parse()
4698   now preserve the value of f exactly. Additionally, leading plus
4699   signs are now accepted][fp3].
4700
4701
4702 Language
4703 --------
4704
4705 * `use` statements that import multiple items [can now rename
4706   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4707 * [Binops work correctly on fat pointers][binfat].
4708 * `pub extern crate`, which does not behave as expected, [issues a
4709   warning][pec] until a better solution is found.
4710
4711 Libraries
4712 ---------
4713
4714 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4715   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4716   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4717   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4718   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4719   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4720   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4721   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4722   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4723   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4724   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4725   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4726   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4727   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4728   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4729   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4730   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4731   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4732   [`thread::sleep`].
4733 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4734   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4735   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4736   `f64::from_str_radix`.
4737 * [Reverse-searching strings is faster with the 'two-way'
4738   algorithm][s].
4739 * [`std::io::copy` allows `?Sized` arguments][cc].
4740 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4741   [override `count`, `nth` and `last` with an O(1)
4742   implementation][it].
4743 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4744 * [`IntoRawFd` has been added to the Unix-specific prelude,
4745   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4746   prelude][pr].
4747 * [`Extend<String>` and `FromIterator<String` are both implemented for
4748   `String`][es].
4749 * [`IntoIterator` is implemented for references to `Option` and
4750   `Result`][into2].
4751 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4752   Copy`][ext] as part of [RFC 839]. This will cause type inference
4753   breakage in rare situations.
4754 * [`BinaryHeap` implements `Debug`][bh2].
4755 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4756   arrays][bm].
4757 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4758   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4759 * [String comparison is faster][faststr].
4760 * `&mut T` where `T: std::fmt::Write` [also implements
4761   `std::fmt::Write`][mutw].
4762 * [A stable regression in `VecDeque::push_back` and other
4763   capacity-altering methods that caused panics for zero-sized types
4764   was fixed][vd].
4765 * [Function pointers implement traits for up to 12 parameters][fp2].
4766
4767 Miscellaneous
4768 -------------
4769
4770 * The compiler [no longer uses the 'morestack' feature to prevent
4771   stack overflow][mm]. Instead it uses guard pages and stack
4772   probes (though stack probes are not yet implemented on any platform
4773   but Windows).
4774 * [The compiler matches traits faster when projections are involved][p].
4775 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4776   `usize`][ffi].
4777 * [Cargo now displays useful information about what its doing during
4778   `cargo update`][cu].
4779
4780 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4781 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4782 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4783 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4784 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4785 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4786 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4787 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4788 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4789 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4790 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4791 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4792 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4793 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4794 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4795 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4796 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4797 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4798 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4799 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4800 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4801 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4802 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4803 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4804 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4805 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4806 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4807 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4808 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4809 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4810 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4811 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4812 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4813 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4814 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4815 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4816 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4817 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4818 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4819 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4820 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4821 [bh2]: https://github.com/rust-lang/rust/pull/28156
4822 [binfat]: https://github.com/rust-lang/rust/pull/28270
4823 [bm]: https://github.com/rust-lang/rust/pull/28197
4824 [cc]: https://github.com/rust-lang/rust/pull/27531
4825 [crlf]: https://github.com/rust-lang/rust/pull/28034
4826 [cu]: https://github.com/rust-lang/cargo/pull/1931
4827 [d]: https://github.com/rust-lang/rust/pull/27825
4828 [dep]: https://github.com/rust-lang/rust/pull/28339
4829 [es]: https://github.com/rust-lang/rust/pull/27956
4830 [ext]: https://github.com/rust-lang/rust/pull/28094
4831 [faststr]: https://github.com/rust-lang/rust/pull/28338
4832 [ffi]: https://github.com/rust-lang/rust/pull/28779
4833 [fp]: https://github.com/rust-lang/rust/pull/28268
4834 [fp2]: https://github.com/rust-lang/rust/pull/28560
4835 [fp3]: https://github.com/rust-lang/rust/pull/27307
4836 [i]: https://github.com/rust-lang/rust/pull/27451
4837 [into2]: https://github.com/rust-lang/rust/pull/28039
4838 [it]: https://github.com/rust-lang/rust/pull/27652
4839 [mm]: https://github.com/rust-lang/rust/pull/27338
4840 [mutw]: https://github.com/rust-lang/rust/pull/28368
4841 [sound]: https://github.com/rust-lang/rust/pull/27641
4842 [p]: https://github.com/rust-lang/rust/pull/27866
4843 [pec]: https://github.com/rust-lang/rust/pull/28486
4844 [pr]: https://github.com/rust-lang/rust/pull/27896
4845 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4846 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4847 [s]: https://github.com/rust-lang/rust/pull/27474
4848 [stab]: https://github.com/rust-lang/rust/pull/28339
4849 [stat]: https://github.com/rust-lang/rust/pull/28321
4850 [vd]: https://github.com/rust-lang/rust/pull/28494
4851
4852 Version 1.3.0 (2015-09-17)
4853 ==============================
4854
4855 * ~900 changes, numerous bugfixes
4856
4857 Highlights
4858 ----------
4859
4860 * The [new object lifetime defaults][nold] have been [turned
4861   on][nold2] after a cycle of warnings about the change. Now types
4862   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4863   being interpreted as `&'a Box<Trait+'a>` to `&'a
4864   Box<Trait+'static>`.
4865 * [The Rustonomicon][nom] is a new book in the official documentation
4866   that dives into writing unsafe Rust.
4867 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4868   timekeeping is employed by other std APIs, as well as out-of-tree
4869   time crates.
4870
4871 Breaking Changes
4872 ----------------
4873
4874 * The [new object lifetime defaults][nold] have been [turned
4875   on][nold2] after a cycle of warnings about the change.
4876 * There is a known [regression][lr] in how object lifetime elision is
4877   interpreted, the proper solution for which is undetermined.
4878 * The `#[prelude_import]` attribute, an internal implementation
4879   detail, was accidentally stabilized previously. [It has been put
4880   behind the `prelude_import` feature gate][pi]. This change is
4881   believed to break no existing code.
4882 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4883   [more sane for dynamically sized types][dst3]. Code that relied on
4884   the previous behavior is thought to be broken.
4885 * The `dropck` rules, which checks that destructors can't access
4886   destroyed values, [have been updated][dropck] to match the
4887   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4888   cause some previously-compiling code to no longer build.
4889
4890 Language
4891 --------
4892
4893 * The [new object lifetime defaults][nold] have been [turned
4894   on][nold2] after a cycle of warnings about the change.
4895 * Semicolons may [now follow types and paths in
4896   macros](https://github.com/rust-lang/rust/pull/27000).
4897 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4898   [more sane for dynamically sized types][dst3]. Code that relied on
4899   the previous behavior is not known to exist, and suspected to be
4900   broken.
4901 * `'static` variables [may now be recursive][st].
4902 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4903   implementations correctly.
4904 * The `dropck` rules, which checks that destructors can't access
4905   destroyed values, [have been updated][dropck] to match the
4906   [RFC][dropckrfc].
4907
4908 Libraries
4909 ---------
4910
4911 * The [`Duration`] API, [has been stabilized][ds], as well as the
4912   `std::time` module, which presently contains only `Duration`.
4913 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4914 * The owned C string, [`CString`], implements [`Borrow`] and the
4915   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4916   these allow C strings to be borrowed and cloned in generic code.
4917 * [`CStr`] implements [`Debug`].
4918 * [`AtomicPtr`] implements [`Debug`].
4919 * [`Error`] trait objects [can be downcast to their concrete types][e]
4920   in many common configurations, using the [`is`], [`downcast`],
4921   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4922   [`Any`] trait.
4923 * Searching for substrings now [employs the two-way algorithm][search]
4924   instead of doing a naive search. This gives major speedups to a
4925   number of methods, including [`contains`][sc], [`find`][sf],
4926   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4927   [`ends_with`][sew] are also faster.
4928 * The performance of `PartialEq` for slices is [much faster][ps].
4929 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4930   is overridden and optimized by the implementations for scalars.
4931 * The [`Hasher`] trait now has a number of specialized `write_*`
4932   methods for primitive types, for efficiency.
4933 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4934   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4935   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4936   of [`std::error::Error::cause`][iec] also delegates to the inner
4937   error.
4938 * [`process::Child`][pc] gained the [`id`] method, which returns a
4939   `u32` representing the platform-specific process identifier.
4940 * The [`connect`] method on slices is deprecated, replaced by the new
4941   [`join`] method (note that both of these are on the *unstable*
4942   [`SliceConcatExt`] trait, but through the magic of the prelude are
4943   available to stable code anyway).
4944 * The [`Div`] operator is implemented for [`Wrapping`] types.
4945 * [`DerefMut` is implemented for `String`][dms].
4946 * Performance of SipHash (the default hasher for `HashMap`) is
4947   [better for long data][sh].
4948 * [`AtomicPtr`] implements [`Send`].
4949 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4950   are now [specialized to use uninitialized buffers for increased
4951   performance][rte].
4952 * Lifetime parameters of foreign functions [are now resolved
4953   properly][f].
4954
4955 Misc
4956 ----
4957
4958 * Rust can now, with some coercion, [produce programs that run on
4959   Windows XP][xp], though XP is not considered a supported platform.
4960 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4961   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4962   recommended for use in 1.3, though should be fully-functional
4963   in the [64-bit 1.4 beta][b14].
4964 * On Fedora-based systems installation will [properly configure the
4965   dynamic linker][fl].
4966 * The compiler gained many new extended error descriptions, which can
4967   be accessed with the `--explain` flag.
4968 * The `dropck` pass, which checks that destructors can't access
4969   destroyed values, [has been rewritten][dropck]. This fixes some
4970   soundness holes, and as such will cause some previously-compiling
4971   code to no longer build.
4972 * `rustc` now uses [LLVM to write archive files where possible][ar].
4973   Eventually this will eliminate the compiler's dependency on the ar
4974   utility.
4975 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4976   supported FreeBSD on x86_64).
4977 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4978   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4979   more strict.
4980 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4981   will kill the process instead of leaking][nlp].
4982
4983 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4984 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4985 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4986 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4987 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
4988 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4989 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4990 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
4991 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
4992 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
4993 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
4994 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
4995 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
4996 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4997 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
4998 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
4999 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5000 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5001 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5002 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5003 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5004 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5005 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5006 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5007 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5008 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5009 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5010 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5011 [ar]: https://github.com/rust-lang/rust/pull/26926
5012 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5013 [dms]: https://github.com/rust-lang/rust/pull/26241
5014 [dropck]: https://github.com/rust-lang/rust/pull/27261
5015 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5016 [ds]: https://github.com/rust-lang/rust/pull/26818
5017 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5018 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5019 [dst3]: https://github.com/rust-lang/rust/pull/27351
5020 [e]: https://github.com/rust-lang/rust/pull/24793
5021 [f]: https://github.com/rust-lang/rust/pull/26588
5022 [fb]: https://github.com/rust-lang/rust/pull/26959
5023 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5024 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5025 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5026 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5027 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5028 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5029 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5030 [lic]: https://github.com/rust-lang/rust/pull/26583
5031 [lnu]: https://github.com/rust-lang/rust/pull/27026
5032 [lr]: https://github.com/rust-lang/rust/issues/27248
5033 [lum]: https://github.com/rust-lang/rust/pull/26378
5034 [lur]: https://github.com/rust-lang/rust/pull/26783
5035 [nlp]: https://github.com/rust-lang/rust/pull/27176
5036 [nold2]: https://github.com/rust-lang/rust/pull/27045
5037 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5038 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5039 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5040 [pi]: https://github.com/rust-lang/rust/pull/26699
5041 [ps]: https://github.com/rust-lang/rust/pull/26884
5042 [rte]: https://github.com/rust-lang/rust/pull/26950
5043 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5044 [search]: https://github.com/rust-lang/rust/pull/26327
5045 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5046 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5047 [sh]: https://github.com/rust-lang/rust/pull/27280
5048 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5049 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5050 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5051 [st]: https://github.com/rust-lang/rust/pull/26630
5052 [win1]: https://github.com/rust-lang/rust/pull/26569
5053 [win2]: https://github.com/rust-lang/rust/pull/26741
5054 [win3]: https://github.com/rust-lang/rust/pull/26741
5055 [win4]: https://github.com/rust-lang/rust/pull/27210
5056 [xp]: https://github.com/rust-lang/rust/pull/26569
5057
5058 Version 1.2.0 (2015-08-07)
5059 ==========================
5060
5061 * ~1200 changes, numerous bugfixes
5062
5063 Highlights
5064 ----------
5065
5066 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5067   like `Rc` to contain types without a fixed size, arrays and trait
5068   objects, finally enabling use of `Rc<[T]>` and completing the
5069   implementation of DST.
5070 * [Parallel codegen][parcodegen] is now working again, which can
5071   substantially speed up large builds in debug mode; It also gets
5072   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5073   jobs). It's not enabled by default, but will be "in the near
5074   future". It can be activated with the `-C codegen-units=N` flag to
5075   `rustc`.
5076 * This is the first release with [experimental support for linking
5077   with the MSVC linker and lib C on Windows (instead of using the GNU
5078   variants via MinGW)][win]. It is yet recommended only for the most
5079   intrepid Rustaceans.
5080 * Benchmark compilations are showing a 30% improvement in
5081   bootstrapping over 1.1.
5082
5083 Breaking Changes
5084 ----------------
5085
5086 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5087   unicode case mapping, which is a previously-planned change in
5088   behavior and considered a bugfix.
5089 * [`mem::align_of`] now specifies [the *minimum alignment* for
5090   T][align], which is usually the alignment programs are interested
5091   in, and the same value reported by clang's
5092   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5093   break real code.
5094 * [The `#[packed]` attribute is no longer silently accepted by the
5095   compiler][packed]. This attribute did nothing and code that
5096   mentioned it likely did not work as intended.
5097 * Associated type defaults are [now behind the
5098   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5099   defaults *did not work*, but could be mentioned syntactically. As
5100   such this breakage has minimal impact.
5101
5102 Language
5103 --------
5104
5105 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5106   matching against dereferenceable values.
5107
5108 Libraries
5109 ---------
5110
5111 * The [`Extend`] trait, which grows a collection from an iterator, is
5112   implemented over iterators of references, for `String`, `Vec`,
5113   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5114   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5115 * The [`iter::once`] function returns an iterator that yields a single
5116   element, and [`iter::empty`] returns an iterator that yields no
5117   elements.
5118 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5119   over substring matches.
5120 * [`Cell`] and [`RefCell`] both implement `Eq`.
5121 * A number of methods for wrapping arithmetic are added to the
5122   integral types, [`wrapping_div`], [`wrapping_rem`],
5123   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5124   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5125   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5126   type.. It is illegal for the default arithmetic operations in Rust
5127   to overflow; the desire to wrap must be explicit.
5128 * The `{:#?}` formatting specifier [displays the alternate,
5129   pretty-printed][debugfmt] form of the `Debug` formatter. This
5130   feature was actually introduced prior to 1.0 with little
5131   fanfare.
5132 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5133   for writing data to formatted strings, similar to [`io::Write`].
5134 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5135   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5136   are used by code generators to emit implementations of [`Debug`].
5137 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5138   methods that convert case, following Unicode case mapping.
5139 * It is now easier to handle poisoned locks. The [`PoisonError`]
5140   type, returned by failing lock operations, exposes `into_inner`,
5141   `get_ref`, and `get_mut`, which all give access to the inner lock
5142   guard, and allow the poisoned lock to continue to operate. The
5143   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5144   poisoned lock without attempting to take the lock.
5145 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5146   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5147   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5148   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5149   `ChildStderr`.
5150 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5151   malformed input.
5152
5153 Misc
5154 ----
5155
5156 * `rustc` employs smarter heuristics for guessing at [typos].
5157 * `rustc` emits more efficient code for [no-op conversions between
5158   unsafe pointers][nop].
5159 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5160   resulting in faster compile times and smaller code.
5161
5162 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5163 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5164 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5165 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5166 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5167 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5168 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5169 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5170 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5171 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5172 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5173 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5174 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5175 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5176 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5177 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5178 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5179 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5180 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5181 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5182 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5183 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5184 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5185 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5186 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5187 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5188 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5189 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5190 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5191 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5192 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5193 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5194 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5195 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5196 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5197 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5198 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5199 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5200 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5201 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5202 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5203 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5204 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5205 [align]: https://github.com/rust-lang/rust/pull/25646
5206 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5207 [typos]: https://github.com/rust-lang/rust/pull/26087
5208 [nop]: https://github.com/rust-lang/rust/pull/26336
5209 [fat]: https://github.com/rust-lang/rust/pull/26411
5210 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5211 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5212 [packed]: https://github.com/rust-lang/rust/pull/25541
5213 [ad]: https://github.com/rust-lang/rust/pull/27382
5214 [win]: https://github.com/rust-lang/rust/pull/25350
5215
5216 Version 1.1.0 (2015-06-25)
5217 =========================
5218
5219 * ~850 changes, numerous bugfixes
5220
5221 Highlights
5222 ----------
5223
5224 * The [`std::fs` module has been expanded][fs] to expand the set of
5225   functionality exposed:
5226   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5227     don't incur a syscall on some platforms.
5228   * A `symlink_metadata` function has been added.
5229   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5230     access to all underlying information.
5231 * The compiler now contains extended explanations of many errors. When an error
5232   with an explanation occurs the compiler suggests using the `--explain` flag
5233   to read the explanation. Error explanations are also [available online][err-index].
5234 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5235   well as other work, the time to bootstrap the compiler decreased by
5236   32%.
5237
5238 Libraries
5239 ---------
5240
5241 * The [`str::split_whitespace`] method splits a string on unicode
5242   whitespace boundaries.
5243 * On both Windows and Unix, new extension traits provide conversion of
5244   I/O types to and from the underlying system handles. On Unix, these
5245   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5246   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5247   `TcpListener`, and `UpdSocket`. Further implementations for
5248   `std::process` will be stabilized later.
5249 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5250   Windows, symlinks can be created with
5251   `std::os::windows::symlink_dir` and
5252   `std::os::windows::symlink_file`.
5253 * The `mpsc::Receiver` type can now be converted into an iterator with
5254   `into_iter` on the [`IntoIterator`] trait.
5255 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5256   implementation of the [`From`] trait.
5257 * The `Debug` implementation for `RangeFull` [creates output that is
5258   more consistent with other implementations][rf].
5259 * [`Debug` is implemented for `File`][file].
5260 * The `Default` implementation for `Arc` [no longer requires `Sync +
5261   Send`][arc].
5262 * [The `Iterator` methods `count`, `nth`, and `last` have been
5263   overridden for slices to have O(1) performance instead of O(n)][si].
5264 * Incorrect handling of paths on Windows has been improved in both the
5265   compiler and the standard library.
5266 * [`AtomicPtr` gained a `Default` implementation][ap].
5267 * In accordance with Rust's policy on arithmetic overflow `abs` now
5268   [panics on overflow when debug assertions are enabled][abs].
5269 * The [`Cloned`] iterator, which was accidentally left unstable for
5270   1.0 [has been stabilized][c].
5271 * The [`Incoming`] iterator, which iterates over incoming TCP
5272   connections, and which was accidentally unnamable in 1.0, [is now
5273   properly exported][inc].
5274 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5275   `sift_up` or `sift_down` panic][bh].
5276 * The [`split_off`] method of `LinkedList` [no longer corrupts
5277   the list in certain scenarios][ll].
5278
5279 Misc
5280 ----
5281
5282 * Type checking performance [has improved notably][sk] with
5283   [multiple improvements][pre].
5284 * The compiler [suggests code changes][ch] for more errors.
5285 * rustc and it's build system have experimental support for [building
5286   toolchains against MUSL][m] instead of glibc on Linux.
5287 * The compiler defines the `target_env` cfg value, which is used for
5288   distinguishing toolchains that are otherwise for the same
5289   platform. Presently this is set to `gnu` for common GNU Linux
5290   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5291 * The [`cargo rustc`][crc] command invokes a build with custom flags
5292   to rustc.
5293 * [Android executables are always position independent][pie].
5294 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5295   with `Drop`][drop].
5296
5297 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5298 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5299 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5300 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5301 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5302 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5303 [rf]: https://github.com/rust-lang/rust/pull/24491
5304 [err-index]: https://doc.rust-lang.org/error-index.html
5305 [sk]: https://github.com/rust-lang/rust/pull/24615
5306 [pre]: https://github.com/rust-lang/rust/pull/25323
5307 [file]: https://github.com/rust-lang/rust/pull/24598
5308 [ch]: https://github.com/rust-lang/rust/pull/24683
5309 [arc]: https://github.com/rust-lang/rust/pull/24695
5310 [si]: https://github.com/rust-lang/rust/pull/24701
5311 [ap]: https://github.com/rust-lang/rust/pull/24834
5312 [m]: https://github.com/rust-lang/rust/pull/24777
5313 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5314 [crc]: https://github.com/rust-lang/cargo/pull/1568
5315 [pie]: https://github.com/rust-lang/rust/pull/24953
5316 [abs]: https://github.com/rust-lang/rust/pull/25441
5317 [c]: https://github.com/rust-lang/rust/pull/25496
5318 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5319 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5320 [inc]: https://github.com/rust-lang/rust/pull/25522
5321 [bh]: https://github.com/rust-lang/rust/pull/25856
5322 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5323 [ll]: https://github.com/rust-lang/rust/pull/26022
5324 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5325 [drop]: https://github.com/rust-lang/rust/pull/24935
5326
5327 Version 1.0.0 (2015-05-15)
5328 ========================
5329
5330 * ~1500 changes, numerous bugfixes
5331
5332 Highlights
5333 ----------
5334
5335 * The vast majority of the standard library is now `#[stable]`. It is
5336   no longer possible to use unstable features with a stable build of
5337   the compiler.
5338 * Many popular crates on [crates.io] now work on the stable release
5339   channel.
5340 * Arithmetic on basic integer types now [checks for overflow in debug
5341   builds][overflow].
5342
5343 Language
5344 --------
5345
5346 * Several [restrictions have been added to trait coherence][coh] in
5347   order to make it easier for upstream authors to change traits
5348   without breaking downstream code.
5349 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5350   improve error messages and macro behavior. For example, `0b1234` is
5351   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5352 * Trait bounds [are always invariant][inv], eliminating the need for
5353   the `PhantomFn` and `MarkerTrait` lang items, which have been
5354   removed.
5355 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5356   "foo" as bar` syntax has been replaced with `extern crate foo as
5357   bar`, and Cargo now automatically translates "-" in *package* names
5358   to underscore for the crate name.
5359 * [Lifetime shadowing is an error][lt].
5360 * [`Send` no longer implies `'static`][send-rfc].
5361 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5362   `MyType::default()`.
5363 * Primitive types [now have inherent methods][prim-inherent],
5364   obviating the need for extension traits like `SliceExt`.
5365 * Methods with `Self: Sized` in their `where` clause are [considered
5366   object-safe][self-sized], allowing many extension traits like
5367   `IteratorExt` to be merged into the traits they extended.
5368 * You can now [refer to associated types][assoc-where] whose
5369   corresponding trait bounds appear only in a `where` clause.
5370 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5371   like `Send` and `Sync` are now library-defined.
5372 * A [Reflect trait][reflect] was introduced, which means that
5373   downcasting via the `Any` trait is effectively limited to concrete
5374   types. This helps retain the potentially-important "parametricity"
5375   property: generic code cannot behave differently for different type
5376   arguments except in minor ways.
5377 * The `unsafe_destructor` feature is now deprecated in favor of the
5378   [new `dropck`][dropck]. This change is a major reduction in unsafe
5379   code.
5380
5381 Libraries
5382 ---------
5383
5384 * The `thread_local` module [has been renamed to `std::thread`][th].
5385 * The methods of `IteratorExt` [have been moved to the `Iterator`
5386   trait itself][ie].
5387 * Several traits that implement Rust's conventions for type
5388   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5389   [centralized in the `std::convert` module][con].
5390 * The `FromError` trait [was removed in favor of `From`][fe].
5391 * The basic sleep function [has moved to
5392   `std::thread::sleep_ms`][slp].
5393 * The `splitn` function now takes an `n` parameter that represents the
5394   number of items yielded by the returned iterator [instead of the
5395   number of 'splits'][spl].
5396 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5397 * [Derived implementations of `PartialOrd` now order enums according
5398   to their explicitly-assigned discriminants][po].
5399 * [Methods for searching strings are generic over `Pattern`s][pat],
5400   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5401   some others.
5402 * [In method resolution, object methods are resolved before inherent
5403   methods][meth].
5404 * [`String::from_str` has been deprecated in favor of the `From` impl,
5405   `String::from`][sf].
5406 * [`io::Error` implements `Sync`][ios].
5407 * [The `words` method on `&str` has been replaced with
5408   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5409   a word?'
5410 * The new path and IO modules are complete and `#[stable]`. This
5411   was the major library focus for this cycle.
5412 * The path API was [revised][path-normalize] to normalize `.`,
5413   adjusting the tradeoffs in favor of the most common usage.
5414 * A large number of remaining APIs in `std` were also stabilized
5415   during this cycle; about 75% of the non-deprecated API surface
5416   is now stable.
5417 * The new [string pattern API][string-pattern] landed, which makes
5418   the string slice API much more internally consistent and flexible.
5419 * A new set of [generic conversion traits][conversion] replaced
5420   many existing ad hoc traits.
5421 * Generic numeric traits were [completely removed][num-traits]. This
5422   was made possible thanks to inherent methods for primitive types,
5423   and the removal gives maximal flexibility for designing a numeric
5424   hierarchy in the future.
5425 * The `Fn` traits are now related via [inheritance][fn-inherit]
5426   and provide ergonomic [blanket implementations][fn-blanket].
5427 * The `Index` and `IndexMut` traits were changed to
5428   [take the index by value][index-value], enabling code like
5429   `hash_map["string"]` to work.
5430 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5431   `Copy` data is known to be `Clone` as well.
5432
5433 Misc
5434 ----
5435
5436 * Many errors now have extended explanations that can be accessed with
5437   the `--explain` flag to `rustc`.
5438 * Many new examples have been added to the standard library
5439   documentation.
5440 * rustdoc has received a number of improvements focused on completion
5441   and polish.
5442 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5443 * Much headway was made on ecosystem-wide CI, making it possible
5444   to [compare builds for breakage][ci-compare].
5445
5446
5447 [crates.io]: http://crates.io
5448 [clo]: https://github.com/rust-lang/rust/pull/24034
5449 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5450 [con]: https://github.com/rust-lang/rust/pull/23875
5451 [cr]: https://github.com/rust-lang/rust/pull/23419
5452 [fe]: https://github.com/rust-lang/rust/pull/23879
5453 [ie]: https://github.com/rust-lang/rust/pull/23300
5454 [inv]: https://github.com/rust-lang/rust/pull/23938
5455 [ios]: https://github.com/rust-lang/rust/pull/24133
5456 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5457 [lt]: https://github.com/rust-lang/rust/pull/24057
5458 [meth]: https://github.com/rust-lang/rust/pull/24056
5459 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5460 [po]: https://github.com/rust-lang/rust/pull/24270
5461 [sf]: https://github.com/rust-lang/rust/pull/24517
5462 [slp]: https://github.com/rust-lang/rust/pull/23949
5463 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5464 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5465 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5466 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5467 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5468 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5469 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5470 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5471 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5472 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5473 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5474 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5475 [reflect]: https://github.com/rust-lang/rust/pull/23712
5476 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5477 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5478 [index-value]: https://github.com/rust-lang/rust/pull/23601
5479 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5480 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5481 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5482 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5483 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5484 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5485
5486
5487 Version 1.0.0-alpha.2 (2015-02-20)
5488 =====================================
5489
5490 * ~1300 changes, numerous bugfixes
5491
5492 * Highlights
5493
5494     * The various I/O modules were [overhauled][io-rfc] to reduce
5495       unnecessary abstractions and provide better interoperation with
5496       the underlying platform. The old `io` module remains temporarily
5497       at `std::old_io`.
5498     * The standard library now [participates in feature gating][feat],
5499       so use of unstable libraries now requires a `#![feature(...)]`
5500       attribute. The impact of this change is [described on the
5501       forum][feat-forum]. [RFC][feat-rfc].
5502
5503 * Language
5504
5505     * `for` loops [now operate on the `IntoIterator` trait][into],
5506       which eliminates the need to call `.iter()`, etc. to iterate
5507       over collections. There are some new subtleties to remember
5508       though regarding what sort of iterators various types yield, in
5509       particular that `for foo in bar { }` yields values from a move
5510       iterator, destroying the original collection. [RFC][into-rfc].
5511     * Objects now have [default lifetime bounds][obj], so you don't
5512       have to write `Box<Trait+'static>` when you don't care about
5513       storing references. [RFC][obj-rfc].
5514     * In types that implement `Drop`, [lifetimes must outlive the
5515       value][drop]. This will soon make it possible to safely
5516       implement `Drop` for types where `#[unsafe_destructor]` is now
5517       required. Read the [gorgeous RFC][drop-rfc] for details.
5518     * The fully qualified <T as Trait>::X syntax lets you set the Self
5519       type for a trait method or associated type. [RFC][ufcs-rfc].
5520     * References to types that implement `Deref<U>` now [automatically
5521       coerce to references][deref] to the dereferenced type `U`,
5522       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5523       should eliminate many unsightly uses of `&*`, as when converting
5524       from references to vectors into references to
5525       slices. [RFC][deref-rfc].
5526     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5527       `|:|`) is obsolete and closure kind is inferred from context.
5528     * [`Self` is a keyword][Self].
5529
5530 * Libraries
5531
5532     * The `Show` and `String` formatting traits [have been
5533       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5534       their related purposes. Automatically getting a string
5535       conversion to use with `format!("{:?}", something_to_debug)` is
5536       now written `#[derive(Debug)]`.
5537     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5538       OsStr}`, provide strings in platform-specific encodings for easier
5539       interop with system APIs. [RFC][osstr-rfc].
5540     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5541       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5542       creating raw pointers.
5543
5544 * Tooling
5545
5546     * Certain long error messages of the form 'expected foo found bar'
5547       are now [split neatly across multiple
5548       lines][multiline]. Examples in the PR.
5549     * On Unix Rust can be [uninstalled][un] by running
5550       `/usr/local/lib/rustlib/uninstall.sh`.
5551     * The `#[rustc_on_unimplemented]` attribute, requiring the
5552       'on_unimplemented' feature, lets rustc [display custom error
5553       messages when a trait is expected to be implemented for a type
5554       but is not][onun].
5555
5556 * Misc
5557
5558     * Rust is tested against a [LALR grammar][lalr], which parses
5559       almost all the Rust files that rustc does.
5560
5561 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5562 [close]: https://github.com/rust-lang/rust/pull/21843
5563 [deref]: https://github.com/rust-lang/rust/pull/21351
5564 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5565 [drop]: https://github.com/rust-lang/rust/pull/21972
5566 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5567 [feat]: https://github.com/rust-lang/rust/pull/21248
5568 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5569 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5570 [fmt]: https://github.com/rust-lang/rust/pull/21457
5571 [into]: https://github.com/rust-lang/rust/pull/20790
5572 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5573 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5574 [lalr]: https://github.com/rust-lang/rust/pull/21452
5575 [multiline]: https://github.com/rust-lang/rust/pull/19870
5576 [obj]: https://github.com/rust-lang/rust/pull/22230
5577 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5578 [onun]: https://github.com/rust-lang/rust/pull/20889
5579 [osstr]: https://github.com/rust-lang/rust/pull/21488
5580 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5581 [Self]: https://github.com/rust-lang/rust/pull/22158
5582 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5583 [un]: https://github.com/rust-lang/rust/pull/22256
5584
5585
5586 Version 1.0.0-alpha (2015-01-09)
5587 ==================================
5588
5589   * ~2400 changes, numerous bugfixes
5590
5591   * Highlights
5592
5593     * The language itself is considered feature complete for 1.0,
5594       though there will be many usability improvements and bugfixes
5595       before the final release.
5596     * Nearly 50% of the public API surface of the standard library has
5597       been declared 'stable'. Those interfaces are unlikely to change
5598       before 1.0.
5599     * The long-running debate over integer types has been
5600       [settled][ints]: Rust will ship with types named `isize` and
5601       `usize`, rather than `int` and `uint`, for pointer-sized
5602       integers. Guidelines will be rolled out during the alpha cycle.
5603     * Most crates that are not `std` have been moved out of the Rust
5604       distribution into the Cargo ecosystem so they can evolve
5605       separately and don't need to be stabilized as quickly, including
5606       'time', 'getopts', 'num', 'regex', and 'term'.
5607     * Documentation continues to be expanded with more API coverage, more
5608       examples, and more in-depth explanations. The guides have been
5609       consolidated into [The Rust Programming Language][trpl].
5610     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5611     * All official Rust binary installers now come with [Cargo], the
5612       Rust package manager.
5613
5614 * Language
5615
5616     * Closures have been [completely redesigned][unboxed] to be
5617       implemented in terms of traits, can now be used as generic type
5618       bounds and thus monomorphized and inlined, or via an opaque
5619       pointer (boxed) as in the old system. The new system is often
5620       referred to as 'unboxed' closures.
5621     * Traits now support [associated types][assoc], allowing families
5622       of related types to be defined together and used generically in
5623       powerful ways.
5624     * Enum variants are [namespaced by their type names][enum].
5625     * [`where` clauses][where] provide a more versatile and attractive
5626       syntax for specifying generic bounds, though the previous syntax
5627       remains valid.
5628     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5629       numeric types.
5630     * Rust [no longer has a runtime][rt] of any description, and only
5631       supports OS threads, not green threads.
5632     * At long last, Rust has been overhauled for 'dynamically-sized
5633       types' ([DST]), which integrates 'fat pointers' (object types,
5634       arrays, and `str`) more deeply into the type system, making it
5635       more consistent.
5636     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5637       `..j` that produce range types and which, when combined with the
5638       `Index` operator and multidispatch, leads to a convenient slice
5639       notation, `[i..j]`.
5640     * The new range syntax revealed an ambiguity in the fixed-length
5641       array syntax, so now fixed length arrays [are written `[T;
5642       N]`][arrays].
5643     * The `Copy` trait is no longer implemented automatically. Unsafe
5644       pointers no longer implement `Sync` and `Send` so types
5645       containing them don't automatically either. `Sync` and `Send`
5646       are now 'unsafe traits' so one can "forcibly" implement them via
5647       `unsafe impl` if a type confirms to the requirements for them
5648       even though the internals do not (e.g. structs containing unsafe
5649       pointers like `Arc`). These changes are intended to prevent some
5650       footguns and are collectively known as [opt-in built-in
5651       traits][oibit] (though `Sync` and `Send` will soon become pure
5652       library types unknown to the compiler).
5653     * Operator traits now take their operands [by value][ops], and
5654       comparison traits can use multidispatch to compare one type
5655       against multiple other types, allowing e.g. `String` to be
5656       compared with `&str`.
5657     * `if let` and `while let` are no longer feature-gated.
5658     * Rust has adopted a more [uniform syntax for escaping unicode
5659       characters][unicode].
5660     * `macro_rules!` [has been declared stable][mac]. Though it is a
5661       flawed system it is sufficiently popular that it must be usable
5662       for 1.0. Effort has gone into [future-proofing][mac-future] it
5663       in ways that will allow other macro systems to be developed in
5664       parallel, and won't otherwise impact the evolution of the
5665       language.
5666     * The prelude has been [pared back significantly][prelude] such
5667       that it is the minimum necessary to support the most pervasive
5668       code patterns, and through [generalized where clauses][where]
5669       many of the prelude extension traits have been consolidated.
5670     * Rust's rudimentary reflection [has been removed][refl], as it
5671       incurred too much code generation for little benefit.
5672     * [Struct variants][structvars] are no longer feature-gated.
5673     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5674       known as 'higher-ranked trait bounds', this crucially allows
5675       unboxed closures to work.
5676     * Macros invocations surrounded by parens or square brackets and
5677       not terminated by a semicolon are [parsed as
5678       expressions][macros], which makes expressions like `vec![1i32,
5679       2, 3].len()` work as expected.
5680     * Trait objects now implement their traits automatically, and
5681       traits that can be coerced to objects now must be [object
5682       safe][objsafe].
5683     * Automatically deriving traits is now done with `#[derive(...)]`
5684       not `#[deriving(...)]` for [consistency with other naming
5685       conventions][derive].
5686     * Importing the containing module or enum at the same time as
5687       items or variants they contain is [now done with `self` instead
5688       of `mod`][self], as in use `foo::{self, bar}`
5689     * Glob imports are no longer feature-gated.
5690     * The `box` operator and `box` patterns have been feature-gated
5691       pending a redesign. For now unique boxes should be allocated
5692       like other containers, with `Box::new`.
5693
5694 * Libraries
5695
5696     * A [series][coll1] of [efforts][coll2] to establish
5697       [conventions][coll3] for collections types has resulted in API
5698       improvements throughout the standard library.
5699     * New [APIs for error handling][err] provide ergonomic interop
5700       between error types, and [new conventions][err-conv] describe
5701       more clearly the recommended error handling strategies in Rust.
5702     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5703       it is easier to discuss failure in the context of error handling
5704       without making clarifications as to whether you are referring to
5705       the 'fail' macro or failure more generally.
5706     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5707       syscall when available.
5708     * The 'serialize' crate has been renamed 'rustc-serialize' and
5709       moved out of the distribution to Cargo. Although it is widely
5710       used now, it is expected to be superseded in the near future.
5711     * The `Show` formatter, typically implemented with
5712       `#[derive(Show)]` is [now requested with the `{:?}`
5713       specifier][show] and is intended for use by all types, for uses
5714       such as `println!` debugging. The new `String` formatter must be
5715       implemented by hand, uses the `{}` specifier, and is intended
5716       for full-fidelity conversions of things that can logically be
5717       represented as strings.
5718
5719 * Tooling
5720
5721     * [Flexible target specification][flex] allows rustc's code
5722       generation to be configured to support otherwise-unsupported
5723       platforms.
5724     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5725       respective debuggers with Rust-appropriate pretty-printing.
5726     * The Windows installation of Rust is distributed with the
5727       MinGW components currently required to link binaries on that
5728       platform.
5729
5730 * Misc
5731
5732     * Nullable enum optimizations have been extended to more types so
5733       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5734       space than the inner types themselves.
5735     * Work has begun on supporting AArch64.
5736
5737 [Cargo]: https://crates.io
5738 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5739 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5740 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5741 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5742 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5743 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5744 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5745 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5746 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5747 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5748 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5749 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5750 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5751 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5752 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5753 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5754 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5755 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5756 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5757 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5758 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5759 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5760 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5761 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5762 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5763 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5764 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5765 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5766 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5767 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5768 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5769 [trpl]: https://doc.rust-lang.org/book/index.html
5770 [rbe]: http://rustbyexample.com/
5771
5772
5773 Version 0.12.0 (2014-10-09)
5774 =============================
5775
5776   * ~1900 changes, numerous bugfixes
5777
5778   * Highlights
5779
5780     * The introductory documentation (now called The Rust Guide) has
5781       been completely rewritten, as have a number of supplementary
5782       guides.
5783     * Rust's package manager, Cargo, continues to improve and is
5784       sometimes considered to be quite awesome.
5785     * Many API's in `std` have been reviewed and updated for
5786       consistency with the in-development Rust coding
5787       guidelines. The standard library documentation tracks
5788       stabilization progress.
5789     * Minor libraries have been moved out-of-tree to the rust-lang org
5790       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5791       be installed with Cargo.
5792     * Lifetime elision allows lifetime annotations to be left off of
5793       function declarations in many common scenarios.
5794     * Rust now works on 64-bit Windows.
5795
5796   * Language
5797     * Indexing can be overloaded with the `Index` and `IndexMut`
5798       traits.
5799     * The `if let` construct takes a branch only if the `let` pattern
5800       matches, currently behind the 'if_let' feature gate.
5801     * 'where clauses', a more flexible syntax for specifying trait
5802       bounds that is more aesthetic, have been added for traits and
5803       free functions. Where clauses will in the future make it
5804       possible to constrain associated types, which would be
5805       impossible with the existing syntax.
5806     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5807       the 'slicing_syntax' feature gate, and can be overloaded with
5808       the `Slice` or `SliceMut` traits.
5809     * The syntax for matching of sub-slices has been changed to use a
5810       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5811       consistency with other uses of `..` and to future-proof
5812       potential additional uses of the syntax.
5813     * The syntax for matching inclusive ranges in patterns has changed
5814       from `0..3` to `0...4` to be consistent with the exclusive range
5815       syntax for slicing.
5816     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5817       c]`) has been put behind the 'advanced_slice_patterns' feature
5818       gate and may be removed in the future.
5819     * Components of tuples and tuple structs can be extracted using
5820       the `value.0` syntax, currently behind the `tuple_indexing`
5821       feature gate.
5822     * The `#[crate_id]` attribute is no longer supported; versioning
5823       is handled by the package manager.
5824     * Renaming crate imports are now written `extern crate foo as bar`
5825       instead of `extern crate bar = foo`.
5826     * Renaming use statements are now written `use foo as bar` instead
5827       of `use bar = foo`.
5828     * `let` and `match` bindings and argument names in macros are now
5829       hygienic.
5830     * The new, more efficient, closure types ('unboxed closures') have
5831       been added under a feature gate, 'unboxed_closures'. These will
5832       soon replace the existing closure types, once higher-ranked
5833       trait lifetimes are added to the language.
5834     * `move` has been added as a keyword, for indicating closures
5835       that capture by value.
5836     * Mutation and assignment is no longer allowed in pattern guards.
5837     * Generic structs and enums can now have trait bounds.
5838     * The `Share` trait is now called `Sync` to free up the term
5839       'shared' to refer to 'shared reference' (the default reference
5840       type.
5841     * Dynamically-sized types have been mostly implemented,
5842       unifying the behavior of fat-pointer types with the rest of the
5843       type system.
5844     * As part of dynamically-sized types, the `Sized` trait has been
5845       introduced, which qualifying types implement by default, and
5846       which type parameters expect by default. To specify that a type
5847       parameter does not need to be sized, write `<Sized? T>`. Most
5848       types are `Sized`, notable exceptions being unsized arrays
5849       (`[T]`) and trait types.
5850     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5851     * Lifetime bounds can now be applied to type parameters and object
5852       types.
5853     * The old, reference counted GC type, `Gc<T>` which was once
5854       denoted by the `@` sigil, has finally been removed. GC will be
5855       revisited in the future.
5856
5857   * Libraries
5858     * Library documentation has been improved for a number of modules.
5859     * Bit-vectors, collections::bitv has been modernized.
5860     * The url crate is deprecated in favor of
5861       http://github.com/servo/rust-url, which can be installed with
5862       Cargo.
5863     * Most I/O stream types can be cloned and subsequently closed from
5864       a different thread.
5865     * A `std::time::Duration` type has been added for use in I/O
5866       methods that rely on timers, as well as in the 'time' crate's
5867       `Timespec` arithmetic.
5868     * The runtime I/O abstraction layer that enabled the green thread
5869       scheduler to do non-thread-blocking I/O has been removed, along
5870       with the libuv-based implementation employed by the green thread
5871       scheduler. This will greatly simplify the future I/O work.
5872     * `collections::btree` has been rewritten to have a more
5873       idiomatic and efficient design.
5874
5875   * Tooling
5876     * rustdoc output now indicates the stability levels of API's.
5877     * The `--crate-name` flag can specify the name of the crate
5878       being compiled, like `#[crate_name]`.
5879     * The `-C metadata` specifies additional metadata to hash into
5880       symbol names, and `-C extra-filename` specifies additional
5881       information to put into the output filename, for use by the
5882       package manager for versioning.
5883     * debug info generation has continued to improve and should be
5884       more reliable under both gdb and lldb.
5885     * rustc has experimental support for compiling in parallel
5886       using the `-C codegen-units` flag.
5887     * rustc no longer encodes rpath information into binaries by
5888       default.
5889
5890   * Misc
5891     * Stack usage has been optimized with LLVM lifetime annotations.
5892     * Official Rust binaries on Linux are more compatible with older
5893       kernels and distributions, built on CentOS 5.10.
5894
5895
5896 Version 0.11.0 (2014-07-02)
5897 ==========================
5898
5899   * ~1700 changes, numerous bugfixes
5900
5901   * Language
5902     * ~[T] has been removed from the language. This type is superseded by
5903       the Vec<T> type.
5904     * ~str has been removed from the language. This type is superseded by
5905       the String type.
5906     * ~T has been removed from the language. This type is superseded by the
5907       Box<T> type.
5908     * @T has been removed from the language. This type is superseded by the
5909       standard library's std::gc::Gc<T> type.
5910     * Struct fields are now all private by default.
5911     * Vector indices and shift amounts are both required to be a `uint`
5912       instead of any integral type.
5913     * Byte character, byte string, and raw byte string literals are now all
5914       supported by prefixing the normal literal with a `b`.
5915     * Multiple ABIs are no longer allowed in an ABI string
5916     * The syntax for lifetimes on closures/procedures has been tweaked
5917       slightly: `<'a>|A, B|: 'b + K -> T`
5918     * Floating point modulus has been removed from the language; however it
5919       is still provided by a library implementation.
5920     * Private enum variants are now disallowed.
5921     * The `priv` keyword has been removed from the language.
5922     * A closure can no longer be invoked through a &-pointer.
5923     * The `use foo, bar, baz;` syntax has been removed from the language.
5924     * The transmute intrinsic no longer works on type parameters.
5925     * Statics now allow blocks/items in their definition.
5926     * Trait bounds are separated from objects with + instead of : now.
5927     * Objects can no longer be read while they are mutably borrowed.
5928     * The address of a static is now marked as insignificant unless the
5929       #[inline(never)] attribute is placed it.
5930     * The #[unsafe_destructor] attribute is now behind a feature gate.
5931     * Struct literals are no longer allowed in ambiguous positions such as
5932       if, while, match, and for..in.
5933     * Declaration of lang items and intrinsics are now feature-gated by
5934       default.
5935     * Integral literals no longer default to `int`, and floating point
5936       literals no longer default to `f64`. Literals must be suffixed with an
5937       appropriate type if inference cannot determine the type of the
5938       literal.
5939     * The Box<T> type is no longer implicitly borrowed to &mut T.
5940     * Procedures are now required to not capture borrowed references.
5941
5942   * Libraries
5943     * The standard library is now a "facade" over a number of underlying
5944       libraries. This means that development on the standard library should
5945       be speedier due to smaller crates, as well as a clearer line between
5946       all dependencies.
5947     * A new library, libcore, lives under the standard library's facade
5948       which is Rust's "0-assumption" library, suitable for embedded and
5949       kernel development for example.
5950     * A regex crate has been added to the standard distribution. This crate
5951       includes statically compiled regular expressions.
5952     * The unwrap/unwrap_err methods on Result require a Show bound for
5953       better error messages.
5954     * The return types of the std::comm primitives have been centralized
5955       around the Result type.
5956     * A number of I/O primitives have gained the ability to time out their
5957       operations.
5958     * A number of I/O primitives have gained the ability to close their
5959       reading/writing halves to cancel pending operations.
5960     * Reverse iterator methods have been removed in favor of `rev()` on
5961       their forward-iteration counterparts.
5962     * A bitflags! macro has been added to enable easy interop with C and
5963       management of bit flags.
5964     * A debug_assert! macro is now provided which is disabled when
5965       `--cfg ndebug` is passed to the compiler.
5966     * A graphviz crate has been added for creating .dot files.
5967     * The std::cast module has been migrated into std::mem.
5968     * The std::local_data api has been migrated from freestanding functions
5969       to being based on methods.
5970     * The Pod trait has been renamed to Copy.
5971     * jemalloc has been added as the default allocator for types.
5972     * The API for allocating memory has been changed to use proper alignment
5973       and sized deallocation
5974     * Connecting a TcpStream or binding a TcpListener is now based on a
5975       string address and a u16 port. This allows connecting to a hostname as
5976       opposed to an IP.
5977     * The Reader trait now contains a core method, read_at_least(), which
5978       correctly handles many repeated 0-length reads.
5979     * The process-spawning API is now centered around a builder-style
5980       Command struct.
5981     * The :? printing qualifier has been moved from the standard library to
5982       an external libdebug crate.
5983     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5984       have been renamed to Eq/Ord.
5985     * The select/plural methods have been removed from format!. The escapes
5986       for { and } have also changed from \{ and \} to {{ and }},
5987       respectively.
5988     * The TaskBuilder API has been re-worked to be a true builder, and
5989       extension traits for spawning native/green tasks have been added.
5990
5991   * Tooling
5992     * All breaking changes to the language or libraries now have their
5993       commit message annotated with `[breaking-change]` to allow for easy
5994       discovery of breaking changes.
5995     * The compiler will now try to suggest how to annotate lifetimes if a
5996       lifetime-related error occurs.
5997     * Debug info continues to be improved greatly with general bug fixes and
5998       better support for situations like link time optimization (LTO).
5999     * Usage of syntax extensions when cross-compiling has been fixed.
6000     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6001       -fdata-sections and --gc-sections has been enabled by default
6002     * The compiler is now stricter about where it will load module files
6003       from when a module is declared via `mod foo;`.
6004     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6005       Syntax extensions are now discovered via a "plugin registrar" type
6006       which will be extended in the future to other various plugins.
6007     * Lints have been restructured to allow for dynamically loadable lints.
6008     * A number of rustdoc improvements:
6009       * The HTML output has been visually redesigned.
6010       * Markdown is now powered by hoedown instead of sundown.
6011       * Searching heuristics have been greatly improved.
6012       * The search index has been reduced in size by a great amount.
6013       * Cross-crate documentation via `pub use` has been greatly improved.
6014       * Primitive types are now hyperlinked and documented.
6015     * Documentation has been moved from static.rust-lang.org/doc to
6016       doc.rust-lang.org
6017     * A new sandbox, play.rust-lang.org, is available for running and
6018       sharing rust code examples on-line.
6019     * Unused attributes are now more robustly warned about.
6020     * The dead_code lint now warns about unused struct fields.
6021     * Cross-compiling to iOS is now supported.
6022     * Cross-compiling to mipsel is now supported.
6023     * Stability attributes are now inherited by default and no longer apply
6024       to intra-crate usage, only inter-crate usage.
6025     * Error message related to non-exhaustive match expressions have been
6026       greatly improved.
6027
6028
6029 Version 0.10 (2014-04-03)
6030 =========================
6031
6032   * ~1500 changes, numerous bugfixes
6033
6034   * Language
6035     * A new RFC process is now in place for modifying the language.
6036     * Patterns with `@`-pointers have been removed from the language.
6037     * Patterns with unique vectors (`~[T]`) have been removed from the
6038       language.
6039     * Patterns with unique strings (`~str`) have been removed from the
6040       language.
6041     * `@str` has been removed from the language.
6042     * `@[T]` has been removed from the language.
6043     * `@self` has been removed from the language.
6044     * `@Trait` has been removed from the language.
6045     * Headers on `~` allocations which contain `@` boxes inside the type for
6046       reference counting have been removed.
6047     * The semantics around the lifetimes of temporary expressions have changed,
6048       see #3511 and #11585 for more information.
6049     * Cross-crate syntax extensions are now possible, but feature gated. See
6050       #11151 for more information. This includes both `macro_rules!` macros as
6051       well as syntax extensions such as `format!`.
6052     * New lint modes have been added, and older ones have been turned on to be
6053       warn-by-default.
6054       * Unnecessary parentheses
6055       * Uppercase statics
6056       * Camel Case types
6057       * Uppercase variables
6058       * Publicly visible private types
6059       * `#[deriving]` with raw pointers
6060     * Unsafe functions can no longer be coerced to closures.
6061     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6062     * The `#[simd]` attribute is now behind a feature gate.
6063     * Visibility is no longer allowed on `extern crate` statements, and
6064       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6065     * Trailing commas are now allowed in argument lists and tuple patterns.
6066     * The `do` keyword has been removed, it is now a reserved keyword.
6067     * Default type parameters have been implemented, but are feature gated.
6068     * Borrowed variables through captures in closures are now considered soundly.
6069     * `extern mod` is now `extern crate`
6070     * The `Freeze` trait has been removed.
6071     * The `Share` trait has been added for types that can be shared among
6072       threads.
6073     * Labels in macros are now hygienic.
6074     * Expression/statement macro invocations can be delimited with `{}` now.
6075     * Treatment of types allowed in `static mut` locations has been tweaked.
6076     * The `*` and `.` operators are now overloadable through the `Deref` and
6077       `DerefMut` traits.
6078     * `~Trait` and `proc` no longer have `Send` bounds by default.
6079     * Partial type hints are now supported with the `_` type marker.
6080     * An `Unsafe` type was introduced for interior mutability. It is now
6081       considered undefined to transmute from `&T` to `&mut T` without using the
6082       `Unsafe` type.
6083     * The #[linkage] attribute was implemented for extern statics/functions.
6084     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6085     * `Pod` was renamed to `Copy`.
6086
6087   * Libraries
6088     * The `libextra` library has been removed. It has now been decomposed into
6089       component libraries with smaller and more focused nuggets of
6090       functionality. The full list of libraries can be found on the
6091       documentation index page.
6092     * std: `std::condition` has been removed. All I/O errors are now propagated
6093       through the `Result` type. In order to assist with error handling, a
6094       `try!` macro for unwrapping errors with an early return and a lint for
6095       unused results has been added. See #12039 for more information.
6096     * std: The `vec` module has been renamed to `slice`.
6097     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6098       This will become the only growable vector in the future.
6099     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6100       are now found at `std::io::BufferedReader` instead of
6101       `std::io::buffered::BufferedReader`.
6102     * std: `print` and `println` are no longer in the prelude, the `print!` and
6103       `println!` macros are intended to be used instead.
6104     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6105       attempts to statically prevent cycles.
6106     * std: The standard distribution is adopting the policy of pushing failure
6107       to the user rather than failing in libraries. Many functions (such as
6108       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6109     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6110       deriving mode: `#[deriving(Show)]`.
6111     * std: `ToStr` is now implemented for all types implementing `Show`.
6112     * std: The formatting trait methods now take `&self` instead of `&T`
6113     * std: The `invert()` method on iterators has been renamed to `rev()`
6114     * std: `std::num` has seen a reduction in the genericity of its traits,
6115       consolidating functionality into a few core traits.
6116     * std: Backtraces are now printed on task failure if the environment
6117       variable `RUST_BACKTRACE` is present.
6118     * std: Naming conventions for iterators have been standardized. More details
6119       can be found on the wiki's style guide.
6120     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6121       still implement the function.
6122     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6123     * std: `assert_approx_eq!` has been removed
6124     * std: The `e` and `E` formatting specifiers for floats have been added to
6125       print them in exponential notation.
6126     * std: The `Times` trait has been removed
6127     * std: Indications of variance and opting out of builtin bounds is done
6128       through marker types in `std::kinds::marker` now
6129     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6130       `#[deriving(Hash)]` is now possible.
6131     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6132     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6133     * std: `Chan::new` is now `channel()`.
6134     * std: A new synchronous channel type has been implemented.
6135     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6136     * std: `hashmap` and `trie` have been moved to `libcollections`
6137     * std: `run` has been rolled into `io::process`
6138     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6139     * std: The equality and comparison traits have seen some reorganization.
6140     * std: `rand` has moved to `librand`.
6141     * std: `to_{lower,upper}case` has been implemented for `char`.
6142     * std: Logging has been moved to `liblog`.
6143     * collections: `HashMap` has been rewritten for higher performance and less
6144       memory usage.
6145     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6146       it can be booted manually. The runtime guide has more information and
6147       examples.
6148     * native: All I/O functionality except signals has been implemented.
6149     * green: Task spawning with `libgreen` has been optimized with stack caching
6150       and various trimming of code.
6151     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6152     * sync: The `extra::sync` module has been updated to modern rust (and moved
6153       to the `sync` library), tweaking and improving various interfaces while
6154       dropping redundant functionality.
6155     * sync: A new `Barrier` type has been added to the `sync` library.
6156     * sync: An efficient mutex for native and green tasks has been implemented.
6157     * serialize: The `base64` module has seen some improvement. It treats
6158       newlines better, has non-string error values, and has seen general
6159       cleanup.
6160     * fourcc: A `fourcc!` macro was introduced
6161     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6162       hexadecimal literal.
6163
6164   * Tooling
6165     * `rustpkg` has been deprecated and removed from the main repository. Its
6166       replacement, `cargo`, is under development.
6167     * Nightly builds of rust are now available
6168     * The memory usage of rustc has been improved many times throughout this
6169       release cycle.
6170     * The build process supports disabling rpath support for the rustc binary
6171       itself.
6172     * Code generation has improved in some cases, giving more information to the
6173       LLVM optimization passes to enable more extensive optimizations.
6174     * Debuginfo compatibility with lldb on OSX has been restored.
6175     * The master branch is now gated on an android bot, making building for
6176       android much more reliable.
6177     * Output flags have been centralized into one `--emit` flag.
6178     * Crate type flags have been centralized into one `--crate-type` flag.
6179     * Codegen flags have been consolidated behind a `-C` flag.
6180     * Linking against outdated crates now has improved error messages.
6181     * Error messages with lifetimes will often suggest how to annotate the
6182       function to fix the error.
6183     * Many more types are documented in the standard library, and new guides
6184       were written.
6185     * Many `rustdoc` improvements:
6186       * code blocks are syntax highlighted.
6187       * render standalone markdown files.
6188       * the --test flag tests all code blocks by default.
6189       * exported macros are displayed.
6190       * re-exported types have their documentation inlined at the location of the
6191         first re-export.
6192       * search works across crates that have been rendered to the same output
6193         directory.
6194
6195
6196 Version 0.9 (2014-01-09)
6197 ==========================
6198
6199    * ~1800 changes, numerous bugfixes
6200
6201    * Language
6202       * The `float` type has been removed. Use `f32` or `f64` instead.
6203       * A new facility for enabling experimental features (feature gating) has
6204         been added, using the crate-level `#[feature(foo)]` attribute.
6205       * Managed boxes (@) are now behind a feature gate
6206         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6207         standard library's `Gc` or `Rc` types instead.
6208       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6209       * Jumping back to the top of a loop is now done with `continue` instead of
6210         `loop`.
6211       * Strings can no longer be mutated through index assignment.
6212       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6213         hash delimiters, as in `r###"foo"###`.
6214       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6215         called once.
6216       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6217       * `@fn`s have been removed.
6218       * `do` only works with procs in order to make it obvious what the cost
6219         of `do` is.
6220       * Single-element tuple-like structs can no longer be dereferenced to
6221         obtain the inner value. A more comprehensive solution for overloading
6222         the dereference operator will be provided in the future.
6223       * The `#[link(...)]` attribute has been replaced with
6224         `#[crate_id = "name#vers"]`.
6225       * Empty `impl`s must be terminated with empty braces and may not be
6226         terminated with a semicolon.
6227       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6228         no longer has any special meaning.
6229       * The old `fmt!` string formatting macro has been removed.
6230       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6231         `print!` and `println!`.
6232       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6233       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6234         `extern mod foo = "bar"` instead.
6235       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6236       * Macros can have attributes.
6237       * Macros can expand to items with attributes.
6238       * Macros can expand to multiple items.
6239       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6240       * Comments may be nested.
6241       * Values automatically coerce to trait objects they implement, without
6242         an explicit `as`.
6243       * Enum discriminants are no longer an entire word but as small as needed to
6244         contain all the variants. The `repr` attribute can be used to override
6245         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6246         `#[repr(C)]` to match C enums.
6247       * Non-string literals are not allowed in attributes (they never worked).
6248       * The FFI now supports variadic functions.
6249       * Octal numeric literals, as in `0o7777`.
6250       * The `concat!` syntax extension performs compile-time string concatenation.
6251       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6252         removed as Rust no longer uses segmented stacks.
6253       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6254       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6255         not `*`; ignoring remaining fields of a struct is also done with `..`,
6256         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6257       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6258       * `rustc` supports the "system" calling convention, which defaults to the
6259         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6260         "C" elsewhere.
6261       * The `type_overflow` lint (default: warn) checks literals for overflow.
6262       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6263       * The `attribute_usage` lint (default: warn) warns about unknown
6264         attributes.
6265       * The `unknown_features` lint (default: warn) warns about unknown
6266         feature gates.
6267       * The `dead_code` lint (default: warn) checks for dead code.
6268       * Rust libraries can be linked statically to one another
6269       * `#[link_args]` is behind the `link_args` feature gate.
6270       * Native libraries are now linked with `#[link(name = "foo")]`
6271       * Native libraries can be statically linked to a rust crate
6272         (`#[link(name = "foo", kind = "static")]`).
6273       * Native OS X frameworks are now officially supported
6274         (`#[link(name = "foo", kind = "framework")]`).
6275       * The `#[thread_local]` attribute creates thread-local (not task-local)
6276         variables. Currently behind the `thread_local` feature gate.
6277       * The `return` keyword may be used in closures.
6278       * Types that can be copied via a memcpy implement the `Pod` kind.
6279       * The `cfg` attribute can now be used on struct fields and enum variants.
6280
6281    * Libraries
6282       * std: The `option` and `result` API's have been overhauled to make them
6283         simpler, more consistent, and more composable.
6284       * std: The entire `std::io` module has been replaced with one that is
6285         more comprehensive and that properly interfaces with the underlying
6286         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6287         implemented.
6288       * std: `io::util` contains a number of useful implementations of
6289         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6290         `ZeroReader`, `TeeReader`.
6291       * std: The reference counted pointer type `extra::rc` moved into std.
6292       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6293         just a wrapper around it).
6294       * std: The `Either` type has been removed.
6295       * std: `fmt::Default` can be implemented for any type to provide default
6296         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6297       * std: The `rand` API continues to be tweaked.
6298       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6299         on failure in gdb, is now named `rust_fail`.
6300       * std: The `each_key` and `each_value` methods on `HashMap` have been
6301         replaced by the `keys` and `values` iterators.
6302       * std: Functions dealing with type size and alignment have moved from the
6303         `sys` module to the `mem` module.
6304       * std: The `path` module was written and API changed.
6305       * std: `str::from_utf8` has been changed to cast instead of allocate.
6306       * std: `starts_with` and `ends_with` methods added to vectors via the
6307         `ImmutableEqVector` trait, which is in the prelude.
6308       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6309         if the index is out of bounds.
6310       * std: Task failure no longer propagates between tasks, as the model was
6311         complex, expensive, and incompatible with thread-based tasks.
6312       * std: The `Any` type can be used for dynamic typing.
6313       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6314         `task::try`.
6315       * std: Methods that produce iterators generally do not have an `_iter`
6316         suffix now.
6317       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6318         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6319       * std: `util::ignore` renamed to `prelude::drop`.
6320       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6321         trait.
6322       * std: `vec::raw` has seen a lot of cleanup and API changes.
6323       * std: The standard library no longer includes any C++ code, and very
6324         minimal C, eliminating the dependency on libstdc++.
6325       * std: Runtime scheduling and I/O functionality has been factored out into
6326         extensible interfaces and is now implemented by two different crates:
6327         libnative, for native threading and I/O; and libgreen, for green threading
6328         and I/O. This paves the way for using the standard library in more limited
6329         embedded environments.
6330       * std: The `comm` module has been rewritten to be much faster, have a
6331         simpler, more consistent API, and to work for both native and green
6332         threading.
6333       * std: All libuv dependencies have been moved into the rustuv crate.
6334       * native: New implementations of runtime scheduling on top of OS threads.
6335       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6336         and other I/O.
6337       * green: The green thread scheduler and message passing types are almost
6338         entirely lock-free.
6339       * extra: The `flatpipes` module had bitrotted and was removed.
6340       * extra: All crypto functions have been removed and Rust now has a policy of
6341         not reimplementing crypto in the standard library. In the future crypto
6342         will be provided by external crates with bindings to established libraries.
6343       * extra: `c_vec` has been modernized.
6344       * extra: The `sort` module has been removed. Use the `sort` method on
6345         mutable slices.
6346
6347    * Tooling
6348       * The `rust` and `rusti` commands have been removed, due to lack of
6349         maintenance.
6350       * `rustdoc` was completely rewritten.
6351       * `rustdoc` can test code examples in documentation.
6352       * `rustpkg` can test packages with the argument, 'test'.
6353       * `rustpkg` supports arbitrary dependencies, including C libraries.
6354       * `rustc`'s support for generating debug info is improved again.
6355       * `rustc` has better error reporting for unbalanced delimiters.
6356       * `rustc`'s JIT support was removed due to bitrot.
6357       * Executables and static libraries can be built with LTO (-Z lto)
6358       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6359         build tools.
6360
6361
6362 Version 0.8 (2013-09-26)
6363 ============================
6364
6365    * ~2200 changes, numerous bugfixes
6366
6367    * Language
6368       * The `for` loop syntax has changed to work with the `Iterator` trait.
6369       * At long last, unwinding works on Windows.
6370       * Default methods are ready for use.
6371       * Many trait inheritance bugs fixed.
6372       * Owned and borrowed trait objects work more reliably.
6373       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6374       * rustc can omit emission of code for the `debug!` macro if it is passed
6375         `--cfg ndebug`
6376       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6377         for foo.rs, then foo/mod.rs, and will generate an error when both are
6378         present.
6379       * Strings no longer contain trailing nulls. The new `std::c_str` module
6380         provides new mechanisms for converting to C strings.
6381       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6382       * The FFI has been overhauled such that foreign functions are called directly,
6383         instead of through a stack-switching wrapper.
6384       * Calling a foreign function must be done through a Rust function with the
6385         `#[fixed_stack_segment]` attribute.
6386       * The `externfn!` macro can be used to declare both a foreign function and
6387         a `#[fixed_stack_segment]` wrapper at once.
6388       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6389       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6390       * `priv` is disallowed everywhere except for struct fields and enum variants.
6391       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6392       * `ref` bindings in irrefutable patterns work correctly now.
6393       * `char` is now prevented from containing invalid code points.
6394       * Casting to `bool` is no longer allowed.
6395       * `\0` is now accepted as an escape in chars and strings.
6396       * `yield` is a reserved keyword.
6397       * `typeof` is a reserved keyword.
6398       * Crates may be imported by URL with `extern mod foo = "url";`.
6399       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6400       * Static vectors can be initialized with repeating elements,
6401         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6402       * Static structs can be initialized with functional record update,
6403         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6404       * `cfg!` can be used to conditionally execute code based on the crate
6405         configuration, similarly to `#[cfg(...)]`.
6406       * The `unnecessary_qualification` lint detects unneeded module
6407         prefixes (default: allow).
6408       * Arithmetic operations have been implemented on the SIMD types in
6409         `std::unstable::simd`.
6410       * Exchange allocation headers were removed, reducing memory usage.
6411       * `format!` implements a completely new, extensible, and higher-performance
6412         string formatting system. It will replace `fmt!`.
6413       * `print!` and `println!` write formatted strings (using the `format!`
6414         extension) to stdout.
6415       * `write!` and `writeln!` write formatted strings (using the `format!`
6416         extension) to the new Writers in `std::rt::io`.
6417       * The library section in which a function or static is placed may
6418         be specified with `#[link_section = "..."]`.
6419       * The `proto!` syntax extension for defining bounded message protocols
6420         was removed.
6421       * `macro_rules!` is hygienic for `let` declarations.
6422       * The `#[export_name]` attribute specifies the name of a symbol.
6423       * `unreachable!` can be used to indicate unreachable code, and fails
6424         if executed.
6425
6426    * Libraries
6427       * std: Transitioned to the new runtime, written in Rust.
6428       * std: Added an experimental I/O library, `rt::io`, based on the new
6429         runtime.
6430       * std: A new generic `range` function was added to the prelude, replacing
6431         `uint::range` and friends.
6432       * std: `range_rev` no longer exists. Since range is an iterator it can be
6433         reversed with `range(lo, hi).invert()`.
6434       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6435         renamed to `unwrap_or`.
6436       * std: The `iterator` module was renamed to `iter`.
6437       * std: Integral types now support the `checked_add`, `checked_sub`, and
6438         `checked_mul` operations for detecting overflow.
6439       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6440         consistency.
6441       * std: Methods are standardizing on conventions for casting methods:
6442         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6443         and cheap casts.
6444       * std: The `CString` type in `c_str` provides new ways to convert to and
6445         from C strings.
6446       * std: `DoubleEndedIterator` can yield elements in two directions.
6447       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6448         two splices.
6449       * std: `str::from_bytes` renamed to `str::from_utf8`.
6450       * std: `pop_opt` and `shift_opt` methods added to vectors.
6451       * std: The task-local data interface no longer uses @, and keys are
6452         no longer function pointers.
6453       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6454       * std: Added `SharedPort` to `comm`.
6455       * std: `Eq` has a default method for `ne`; only `eq` is required
6456         in implementations.
6457       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6458         is required in implementations.
6459       * std: `is_utf8` performance is improved, impacting many string functions.
6460       * std: `os::MemoryMap` provides cross-platform mmap.
6461       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6462         are not 'in-bounds' are considered undefined.
6463       * std: Many freestanding functions in `vec` removed in favor of methods.
6464       * std: Many freestanding functions on scalar types removed in favor of
6465         methods.
6466       * std: Many options to task builders were removed since they don't make
6467         sense in the new scheduler design.
6468       * std: More containers implement `FromIterator` so can be created by the
6469         `collect` method.
6470       * std: More complete atomic types in `unstable::atomics`.
6471       * std: `comm::PortSet` removed.
6472       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6473         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6474         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6475         default implementations.
6476       * std: Various `from_str` functions were removed in favor of a generic
6477         `from_str` which is available in the prelude.
6478       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6479       * extra: `dlist`, the doubly-linked list was modernized.
6480       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6481       * extra: Added `glob` module, replacing `std::os::glob`.
6482       * extra: `rope` was removed.
6483       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6484       * extra: `net`, and `timer` were removed. The experimental replacements
6485         are `std::rt::io::net` and `std::rt::io::timer`.
6486       * extra: Iterators implemented for `SmallIntMap`.
6487       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6488       * extra: `SmallIntSet` removed. Use `BitvSet`.
6489       * extra: Performance of JSON parsing greatly improved.
6490       * extra: `semver` updated to SemVer 2.0.0.
6491       * extra: `term` handles more terminals correctly.
6492       * extra: `dbg` module removed.
6493       * extra: `par` module removed.
6494       * extra: `future` was cleaned up, with some method renames.
6495       * extra: Most free functions in `getopts` were converted to methods.
6496
6497    * Other
6498       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6499       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6500         similarly to gcc's `--march` flag.
6501       * rustc's performance compiling small crates is much better.
6502       * rustpkg has received many improvements.
6503       * rustpkg supports git tags as package IDs.
6504       * rustpkg builds into target-specific directories so it can be used for
6505         cross-compiling.
6506       * The number of concurrent test tasks is controlled by the environment
6507         variable RUST_TEST_TASKS.
6508       * The test harness can now report metrics for benchmarks.
6509       * All tools have man pages.
6510       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6511       * The runtime uses jemalloc for allocations.
6512       * Segmented stacks are temporarily disabled as part of the transition to
6513         the new runtime. Stack overflows are possible!
6514       * A new documentation backend, rustdoc_ng, is available for use. It is
6515         still invoked through the normal `rustdoc` command.
6516
6517
6518 Version 0.7 (2013-07-03)
6519 =======================
6520
6521    * ~2000 changes, numerous bugfixes
6522
6523    * Language
6524       * `impl`s no longer accept a visibility qualifier. Put them on methods
6525         instead.
6526       * The borrow checker has been rewritten with flow-sensitivity, fixing
6527         many bugs and inconveniences.
6528       * The `self` parameter no longer implicitly means `&'self self`,
6529         and can be explicitly marked with a lifetime.
6530       * Overloadable compound operators (`+=`, etc.) have been temporarily
6531         removed due to bugs.
6532       * The `for` loop protocol now requires `for`-iterators to return `bool`
6533         so they compose better.
6534       * The `Durable` trait is replaced with the `'static` bounds.
6535       * Trait default methods work more often.
6536       * Structs with the `#[packed]` attribute have byte alignment and
6537         no padding between fields.
6538       * Type parameters bound by `Copy` must now be copied explicitly with
6539         the `copy` keyword.
6540       * It is now illegal to move out of a dereferenced unsafe pointer.
6541       * `Option<~T>` is now represented as a nullable pointer.
6542       * `@mut` does dynamic borrow checks correctly.
6543       * The `main` function is only detected at the topmost level of the crate.
6544         The `#[main]` attribute is still valid anywhere.
6545       * Struct fields may no longer be mutable. Use inherited mutability.
6546       * The `#[no_send]` attribute makes a type that would otherwise be
6547         `Send`, not.
6548       * The `#[no_freeze]` attribute makes a type that would otherwise be
6549         `Freeze`, not.
6550       * Unbounded recursion will abort the process after reaching the limit
6551         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6552       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6553         are never implicitly copyable.
6554       * `#[static_assert]` makes compile-time assertions about static bools.
6555       * At long last, 'argument modes' no longer exist.
6556       * The rarely used `use mod` statement no longer exists.
6557
6558    * Syntax extensions
6559       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6560         argument list.
6561       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6562         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6563         `#[deriving(...)]`.
6564       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6565         and unsuffixed integer literals.
6566
6567    * Libraries
6568       * The `core` crate was renamed to `std`.
6569       * The `std` crate was renamed to `extra`.
6570       * More and improved documentation.
6571       * std: `iterator` module for external iterator objects.
6572       * Many old-style (internal, higher-order function) iterators replaced by
6573         implementations of `Iterator`.
6574       * std: Many old internal vector and string iterators,
6575         incl. `any`, `all`. removed.
6576       * std: The `finalize` method of `Drop` renamed to `drop`.
6577       * std: The `drop` method now takes `&mut self` instead of `&self`.
6578       * std: The prelude no longer re-exports any modules, only types and traits.
6579       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6580         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6581       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6582         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6583       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6584         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6585       * std: Many types implement `Clone`.
6586       * std: `path` type renamed to `Path`.
6587       * std: `mut` module and `Mut` type removed.
6588       * std: Many standalone functions removed in favor of methods and iterators
6589         in `vec`, `str`. In the future methods will also work as functions.
6590       * std: `reinterpret_cast` removed. Use `transmute`.
6591       * std: ascii string handling in `std::ascii`.
6592       * std: `Rand` is implemented for ~/@.
6593       * std: `run` module for spawning processes overhauled.
6594       * std: Various atomic types added to `unstable::atomic`.
6595       * std: Various types implement `Zero`.
6596       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6597       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6598       * std: Added `os::mkdir_recursive`.
6599       * std: Added `os::glob` function performs filesystems globs.
6600       * std: `FuzzyEq` renamed to `ApproxEq`.
6601       * std: `Map` now defines `pop` and `swap` methods.
6602       * std: `Cell` constructors converted to static methods.
6603       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6604       * extra: `flate` module moved from `std` to `extra`.
6605       * extra: `fileinput` module for iterating over a series of files.
6606       * extra: `Complex` number type and `complex` module.
6607       * extra: `Rational` number type and `rational` module.
6608       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6609       * extra: `term` uses terminfo now, is more correct.
6610       * extra: `arc` functions converted to methods.
6611       * extra: Implementation of fixed output size variations of SHA-2.
6612
6613    * Tooling
6614       * `unused_variable`  lint mode for unused variables (default: warn).
6615       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6616         (default: warn).
6617       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6618         (default: warn).
6619       * `dead_assignment` lint mode for unread variables (default: warn).
6620       * `unnecessary_allocation` lint mode detects some heap allocations that are
6621         immediately borrowed so could be written without allocating (default: warn).
6622       * `missing_doc` lint mode (default: allow).
6623       * `unreachable_code` lint mode (default: warn).
6624       * The `rusti` command has been rewritten and a number of bugs addressed.
6625       * rustc outputs in color on more terminals.
6626       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6627       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6628       * Compiling with `-g` will make the binary record information about
6629         dynamic borrowcheck failures for debugging.
6630       * rustdoc has a nicer stylesheet.
6631       * Various improvements to rustdoc.
6632       * Improvements to rustpkg (see the detailed release notes).
6633
6634
6635 Version 0.6 (2013-04-03)
6636 ========================
6637
6638    * ~2100 changes, numerous bugfixes
6639
6640    * Syntax changes
6641       * The self type parameter in traits is now spelled `Self`
6642       * The `self` parameter in trait and impl methods must now be explicitly
6643         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6644       * Static methods no longer require the `static` keyword and instead
6645         are distinguished by the lack of a `self` parameter
6646       * Replaced the `Durable` trait with the `'static` lifetime
6647       * The old closure type syntax with the trailing sigil has been
6648         removed in favor of the more consistent leading sigil
6649       * `super` is a keyword, and may be prefixed to paths
6650       * Trait bounds are separated with `+` instead of whitespace
6651       * Traits are implemented with `impl Trait for Type`
6652         instead of `impl Type: Trait`
6653       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6654       * The `export` keyword has finally been removed
6655       * The `move` keyword has been removed (see "Semantic changes")
6656       * The interior mutability qualifier on vectors, `[mut T]`, has been
6657         removed. Use `&mut [T]`, etc.
6658       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6659       * `fail` is no longer a keyword. Use `fail!()`
6660       * `assert` is no longer a keyword. Use `assert!()`
6661       * `log` is no longer a keyword. use `debug!`, etc.
6662       * 1-tuples may be represented as `(T,)`
6663       * Struct fields may no longer be `mut`. Use inherited mutability,
6664         `@mut T`, `core::mut` or `core::cell`
6665       * `extern mod { ... }` is no longer valid syntax for foreign
6666         function modules. Use extern blocks: `extern { ... }`
6667       * Newtype enums removed. Use tuple-structs.
6668       * Trait implementations no longer support visibility modifiers
6669       * Pattern matching over vectors improved and expanded
6670       * `const` renamed to `static` to correspond to lifetime name,
6671         and make room for future `static mut` unsafe mutable globals.
6672       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6673       * `Clone` implementations can be automatically generated with
6674         `#[deriving(Clone)]`
6675       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6676         instead of `foo as Bar`.
6677       * Fixed length vector types are now written as `[int, .. 3]`
6678         instead of `[int * 3]`.
6679       * Fixed length vector types can express the length as a constant
6680         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6681
6682    * Semantic changes
6683       * Types with owned pointers or custom destructors move by default,
6684         eliminating the `move` keyword
6685       * All foreign functions are considered unsafe
6686       * &mut is now unaliasable
6687       * Writes to borrowed @mut pointers are prevented dynamically
6688       * () has size 0
6689       * The name of the main function can be customized using #[main]
6690       * The default type of an inferred closure is &fn instead of @fn
6691       * `use` statements may no longer be "chained" - they cannot import
6692         identifiers imported by previous `use` statements
6693       * `use` statements are crate relative, importing from the "top"
6694         of the crate by default. Paths may be prefixed with `super::`
6695         or `self::` to change the search behavior.
6696       * Method visibility is inherited from the implementation declaration
6697       * Structural records have been removed
6698       * Many more types can be used in static items, including enums
6699         'static-lifetime pointers and vectors
6700       * Pattern matching over vectors improved and expanded
6701       * Typechecking of closure types has been overhauled to
6702         improve inference and eliminate unsoundness
6703       * Macros leave scope at the end of modules, unless that module is
6704         tagged with #[macro_escape]
6705
6706    * Libraries
6707       * Added big integers to `std::bigint`
6708       * Removed `core::oldcomm` module
6709       * Added pipe-based `core::comm` module
6710       * Numeric traits have been reorganized under `core::num`
6711       * `vec::slice` finally returns a slice
6712       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6713       * Containers reorganized around traits in `core::container`
6714       * `core::dvec` removed, `~[T]` is a drop-in replacement
6715       * `core::send_map` renamed to `core::hashmap`
6716       * `std::map` removed; replaced with `core::hashmap`
6717       * `std::treemap` reimplemented as an owned balanced tree
6718       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6719       * `core::trie` added as a fast ordered map for integer keys
6720       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6721       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6722         overload the comparison operators, whereas `TotalOrd` is used
6723         by certain container types
6724
6725    * Other
6726       * Replaced the 'cargo' package manager with 'rustpkg'
6727       * Added all-purpose 'rust' tool
6728       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6729       * rustc now *attempts* to offer spelling suggestions
6730       * Improved support for ARM and Android
6731       * Preliminary MIPS backend
6732       * Improved foreign function ABI implementation for x86, x86_64
6733       * Various memory usage improvements
6734       * Rust code may be embedded in foreign code under limited circumstances
6735       * Inline assembler supported by new asm!() syntax extension.
6736
6737
6738 Version 0.5 (2012-12-21)
6739 ===========================
6740
6741    * ~900 changes, numerous bugfixes
6742
6743    * Syntax changes
6744       * Removed `<-` move operator
6745       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6746       * Removed old fixed length vector syntax - `[T]/N`
6747       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6748       * Macros may now expand to items and statements
6749       * `a.b()` is always parsed as a method call, never as a field projection
6750       * `Eq` and `IterBytes` implementations can be automatically generated
6751         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6752       * Removed the special crate language for `.rc` files
6753       * Function arguments may consist of any irrefutable pattern
6754
6755    * Semantic changes
6756       * `&` and `~` pointers may point to objects
6757       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6758       * Enum variants may be structs
6759       * Destructors can be added to all nominal types with the Drop trait
6760       * Structs and nullary enum variants may be constants
6761       * Values that cannot be implicitly copied are now automatically moved
6762         without writing `move` explicitly
6763       * `&T` may now be coerced to `*T`
6764       * Coercions happen in `let` statements as well as function calls
6765       * `use` statements now take crate-relative paths
6766       * The module and type namespaces have been merged so that static
6767         method names can be resolved under the trait in which they are
6768         declared
6769
6770    * Improved support for language features
6771       * Trait inheritance works in many scenarios
6772       * More support for explicit self arguments in methods - `self`, `&self`
6773         `@self`, and `~self` all generally work as expected
6774       * Static methods work in more situations
6775       * Experimental: Traits may declare default methods for the implementations
6776         to use
6777
6778    * Libraries
6779       * New condition handling system in `core::condition`
6780       * Timsort added to `std::sort`
6781       * New priority queue, `std::priority_queue`
6782       * Pipes for serializable types, `std::flatpipes'
6783       * Serialization overhauled to be trait-based
6784       * Expanded `getopts` definitions
6785       * Moved futures to `std`
6786       * More functions are pure now
6787       * `core::comm` renamed to `oldcomm`. Still deprecated
6788       * `rustdoc` and `cargo` are libraries now
6789
6790    * Misc
6791       * Added a preliminary REPL, `rusti`
6792       * License changed from MIT to dual MIT/APL2
6793
6794
6795 Version 0.4 (2012-10-15)
6796 ==========================
6797
6798    * ~2000 changes, numerous bugfixes
6799
6800    * Syntax
6801       * All keywords are now strict and may not be used as identifiers anywhere
6802       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6803         'of', 'with', 'to', 'class'.
6804       * Classes are replaced with simpler structs
6805       * Explicit method self types
6806       * `ret` became `return` and `alt` became `match`
6807       * `import` is now `use`; `use is now `extern mod`
6808       * `extern mod { ... }` is now `extern { ... }`
6809       * `use mod` is the recommended way to import modules
6810       * `pub` and `priv` replace deprecated export lists
6811       * The syntax of `match` pattern arms now uses fat arrow (=>)
6812       * `main` no longer accepts an args vector; use `os::args` instead
6813
6814    * Semantics
6815       * Trait implementations are now coherent, ala Haskell typeclasses
6816       * Trait methods may be static
6817       * Argument modes are deprecated
6818       * Borrowed pointers are much more mature and recommended for use
6819       * Strings and vectors in the static region are stored in constant memory
6820       * Typestate was removed
6821       * Resolution rewritten to be more reliable
6822       * Support for 'dual-mode' data structures (freezing and thawing)
6823
6824    * Libraries
6825       * Most binary operators can now be overloaded via the traits in
6826         `core::ops'
6827       * `std::net::url` for representing URLs
6828       * Sendable hash maps in `core::send_map`
6829       * `core::task' gained a (currently unsafe) task-local storage API
6830
6831    * Concurrency
6832       * An efficient new intertask communication primitive called the pipe,
6833         along with a number of higher-level channel types, in `core::pipes`
6834       * `std::arc`, an atomically reference counted, immutable, shared memory
6835         type
6836       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6837       * Futures are now based on pipes and sendable
6838       * More robust linked task failure
6839       * Improved task builder API
6840
6841    * Other
6842       * Improved error reporting
6843       * Preliminary JIT support
6844       * Preliminary work on precise GC
6845       * Extensive architectural improvements to rustc
6846       * Begun a transition away from buggy C++-based reflection (shape) code to
6847         Rust-based (visitor) code
6848       * All hash functions and tables converted to secure, randomized SipHash
6849
6850
6851 Version 0.3  (2012-07-12)
6852 ========================
6853
6854    * ~1900 changes, numerous bugfixes
6855
6856    * New coding conveniences
6857       * Integer-literal suffix inference
6858       * Per-item control over warnings, errors
6859       * #[cfg(windows)] and #[cfg(unix)] attributes
6860       * Documentation comments
6861       * More compact closure syntax
6862       * 'do' expressions for treating higher-order functions as
6863         control structures
6864       * *-patterns (wildcard extended to all constructor fields)
6865
6866    * Semantic cleanup
6867       * Name resolution pass and exhaustiveness checker rewritten
6868       * Region pointers and borrow checking supersede alias
6869         analysis
6870       * Init-ness checking is now provided by a region-based liveness
6871         pass instead of the typestate pass; same for last-use analysis
6872       * Extensive work on region pointers
6873
6874    * Experimental new language features
6875       * Slices and fixed-size, interior-allocated vectors
6876       * #!-comments for lang versioning, shell execution
6877       * Destructors and iface implementation for classes;
6878         type-parameterized classes and class methods
6879       * 'const' type kind for types that can be used to implement
6880         shared-memory concurrency patterns
6881
6882    * Type reflection
6883
6884    * Removal of various obsolete features
6885       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6886                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6887
6888       * Constructs: do-while loops ('do' repurposed), fn binding,
6889                     resources (replaced by destructors)
6890
6891    * Compiler reorganization
6892       * Syntax-layer of compiler split into separate crate
6893       * Clang (from LLVM project) integrated into build
6894       * Typechecker split into sub-modules
6895
6896    * New library code
6897       * New time functions
6898       * Extension methods for many built-in types
6899       * Arc: atomic-refcount read-only / exclusive-use shared cells
6900       * Par: parallel map and search routines
6901       * Extensive work on libuv interface
6902       * Much vector code moved to libraries
6903       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6904         #include, #include_str, #include_bin
6905
6906    * Tool improvements
6907       * Cargo automatically resolves dependencies
6908
6909
6910 Version 0.2  (2012-03-29)
6911 =========================
6912
6913    * >1500 changes, numerous bugfixes
6914
6915    * New docs and doc tooling
6916
6917    * New port: FreeBSD x86_64
6918
6919    * Compilation model enhancements
6920       * Generics now specialized, multiply instantiated
6921       * Functions now inlined across separate crates
6922
6923    * Scheduling, stack and threading fixes
6924       * Noticeably improved message-passing performance
6925       * Explicit schedulers
6926       * Callbacks from C
6927       * Helgrind clean
6928
6929    * Experimental new language features
6930       * Operator overloading
6931       * Region pointers
6932       * Classes
6933
6934    * Various language extensions
6935       * C-callback function types: 'crust fn ...'
6936       * Infinite-loop construct: 'loop { ... }'
6937       * Shorten 'mutable' to 'mut'
6938       * Required mutable-local qualifier: 'let mut ...'
6939       * Basic glob-exporting: 'export foo::*;'
6940       * Alt now exhaustive, 'alt check' for runtime-checked
6941       * Block-function form of 'for' loop, with 'break' and 'ret'.
6942
6943    * New library code
6944       * AST quasi-quote syntax extension
6945       * Revived libuv interface
6946       * New modules: core::{future, iter}, std::arena
6947       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6948       * Extensive cleanup, regularization in libstd, libcore
6949
6950
6951 Version 0.1  (2012-01-20)
6952 ===============================
6953
6954    * Most language features work, including:
6955       * Unique pointers, unique closures, move semantics
6956       * Interface-constrained generics
6957       * Static interface dispatch
6958       * Stack growth
6959       * Multithread task scheduling
6960       * Typestate predicates
6961       * Failure unwinding, destructors
6962       * Pattern matching and destructuring assignment
6963       * Lightweight block-lambda syntax
6964       * Preliminary macro-by-example
6965
6966    * Compiler works with the following configurations:
6967       * Linux: x86 and x86_64 hosts and targets
6968       * macOS: x86 and x86_64 hosts and targets
6969       * Windows: x86 hosts and targets
6970
6971    * Cross compilation / multi-target configuration supported.
6972
6973    * Preliminary API-documentation and package-management tools included.
6974
6975 Known issues:
6976
6977    * Documentation is incomplete.
6978
6979    * Performance is below intended target.
6980
6981    * Standard library APIs are subject to extensive change, reorganization.
6982
6983    * Language-level versioning is not yet operational - future code will
6984      break unexpectedly.