]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Give each PathSegment a NodeId
[rust.git] / RELEASES.md
1 Version 1.30.0 (2018-10-25)
2 ==========================
3
4 Language
5 --------
6 - [Procedural macros are now available.][52081] These kinds of macros allow for
7   more powerful code generation. There is a [new chapter available][proc-macros]
8   in the Rust Programming Language book that goes further in depth.
9 - [You can now use keywords as identifiers using the raw identifiers
10   syntax (`r#`),][53236] e.g. `let r#for = true;`
11 - [Using anonymous parameters in traits is now deprecated with a warning and
12   will be a hard error in the 2018 edition.][53272]
13 - [You can now use `crate` in paths.][54404] This allows you to refer to the
14   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
15 - [Using a external crate no longer requires being prefixed with `::`.][54404]
16   Previously, using a external crate in a module without a use statement
17   required `let json = ::serde_json::from_str(foo);` but can now be written
18   as `let json = serde_json::from_str(foo);`.
19 - [You can now apply the `#[used]` attribute to static items to prevent the
20   compiler from optimising them away, even if they appear to be unused,][51363]
21   e.g. `#[used] static FOO: u32 = 1;`
22 - [You can now import and reexport macros from other crates with the `use`
23   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
24   the root module of the crate. If your macro relies on calling other local
25   macros, it is recommended to export with the
26   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
27   those macros.
28 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
29   using the `vis` specifier.][53370]
30 - [Non-macro attributes now allow all forms of literals, not just
31   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
32   write `#[attr(true)]`.
33 - [You can now specify a function to handle a panic in the Rust runtime with the
34   `#[panic_handler]` attribute.][51366]
35
36 Compiler
37 --------
38 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
39 - [Added the `aarch64-unknown-netbsd` target][53165]
40
41 Libraries
42 ---------
43 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
44
45 Stabilized APIs
46 ---------------
47 - [`Ipv4Addr::BROADCAST`]
48 - [`Ipv4Addr::LOCALHOST`]
49 - [`Ipv4Addr::UNSPECIFIED`]
50 - [`Ipv6Addr::LOCALHOST`]
51 - [`Ipv6Addr::UNSPECIFIED`]
52 - [`Iterator::find_map`]
53
54   The following methods are replacement methods for `trim_left`, `trim_right`,
55   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
56   in 1.33.0:
57 - [`str::trim_end_matches`]
58 - [`str::trim_end`]
59 - [`str::trim_start_matches`]
60 - [`str::trim_start`]
61
62 Cargo
63 ----
64 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
65 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
66   equivalent to calling `rustdoc --error-format=json`.
67 - [You can specify which edition to create a project in cargo
68   with `cargo new --edition`.][cargo/5984] Currently only `2015` is a
69   valid option.
70 - [Cargo will now provide a progress bar for builds.][cargo/5995]
71
72 Misc
73 ----
74 - [`rustdoc` allows you to specify what edition to treat your code as with the
75   `--edition` option.][54057]
76 - [`rustdoc` now has the `--color` (specify whether to output color) and
77   `--error-format` (specify error format, e.g. `json`) options.][53003]
78 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
79   debug symbols.][53774]
80 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
81   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
82
83 [50911]: https://github.com/rust-lang/rust/pull/50911/
84 [51363]: https://github.com/rust-lang/rust/pull/51363/
85 [51366]: https://github.com/rust-lang/rust/pull/51366/
86 [52081]: https://github.com/rust-lang/rust/pull/52081/
87 [53003]: https://github.com/rust-lang/rust/pull/53003/
88 [53033]: https://github.com/rust-lang/rust/pull/53033/
89 [53044]: https://github.com/rust-lang/rust/pull/53044/
90 [53165]: https://github.com/rust-lang/rust/pull/53165/
91 [53213]: https://github.com/rust-lang/rust/pull/53213/
92 [53236]: https://github.com/rust-lang/rust/pull/53236/
93 [53272]: https://github.com/rust-lang/rust/pull/53272/
94 [53370]: https://github.com/rust-lang/rust/pull/53370/
95 [53459]: https://github.com/rust-lang/rust/pull/53459/
96 [53774]: https://github.com/rust-lang/rust/pull/53774/
97 [53822]: https://github.com/rust-lang/rust/pull/53822/
98 [54057]: https://github.com/rust-lang/rust/pull/54057/
99 [54146]: https://github.com/rust-lang/rust/pull/54146/
100 [54404]: https://github.com/rust-lang/rust/pull/54404/
101 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
102 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
103 [cargo/5984]: https://github.com/rust-lang/cargo/pull/5984/
104 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
105 [proc-macros]: https://doc.rust-lang.org/book/2018-edition/ch19-06-macros.html
106
107 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
108 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
109 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
110 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
111 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
112 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
113 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
114 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
115 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
116 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
117
118
119 Version 1.29.2 (2018-10-11)
120 ===========================
121
122 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
123 - The `rls-preview` component on the windows-gnu targets has been restored.
124
125 [54639]: https://github.com/rust-lang/rust/pull/54639
126
127
128 Version 1.29.1 (2018-09-25)
129 ===========================
130
131 Security Notes
132 --------------
133
134 - The standard library's `str::repeat` function contained an out of bounds write
135   caused by an integer overflow. This has been fixed by deterministically
136   panicking when an overflow happens.
137
138   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
139   us.
140
141
142 Version 1.29.0 (2018-09-13)
143 ==========================
144
145 Compiler
146 --------
147 - [Bumped minimum LLVM version to 5.0.][51899]
148 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
149 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
150
151 Libraries
152 ---------
153 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
154 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
155 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
156 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
157   for `&str`.][51178]
158 - [`Cell<T>` now allows `T` to be unsized.][50494]
159 - [`SocketAddr` is now stable on Redox.][52656]
160
161 Stabilized APIs
162 ---------------
163 - [`Arc::downcast`]
164 - [`Iterator::flatten`]
165 - [`Rc::downcast`]
166
167 Cargo
168 -----
169 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
170   `--locked` to disable this behavior.
171 - [`cargo-install` will now allow you to cross compile an install
172   using `--target`.][cargo/5614]
173 - [Added the `cargo-fix` subcommand to automatically move project code from
174   2015 edition to 2018.][cargo/5723]
175 - [`cargo doc` can now optionally document private types using the
176   `--document-private-items` flag.][cargo/5543]
177
178 Misc
179 ----
180 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
181   the specified level to that level.][52354] For example `--cap-lints warn`
182   will demote `deny` and `forbid` lints to `warn`.
183 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
184   fails and `101` if there is a panic.][52197]
185 - [A preview of clippy has been made available through rustup.][51122]
186   You can install the preview with `rustup component add clippy-preview`.
187
188 Compatibility Notes
189 -------------------
190 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
191   Use `str::get_unchecked(begin..end)` instead.
192 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
193   Consider using the `home_dir` function from
194   https://crates.io/crates/dirs instead.
195 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
196 - [`cfg` attributes and `--cfg` command line flags are now more
197   strictly validated.][53893]
198
199 [53893]: https://github.com/rust-lang/rust/pull/53893/
200 [52861]: https://github.com/rust-lang/rust/pull/52861/
201 [52656]: https://github.com/rust-lang/rust/pull/52656/
202 [52239]: https://github.com/rust-lang/rust/pull/52239/
203 [52330]: https://github.com/rust-lang/rust/pull/52330/
204 [52354]: https://github.com/rust-lang/rust/pull/52354/
205 [52402]: https://github.com/rust-lang/rust/pull/52402/
206 [52103]: https://github.com/rust-lang/rust/pull/52103/
207 [52197]: https://github.com/rust-lang/rust/pull/52197/
208 [51807]: https://github.com/rust-lang/rust/pull/51807/
209 [51899]: https://github.com/rust-lang/rust/pull/51899/
210 [51912]: https://github.com/rust-lang/rust/pull/51912/
211 [51511]: https://github.com/rust-lang/rust/pull/51511/
212 [51619]: https://github.com/rust-lang/rust/pull/51619/
213 [51656]: https://github.com/rust-lang/rust/pull/51656/
214 [51178]: https://github.com/rust-lang/rust/pull/51178/
215 [51122]: https://github.com/rust-lang/rust/pull/51122
216 [50494]: https://github.com/rust-lang/rust/pull/50494/
217 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
218 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
219 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
220 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
221 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
222 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
223 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
224
225
226 Version 1.28.0 (2018-08-02)
227 ===========================
228
229 Language
230 --------
231 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
232   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
233   the inner type across Foreign Function Interface (FFI) boundaries.
234 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
235   and can now be used as identifiers.][51196]
236 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
237   stable.][51241] This will allow users to specify a global allocator for
238   their program.
239 - [Unit test functions marked with the `#[test]` attribute can now return
240   `Result<(), E: Debug>` in addition to `()`.][51298]
241 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
242   allows macros to easily target lifetimes.
243
244 Compiler
245 --------
246 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
247   prioritise making smaller binary sizes. `z` is the same as `s` with the
248   exception that it does not vectorise loops, which typically results in an even
249   smaller binary.
250 - [The short error format is now stable.][49546] Specified with
251   `--error-format=short` this option will provide a more compressed output of
252   rust error messages.
253 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
254 - [Reduced the number of allocations in the macro parser.][50855] This can
255   improve compile times of macro heavy crates on average by 5%.
256
257 Libraries
258 ---------
259 - [Implemented `Default` for `&mut str`.][51306]
260 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
261 - [Implemented `Extend` for `()`.][50234]
262 - [The `Debug` implementation of `time::Duration` should now be more easily
263   human readable.][50364] Previously a `Duration` of one second would printed as
264   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
265 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
266   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
267   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
268   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
269   for `PathBuf`.][50170]
270 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
271   and `Wrapping<i128>`.][50465]
272 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
273   possible.][51050] This can provide up to a 40% speed increase.
274 - [Improved error messages when using `format!`.][50610]
275
276 Stabilized APIs
277 ---------------
278 - [`Iterator::step_by`]
279 - [`Path::ancestors`]
280 - [`SystemTime::UNIX_EPOCH`]
281 - [`alloc::GlobalAlloc`]
282 - [`alloc::Layout`]
283 - [`alloc::LayoutErr`]
284 - [`alloc::System`]
285 - [`alloc::alloc`]
286 - [`alloc::alloc_zeroed`]
287 - [`alloc::dealloc`]
288 - [`alloc::realloc`]
289 - [`alloc::handle_alloc_error`]
290 - [`btree_map::Entry::or_default`]
291 - [`fmt::Alignment`]
292 - [`hash_map::Entry::or_default`]
293 - [`iter::repeat_with`]
294 - [`num::NonZeroUsize`]
295 - [`num::NonZeroU128`]
296 - [`num::NonZeroU16`]
297 - [`num::NonZeroU32`]
298 - [`num::NonZeroU64`]
299 - [`num::NonZeroU8`]
300 - [`ops::RangeBounds`]
301 - [`slice::SliceIndex`]
302 - [`slice::from_mut`]
303 - [`slice::from_ref`]
304 - [`{Any + Send + Sync}::downcast_mut`]
305 - [`{Any + Send + Sync}::downcast_ref`]
306 - [`{Any + Send + Sync}::is`]
307
308 Cargo
309 -----
310 - [Cargo will now no longer allow you to publish crates with build scripts that
311   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
312   considered to be immutable.
313
314 Misc
315 ----
316 - [The `suggestion_applicability` field in `rustc`'s json output is now
317   stable.][50486] This will allow dev tools to check whether a code suggestion
318   would apply to them.
319
320 Compatibility Notes
321 -------------------
322 - [Rust will consider trait objects with duplicated constraints to be the same
323   type as without the duplicated constraint.][51276] For example the below code will
324   now fail to compile.
325   ```rust
326   trait Trait {}
327
328   impl Trait + Send {
329       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
330   }
331
332   impl Trait + Send + Send {
333       fn test(&self) { println!("two"); }
334   }
335   ```
336
337 [49546]: https://github.com/rust-lang/rust/pull/49546/
338 [50143]: https://github.com/rust-lang/rust/pull/50143/
339 [50170]: https://github.com/rust-lang/rust/pull/50170/
340 [50234]: https://github.com/rust-lang/rust/pull/50234/
341 [50265]: https://github.com/rust-lang/rust/pull/50265/
342 [50364]: https://github.com/rust-lang/rust/pull/50364/
343 [50385]: https://github.com/rust-lang/rust/pull/50385/
344 [50465]: https://github.com/rust-lang/rust/pull/50465/
345 [50486]: https://github.com/rust-lang/rust/pull/50486/
346 [50554]: https://github.com/rust-lang/rust/pull/50554/
347 [50610]: https://github.com/rust-lang/rust/pull/50610/
348 [50855]: https://github.com/rust-lang/rust/pull/50855/
349 [51050]: https://github.com/rust-lang/rust/pull/51050/
350 [51196]: https://github.com/rust-lang/rust/pull/51196/
351 [51200]: https://github.com/rust-lang/rust/pull/51200/
352 [51241]: https://github.com/rust-lang/rust/pull/51241/
353 [51276]: https://github.com/rust-lang/rust/pull/51276/
354 [51298]: https://github.com/rust-lang/rust/pull/51298/
355 [51306]: https://github.com/rust-lang/rust/pull/51306/
356 [51562]: https://github.com/rust-lang/rust/pull/51562/
357 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
358 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
359 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
360 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
361 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
362 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
363 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
364 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
365 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
366 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
367 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
368 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
369 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
370 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
371 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
372 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
373 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
374 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
375 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
376 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
377 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
378 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
379 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
380 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
381 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
382 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
383 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
384 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
385 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
386 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
387
388 Version 1.27.2 (2018-07-20)
389 ===========================
390
391 Compatibility Notes
392 -------------------
393
394 - The borrow checker was fixed to avoid potential unsoundness when using
395   match ergonomics: [#52213][52213].
396
397 [52213]: https://github.com/rust-lang/rust/issues/52213
398
399 Version 1.27.1 (2018-07-10)
400 ===========================
401
402 Security Notes
403 --------------
404
405 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
406   when running, which enabled executing code as some other user on a
407   given machine. This release fixes that vulnerability; you can read
408   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
409
410   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
411
412 Compatibility Notes
413 -------------------
414
415 - The borrow checker was fixed to avoid an additional potential unsoundness when using
416   match ergonomics: [#51415][51415], [#49534][49534].
417
418 [51415]: https://github.com/rust-lang/rust/issues/51415
419 [49534]: https://github.com/rust-lang/rust/issues/49534
420 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
421 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
422
423 Version 1.27.0 (2018-06-21)
424 ==========================
425
426 Language
427 --------
428 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
429   be used as an identifier.
430 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
431   bare `Trait` syntax, and should make it clearer when being used in tandem with
432   `impl Trait` because it is equivalent to the following syntax:
433   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
434   `Box<Trait> == Box<dyn Trait>`.
435 - [Attributes on generic parameters such as types and lifetimes are
436   now stable.][48851] e.g.
437   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
438 - [The `#[must_use]` attribute can now also be used on functions as well as
439   types.][48925] It provides a lint that by default warns users when the
440   value returned by a function has not been used.
441
442 Compiler
443 --------
444 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
445
446 Libraries
447 ---------
448 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
449   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
450   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
451   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
452   the `cfg` attribute.
453 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
454   std are now available in core.][49896]
455 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
456   to `Self`.][49630]
457 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
458   that the operation isn't done in place.
459 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
460   the `#[must_use]` attribute][49533] to warn about unused potentially
461   expensive allocations.
462
463 Stabilized APIs
464 ---------------
465 - [`DoubleEndedIterator::rfind`]
466 - [`DoubleEndedIterator::rfold`]
467 - [`DoubleEndedIterator::try_rfold`]
468 - [`Duration::from_micros`]
469 - [`Duration::from_nanos`]
470 - [`Duration::subsec_micros`]
471 - [`Duration::subsec_millis`]
472 - [`HashMap::remove_entry`]
473 - [`Iterator::try_fold`]
474 - [`Iterator::try_for_each`]
475 - [`NonNull::cast`]
476 - [`Option::filter`]
477 - [`String::replace_range`]
478 - [`Take::set_limit`]
479 - [`hint::unreachable_unchecked`]
480 - [`os::unix::process::parent_id`]
481 - [`ptr::swap_nonoverlapping`]
482 - [`slice::rsplit_mut`]
483 - [`slice::rsplit`]
484 - [`slice::swap_with_slice`]
485
486 Cargo
487 -----
488 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
489   `readme`, and `repository` fields.][cargo/5386]
490 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
491 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
492   a different directory than `target` for placing compilation artifacts.
493 - [Cargo will be adding automatic target inference for binaries, benchmarks,
494   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
495   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
496   where cargo would infer a binary, Cargo will produce a warning. You can
497   disable this feature ahead of time by setting any of the following to false:
498   `autobins`, `autobenches`, `autoexamples`, `autotests`.
499 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
500   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
501
502 Misc
503 ----
504 - [Added “The Rustc book” into the official documentation.][49707]
505   [“The Rustc book”] documents and teaches how to use the rustc compiler.
506 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
507
508 Compatibility Notes
509 -------------------
510 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
511   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
512   compile, `"".is_empty()` will still compile.
513 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
514   will only print the inner type.][48553] E.g.
515   `print!("{:?}", AtomicBool::new(true))` will print `true`,
516   not `AtomicBool(true)`.
517 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
518   could enter higher numbers but they were not supported by LLVM. Up to 512MB
519   alignment should cover all use cases.
520 - The `.description()` method on the `std::error::Error` trait
521   [has been soft-deprecated][50163]. It is no longer required to implement it.
522
523 [48553]: https://github.com/rust-lang/rust/pull/48553/
524 [48851]: https://github.com/rust-lang/rust/pull/48851/
525 [48925]: https://github.com/rust-lang/rust/pull/48925/
526 [49533]: https://github.com/rust-lang/rust/pull/49533/
527 [49623]: https://github.com/rust-lang/rust/pull/49623/
528 [49630]: https://github.com/rust-lang/rust/pull/49630/
529 [49664]: https://github.com/rust-lang/rust/pull/49664/
530 [49699]: https://github.com/rust-lang/rust/pull/49699/
531 [49707]: https://github.com/rust-lang/rust/pull/49707/
532 [49719]: https://github.com/rust-lang/rust/pull/49719/
533 [49896]: https://github.com/rust-lang/rust/pull/49896/
534 [49968]: https://github.com/rust-lang/rust/pull/49968/
535 [50163]: https://github.com/rust-lang/rust/pull/50163
536 [50177]: https://github.com/rust-lang/rust/pull/50177/
537 [50378]: https://github.com/rust-lang/rust/pull/50378/
538 [50398]: https://github.com/rust-lang/rust/pull/50398/
539 [50423]: https://github.com/rust-lang/rust/pull/50423/
540 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
541 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
542 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
543 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
544 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
545 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
546 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
547 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
548 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
549 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
550 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
551 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
552 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
553 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
554 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
555 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
556 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
557 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
558 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
559 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
560 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
561 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
562 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
563 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
564 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
565 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
566 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
567 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
568 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
569 [“The Rustc book”]: https://doc.rust-lang.org/rustc
570
571
572 Version 1.26.2 (2018-06-05)
573 ==========================
574
575 Compatibility Notes
576 -------------------
577
578 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
579
580 [51117]: https://github.com/rust-lang/rust/issues/51117
581
582
583 Version 1.26.1 (2018-05-29)
584 ==========================
585
586 Tools
587 -----
588
589 - [RLS now works on Windows.][50646]
590 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
591
592
593 Compatibility Notes
594 --------
595
596 - [`fn main() -> impl Trait` no longer works for non-Termination
597   trait.][50656]
598   This reverts an accidental stabilization.
599 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
600 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
601
602 [50646]: https://github.com/rust-lang/rust/issues/50646
603 [50656]: https://github.com/rust-lang/rust/pull/50656
604 [50812]: https://github.com/rust-lang/rust/pull/50812
605 [50950]: https://github.com/rust-lang/rust/issues/50950
606 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
607
608 Version 1.26.0 (2018-05-10)
609 ==========================
610
611 Language
612 --------
613 - [Closures now implement `Copy` and/or `Clone` if all captured variables
614   implement either or both traits.][49299]
615 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
616 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
617   lifetime can be elided.][49458]
618 - [`impl Trait` is now stable allowing you to have abstract types in returns
619    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
620   `fn open(path: impl AsRef<Path>)`.
621 - [Pattern matching will now automatically apply dereferences.][49394]
622 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
623 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
624 - [A lot of operations are now available in a const context.][46882] E.g. You
625   can now index into constant arrays, reference and dereference into constants,
626   and use tuple struct constructors.
627 - [Fixed entry slice patterns are now stable.][48516] E.g.
628   ```rust
629   let points = [1, 2, 3, 4];
630   match points {
631       [1, 2, 3, 4] => println!("All points were sequential."),
632       _ => println!("Not all points were sequential."),
633   }
634   ```
635
636
637 Compiler
638 --------
639 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
640 - [Fixed exponential projection complexity on nested types.][48296]
641   This can provide up to a ~12% reduction in compile times for certain crates.
642 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
643   to remap path prefixes outputted by the compiler.
644 - [Added `powerpc-unknown-netbsd` target.][48281]
645
646 Libraries
647 ---------
648 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
649 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
650   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
651 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
652 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
653 - [`ascii::escape_default` is now available in libcore.][48735]
654 - [Trailing commas are now supported in std and core macros.][48056]
655 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
656 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
657
658 Stabilized APIs
659 ---------------
660 - [`*const T::add`]
661 - [`*const T::copy_to_nonoverlapping`]
662 - [`*const T::copy_to`]
663 - [`*const T::read_unaligned`]
664 - [`*const T::read_volatile`]
665 - [`*const T::read`]
666 - [`*const T::sub`]
667 - [`*const T::wrapping_add`]
668 - [`*const T::wrapping_sub`]
669 - [`*mut T::add`]
670 - [`*mut T::copy_to_nonoverlapping`]
671 - [`*mut T::copy_to`]
672 - [`*mut T::read_unaligned`]
673 - [`*mut T::read_volatile`]
674 - [`*mut T::read`]
675 - [`*mut T::replace`]
676 - [`*mut T::sub`]
677 - [`*mut T::swap`]
678 - [`*mut T::wrapping_add`]
679 - [`*mut T::wrapping_sub`]
680 - [`*mut T::write_bytes`]
681 - [`*mut T::write_unaligned`]
682 - [`*mut T::write_volatile`]
683 - [`*mut T::write`]
684 - [`Box::leak`]
685 - [`FromUtf8Error::as_bytes`]
686 - [`LocalKey::try_with`]
687 - [`Option::cloned`]
688 - [`btree_map::Entry::and_modify`]
689 - [`fs::read_to_string`]
690 - [`fs::read`]
691 - [`fs::write`]
692 - [`hash_map::Entry::and_modify`]
693 - [`iter::FusedIterator`]
694 - [`ops::RangeInclusive`]
695 - [`ops::RangeToInclusive`]
696 - [`process::id`]
697 - [`slice::rotate_left`]
698 - [`slice::rotate_right`]
699 - [`String::retain`]
700
701
702 Cargo
703 -----
704 - [Cargo will now output path to custom commands when `-v` is
705   passed with `--list`][cargo/5041]
706 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
707
708 Misc
709 ----
710 - [The second edition of "The Rust Programming Language" book is now recommended
711   over the first.][48404]
712
713 Compatibility Notes
714 -------------------
715
716 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
717   syntax is now invalid.
718   ```
719   use std::ops::Fn as dyn;
720   fn g(_: Box<dyn(std::fmt::Debug)>) {}
721   ```
722 - [The result of dereferences are no longer promoted to `'static`.][47408]
723   e.g.
724   ```rust
725   fn main() {
726       const PAIR: &(i32, i32) = &(0, 1);
727       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
728   }
729   ```
730 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
731 - [`".e0"` will now no longer parse as `0.0` and will instead cause
732   an error.][48235]
733 - [Removed hoedown from rustdoc.][48274]
734 - [Bounds on higher-kinded lifetimes a hard error.][48326]
735
736 [46882]: https://github.com/rust-lang/rust/pull/46882
737 [47379]: https://github.com/rust-lang/rust/pull/47379
738 [47408]: https://github.com/rust-lang/rust/pull/47408
739 [47813]: https://github.com/rust-lang/rust/pull/47813
740 [48056]: https://github.com/rust-lang/rust/pull/48056
741 [48125]: https://github.com/rust-lang/rust/pull/48125
742 [48166]: https://github.com/rust-lang/rust/pull/48166
743 [48235]: https://github.com/rust-lang/rust/pull/48235
744 [48274]: https://github.com/rust-lang/rust/pull/48274
745 [48281]: https://github.com/rust-lang/rust/pull/48281
746 [48296]: https://github.com/rust-lang/rust/pull/48296
747 [48326]: https://github.com/rust-lang/rust/pull/48326
748 [48359]: https://github.com/rust-lang/rust/pull/48359
749 [48404]: https://github.com/rust-lang/rust/pull/48404
750 [48481]: https://github.com/rust-lang/rust/pull/48481
751 [48516]: https://github.com/rust-lang/rust/pull/48516
752 [48628]: https://github.com/rust-lang/rust/pull/48628
753 [48629]: https://github.com/rust-lang/rust/pull/48629
754 [48657]: https://github.com/rust-lang/rust/pull/48657
755 [48735]: https://github.com/rust-lang/rust/pull/48735
756 [48978]: https://github.com/rust-lang/rust/pull/48978
757 [49101]: https://github.com/rust-lang/rust/pull/49101
758 [49109]: https://github.com/rust-lang/rust/pull/49109
759 [49121]: https://github.com/rust-lang/rust/pull/49121
760 [49162]: https://github.com/rust-lang/rust/pull/49162
761 [49184]: https://github.com/rust-lang/rust/pull/49184
762 [49234]: https://github.com/rust-lang/rust/pull/49234
763 [49255]: https://github.com/rust-lang/rust/pull/49255
764 [49299]: https://github.com/rust-lang/rust/pull/49299
765 [49305]: https://github.com/rust-lang/rust/pull/49305
766 [49394]: https://github.com/rust-lang/rust/pull/49394
767 [49458]: https://github.com/rust-lang/rust/pull/49458
768 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
769 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
770 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
771 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
772 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
773 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
774 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
775 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
776 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
777 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
778 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
779 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
780 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
781 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
782 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
783 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
784 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
785 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
786 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
787 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
788 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
789 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
790 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
791 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
792 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
793 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
794 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
795 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
796 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
797 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
798 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
799 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
800 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
801 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
802 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
803 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
804 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
805 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
806 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
807 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
808 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
809 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
810
811
812 Version 1.25.0 (2018-03-29)
813 ==========================
814
815 Language
816 --------
817 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
818 - [You can now use nested groups of imports.][47948]
819   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
820 - [You can now have `|` at the start of a match arm.][47947] e.g.
821 ```rust
822 enum Foo { A, B, C }
823
824 fn main() {
825     let x = Foo::A;
826     match x {
827         | Foo::A
828         | Foo::B => println!("AB"),
829         | Foo::C => println!("C"),
830     }
831 }
832 ```
833
834 Compiler
835 --------
836 - [Upgraded to LLVM 6.][47828]
837 - [Added `-C lto=val` option.][47521]
838 - [Added `i586-unknown-linux-musl` target][47282]
839
840 Libraries
841 ---------
842 - [Impl Send for `process::Command` on Unix.][47760]
843 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
844 - [`UnsafeCell::into_inner` is now safe.][47204]
845 - [Implement libstd for CloudABI.][47268]
846 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
847 - [Implement `AsRef<Path>` for Component][46985]
848 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
849 - [Moved `Duration` to libcore.][46666]
850
851 Stabilized APIs
852 ---------------
853 - [`Location::column`]
854 - [`ptr::NonNull`]
855
856 The following functions can now be used in a constant expression.
857 eg. `static MINUTE: Duration = Duration::from_secs(60);`
858 - [`Duration::new`][47300]
859 - [`Duration::from_secs`][47300]
860 - [`Duration::from_millis`][47300]
861
862 Cargo
863 -----
864 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
865 - [`cargo new` now defaults to creating a binary crate, instead of a
866   library crate.][cargo/5029]
867
868 Misc
869 ----
870 - [Rust by example is now shipped with new releases][46196]
871
872 Compatibility Notes
873 -------------------
874 - [Deprecated `net::lookup_host`.][47510]
875 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
876 - The borrow checker was sometimes incorrectly permitting overlapping borrows
877   around indexing operations (see [#47349][47349]). This has been fixed (which also
878   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
879 - [Removed deprecated unstable attribute `#[simd]`.][47251]
880
881 [33903]: https://github.com/rust-lang/rust/pull/33903
882 [47947]: https://github.com/rust-lang/rust/pull/47947
883 [47948]: https://github.com/rust-lang/rust/pull/47948
884 [47760]: https://github.com/rust-lang/rust/pull/47760
885 [47790]: https://github.com/rust-lang/rust/pull/47790
886 [47828]: https://github.com/rust-lang/rust/pull/47828
887 [47398]: https://github.com/rust-lang/rust/pull/47398
888 [47510]: https://github.com/rust-lang/rust/pull/47510
889 [47521]: https://github.com/rust-lang/rust/pull/47521
890 [47204]: https://github.com/rust-lang/rust/pull/47204
891 [47251]: https://github.com/rust-lang/rust/pull/47251
892 [47268]: https://github.com/rust-lang/rust/pull/47268
893 [47282]: https://github.com/rust-lang/rust/pull/47282
894 [47300]: https://github.com/rust-lang/rust/pull/47300
895 [47349]: https://github.com/rust-lang/rust/pull/47349
896 [46931]: https://github.com/rust-lang/rust/pull/46931
897 [46985]: https://github.com/rust-lang/rust/pull/46985
898 [47006]: https://github.com/rust-lang/rust/pull/47006
899 [46830]: https://github.com/rust-lang/rust/pull/46830
900 [46095]: https://github.com/rust-lang/rust/pull/46095
901 [46666]: https://github.com/rust-lang/rust/pull/46666
902 [46196]: https://github.com/rust-lang/rust/pull/46196
903 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
904 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
905 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
906 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
907 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
908
909
910 Version 1.24.1 (2018-03-01)
911 ==========================
912
913  - [Do not abort when unwinding through FFI][48251]
914  - [Emit UTF-16 files for linker arguments on Windows][48318]
915  - [Make the error index generator work again][48308]
916  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
917
918 [48251]: https://github.com/rust-lang/rust/issues/48251
919 [48308]: https://github.com/rust-lang/rust/issues/48308
920 [48318]: https://github.com/rust-lang/rust/issues/48318
921 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
922
923
924 Version 1.24.0 (2018-02-15)
925 ==========================
926
927 Language
928 --------
929 - [External `sysv64` ffi is now available.][46528]
930   eg. `extern "sysv64" fn foo () {}`
931
932 Compiler
933 --------
934 - [rustc now uses 16 codegen units by default for release builds.][46910]
935   For the fastest builds, utilize `codegen-units=1`.
936 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
937 - [Add `aarch64-unknown-openbsd` support][46760]
938
939 Libraries
940 ---------
941 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
942   improvement in performance in the majority of cases.
943 - [`OsStr`'s `Debug` implementation is now lossless and consistent
944   with Windows.][46798]
945 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
946 - [impl `From<bool>` for `AtomicBool`][46293]
947 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
948 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
949 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
950 - [float::from_bits now just uses transmute.][46012] This provides
951   some optimisations from LLVM.
952 - [Copied `AsciiExt` methods onto `char`][46077]
953 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
954 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
955 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
956 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
957
958 Stabilized APIs
959 ---------------
960 - [`RefCell::replace`]
961 - [`RefCell::swap`]
962 - [`atomic::spin_loop_hint`]
963
964 The following functions can now be used in a constant expression.
965 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
966
967 - [`AtomicBool::new`][46287]
968 - [`AtomicUsize::new`][46287]
969 - [`AtomicIsize::new`][46287]
970 - [`AtomicPtr::new`][46287]
971 - [`Cell::new`][46287]
972 - [`{integer}::min_value`][46287]
973 - [`{integer}::max_value`][46287]
974 - [`mem::size_of`][46287]
975 - [`mem::align_of`][46287]
976 - [`ptr::null`][46287]
977 - [`ptr::null_mut`][46287]
978 - [`RefCell::new`][46287]
979 - [`UnsafeCell::new`][46287]
980
981 Cargo
982 -----
983 - [Added a `workspace.default-members` config that
984   overrides implied `--all` in virtual workspaces.][cargo/4743]
985 - [Enable incremental by default on development builds.][cargo/4817] Also added
986   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
987   per-project or global basis respectively.
988
989 Misc
990 ----
991
992 Compatibility Notes
993 -------------------
994 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
995 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
996   in accordance with IETF RFC 4291 §2.2.
997 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
998 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
999   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1000 - [Leading zeros in tuple struct members is now an error][47084]
1001 - [`column!()` macro is one-based instead of zero-based][46977]
1002 - [`fmt::Arguments` can no longer be shared across threads][45198]
1003 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1004 - [Cargo sets a different working directory for the compiler][cargo/4788]
1005
1006 [44884]: https://github.com/rust-lang/rust/pull/44884
1007 [45198]: https://github.com/rust-lang/rust/pull/45198
1008 [45506]: https://github.com/rust-lang/rust/pull/45506
1009 [45904]: https://github.com/rust-lang/rust/pull/45904
1010 [45990]: https://github.com/rust-lang/rust/pull/45990
1011 [46012]: https://github.com/rust-lang/rust/pull/46012
1012 [46077]: https://github.com/rust-lang/rust/pull/46077
1013 [46094]: https://github.com/rust-lang/rust/pull/46094
1014 [46284]: https://github.com/rust-lang/rust/pull/46284
1015 [46287]: https://github.com/rust-lang/rust/pull/46287
1016 [46293]: https://github.com/rust-lang/rust/pull/46293
1017 [46528]: https://github.com/rust-lang/rust/pull/46528
1018 [46671]: https://github.com/rust-lang/rust/pull/46671
1019 [46713]: https://github.com/rust-lang/rust/pull/46713
1020 [46735]: https://github.com/rust-lang/rust/pull/46735
1021 [46749]: https://github.com/rust-lang/rust/pull/46749
1022 [46760]: https://github.com/rust-lang/rust/pull/46760
1023 [46798]: https://github.com/rust-lang/rust/pull/46798
1024 [46828]: https://github.com/rust-lang/rust/pull/46828
1025 [46831]: https://github.com/rust-lang/rust/pull/46831
1026 [46833]: https://github.com/rust-lang/rust/pull/46833
1027 [46910]: https://github.com/rust-lang/rust/pull/46910
1028 [46977]: https://github.com/rust-lang/rust/pull/46977
1029 [47018]: https://github.com/rust-lang/rust/pull/47018
1030 [47080]: https://github.com/rust-lang/rust/pull/47080
1031 [47084]: https://github.com/rust-lang/rust/pull/47084
1032 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1033 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1034 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1035 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1036 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1037 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1038
1039
1040 Version 1.23.0 (2018-01-04)
1041 ==========================
1042
1043 Language
1044 --------
1045 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1046 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1047   Which should fix some confusing errors in some operations.
1048
1049 Compiler
1050 --------
1051 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1052   undefined behavior.][45920]
1053 - [rustc now suggests renaming import if names clash.][45660]
1054 - [Display errors/warnings correctly when there are zero-width or
1055   wide characters.][45711]
1056 - [rustc now avoids unnecessary copies of arguments that are
1057   simple bindings][45380] This should improve memory usage on average by 5-10%.
1058 - [Updated musl used to build musl rustc to 1.1.17][45393]
1059
1060 Libraries
1061 ---------
1062 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1063 - [Implement Hash for raw pointers to unsized types][45483]
1064 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1065 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1066 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1067 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1068   and `<*mut T>::as_mut`][44932]
1069 - [Optimized `Thread::{park, unpark}` implementation][45524]
1070 - [Improved `SliceExt::binary_search` performance.][45333]
1071 - [impl `FromIterator<()>` for `()`][45379]
1072 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1073   is now deprecated.
1074
1075 Stabilized APIs
1076 ---------------
1077
1078 Cargo
1079 -----
1080 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1081   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1082 - [Added unit test checking to `cargo check`][cargo/4592]
1083 - [Cargo now lets you install a specific version
1084   using `cargo install --version`][cargo/4637]
1085
1086 Misc
1087 ----
1088 - [Releases now ship with the Cargo book documentation.][45692]
1089 - [rustdoc now prints rendering warnings on every run.][45324]
1090
1091 Compatibility Notes
1092 -------------------
1093 - [Changes have been made to type equality to make it more correct,
1094   in rare cases this could break some code.][45853] [Tracking issue for
1095   further information][45852]
1096 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1097 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1098   Android 9, the minimum supported version is Android 14.
1099 - [Bumped the minimum LLVM to 3.9][45326]
1100
1101 [44042]: https://github.com/rust-lang/rust/pull/44042
1102 [44932]: https://github.com/rust-lang/rust/pull/44932
1103 [45267]: https://github.com/rust-lang/rust/pull/45267
1104 [45324]: https://github.com/rust-lang/rust/pull/45324
1105 [45326]: https://github.com/rust-lang/rust/pull/45326
1106 [45333]: https://github.com/rust-lang/rust/pull/45333
1107 [45379]: https://github.com/rust-lang/rust/pull/45379
1108 [45380]: https://github.com/rust-lang/rust/pull/45380
1109 [45393]: https://github.com/rust-lang/rust/pull/45393
1110 [45435]: https://github.com/rust-lang/rust/pull/45435
1111 [45483]: https://github.com/rust-lang/rust/pull/45483
1112 [45524]: https://github.com/rust-lang/rust/pull/45524
1113 [45571]: https://github.com/rust-lang/rust/pull/45571
1114 [45580]: https://github.com/rust-lang/rust/pull/45580
1115 [45610]: https://github.com/rust-lang/rust/pull/45610
1116 [45660]: https://github.com/rust-lang/rust/pull/45660
1117 [45692]: https://github.com/rust-lang/rust/pull/45692
1118 [45711]: https://github.com/rust-lang/rust/pull/45711
1119 [45772]: https://github.com/rust-lang/rust/pull/45772
1120 [45852]: https://github.com/rust-lang/rust/issues/45852
1121 [45853]: https://github.com/rust-lang/rust/pull/45853
1122 [45887]: https://github.com/rust-lang/rust/pull/45887
1123 [45920]: https://github.com/rust-lang/rust/pull/45920
1124 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1125 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1126 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1127
1128
1129 Version 1.22.1 (2017-11-22)
1130 ==========================
1131
1132 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1133
1134 [46183]: https://github.com/rust-lang/rust/pull/46183
1135
1136 Version 1.22.0 (2017-11-22)
1137 ==========================
1138
1139 Language
1140 --------
1141 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1142 - [Now accepts underscores in unicode escapes][43716]
1143 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1144 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1145
1146 Compiler
1147 --------
1148 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1149 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1150   This should decrease compile times for debug builds.
1151 - [strict memory alignment now enabled on ARMv6][45094]
1152 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1153
1154 Libraries
1155 ---------
1156 - [Allow atomic operations up to 32 bits
1157   on `armv5te_unknown_linux_gnueabi`][44978]
1158 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1159 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1160 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1161 - [Properly detect overflow in `Instant += Duration`.][44220]
1162 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1163 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1164 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1165
1166 Stabilized APIs
1167 ---------------
1168
1169 Cargo
1170 -----
1171 - [Cargo will now build multi file examples in subdirectories of the `examples`
1172   folder that have a `main.rs` file.][cargo/4496]
1173 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1174   the old format will continue to work and can be updated with `cargo update`.
1175 - [Now supports vendoring git repositories][cargo/3992]
1176
1177 Misc
1178 ----
1179 - [`libbacktrace` is now available on Apple platforms.][44251]
1180 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1181   This now lets you specify that a given code example will fail to compile.
1182
1183 Compatibility Notes
1184 -------------------
1185 - [The minimum Android version that rustc can build for has been bumped
1186   to `4.0` from `2.3`][45656]
1187 - [Allowing `T op= &T` for numeric types has broken some type
1188   inference cases][45480]
1189
1190
1191 [42526]: https://github.com/rust-lang/rust/pull/42526
1192 [43017]: https://github.com/rust-lang/rust/pull/43017
1193 [43716]: https://github.com/rust-lang/rust/pull/43716
1194 [43949]: https://github.com/rust-lang/rust/pull/43949
1195 [44015]: https://github.com/rust-lang/rust/pull/44015
1196 [44220]: https://github.com/rust-lang/rust/pull/44220
1197 [44251]: https://github.com/rust-lang/rust/pull/44251
1198 [44287]: https://github.com/rust-lang/rust/pull/44287
1199 [44303]: https://github.com/rust-lang/rust/pull/44303
1200 [44456]: https://github.com/rust-lang/rust/pull/44456
1201 [44466]: https://github.com/rust-lang/rust/pull/44466
1202 [44895]: https://github.com/rust-lang/rust/pull/44895
1203 [44966]: https://github.com/rust-lang/rust/pull/44966
1204 [44978]: https://github.com/rust-lang/rust/pull/44978
1205 [45041]: https://github.com/rust-lang/rust/pull/45041
1206 [45064]: https://github.com/rust-lang/rust/pull/45064
1207 [45075]: https://github.com/rust-lang/rust/pull/45075
1208 [45094]: https://github.com/rust-lang/rust/pull/45094
1209 [45095]: https://github.com/rust-lang/rust/pull/45095
1210 [45480]: https://github.com/rust-lang/rust/issues/45480
1211 [45656]: https://github.com/rust-lang/rust/pull/45656
1212 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1213 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1214 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1215
1216
1217
1218
1219
1220
1221 Version 1.21.0 (2017-10-12)
1222 ==========================
1223
1224 Language
1225 --------
1226 - [You can now use static references for literals.][43838]
1227   Example:
1228   ```rust
1229   fn main() {
1230       let x: &'static u32 = &0;
1231   }
1232   ```
1233 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1234   Example:
1235   ```rust
1236   my_macro!(Vec<i32>::new); // Always worked
1237   my_macro!(Vec::<i32>::new); // Now works
1238   ```
1239
1240 Compiler
1241 --------
1242 - [Upgraded jemalloc to 4.5.0][43911]
1243 - [Enabled unwinding panics on Redox][43917]
1244 - [Now runs LLVM in parallel during translation phase.][43506]
1245   This should reduce peak memory usage.
1246
1247 Libraries
1248 ---------
1249 - [Generate builtin impls for `Clone` for all arrays and tuples that
1250   are `T: Clone`][43690]
1251 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1252 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1253   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1254
1255 Stabilized APIs
1256 ---------------
1257
1258 [`std::mem::discriminant`]
1259
1260 Cargo
1261 -----
1262 - [You can now call `cargo install` with multiple package names][cargo/4216]
1263 - [Cargo commands inside a virtual workspace will now implicitly
1264   pass `--all`][cargo/4335]
1265 - [Added a `[patch]` section to `Cargo.toml` to handle
1266   prepublication dependencies][cargo/4123] [RFC 1969]
1267 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1268   like patterns][cargo/4270]
1269 - [Added the `--all-targets` option][cargo/4400]
1270 - [Using required dependencies as a feature is now deprecated and emits
1271   a warning][cargo/4364]
1272
1273
1274 Misc
1275 ----
1276 - [Cargo docs are moving][43916]
1277   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1278 - [The rustdoc book is now available][43863]
1279   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1280 - [Added a preview of RLS has been made available through rustup][44204]
1281   Install with `rustup component add rls-preview`
1282 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1283   Previously only showed `std::os::unix`.
1284
1285 Compatibility Notes
1286 -------------------
1287 - [Changes in method matching against higher-ranked types][43880] This may cause
1288   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1289 - [rustc's JSON error output's byte position start at top of file.][42973]
1290   Was previously relative to the rustc's internal `CodeMap` struct which
1291   required the unstable library `libsyntax` to correctly use.
1292 - [`unused_results` lint no longer ignores booleans][43728]
1293
1294 [42565]: https://github.com/rust-lang/rust/pull/42565
1295 [42973]: https://github.com/rust-lang/rust/pull/42973
1296 [43348]: https://github.com/rust-lang/rust/pull/43348
1297 [43459]: https://github.com/rust-lang/rust/pull/43459
1298 [43506]: https://github.com/rust-lang/rust/pull/43506
1299 [43540]: https://github.com/rust-lang/rust/pull/43540
1300 [43690]: https://github.com/rust-lang/rust/pull/43690
1301 [43728]: https://github.com/rust-lang/rust/pull/43728
1302 [43838]: https://github.com/rust-lang/rust/pull/43838
1303 [43863]: https://github.com/rust-lang/rust/pull/43863
1304 [43880]: https://github.com/rust-lang/rust/pull/43880
1305 [43911]: https://github.com/rust-lang/rust/pull/43911
1306 [43916]: https://github.com/rust-lang/rust/pull/43916
1307 [43917]: https://github.com/rust-lang/rust/pull/43917
1308 [44204]: https://github.com/rust-lang/rust/pull/44204
1309 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1310 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1311 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1312 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1313 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1314 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1315 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1316 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1317 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1318
1319 Version 1.20.0 (2017-08-31)
1320 ===========================
1321
1322 Language
1323 --------
1324 - [Associated constants are now stabilised.][42809]
1325 - [A lot of macro bugs are now fixed.][42913]
1326
1327 Compiler
1328 --------
1329
1330 - [Struct fields are now properly coerced to the expected field type.][42807]
1331 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1332   `wasm32-experimental-emscripten` target.
1333 - [Changed some of the error messages to be more helpful.][42033]
1334 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1335   it.][43170]
1336 - [rustc now reports the total number of errors on compilation failure][43015]
1337   previously this was only the number of errors in the pass that failed.
1338 - [Expansion in rustc has been sped up 29x.][42533]
1339 - [added `msp430-none-elf` target.][43099]
1340 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1341   applicable][43178]
1342 - [Fixes backtraces on Redox][43228]
1343 - [rustc now identifies different versions of same crate when absolute paths of
1344   different types match in an error message.][42826]
1345
1346 Libraries
1347 ---------
1348
1349
1350 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1351 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1352   tuples.][43011]
1353 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1354   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1355 - [Impl `Clone` for `DefaultHasher`.][42799]
1356 - [Impl `Sync` for `SyncSender`.][42397]
1357 - [Impl `FromStr` for `char`][42271]
1358 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1359   NaN.][42431]
1360 - [allow messages in the `unimplemented!()` macro.][42155]
1361   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1362 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1363 - [Upgrade to Unicode 10.0.0][42999]
1364 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1365 - [Skip the main thread's manual stack guard on Linux][43072]
1366 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1367 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1368   previously 2^15.
1369 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1370
1371 Stabilized APIs
1372 ---------------
1373
1374 - [`CStr::into_c_string`]
1375 - [`CString::as_c_str`]
1376 - [`CString::into_boxed_c_str`]
1377 - [`Chain::get_mut`]
1378 - [`Chain::get_ref`]
1379 - [`Chain::into_inner`]
1380 - [`Option::get_or_insert_with`]
1381 - [`Option::get_or_insert`]
1382 - [`OsStr::into_os_string`]
1383 - [`OsString::into_boxed_os_str`]
1384 - [`Take::get_mut`]
1385 - [`Take::get_ref`]
1386 - [`Utf8Error::error_len`]
1387 - [`char::EscapeDebug`]
1388 - [`char::escape_debug`]
1389 - [`compile_error!`]
1390 - [`f32::from_bits`]
1391 - [`f32::to_bits`]
1392 - [`f64::from_bits`]
1393 - [`f64::to_bits`]
1394 - [`mem::ManuallyDrop`]
1395 - [`slice::sort_unstable_by_key`]
1396 - [`slice::sort_unstable_by`]
1397 - [`slice::sort_unstable`]
1398 - [`str::from_boxed_utf8_unchecked`]
1399 - [`str::as_bytes_mut`]
1400 - [`str::as_bytes_mut`]
1401 - [`str::from_utf8_mut`]
1402 - [`str::from_utf8_unchecked_mut`]
1403 - [`str::get_mut`]
1404 - [`str::get_unchecked_mut`]
1405 - [`str::get_unchecked`]
1406 - [`str::get`]
1407 - [`str::into_boxed_bytes`]
1408
1409
1410 Cargo
1411 -----
1412 - [Cargo API token location moved from `~/.cargo/config` to
1413   `~/.cargo/credentials`.][cargo/3978]
1414 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1415   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1416   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1417 - [You can now specify version of a binary when installed through
1418   `cargo install` using `--vers`.][cargo/4229]
1419 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1420   failure.][cargo/4248]
1421 - [Changed the convention around which file is the crate root.][cargo/4259]
1422 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1423   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1424
1425 Compatibility Notes
1426 -------------------
1427
1428 - [Functions with `'static` in their return types will now not be as usable as
1429   if they were using lifetime parameters instead.][42417]
1430 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1431   takes the sign of NaN into account where previously didn't.][42430]
1432
1433 [42033]: https://github.com/rust-lang/rust/pull/42033
1434 [42155]: https://github.com/rust-lang/rust/pull/42155
1435 [42271]: https://github.com/rust-lang/rust/pull/42271
1436 [42397]: https://github.com/rust-lang/rust/pull/42397
1437 [42417]: https://github.com/rust-lang/rust/pull/42417
1438 [42430]: https://github.com/rust-lang/rust/pull/42430
1439 [42431]: https://github.com/rust-lang/rust/pull/42431
1440 [42533]: https://github.com/rust-lang/rust/pull/42533
1441 [42571]: https://github.com/rust-lang/rust/pull/42571
1442 [42613]: https://github.com/rust-lang/rust/pull/42613
1443 [42799]: https://github.com/rust-lang/rust/pull/42799
1444 [42807]: https://github.com/rust-lang/rust/pull/42807
1445 [42809]: https://github.com/rust-lang/rust/pull/42809
1446 [42822]: https://github.com/rust-lang/rust/pull/42822
1447 [42826]: https://github.com/rust-lang/rust/pull/42826
1448 [42854]: https://github.com/rust-lang/rust/pull/42854
1449 [42913]: https://github.com/rust-lang/rust/pull/42913
1450 [42999]: https://github.com/rust-lang/rust/pull/42999
1451 [43011]: https://github.com/rust-lang/rust/pull/43011
1452 [43015]: https://github.com/rust-lang/rust/pull/43015
1453 [43072]: https://github.com/rust-lang/rust/pull/43072
1454 [43077]: https://github.com/rust-lang/rust/pull/43077
1455 [43097]: https://github.com/rust-lang/rust/pull/43097
1456 [43099]: https://github.com/rust-lang/rust/pull/43099
1457 [43170]: https://github.com/rust-lang/rust/pull/43170
1458 [43178]: https://github.com/rust-lang/rust/pull/43178
1459 [43185]: https://github.com/rust-lang/rust/pull/43185
1460 [43228]: https://github.com/rust-lang/rust/pull/43228
1461 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1462 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1463 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1464 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1465 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1466 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1467 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1468 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1469 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1470 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1471 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1472 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1473 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1474 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1475 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1476 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1477 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1478 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1479 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1480 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1481 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1482 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1483 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1484 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1485 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1486 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1487 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1488 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1489 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1490 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1491 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1492 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1493 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1494 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1495 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1496 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1497 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1498 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1499 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1500
1501
1502 Version 1.19.0 (2017-07-20)
1503 ===========================
1504
1505 Language
1506 --------
1507
1508 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1509   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1510 - [Macro recursion limit increased to 1024 from 64.][41676]
1511 - [Added lint for detecting unused macros.][41907]
1512 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1513   For example: `let x = loop { break 7; };`
1514 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1515   contain `Copy` types and cannot have a `Drop` implementation.
1516   Example: `union Foo { bar: u8, baz: usize }`
1517 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1518   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1519
1520 Compiler
1521 --------
1522
1523 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1524 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1525   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1526   you should use `--target armv7-linux-androideabi`.
1527 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1528 - [Minor optimisation of string operations.][42037]
1529 - [Compiler error message is now `aborting due to previous error(s)` instead of
1530   `aborting due to N previous errors`][42150] This was previously inaccurate and
1531   would only count certain kinds of errors.
1532 - [The compiler now supports Visual Studio 2017][42225]
1533 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1534 - [Added a lot][42264] of [new error codes][42302]
1535 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1536   libraries with C Run-time Libraries(CRT) to be statically linked.
1537 - [Fixed various ARM codegen bugs][42740]
1538
1539 Libraries
1540 ---------
1541
1542 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1543   `Extend<Cow<'a, str>>`][41449]
1544 - [`Vec` now implements `From<&mut [T]>`][41530]
1545 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1546 - [`SplitWhitespace` now implements `Clone`][41659]
1547 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1548   1.5x faster][41764]
1549 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1550   macros, but for printing to stderr.
1551
1552 Stabilized APIs
1553 ---------------
1554
1555 - [`OsString::shrink_to_fit`]
1556 - [`cmp::Reverse`]
1557 - [`Command::envs`]
1558 - [`thread::ThreadId`]
1559
1560 Cargo
1561 -----
1562
1563 - [Build scripts can now add environment variables to the environment
1564   the crate is being compiled in.
1565   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1566 - [Subcommands now replace the current process rather than spawning a new
1567   child process][cargo/3970]
1568 - [Workspace members can now accept glob file patterns][cargo/3979]
1569 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1570   the members in a given workspace.][cargo/3988]
1571 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1572 - [Target directory path is now in the cargo metadata][cargo/4022]
1573 - [Cargo no longer checks out a local working directory for the
1574   crates.io index][cargo/4026] This should provide smaller file size for the
1575   registry, and improve cloning times, especially on Windows machines.
1576 - [Added an `--exclude` option for excluding certain packages when using the
1577   `--all` option][cargo/4031]
1578 - [Cargo will now automatically retry when receiving a 5xx error
1579   from crates.io][cargo/4032]
1580 - [The `--features` option now accepts multiple comma or space
1581   delimited values.][cargo/4084]
1582 - [Added support for custom target specific runners][cargo/3954]
1583
1584 Misc
1585 ----
1586
1587 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1588   Windows Debugger.
1589 - [Rust will now release XZ compressed packages][rust-installer/57]
1590 - [rustup will now prefer to download rust packages with
1591   XZ compression][rustup/1100] over GZip packages.
1592 - [Added the ability to escape `#` in rust documentation][41785] By adding
1593   additional `#`'s ie. `##` is now `#`
1594
1595 Compatibility Notes
1596 -------------------
1597
1598 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1599 - [`-Z` flags are now no longer allowed to be used on the stable
1600   compiler.][41751] This has been a warning for a year previous to this.
1601 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1602   longer works][42844]. Users should migrate to the built-in `check`
1603   command, which has been available since 1.16.
1604 - [Ending a float literal with `._` is now a hard error.
1605   Example: `42._` .][41946]
1606 - [Any use of a private `extern crate` outside of its module is now a
1607   hard error.][36886] This was previously a warning.
1608 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1609   relative while the `::` prefix makes a path absolute, but was ignored and the
1610   path was relative regardless.
1611 - [Floating point constants in match patterns is now a hard error][36890]
1612   This was previously a warning.
1613 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1614   match patterns is now a hard error][36891] This was previously a warning.
1615 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1616   a warning.
1617 - [From the pound escape, lines consisting of multiple `#`s are
1618   now visible][41785]
1619 - [It is an error to re-export private enum variants][42460]. This is
1620   known to break a number of crates that depend on an older version of
1621   mustache.
1622 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1623   to use it to find the linker, and the build will fail where it did
1624   not previously][42607]
1625
1626 [36886]: https://github.com/rust-lang/rust/issues/36886
1627 [36888]: https://github.com/rust-lang/rust/issues/36888
1628 [36890]: https://github.com/rust-lang/rust/issues/36890
1629 [36891]: https://github.com/rust-lang/rust/issues/36891
1630 [36892]: https://github.com/rust-lang/rust/issues/36892
1631 [37406]: https://github.com/rust-lang/rust/issues/37406
1632 [39983]: https://github.com/rust-lang/rust/pull/39983
1633 [41145]: https://github.com/rust-lang/rust/pull/41145
1634 [41192]: https://github.com/rust-lang/rust/pull/41192
1635 [41258]: https://github.com/rust-lang/rust/pull/41258
1636 [41370]: https://github.com/rust-lang/rust/pull/41370
1637 [41449]: https://github.com/rust-lang/rust/pull/41449
1638 [41530]: https://github.com/rust-lang/rust/pull/41530
1639 [41624]: https://github.com/rust-lang/rust/pull/41624
1640 [41656]: https://github.com/rust-lang/rust/pull/41656
1641 [41659]: https://github.com/rust-lang/rust/pull/41659
1642 [41676]: https://github.com/rust-lang/rust/pull/41676
1643 [41751]: https://github.com/rust-lang/rust/pull/41751
1644 [41764]: https://github.com/rust-lang/rust/pull/41764
1645 [41785]: https://github.com/rust-lang/rust/pull/41785
1646 [41873]: https://github.com/rust-lang/rust/pull/41873
1647 [41907]: https://github.com/rust-lang/rust/pull/41907
1648 [41946]: https://github.com/rust-lang/rust/pull/41946
1649 [42016]: https://github.com/rust-lang/rust/pull/42016
1650 [42037]: https://github.com/rust-lang/rust/pull/42037
1651 [42068]: https://github.com/rust-lang/rust/pull/42068
1652 [42150]: https://github.com/rust-lang/rust/pull/42150
1653 [42162]: https://github.com/rust-lang/rust/pull/42162
1654 [42225]: https://github.com/rust-lang/rust/pull/42225
1655 [42264]: https://github.com/rust-lang/rust/pull/42264
1656 [42302]: https://github.com/rust-lang/rust/pull/42302
1657 [42460]: https://github.com/rust-lang/rust/issues/42460
1658 [42607]: https://github.com/rust-lang/rust/issues/42607
1659 [42740]: https://github.com/rust-lang/rust/pull/42740
1660 [42844]: https://github.com/rust-lang/rust/issues/42844
1661 [42948]: https://github.com/rust-lang/rust/pull/42948
1662 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1663 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1664 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1665 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1666 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1667 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1668 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1669 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1670 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1671 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1672 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1673 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1674 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1675 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1676 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1677 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1678 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1679 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1680 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1681 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1682 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1683 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1684
1685
1686 Version 1.18.0 (2017-06-08)
1687 ===========================
1688
1689 Language
1690 --------
1691
1692 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1693   make the item visible to just that module tree. Also accepts the keyword
1694   `crate` to make something public to the whole crate but not users of the
1695   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1696 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1697   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1698 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1699   types like `Write + Send`, trailing `+` are now supported in trait objects,
1700   and better error reporting for trait objects starting with `?Sized`.
1701 - [0e+10 is now a valid floating point literal][40589]
1702 - [Now warns if you bind a lifetime parameter to 'static][40734]
1703 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1704   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1705   representation in some cases.][40377]
1706
1707 Compiler
1708 --------
1709
1710 - [rustc can now emit mir with `--emit mir`][39891]
1711 - [Improved LLVM IR for trivial functions][40367]
1712 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1713 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1714   opportunities found through profiling
1715 - [Improved backtrace formatting when panicking][38165]
1716
1717 Libraries
1718 ---------
1719
1720 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1721   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1722   iteration or reallocation.
1723 - [Simplified HashMap Bucket interface][40561] provides performance
1724   improvements for iterating and cloning.
1725 - [Specialize Vec::from_elem to use calloc][40409]
1726 - [Fixed Race condition in fs::create_dir_all][39799]
1727 - [No longer caching stdio on Windows][40516]
1728 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1729   2.50%~ faster and in one case now 12.50% faster.
1730 - [Optimized `AtomicBool::fetch_nand`][41143]
1731
1732 Stabilized APIs
1733 ---------------
1734
1735 - [`Child::try_wait`]
1736 - [`HashMap::retain`]
1737 - [`HashSet::retain`]
1738 - [`PeekMut::pop`]
1739 - [`TcpStream::peek`]
1740 - [`UdpSocket::peek`]
1741 - [`UdpSocket::peek_from`]
1742
1743 Cargo
1744 -----
1745
1746 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1747   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1748 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1749 - [Added Android build support][cargo/3885]
1750 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1751   of a certain type, for example `cargo build --bins` will build all
1752   binaries.
1753 - [Added support for haiku][cargo/3952]
1754
1755 Misc
1756 ----
1757
1758 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1759 - [Added rust-windbg script for better debugging on Windows][39983]
1760 - [Rust now uses the official cross compiler for NetBSD][40612]
1761 - [rustdoc now accepts `#` at the start of files][40828]
1762 - [Fixed jemalloc support for musl][41168]
1763
1764 Compatibility Notes
1765 -------------------
1766
1767 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1768   always placed after the sign if it exists and before the digits. With the `#`
1769   flag the zeroes are placed after the prefix and before the digits.
1770 - [Due to the struct field optimisation][40377], using `transmute` on structs
1771   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1772   always been undefined behavior, but is now more likely to break in practice.
1773 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1774   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1775   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1776 - [Overlapping inherent `impl`s are now a hard error][40728]
1777 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1778 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1779   `out.asm` and `out.ll` instead of only one of the filetypes.
1780 - [ calling a function that returns `Self` will no longer work][41805] when
1781   the size of `Self` cannot be statically determined.
1782 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1783   this has caused a few regressions namely:
1784
1785   - Changed the link order of local static/dynamic libraries (respecting the
1786     order on given rather than having the compiler reorder).
1787   - Changed how MinGW is linked, native code linked to dynamic libraries
1788     may require manually linking to the gcc support library (for the native
1789     code itself)
1790
1791 [38165]: https://github.com/rust-lang/rust/pull/38165
1792 [39799]: https://github.com/rust-lang/rust/pull/39799
1793 [39891]: https://github.com/rust-lang/rust/pull/39891
1794 [39983]: https://github.com/rust-lang/rust/pull/39983
1795 [40043]: https://github.com/rust-lang/rust/pull/40043
1796 [40241]: https://github.com/rust-lang/rust/pull/40241
1797 [40338]: https://github.com/rust-lang/rust/pull/40338
1798 [40367]: https://github.com/rust-lang/rust/pull/40367
1799 [40377]: https://github.com/rust-lang/rust/pull/40377
1800 [40409]: https://github.com/rust-lang/rust/pull/40409
1801 [40516]: https://github.com/rust-lang/rust/pull/40516
1802 [40556]: https://github.com/rust-lang/rust/pull/40556
1803 [40561]: https://github.com/rust-lang/rust/pull/40561
1804 [40589]: https://github.com/rust-lang/rust/pull/40589
1805 [40612]: https://github.com/rust-lang/rust/pull/40612
1806 [40723]: https://github.com/rust-lang/rust/pull/40723
1807 [40728]: https://github.com/rust-lang/rust/pull/40728
1808 [40731]: https://github.com/rust-lang/rust/pull/40731
1809 [40734]: https://github.com/rust-lang/rust/pull/40734
1810 [40805]: https://github.com/rust-lang/rust/pull/40805
1811 [40807]: https://github.com/rust-lang/rust/pull/40807
1812 [40828]: https://github.com/rust-lang/rust/pull/40828
1813 [40870]: https://github.com/rust-lang/rust/pull/40870
1814 [41085]: https://github.com/rust-lang/rust/pull/41085
1815 [41143]: https://github.com/rust-lang/rust/pull/41143
1816 [41168]: https://github.com/rust-lang/rust/pull/41168
1817 [41270]: https://github.com/rust-lang/rust/issues/41270
1818 [41469]: https://github.com/rust-lang/rust/pull/41469
1819 [41805]: https://github.com/rust-lang/rust/issues/41805
1820 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1821 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1822 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1823 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1824 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1825 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1826 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1827 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1828 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1829 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1830 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1831 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1832 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1833 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1834
1835
1836 Version 1.17.0 (2017-04-27)
1837 ===========================
1838
1839 Language
1840 --------
1841
1842 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1843 * [Fields of structs may be initialized without duplicating the field/variable
1844   names][39761]. [RFC 1682]
1845 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1846 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1847   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1848   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1849   `'b`. Soundness fix.
1850 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1851 * [Static variables may contain references to other statics][40027]
1852
1853 Compiler
1854 --------
1855
1856 * [Exit quickly on only `--emit dep-info`][40336]
1857 * [Make `-C relocation-model` more correctly determine whether the linker
1858   creates a position-independent executable][40245]
1859 * [Add `-C overflow-checks` to directly control whether integer overflow
1860   panics][40037]
1861 * [The rustc type checker now checks items on demand instead of in a single
1862   in-order pass][40008]. This is mostly an internal refactoring in support of
1863   future work, including incremental type checking, but also resolves [RFC
1864   1647], allowing `Self` to appear in `impl` `where` clauses.
1865 * [Optimize vtable loads][39995]
1866 * [Turn off vectorization for Emscripten targets][39990]
1867 * [Provide suggestions for unknown macros imported with `use`][39953]
1868 * [Fix ICEs in path resolution][39939]
1869 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1870 * [Add clearer error message using `&str + &str`][39116]
1871
1872 Stabilized APIs
1873 ---------------
1874
1875 * [`Arc::into_raw`]
1876 * [`Arc::from_raw`]
1877 * [`Arc::ptr_eq`]
1878 * [`Rc::into_raw`]
1879 * [`Rc::from_raw`]
1880 * [`Rc::ptr_eq`]
1881 * [`Ordering::then`]
1882 * [`Ordering::then_with`]
1883 * [`BTreeMap::range`]
1884 * [`BTreeMap::range_mut`]
1885 * [`collections::Bound`]
1886 * [`process::abort`]
1887 * [`ptr::read_unaligned`]
1888 * [`ptr::write_unaligned`]
1889 * [`Result::expect_err`]
1890 * [`Cell::swap`]
1891 * [`Cell::replace`]
1892 * [`Cell::into_inner`]
1893 * [`Cell::take`]
1894
1895 Libraries
1896 ---------
1897
1898 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1899 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1900 * [`String` implements `FromIterator<&char>`][40028]
1901 * `Box` [implements][40009] a number of new conversions:
1902   `From<Box<str>> for String`,
1903   `From<Box<[T]>> for Vec<T>`,
1904   `From<Box<CStr>> for CString`,
1905   `From<Box<OsStr>> for OsString`,
1906   `From<Box<Path>> for PathBuf`,
1907   `Into<Box<str>> for String`,
1908   `Into<Box<[T]>> for Vec<T>`,
1909   `Into<Box<CStr>> for CString`,
1910   `Into<Box<OsStr>> for OsString`,
1911   `Into<Box<Path>> for PathBuf`,
1912   `Default for Box<str>`,
1913   `Default for Box<CStr>`,
1914   `Default for Box<OsStr>`,
1915   `From<&CStr> for Box<CStr>`,
1916   `From<&OsStr> for Box<OsStr>`,
1917   `From<&Path> for Box<Path>`
1918 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
1919 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
1920 * [Slightly optimize `slice::sort`][39538]
1921 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
1922 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
1923   `Box<str>` implements `From<&str>`][39438]
1924 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
1925   `From<(I, u16)> where I: Into<IpAddr>`][39372]
1926 * [`format!` estimates the needed capacity before writing a string][39356]
1927 * [Support unprivileged symlink creation in Windows][38921]
1928 * [`PathBuf` implements `Default`][38764]
1929 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
1930 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
1931   and poor hash functions.
1932
1933 Cargo
1934 -----
1935
1936 * [Add `cargo check --all`][cargo/3731]
1937 * [Add an option to ignore SSL revocation checking][cargo/3699]
1938 * [Add `cargo run --package`][cargo/3691]
1939 * [Add `required_features`][cargo/3667]
1940 * [Assume `build.rs` is a build script][cargo/3664]
1941 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
1942
1943 Misc
1944 ----
1945
1946 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
1947   `rustbook`][39633]
1948 * [The "Unstable Book" documents nightly-only features][ubook]
1949 * [Improve the style of the sidebar in rustdoc output][40265]
1950 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
1951 * [Fix MSP430 breakage due to `i128`][40257]
1952 * [Preliminary Solaris/SPARCv9 support][39903]
1953 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
1954   run without installing the MSVC runtime.
1955 * [`rustdoc --test` includes file names in test names][39788]
1956 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
1957   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
1958 * [Initial support for `aarch64-unknown-freebsd`][39491]
1959 * [Initial support for `i686-unknown-netbsd`][39426]
1960 * [This release no longer includes the old makefile build system][39431]. Rust
1961   is built with a custom build system, written in Rust, and with Cargo.
1962 * [Add Debug implementations for libcollection structs][39002]
1963 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
1964 * [`--test-threads=0` produces an error][38945]
1965 * [`rustup` installs documentation by default][40526]
1966 * [The Rust source includes NatVis visualizations][39843]. These can be used by
1967   WinDbg and Visual Studio to improve the debugging experience.
1968
1969 Compatibility Notes
1970 -------------------
1971
1972 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
1973   workaround, either use MSVC 2015 or run vcvars.bat.
1974 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1975   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
1976   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
1977   fix.
1978 * [`format!` and `Display::to_string` panic if an underlying formatting
1979   implementation returns an error][40117]. Previously the error was silently
1980   ignored. It is incorrect for `write_fmt` to return an error when writing
1981   to a string.
1982 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
1983   crates were marked stable and could be accessed from the stable toolchain.
1984 * [Rust git source no longer includes vendored crates][39728]. Those that need
1985   to build with vendored crates should build from release tarballs.
1986 * [Fix inert attributes from `proc_macro_derives`][39572]
1987 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
1988   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
1989   build system.
1990 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
1991   existing code generally ignores the type of dead-code unless a type-hint is
1992   provided; this can cause surprising inference interactions particularly around
1993   defaulting. The new code uniformly ignores the result type of dead-code.
1994 * [Tuple-struct constructors with private fields are no longer visible][38932]
1995 * [Lifetime parameters that do not appear in the arguments are now considered
1996   early-bound][38897], resolving a soundness bug (#[32330]). The
1997   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
1998   April of 2016.
1999 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2000 * [Make transmuting from fn item types to pointer-sized types a hard
2001   error][34198]
2002
2003 [27787]: https://github.com/rust-lang/rust/issues/27787
2004 [32330]: https://github.com/rust-lang/rust/issues/32330
2005 [34198]: https://github.com/rust-lang/rust/pull/34198
2006 [38161]: https://github.com/rust-lang/rust/pull/38161
2007 [38368]: https://github.com/rust-lang/rust/pull/38368
2008 [38584]: https://github.com/rust-lang/rust/issues/38584
2009 [38661]: https://github.com/rust-lang/rust/pull/38661
2010 [38764]: https://github.com/rust-lang/rust/pull/38764
2011 [38864]: https://github.com/rust-lang/rust/issues/38864
2012 [38897]: https://github.com/rust-lang/rust/pull/38897
2013 [38921]: https://github.com/rust-lang/rust/pull/38921
2014 [38932]: https://github.com/rust-lang/rust/pull/38932
2015 [38945]: https://github.com/rust-lang/rust/pull/38945
2016 [38981]: https://github.com/rust-lang/rust/pull/38981
2017 [39002]: https://github.com/rust-lang/rust/pull/39002
2018 [39116]: https://github.com/rust-lang/rust/pull/39116
2019 [39193]: https://github.com/rust-lang/rust/pull/39193
2020 [39265]: https://github.com/rust-lang/rust/pull/39265
2021 [39356]: https://github.com/rust-lang/rust/pull/39356
2022 [39372]: https://github.com/rust-lang/rust/pull/39372
2023 [39426]: https://github.com/rust-lang/rust/pull/39426
2024 [39431]: https://github.com/rust-lang/rust/pull/39431
2025 [39438]: https://github.com/rust-lang/rust/pull/39438
2026 [39440]: https://github.com/rust-lang/rust/pull/39440
2027 [39485]: https://github.com/rust-lang/rust/pull/39485
2028 [39491]: https://github.com/rust-lang/rust/pull/39491
2029 [39518]: https://github.com/rust-lang/rust/pull/39518
2030 [39538]: https://github.com/rust-lang/rust/pull/39538
2031 [39572]: https://github.com/rust-lang/rust/pull/39572
2032 [39633]: https://github.com/rust-lang/rust/pull/39633
2033 [39642]: https://github.com/rust-lang/rust/pull/39642
2034 [39728]: https://github.com/rust-lang/rust/pull/39728
2035 [39761]: https://github.com/rust-lang/rust/pull/39761
2036 [39788]: https://github.com/rust-lang/rust/pull/39788
2037 [39793]: https://github.com/rust-lang/rust/pull/39793
2038 [39837]: https://github.com/rust-lang/rust/pull/39837
2039 [39843]: https://github.com/rust-lang/rust/pull/39843
2040 [39851]: https://github.com/rust-lang/rust/pull/39851
2041 [39903]: https://github.com/rust-lang/rust/pull/39903
2042 [39939]: https://github.com/rust-lang/rust/pull/39939
2043 [39953]: https://github.com/rust-lang/rust/pull/39953
2044 [39960]: https://github.com/rust-lang/rust/pull/39960
2045 [39990]: https://github.com/rust-lang/rust/pull/39990
2046 [39995]: https://github.com/rust-lang/rust/pull/39995
2047 [40008]: https://github.com/rust-lang/rust/pull/40008
2048 [40009]: https://github.com/rust-lang/rust/pull/40009
2049 [40027]: https://github.com/rust-lang/rust/pull/40027
2050 [40028]: https://github.com/rust-lang/rust/pull/40028
2051 [40037]: https://github.com/rust-lang/rust/pull/40037
2052 [40117]: https://github.com/rust-lang/rust/pull/40117
2053 [40166]: https://github.com/rust-lang/rust/pull/40166
2054 [40245]: https://github.com/rust-lang/rust/pull/40245
2055 [40257]: https://github.com/rust-lang/rust/pull/40257
2056 [40261]: https://github.com/rust-lang/rust/pull/40261
2057 [40265]: https://github.com/rust-lang/rust/pull/40265
2058 [40319]: https://github.com/rust-lang/rust/pull/40319
2059 [40336]: https://github.com/rust-lang/rust/pull/40336
2060 [40526]: https://github.com/rust-lang/rust/pull/40526
2061 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2062 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2063 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2064 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2065 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2066 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2067 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2068 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2069 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2070 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2071 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2072 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2073 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2074 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2075 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2076 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2077 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2078 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2079 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2080 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2081 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2082 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2083 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2084 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2085 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2086 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2087 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2088 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2089 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2090 [mdbook]: https://crates.io/crates/mdbook
2091 [ubook]: https://doc.rust-lang.org/unstable-book/
2092
2093
2094 Version 1.16.0 (2017-03-16)
2095 ===========================
2096
2097 Language
2098 --------
2099
2100 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2101 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2102   match patterns][38069]
2103 * [Clean up semantics of `self` in an import list][38313]
2104 * [`Self` may appear in `impl` headers][38920]
2105 * [`Self` may appear in struct expressions][39282]
2106
2107 Compiler
2108 --------
2109
2110 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2111   a `.rmeta` file containing only crate metadata][38571]. This can be
2112   used by tools like the Rust Language Service to perform
2113   metadata-only builds.
2114 * [Levenshtein based typo suggestions now work in most places, while
2115   previously they worked only for fields and sometimes for local
2116   variables][38927]. Together with the overhaul of "no
2117   resolution"/"unexpected resolution" errors (#[38154]) they result in
2118   large and systematic improvement in resolution diagnostics.
2119 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2120   `U`][38670]
2121 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2122 * [`rustc` no longer attempts to provide "consider using an explicit
2123   lifetime" suggestions][37057]. They were inaccurate.
2124
2125 Stabilized APIs
2126 ---------------
2127
2128 * [`VecDeque::truncate`]
2129 * [`VecDeque::resize`]
2130 * [`String::insert_str`]
2131 * [`Duration::checked_add`]
2132 * [`Duration::checked_sub`]
2133 * [`Duration::checked_div`]
2134 * [`Duration::checked_mul`]
2135 * [`str::replacen`]
2136 * [`str::repeat`]
2137 * [`SocketAddr::is_ipv4`]
2138 * [`SocketAddr::is_ipv6`]
2139 * [`IpAddr::is_ipv4`]
2140 * [`IpAddr::is_ipv6`]
2141 * [`Vec::dedup_by`]
2142 * [`Vec::dedup_by_key`]
2143 * [`Result::unwrap_or_default`]
2144 * [`<*const T>::wrapping_offset`]
2145 * [`<*mut T>::wrapping_offset`]
2146 * `CommandExt::creation_flags`
2147 * [`File::set_permissions`]
2148 * [`String::split_off`]
2149
2150 Libraries
2151 ---------
2152
2153 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2154   their argument by `Borrow` parameter][37761]
2155 * [All public types in std implement `Debug`][38006]
2156 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2157 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2158 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2159   Windows][38274]
2160 * [std: Fix partial writes in `LineWriter`][38062]
2161 * [std: Clamp max read/write sizes on Unix][38062]
2162 * [Use more specific panic message for `&str` slicing errors][38066]
2163 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2164   functionality cannot be achieved in std currently.
2165 * [`writeln!`, like `println!`, now accepts a form with no string
2166   or formatting arguments, to just print a newline][38469]
2167 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2168 * [Reduce the size of static data in `std_unicode::tables`][38781]
2169 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2170   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2171   `Display`][38909]
2172 * [`Duration` implements `Sum`][38712]
2173 * [`String` implements `ToSocketAddrs`][39048]
2174
2175 Cargo
2176 -----
2177
2178 * [The `cargo check` command does a type check of a project without
2179   building it][cargo/3296]
2180 * [crates.io will display CI badges from Travis and AppVeyor, if
2181   specified in Cargo.toml][cargo/3546]
2182 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2183 * [Compilation profiles accept integer values for `debug`, in addition
2184   to `true` and `false`. These are passed to `rustc` as the value to
2185   `-C debuginfo`][cargo/3534]
2186 * [Implement `cargo --version --verbose`][cargo/3604]
2187 * [All builds now output 'dep-info' build dependencies compatible with
2188   make and ninja][cargo/3557]
2189 * [Build all workspace members with `build --all`][cargo/3511]
2190 * [Document all workspace members with `doc --all`][cargo/3515]
2191 * [Path deps outside workspace are not members][cargo/3443]
2192
2193 Misc
2194 ----
2195
2196 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2197   the path to the Rust implementation][38589]
2198 * [The `armv7-linux-androideabi` target no longer enables NEON
2199   extensions, per Google's ABI guide][38413]
2200 * [The stock standard library can be compiled for Redox OS][38401]
2201 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2202   available.
2203 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2204   builds available.
2205 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2206
2207 Compatibility Notes
2208 -------------------
2209
2210 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2211   match patterns][38069]
2212 * In this release, references to uninhabited types can not be
2213   pattern-matched. This was accidentally allowed in 1.15.
2214 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2215 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2216   Windows][38274]
2217 * [Clean up semantics of `self` in an import list][38313]
2218 * Reimplemented lifetime elision. This change was almost entirely compatible
2219   with existing code, but it did close a number of small bugs and loopholes,
2220   as well as being more accepting in some other [cases][41105].
2221
2222 [37057]: https://github.com/rust-lang/rust/pull/37057
2223 [37761]: https://github.com/rust-lang/rust/pull/37761
2224 [38006]: https://github.com/rust-lang/rust/pull/38006
2225 [38051]: https://github.com/rust-lang/rust/pull/38051
2226 [38062]: https://github.com/rust-lang/rust/pull/38062
2227 [38062]: https://github.com/rust-lang/rust/pull/38622
2228 [38066]: https://github.com/rust-lang/rust/pull/38066
2229 [38069]: https://github.com/rust-lang/rust/pull/38069
2230 [38131]: https://github.com/rust-lang/rust/pull/38131
2231 [38154]: https://github.com/rust-lang/rust/pull/38154
2232 [38274]: https://github.com/rust-lang/rust/pull/38274
2233 [38304]: https://github.com/rust-lang/rust/pull/38304
2234 [38313]: https://github.com/rust-lang/rust/pull/38313
2235 [38314]: https://github.com/rust-lang/rust/pull/38314
2236 [38327]: https://github.com/rust-lang/rust/pull/38327
2237 [38401]: https://github.com/rust-lang/rust/pull/38401
2238 [38413]: https://github.com/rust-lang/rust/pull/38413
2239 [38469]: https://github.com/rust-lang/rust/pull/38469
2240 [38559]: https://github.com/rust-lang/rust/pull/38559
2241 [38571]: https://github.com/rust-lang/rust/pull/38571
2242 [38580]: https://github.com/rust-lang/rust/pull/38580
2243 [38589]: https://github.com/rust-lang/rust/pull/38589
2244 [38670]: https://github.com/rust-lang/rust/pull/38670
2245 [38712]: https://github.com/rust-lang/rust/pull/38712
2246 [38726]: https://github.com/rust-lang/rust/pull/38726
2247 [38781]: https://github.com/rust-lang/rust/pull/38781
2248 [38798]: https://github.com/rust-lang/rust/pull/38798
2249 [38909]: https://github.com/rust-lang/rust/pull/38909
2250 [38920]: https://github.com/rust-lang/rust/pull/38920
2251 [38927]: https://github.com/rust-lang/rust/pull/38927
2252 [39048]: https://github.com/rust-lang/rust/pull/39048
2253 [39282]: https://github.com/rust-lang/rust/pull/39282
2254 [39379]: https://github.com/rust-lang/rust/pull/39379
2255 [41105]: https://github.com/rust-lang/rust/issues/41105
2256 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2257 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2258 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2259 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2260 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2261 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2262 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2263 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2264 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2265 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2266 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2267 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2268 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2269 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2270 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2271 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2272 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2273 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2274 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2275 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2276 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2277 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2278 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2279 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2280 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2281 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2282 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2283 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2284 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2285 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2286
2287
2288 Version 1.15.1 (2017-02-09)
2289 ===========================
2290
2291 * [Fix IntoIter::as_mut_slice's signature][39466]
2292 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2293
2294 [39466]: https://github.com/rust-lang/rust/pull/39466
2295 [39523]: https://github.com/rust-lang/rust/pull/39523
2296
2297
2298 Version 1.15.0 (2017-02-02)
2299 ===========================
2300
2301 Language
2302 --------
2303
2304 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2305   stable. This allows popular code-generating crates like Serde and Diesel to
2306   work ergonomically. [RFC 1681].
2307 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2308   with curly braces][36868]. Part of [RFC 1506].
2309 * [A number of minor changes to name resolution have been activated][37127].
2310   They add up to more consistent semantics, allowing for future evolution of
2311   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2312   details of what is different. The breaking changes here have been transitioned
2313   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2314 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2315   bounds][38279]
2316 * [`?Sized` can be used in `where` clauses][37791]
2317 * [There is now a limit on the size of monomorphized types and it can be
2318   modified with the `#![type_size_limit]` crate attribute, similarly to
2319   the `#![recursion_limit]` attribute][37789]
2320
2321 Compiler
2322 --------
2323
2324 * [On Windows, the compiler will apply dllimport attributes when linking to
2325   extern functions][37973]. Additional attributes and flags can control which
2326   library kind is linked and its name. [RFC 1717].
2327 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2328 * [The `--test` flag works with procedural macro crates][38107]
2329 * [Fix `extern "aapcs" fn` ABI][37814]
2330 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2331 * [The `format!` expander recognizes incorrect `printf` and shell-style
2332   formatting directives and suggests the correct format][37613].
2333 * [Only report one error for all unused imports in an import list][37456]
2334
2335 Compiler Performance
2336 --------------------
2337
2338 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2339 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2340 * [Don't clone in `UnificationTable::probe`][37848]
2341 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2342 * [Use small vectors in type walker][37760]
2343 * [Macro expansion performance was improved][37701]
2344 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2345 * [Replace FNV with a faster hash function][37229]
2346
2347 Stabilized APIs
2348 ---------------
2349
2350 * [`std::iter::Iterator::min_by`]
2351 * [`std::iter::Iterator::max_by`]
2352 * [`std::os::*::fs::FileExt`]
2353 * [`std::sync::atomic::Atomic*::get_mut`]
2354 * [`std::sync::atomic::Atomic*::into_inner`]
2355 * [`std::vec::IntoIter::as_slice`]
2356 * [`std::vec::IntoIter::as_mut_slice`]
2357 * [`std::sync::mpsc::Receiver::try_iter`]
2358 * [`std::os::unix::process::CommandExt::before_exec`]
2359 * [`std::rc::Rc::strong_count`]
2360 * [`std::rc::Rc::weak_count`]
2361 * [`std::sync::Arc::strong_count`]
2362 * [`std::sync::Arc::weak_count`]
2363 * [`std::char::encode_utf8`]
2364 * [`std::char::encode_utf16`]
2365 * [`std::cell::Ref::clone`]
2366 * [`std::io::Take::into_inner`]
2367
2368 Libraries
2369 ---------
2370
2371 * [The standard sorting algorithm has been rewritten for dramatic performance
2372   improvements][38192]. It is a hybrid merge sort, drawing influences from
2373   Timsort. Previously it was a naive merge sort.
2374 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2375 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2376   performance.
2377 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2378   and `char_indices().last()`][37882]
2379 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2380 * [Chinese characters display correctly in `fmt::Debug`][37855]
2381 * [Derive `Default` for `Duration`][37699]
2382 * [Support creation of anonymous pipes on WinXP/2k][37677]
2383 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2384 * [Don't pass overlapped handles to processes][38835]
2385
2386 Cargo
2387 -----
2388
2389 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2390   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2391   should instead check the variable at runtime with `std::env`. That the value
2392   was set at build time was a bug, and incorrect when cross-compiling. This
2393   change is known to cause breakage.
2394 * [Add `--all` flag to `cargo test`][cargo/3221]
2395 * [Compile statically against the MSVC CRT][cargo/3363]
2396 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2397 * [Link OpenSSL statically on OSX][cargo/3311]
2398 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2399 * [Test for bad path overrides with summaries][cargo/3336]
2400 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2401 * [Fix retrying crate downloads for network errors][cargo/3348]
2402 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2403 * [Emit more info on --message-format=json][cargo/3319]
2404 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2405 * [Don't ignore errors in workspace manifest][cargo/3409]
2406 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2407
2408 Tooling
2409 -------
2410
2411 * [Test runners (binaries built with `--test`) now support a `--list` argument
2412   that lists the tests it contains][38185]
2413 * [Test runners now support a `--exact` argument that makes the test filter
2414   match exactly, instead of matching only a substring of the test name][38181]
2415 * [rustdoc supports a `--playground-url` flag][37763]
2416 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2417
2418 Misc
2419 ----
2420
2421 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2422   continue to be used in this release by passing `--disable-rustbuild` to the
2423   configure script, but they will be deleted soon. Note that the new build
2424   system uses a different on-disk layout that will likely affect any scripts
2425   building Rust.
2426 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2427   releases.
2428 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2429 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2430   releases.
2431
2432 Compatibility Notes
2433 -------------------
2434
2435 * [A number of minor changes to name resolution have been activated][37127].
2436   They add up to more consistent semantics, allowing for future evolution of
2437   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2438   details of what is different. The breaking changes here have been transitioned
2439   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2440 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2441   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2442   should instead check the variable at runtime with `std::env`. That the value
2443   was set at build time was a bug, and incorrect when cross-compiling. This
2444   change is known to cause breakage.
2445 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2446   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2447   1.10 and is now an error by default. It will become a hard error in the near
2448   future.
2449 * [The semantics relating modules to file system directories are changing in
2450   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2451   lint, which is a warning in this release, and will become a hard error in the
2452   future.
2453 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2454 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2455   the underlying iterator][37834]
2456
2457 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2458 [33685]: https://github.com/rust-lang/rust/issues/33685
2459 [36868]: https://github.com/rust-lang/rust/pull/36868
2460 [37127]: https://github.com/rust-lang/rust/pull/37127
2461 [37229]: https://github.com/rust-lang/rust/pull/37229
2462 [37456]: https://github.com/rust-lang/rust/pull/37456
2463 [37527]: https://github.com/rust-lang/rust/pull/37527
2464 [37602]: https://github.com/rust-lang/rust/pull/37602
2465 [37613]: https://github.com/rust-lang/rust/pull/37613
2466 [37615]: https://github.com/rust-lang/rust/pull/37615
2467 [37636]: https://github.com/rust-lang/rust/pull/37636
2468 [37627]: https://github.com/rust-lang/rust/pull/37627
2469 [37642]: https://github.com/rust-lang/rust/pull/37642
2470 [37677]: https://github.com/rust-lang/rust/pull/37677
2471 [37699]: https://github.com/rust-lang/rust/pull/37699
2472 [37701]: https://github.com/rust-lang/rust/pull/37701
2473 [37705]: https://github.com/rust-lang/rust/pull/37705
2474 [37749]: https://github.com/rust-lang/rust/pull/37749
2475 [37760]: https://github.com/rust-lang/rust/pull/37760
2476 [37763]: https://github.com/rust-lang/rust/pull/37763
2477 [37764]: https://github.com/rust-lang/rust/pull/37764
2478 [37789]: https://github.com/rust-lang/rust/pull/37789
2479 [37791]: https://github.com/rust-lang/rust/pull/37791
2480 [37814]: https://github.com/rust-lang/rust/pull/37814
2481 [37817]: https://github.com/rust-lang/rust/pull/37817
2482 [37834]: https://github.com/rust-lang/rust/pull/37834
2483 [37848]: https://github.com/rust-lang/rust/pull/37848
2484 [37855]: https://github.com/rust-lang/rust/pull/37855
2485 [37882]: https://github.com/rust-lang/rust/pull/37882
2486 [37888]: https://github.com/rust-lang/rust/pull/37888
2487 [37973]: https://github.com/rust-lang/rust/pull/37973
2488 [37979]: https://github.com/rust-lang/rust/pull/37979
2489 [38086]: https://github.com/rust-lang/rust/pull/38086
2490 [38107]: https://github.com/rust-lang/rust/pull/38107
2491 [38117]: https://github.com/rust-lang/rust/pull/38117
2492 [38134]: https://github.com/rust-lang/rust/pull/38134
2493 [38146]: https://github.com/rust-lang/rust/pull/38146
2494 [38181]: https://github.com/rust-lang/rust/pull/38181
2495 [38182]: https://github.com/rust-lang/rust/pull/38182
2496 [38185]: https://github.com/rust-lang/rust/pull/38185
2497 [38192]: https://github.com/rust-lang/rust/pull/38192
2498 [38279]: https://github.com/rust-lang/rust/pull/38279
2499 [38835]: https://github.com/rust-lang/rust/pull/38835
2500 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2501 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2502 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2503 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2504 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2505 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2506 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2507 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2508 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2509 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2510 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2511 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2512 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2513 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2514 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2515 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2516 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2517 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2518 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2519 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2520 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2521 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2522 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2523 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2524 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2525 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2526 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2527 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2528 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2529 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2530 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2531 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2532 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2533 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2534 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2535 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2536 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2537 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2538
2539
2540 Version 1.14.0 (2016-12-22)
2541 ===========================
2542
2543 Language
2544 --------
2545
2546 * [`..` matches multiple tuple fields in enum variants, structs
2547   and tuples][36843]. [RFC 1492].
2548 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2549 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2550 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2551   dereferencing][36822]
2552
2553 Compiler
2554 --------
2555
2556 * [Mark enums with non-zero discriminant as non-zero][37224]
2557 * [Lower-case `static mut` names are linted like other
2558   statics and consts][37162]
2559 * [Fix ICE on some macros in const integer positions
2560    (e.g. `[u8; m!()]`)][36819]
2561 * [Improve error message and snippet for "did you mean `x`"][36798]
2562 * [Add a panic-strategy field to the target specification][36794]
2563 * [Include LLVM version in `--version --verbose`][37200]
2564
2565 Compile-time Optimizations
2566 --------------------------
2567
2568 * [Improve macro expansion performance][37569]
2569 * [Shrink `Expr_::ExprInlineAsm`][37445]
2570 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2571 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2572 * [Avoid more allocations when compiling html5ever][37373]
2573 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2574 * [Avoid some allocations in the macro parser][37318]
2575 * [Use a faster deflate setting][37298]
2576 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2577   during interning of slices][37270]
2578 * [Optimize `write_metadata`][37267]
2579 * [Don't process obligation forest cycles when stalled][37231]
2580 * [Avoid many `CrateConfig` clones][37161]
2581 * [Optimize `Substs::super_fold_with`][37108]
2582 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2583 * [Speed up `plug_leaks`][36917]
2584
2585 Libraries
2586 ---------
2587
2588 * [`println!()`, with no arguments, prints newline][36825].
2589   Previously, an empty string was required to achieve the same.
2590 * [`Wrapping` impls standard binary and unary operators, as well as
2591    the `Sum` and `Product` iterators][37356]
2592 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2593   Vec<T>`][37326]
2594 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2595   `VecDeque` iterators][37315]
2596 * [Improve `SipHasher` performance on small values][37312]
2597 * [Add Iterator trait TrustedLen to enable better FromIterator /
2598   Extend][37306]
2599 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2600 * [`ReadDir` implements `Debug`][37221]
2601 * [Implement `RefUnwindSafe` for atomic types][37178]
2602 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2603 * [Avoid allocations in `Decoder::read_str`][37064]
2604 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2605 * [Impl `Debug` for raw pointers to unsized data][36880]
2606 * [Don't reuse `HashMap` random seeds][37470]
2607 * [The internal memory layout of `HashMap` is more cache-friendly, for
2608   significant improvements in some operations][36692]
2609 * [`HashMap` uses less memory on 32-bit architectures][36595]
2610 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2611
2612 Cargo
2613 -----
2614
2615 * [Expose rustc cfg values to build scripts][cargo/3243]
2616 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2617 * [Fix passing --features when testing multiple packages][cargo/3280]
2618 * [Use a single profile set per workspace][cargo/3249]
2619 * [Load `replace` sections from lock files][cargo/3220]
2620 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2621
2622 Tooling
2623 -------
2624
2625 * [rustup is the recommended Rust installation method][1.14rustup]
2626 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2627   S390x. These are [tier 2] platforms and may have major defects. Follow the
2628   instructions on the website to install, or add the targets to an existing
2629   installation with `rustup target add`. The new target triples are:
2630   - `mips-unknown-linux-gnu`
2631   - `mipsel-unknown-linux-gnu`
2632   - `mips64-unknown-linux-gnuabi64`
2633   - `mips64el-unknown-linux-gnuabi64 `
2634   - `powerpc-unknown-linux-gnu`
2635   - `powerpc64-unknown-linux-gnu`
2636   - `powerpc64le-unknown-linux-gnu`
2637   - `s390x-unknown-linux-gnu `
2638 * This release includes target (std) builds for ARM Linux running MUSL
2639   libc. These are [tier 2] platforms and may have major defects. Add the
2640   following triples to an existing rustup installation with `rustup target add`:
2641   - `arm-unknown-linux-musleabi`
2642   - `arm-unknown-linux-musleabihf`
2643   - `armv7-unknown-linux-musleabihf`
2644 * This release includes [experimental support for WebAssembly][1.14wasm], via
2645   the `wasm32-unknown-emscripten` target. This target is known to have major
2646   defects. Please test, report, and fix.
2647 * rustup no longer installs documentation by default. Run `rustup
2648   component add rust-docs` to install.
2649 * [Fix line stepping in debugger][37310]
2650 * [Enable line number debuginfo in releases][37280]
2651
2652 Misc
2653 ----
2654
2655 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2656 * [Add support for Fuchsia OS][37313]
2657 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2658
2659 Compatibility Notes
2660 -------------------
2661
2662 * [A number of forward-compatibility lints used by the compiler
2663   to gradually introduce language changes have been converted
2664   to deny by default][36894]:
2665   - ["use of inaccessible extern crate erroneously allowed"][36886]
2666   - ["type parameter default erroneously allowed in invalid location"][36887]
2667   - ["detects super or self keywords at the beginning of global path"][36888]
2668   - ["two overlapping inherent impls define an item with the same name
2669     were erroneously allowed"][36889]
2670   - ["floating-point constants cannot be used in patterns"][36890]
2671   - ["constants of struct or enum type can only be used in a pattern if
2672      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2673   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2674 * [Prohibit patterns in trait methods without bodies][37378]
2675 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2676 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2677 * [The `$crate` macro variable is accepted in fewer locations][37213]
2678 * [Impls specifying extra region requirements beyond the trait
2679   they implement are rejected][37167]
2680 * [Enums may not be unsized][37111]. Unsized enums are intended to
2681   work but never have. For now they are forbidden.
2682 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2683
2684 [tier 2]: https://forge.rust-lang.org/platform-support.html
2685 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2686 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2687 [36430]: https://github.com/rust-lang/rust/pull/36430
2688 [36595]: https://github.com/rust-lang/rust/pull/36595
2689 [36595]: https://github.com/rust-lang/rust/pull/36595
2690 [36692]: https://github.com/rust-lang/rust/pull/36692
2691 [36767]: https://github.com/rust-lang/rust/pull/36767
2692 [36794]: https://github.com/rust-lang/rust/pull/36794
2693 [36798]: https://github.com/rust-lang/rust/pull/36798
2694 [36819]: https://github.com/rust-lang/rust/pull/36819
2695 [36822]: https://github.com/rust-lang/rust/pull/36822
2696 [36825]: https://github.com/rust-lang/rust/pull/36825
2697 [36843]: https://github.com/rust-lang/rust/pull/36843
2698 [36880]: https://github.com/rust-lang/rust/pull/36880
2699 [36886]: https://github.com/rust-lang/rust/issues/36886
2700 [36887]: https://github.com/rust-lang/rust/issues/36887
2701 [36888]: https://github.com/rust-lang/rust/issues/36888
2702 [36889]: https://github.com/rust-lang/rust/issues/36889
2703 [36890]: https://github.com/rust-lang/rust/issues/36890
2704 [36891]: https://github.com/rust-lang/rust/issues/36891
2705 [36892]: https://github.com/rust-lang/rust/issues/36892
2706 [36894]: https://github.com/rust-lang/rust/pull/36894
2707 [36917]: https://github.com/rust-lang/rust/pull/36917
2708 [36993]: https://github.com/rust-lang/rust/pull/36993
2709 [37037]: https://github.com/rust-lang/rust/pull/37037
2710 [37064]: https://github.com/rust-lang/rust/pull/37064
2711 [37094]: https://github.com/rust-lang/rust/pull/37094
2712 [37108]: https://github.com/rust-lang/rust/pull/37108
2713 [37111]: https://github.com/rust-lang/rust/pull/37111
2714 [37161]: https://github.com/rust-lang/rust/pull/37161
2715 [37162]: https://github.com/rust-lang/rust/pull/37162
2716 [37167]: https://github.com/rust-lang/rust/pull/37167
2717 [37178]: https://github.com/rust-lang/rust/pull/37178
2718 [37200]: https://github.com/rust-lang/rust/pull/37200
2719 [37213]: https://github.com/rust-lang/rust/pull/37213
2720 [37221]: https://github.com/rust-lang/rust/pull/37221
2721 [37224]: https://github.com/rust-lang/rust/pull/37224
2722 [37230]: https://github.com/rust-lang/rust/pull/37230
2723 [37231]: https://github.com/rust-lang/rust/pull/37231
2724 [37247]: https://github.com/rust-lang/rust/pull/37247
2725 [37267]: https://github.com/rust-lang/rust/pull/37267
2726 [37270]: https://github.com/rust-lang/rust/pull/37270
2727 [37273]: https://github.com/rust-lang/rust/pull/37273
2728 [37280]: https://github.com/rust-lang/rust/pull/37280
2729 [37298]: https://github.com/rust-lang/rust/pull/37298
2730 [37306]: https://github.com/rust-lang/rust/pull/37306
2731 [37310]: https://github.com/rust-lang/rust/pull/37310
2732 [37312]: https://github.com/rust-lang/rust/pull/37312
2733 [37313]: https://github.com/rust-lang/rust/pull/37313
2734 [37315]: https://github.com/rust-lang/rust/pull/37315
2735 [37318]: https://github.com/rust-lang/rust/pull/37318
2736 [37322]: https://github.com/rust-lang/rust/pull/37322
2737 [37326]: https://github.com/rust-lang/rust/pull/37326
2738 [37351]: https://github.com/rust-lang/rust/pull/37351
2739 [37356]: https://github.com/rust-lang/rust/pull/37356
2740 [37367]: https://github.com/rust-lang/rust/pull/37367
2741 [37373]: https://github.com/rust-lang/rust/pull/37373
2742 [37378]: https://github.com/rust-lang/rust/pull/37378
2743 [37389]: https://github.com/rust-lang/rust/pull/37389
2744 [37392]: https://github.com/rust-lang/rust/pull/37392
2745 [37427]: https://github.com/rust-lang/rust/pull/37427
2746 [37439]: https://github.com/rust-lang/rust/pull/37439
2747 [37445]: https://github.com/rust-lang/rust/pull/37445
2748 [37470]: https://github.com/rust-lang/rust/pull/37470
2749 [37569]: https://github.com/rust-lang/rust/pull/37569
2750 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2751 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2752 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2753 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2754 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2755 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2756 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2757
2758
2759 Version 1.13.0 (2016-11-10)
2760 ===========================
2761
2762 Language
2763 --------
2764
2765 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2766   errors, like the `try!` macro, described in [RFC 0243].
2767 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2768 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2769 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2770 * [Fix lifetime rules for 'if' conditions][36029]
2771 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2772
2773 Compiler
2774 --------
2775
2776 * [Add the `-C link-arg` argument][36574]
2777 * [Remove the old AST-based backend from rustc_trans][35764]
2778 * [Don't enable NEON by default on armv7 Linux][35814]
2779 * [Fix debug line number info for macro expansions][35238]
2780 * [Do not emit "class method" debuginfo for types that are not
2781   DICompositeType][36008]
2782 * [Warn about multiple conflicting #[repr] hints][34623]
2783 * [When sizing DST, don't double-count nested struct prefixes][36351]
2784 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2785 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2786 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2787 * [Expand macros without recursing to avoid stack overflows][36214]
2788
2789 Diagnostics
2790 -----------
2791
2792 * [Replace macro backtraces with labeled local uses][35702]
2793 * [Improve error message for misplaced doc comments][33922]
2794 * [Buffer unix and lock windows to prevent message interleaving][35975]
2795 * [Update lifetime errors to specifically note temporaries][36171]
2796 * [Special case a few colors for Windows][36178]
2797 * [Suggest `use self` when such an import resolves][36289]
2798 * [Be more specific when type parameter shadows primitive type][36338]
2799 * Many minor improvements
2800
2801 Compile-time Optimizations
2802 --------------------------
2803
2804 * [Compute and cache HIR hashes at beginning][35854]
2805 * [Don't hash types in loan paths][36004]
2806 * [Cache projections in trans][35761]
2807 * [Optimize the parser's last token handling][36527]
2808 * [Only instantiate #[inline] functions in codegen units referencing
2809   them][36524]. This leads to big improvements in cases where crates export
2810   define many inline functions without using them directly.
2811 * [Lazily allocate TypedArena's first chunk][36592]
2812 * [Don't allocate during default HashSet creation][36734]
2813
2814 Stabilized APIs
2815 ---------------
2816
2817 * [`checked_abs`]
2818 * [`wrapping_abs`]
2819 * [`overflowing_abs`]
2820 * [`RefCell::try_borrow`]
2821 * [`RefCell::try_borrow_mut`]
2822
2823 Libraries
2824 ---------
2825
2826 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2827 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2828   covariant][35354]
2829 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2830 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2831 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2832 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2833 * [Use arc4rand on FreeBSD][35884]
2834 * [memrchr: Correct aligned offset computation][35969]
2835 * [Improve Demangling of Rust Symbols][36059]
2836 * [Use monotonic time in condition variables][35048]
2837 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2838 * [Implement conversion traits for `char`][35755]
2839 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2840 * [Zero first byte of CString on drop][36264]
2841 * [Inherit overflow checks for sum and product][36372]
2842 * [Add missing Eq implementations][36423]
2843 * [Implement `Debug` for `DirEntry`][36631]
2844 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2845   `errno`][36754]
2846 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2847 * [Implement more traits for `std::io::ErrorKind`][35911]
2848 * [Optimize BinaryHeap bounds checking][36072]
2849 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2850   `extend_with_element`][36355]
2851 * [Fix overflow checking in unsigned pow()][34942]
2852
2853 Cargo
2854 -----
2855
2856 * This release includes security fixes to both curl and OpenSSL.
2857 * [Fix transitive doctests when panic=abort][cargo/3021]
2858 * [Add --all-features flag to cargo][cargo/3038]
2859 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2860 * [Don't parse the home directory more than once][cargo/3078]
2861 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2862 * [Update OpenSSL to 1.0.2j][cargo/3121]
2863 * [Add license and license_file to cargo metadata output][cargo/3110]
2864 * [Make crates-io registry URL optional in config; ignore all changes to
2865   source.crates-io][cargo/3089]
2866 * [Don't download dependencies from other platforms][cargo/3123]
2867 * [Build transitive dev-dependencies when needed][cargo/3125]
2868 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2869 * [Avoid updating registry when adding existing deps][cargo/3144]
2870 * [Warn about path overrides that won't work][cargo/3136]
2871 * [Use workspaces during `cargo install`][cargo/3146]
2872 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2873 * [Add --message-format flag][cargo/3000]
2874 * [Pass target environment for rustdoc][cargo/3205]
2875 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2876 * [Update curl and curl-sys][cargo/3241]
2877 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2878
2879 Tooling
2880 -------
2881
2882 * [rustdoc: Add the `--sysroot` argument][36586]
2883 * [rustdoc: Fix a couple of issues with the search results][35655]
2884 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2885 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2886 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2887
2888 Misc
2889 ----
2890
2891 * [Remove unmaintained style guide][35124]
2892 * [Add s390x support][36369]
2893 * [Initial work at Haiku OS support][36727]
2894 * [Add mips-uclibc targets][35734]
2895 * [Crate-ify compiler-rt into compiler-builtins][35021]
2896 * [Add rustc version info (git hash + date) to dist tarball][36213]
2897 * Many documentation improvements
2898
2899 Compatibility Notes
2900 -------------------
2901
2902 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2903 * [Deny (by default) transmuting from fn item types to pointer-sized
2904   types][34923]. Continuing the long transition to zero-sized fn items,
2905   per [RFC 401].
2906 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2907   Part of [RFC 1506].
2908 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2909 * [Fix lifetime rules for 'if' conditions][36029].
2910 * [Inherit overflow checks for sum and product][36372].
2911 * [Forbid user-defined macros named "macro_rules"][36730].
2912
2913 [33922]: https://github.com/rust-lang/rust/pull/33922
2914 [34623]: https://github.com/rust-lang/rust/pull/34623
2915 [34923]: https://github.com/rust-lang/rust/pull/34923
2916 [34942]: https://github.com/rust-lang/rust/pull/34942
2917 [34982]: https://github.com/rust-lang/rust/pull/34982
2918 [35021]: https://github.com/rust-lang/rust/pull/35021
2919 [35048]: https://github.com/rust-lang/rust/pull/35048
2920 [35074]: https://github.com/rust-lang/rust/pull/35074
2921 [35124]: https://github.com/rust-lang/rust/pull/35124
2922 [35234]: https://github.com/rust-lang/rust/pull/35234
2923 [35238]: https://github.com/rust-lang/rust/pull/35238
2924 [35354]: https://github.com/rust-lang/rust/pull/35354
2925 [35559]: https://github.com/rust-lang/rust/pull/35559
2926 [35585]: https://github.com/rust-lang/rust/pull/35585
2927 [35627]: https://github.com/rust-lang/rust/pull/35627
2928 [35655]: https://github.com/rust-lang/rust/pull/35655
2929 [35702]: https://github.com/rust-lang/rust/pull/35702
2930 [35707]: https://github.com/rust-lang/rust/pull/35707
2931 [35728]: https://github.com/rust-lang/rust/pull/35728
2932 [35734]: https://github.com/rust-lang/rust/pull/35734
2933 [35755]: https://github.com/rust-lang/rust/pull/35755
2934 [35761]: https://github.com/rust-lang/rust/pull/35761
2935 [35764]: https://github.com/rust-lang/rust/pull/35764
2936 [35814]: https://github.com/rust-lang/rust/pull/35814
2937 [35854]: https://github.com/rust-lang/rust/pull/35854
2938 [35871]: https://github.com/rust-lang/rust/pull/35871
2939 [35884]: https://github.com/rust-lang/rust/pull/35884
2940 [35911]: https://github.com/rust-lang/rust/pull/35911
2941 [35969]: https://github.com/rust-lang/rust/pull/35969
2942 [35975]: https://github.com/rust-lang/rust/pull/35975
2943 [36004]: https://github.com/rust-lang/rust/pull/36004
2944 [36008]: https://github.com/rust-lang/rust/pull/36008
2945 [36014]: https://github.com/rust-lang/rust/pull/36014
2946 [36029]: https://github.com/rust-lang/rust/pull/36029
2947 [36059]: https://github.com/rust-lang/rust/pull/36059
2948 [36072]: https://github.com/rust-lang/rust/pull/36072
2949 [36101]: https://github.com/rust-lang/rust/pull/36101
2950 [36104]: https://github.com/rust-lang/rust/pull/36104
2951 [36171]: https://github.com/rust-lang/rust/pull/36171
2952 [36173]: https://github.com/rust-lang/rust/pull/36173
2953 [36178]: https://github.com/rust-lang/rust/pull/36178
2954 [36213]: https://github.com/rust-lang/rust/pull/36213
2955 [36214]: https://github.com/rust-lang/rust/pull/36214
2956 [36264]: https://github.com/rust-lang/rust/pull/36264
2957 [36266]: https://github.com/rust-lang/rust/pull/36266
2958 [36289]: https://github.com/rust-lang/rust/pull/36289
2959 [36338]: https://github.com/rust-lang/rust/pull/36338
2960 [36351]: https://github.com/rust-lang/rust/pull/36351
2961 [36355]: https://github.com/rust-lang/rust/pull/36355
2962 [36369]: https://github.com/rust-lang/rust/pull/36369
2963 [36372]: https://github.com/rust-lang/rust/pull/36372
2964 [36423]: https://github.com/rust-lang/rust/pull/36423
2965 [36482]: https://github.com/rust-lang/rust/pull/36482
2966 [36505]: https://github.com/rust-lang/rust/pull/36505
2967 [36524]: https://github.com/rust-lang/rust/pull/36524
2968 [36527]: https://github.com/rust-lang/rust/pull/36527
2969 [36551]: https://github.com/rust-lang/rust/pull/36551
2970 [36574]: https://github.com/rust-lang/rust/pull/36574
2971 [36586]: https://github.com/rust-lang/rust/pull/36586
2972 [36592]: https://github.com/rust-lang/rust/pull/36592
2973 [36631]: https://github.com/rust-lang/rust/pull/36631
2974 [36639]: https://github.com/rust-lang/rust/pull/36639
2975 [36721]: https://github.com/rust-lang/rust/pull/36721
2976 [36727]: https://github.com/rust-lang/rust/pull/36727
2977 [36730]: https://github.com/rust-lang/rust/pull/36730
2978 [36734]: https://github.com/rust-lang/rust/pull/36734
2979 [36754]: https://github.com/rust-lang/rust/pull/36754
2980 [36995]: https://github.com/rust-lang/rust/pull/36995
2981 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
2982 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
2983 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2984 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
2985 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
2986 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
2987 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
2988 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
2989 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
2990 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
2991 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
2992 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
2993 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
2994 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
2995 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
2996 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
2997 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
2998 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
2999 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3000 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3001 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3002 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3003 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3004 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3005 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3006 [rustup]: https://www.rustup.rs
3007 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3008 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3009 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3010 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3011 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3012 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3013 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3014
3015
3016 Version 1.12.1 (2016-10-20)
3017 ===========================
3018
3019 Regression Fixes
3020 ----------------
3021
3022 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3023 * [Confusion with double negation and booleans][36856]
3024 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3025 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3026 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3027 * [Corrupted memory after updated to 1.12][36936]
3028 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3029 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3030 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3031
3032 [36381]: https://github.com/rust-lang/rust/issues/36381
3033 [36856]: https://github.com/rust-lang/rust/issues/36856
3034 [36875]: https://github.com/rust-lang/rust/issues/36875
3035 [36924]: https://github.com/rust-lang/rust/issues/36924
3036 [36926]: https://github.com/rust-lang/rust/issues/36926
3037 [36936]: https://github.com/rust-lang/rust/issues/36936
3038 [37026]: https://github.com/rust-lang/rust/issues/37026
3039 [37112]: https://github.com/rust-lang/rust/issues/37112
3040 [37153]: https://github.com/rust-lang/rust/issues/37153
3041
3042
3043 Version 1.12.0 (2016-09-29)
3044 ===========================
3045
3046 Highlights
3047 ----------
3048
3049 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3050   This translation pass is far simpler than the previous AST->LLVM pass, and
3051   creates opportunities to perform new optimizations directly on the MIR. It
3052   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3053 * [`rustc` presents a new, more readable error format, along with
3054   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3055   Most common editors supporting Rust have been updated to work with it. It was
3056   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3057
3058 Compiler
3059 --------
3060
3061 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3062   This translation pass is far simpler than the previous AST->LLVM pass, and
3063   creates opportunities to perform new optimizations directly on the MIR. It
3064   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3065 * [Print the Rust target name, not the LLVM target name, with
3066   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3067 * [The computation of `TypeId` is correct in some cases where it was previously
3068   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3069 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3070 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3071   `--print relocation-models`, and `--print code-models` print the available
3072   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3073   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3074 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3075   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3076   These targets produce statically-linked binaries. There are no binary release
3077   builds yet though.
3078
3079 Diagnostics
3080 -----------
3081
3082 * [`rustc` presents a new, more readable error format, along with
3083   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3084   Most common editors supporting Rust have been updated to work with it. It was
3085   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3086 * [In error descriptions, references are now described in plain English,
3087   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3088 * [In error type descriptions, unknown numeric types are named `{integer}` or
3089   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3090 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3091
3092 Language
3093 --------
3094
3095 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3096 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3097 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3098   useful](https://github.com/rust-lang/rust/pull/34908)
3099 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3100   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3101 * [Semicolons are properly required as statement delimiters inside
3102   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3103 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3104
3105 Stabilized APIs
3106 ---------------
3107
3108 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3109 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3110 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3111 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3112 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3113 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3114 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3115 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3116 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3117 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3118   Both on Unix and Windows.
3119 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3120 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3121 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3122 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3123 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3124 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3125 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3126 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3127
3128 Libraries
3129 ---------
3130
3131 * [The `format!` macro and friends now allow a single argument to be formatted
3132   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3133 * [The lifetime bounds on `[T]::binary_search_by` and
3134   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3135 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3136 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3137 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3138 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3139 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3140 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3141 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3142 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3143   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3144 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3145   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3146 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3147 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3148   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3149 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3150 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3151 * [`mpsc::sync_channel` `Receiver`s return any available message before
3152   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3153 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3154 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3155
3156 Cargo
3157 -----
3158
3159 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3160 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3161 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3162 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3163 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3164 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3165 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3166 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3167 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3168 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3169 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3170 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3171 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3172 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3173 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3174 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3175
3176 Performance
3177 -----------
3178
3179 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3180 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3181
3182 Tooling
3183 -------
3184
3185 * [Test binaries now support a `--test-threads` argument to specify the number
3186   of threads used to run tests, and which acts the same as the
3187   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3188 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3189 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3190 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3191 * [Rust releases now come with source packages that can be installed by rustup
3192   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3193   The resulting source code can be used by tools and IDES, located in the
3194   sysroot under `lib/rustlib/src`.
3195
3196 Misc
3197 ----
3198
3199 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3200 * Many minor improvements to the documentation.
3201 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3202
3203 Compatibility Notes
3204 -------------------
3205
3206 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3207   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3208 * [When formatting strings, if "precision" is specified, the "fill",
3209   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3210 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3211
3212
3213 Version 1.11.0 (2016-08-18)
3214 ===========================
3215
3216 Language
3217 --------
3218
3219 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3220 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3221 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3222 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3223 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3224
3225 Stabilized APIs
3226 ---------------
3227
3228 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3229 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3230 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3231 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3232 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3233 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3234   (in libcore - previously stabilized in libstd)
3235 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3236   (in libcore - previously stabilized in libstd)
3237 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3238   (in libcore - previously stabilized in libstd)
3239 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3240   (in libcore - previously stabilized in libstd)
3241 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3242 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3243 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3244 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3245
3246 Libraries
3247 ---------
3248
3249 * [The `thread_local!` macro supports multiple definitions in a single
3250    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3251 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3252 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3253   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3254 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3255 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3256 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3257 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3258
3259 Cargo
3260 -----
3261
3262 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3263 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3264 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3265 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3266 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3267   and `-vv` prints warnings for all crates.
3268 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3269 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3270   This provides room for expansion by arbitrary tools.
3271 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3272 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3273 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3274 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3275 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3276 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3277 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3278
3279 Performance
3280 -----------
3281
3282 * [Caching projections speeds up type check dramatically for some
3283   workloads](https://github.com/rust-lang/rust/pull/33816)
3284 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3285   This hasher is faster, but is believed to provide sufficient
3286   protection from collision attacks.
3287 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3288
3289 Rustdoc
3290 -------
3291
3292 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3293 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3294 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3295 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3296 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3297
3298 Tooling
3299 -------
3300
3301 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3302 * [When emitting debug info, rustc emits frame pointers for closures,
3303   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3304 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3305 * Many more errors have been given error codes and extended
3306   explanations
3307 * API documentation continues to be improved, with many new examples
3308
3309 Misc
3310 ----
3311
3312 * [rustc no longer hangs when dependencies recursively re-export
3313   submodules](https://github.com/rust-lang/rust/pull/34542)
3314 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3315 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3316   rewritten](https://github.com/rust-lang/rust/pull/33895)
3317 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3318   No targets use this yet, but it works toward AVR support.
3319
3320 Compatibility Notes
3321 -------------------
3322
3323 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3324 * [The new follow-set rules that place restrictions on `macro_rules!`
3325   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3326   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3327   and has been a warning since 1.10.
3328 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3329   This causes breakage in some corner cases.
3330
3331
3332 Version 1.10.0 (2016-07-07)
3333 ===========================
3334
3335 Language
3336 --------
3337
3338 * [Allow `concat_idents!` in type positions as well as in expression
3339   positions](https://github.com/rust-lang/rust/pull/33735).
3340 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3341   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3342 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3343 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3344 * [`panic!` can be converted to a runtime abort with the
3345   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3346   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3347 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3348   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3349   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3350   Note that Cargo does not yet directly support cdylibs.
3351
3352 Stabilized APIs
3353 ---------------
3354
3355 * `os::windows::fs::OpenOptionsExt::access_mode`
3356 * `os::windows::fs::OpenOptionsExt::share_mode`
3357 * `os::windows::fs::OpenOptionsExt::custom_flags`
3358 * `os::windows::fs::OpenOptionsExt::attributes`
3359 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3360 * `os::unix::fs::OpenOptionsExt::custom_flags`
3361 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3362 * `Default for sync::Weak`
3363 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3364 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3365 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3366 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3367 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3368 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3369 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3370 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3371 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3372 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3373 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3374 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3375 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3376 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3377 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3378 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3379 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3380 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3381 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3382 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3383 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3384 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3385 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3386 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3387 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3388 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3389 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3390 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3391 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3392 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3393 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3394 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3395 * Read/Write/RawFd impls for `UnixStream`
3396 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3397 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3398 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3399 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3400 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3401 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3402 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3403 * RawFd impls for `UnixListener`
3404 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3405 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3406 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3407 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3408 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3409 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3410 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3411 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3412 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3413 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3414 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3415 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3416 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3417 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3418 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3419 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3420 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3421 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3422 * RawFd impls for `UnixDatagram`
3423 * `{BTree,Hash}Map::values_mut`
3424 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3425
3426 Libraries
3427 ---------
3428
3429 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3430   The semantics of this minor method are subtle and probably not what
3431   most people want.
3432 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3433 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3434   will fall back to `/dev/urandom` temporarily to avoid blocking
3435   during early boot](https://github.com/rust-lang/rust/pull/33086).
3436 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3437 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3438 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3439 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3440 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3441 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3442   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3443
3444 Cargo
3445 -----
3446 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3447   This controls the runtime behavior of the `panic!` macro
3448   and can be either "unwind" (the default), or "abort".
3449   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3450 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3451 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3452 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3453   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3454 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3455 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3456 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3457   By default they are retried twice, which can be customized with the
3458   `net.retry` value in `.cargo/config`.
3459 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3460 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3461 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3462 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3463   Makes it possible to install multiple crates in parallel.
3464 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3465 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3466 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3467 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3468 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3469 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3470
3471 Performance
3472 -----------
3473
3474 * [rustc memory usage was reduced by refactoring the context used for
3475   type checking](https://github.com/rust-lang/rust/pull/33425).
3476 * [Speed up creation of `HashMap`s by caching the random keys used
3477   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3478 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3479 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3480 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3481   10x faster than the previous lookup tables.
3482 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3483
3484 Usability
3485 ---------
3486
3487 * Many incremental improvements to documentation and rustdoc.
3488 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3489 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3490 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3491 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3492 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3493 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3494 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3495
3496 Misc
3497 ----
3498
3499 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3500 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3501 * [`std` no longer prints backtraces on platforms where the running
3502   module must be loaded with `env::current_exe`, which can't be relied
3503   on](https://github.com/rust-lang/rust/pull/33554).
3504 * This release includes std binaries for the i586-unknown-linux-gnu,
3505   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3506   i586 target is for old x86 hardware without SSE2, and the armv7
3507   target is for Android running on modern ARM architectures.
3508 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3509   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3510 * [On Unix the runtime aborts by calling `libc::abort` instead of
3511   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3512 * [Rust is now bootstrapped from the previous release of Rust,
3513   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3514
3515 Compatibility Notes
3516 -------------------
3517
3518 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3519 * [`target_env` for Linux ARM targets is just `gnu`, not
3520   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3521 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3522 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3523 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3524   Affects how macros are parsed.
3525 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3526 * [Feature-gated attributes on macro-generated macro invocations are
3527   now rejected](https://github.com/rust-lang/rust/pull/32791).
3528 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3529   This caused some minor changes to type inference.
3530
3531
3532 Version 1.9.0 (2016-05-26)
3533 ==========================
3534
3535 Language
3536 --------
3537
3538 * The `#[deprecated]` attribute when applied to an API will generate
3539   warnings when used. The warnings may be suppressed with
3540   `#[allow(deprecated)]`. [RFC 1270].
3541 * [`fn` item types are zero sized, and each `fn` names a unique
3542   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3543   `transmute` on a `fn` type will generate a warning for a few cycles,
3544   then will be converted to an error.
3545 * [Field and method resolution understand visibility, so private
3546   fields and methods cannot prevent the proper use of public fields
3547   and methods][1.9fv].
3548 * [The parser considers unicode codepoints in the
3549   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3550
3551 Stabilized APIs
3552 ---------------
3553
3554 * [`std::panic`]
3555 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3556 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3557 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3558 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3559 * [`str::is_char_boundary`]
3560 * [`<*const T>::as_ref`]
3561 * [`<*mut T>::as_ref`]
3562 * [`<*mut T>::as_mut`]
3563 * [`AsciiExt::make_ascii_uppercase`]
3564 * [`AsciiExt::make_ascii_lowercase`]
3565 * [`char::decode_utf16`]
3566 * [`char::DecodeUtf16`]
3567 * [`char::DecodeUtf16Error`]
3568 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3569 * [`BTreeSet::take`]
3570 * [`BTreeSet::replace`]
3571 * [`BTreeSet::get`]
3572 * [`HashSet::take`]
3573 * [`HashSet::replace`]
3574 * [`HashSet::get`]
3575 * [`OsString::with_capacity`]
3576 * [`OsString::clear`]
3577 * [`OsString::capacity`]
3578 * [`OsString::reserve`]
3579 * [`OsString::reserve_exact`]
3580 * [`OsStr::is_empty`]
3581 * [`OsStr::len`]
3582 * [`std::os::unix::thread`]
3583 * [`RawPthread`]
3584 * [`JoinHandleExt`]
3585 * [`JoinHandleExt::as_pthread_t`]
3586 * [`JoinHandleExt::into_pthread_t`]
3587 * [`HashSet::hasher`]
3588 * [`HashMap::hasher`]
3589 * [`CommandExt::exec`]
3590 * [`File::try_clone`]
3591 * [`SocketAddr::set_ip`]
3592 * [`SocketAddr::set_port`]
3593 * [`SocketAddrV4::set_ip`]
3594 * [`SocketAddrV4::set_port`]
3595 * [`SocketAddrV6::set_ip`]
3596 * [`SocketAddrV6::set_port`]
3597 * [`SocketAddrV6::set_flowinfo`]
3598 * [`SocketAddrV6::set_scope_id`]
3599 * [`slice::copy_from_slice`]
3600 * [`ptr::read_volatile`]
3601 * [`ptr::write_volatile`]
3602 * [`OpenOptions::create_new`]
3603 * [`TcpStream::set_nodelay`]
3604 * [`TcpStream::nodelay`]
3605 * [`TcpStream::set_ttl`]
3606 * [`TcpStream::ttl`]
3607 * [`TcpStream::set_only_v6`]
3608 * [`TcpStream::only_v6`]
3609 * [`TcpStream::take_error`]
3610 * [`TcpStream::set_nonblocking`]
3611 * [`TcpListener::set_ttl`]
3612 * [`TcpListener::ttl`]
3613 * [`TcpListener::set_only_v6`]
3614 * [`TcpListener::only_v6`]
3615 * [`TcpListener::take_error`]
3616 * [`TcpListener::set_nonblocking`]
3617 * [`UdpSocket::set_broadcast`]
3618 * [`UdpSocket::broadcast`]
3619 * [`UdpSocket::set_multicast_loop_v4`]
3620 * [`UdpSocket::multicast_loop_v4`]
3621 * [`UdpSocket::set_multicast_ttl_v4`]
3622 * [`UdpSocket::multicast_ttl_v4`]
3623 * [`UdpSocket::set_multicast_loop_v6`]
3624 * [`UdpSocket::multicast_loop_v6`]
3625 * [`UdpSocket::set_multicast_ttl_v6`]
3626 * [`UdpSocket::multicast_ttl_v6`]
3627 * [`UdpSocket::set_ttl`]
3628 * [`UdpSocket::ttl`]
3629 * [`UdpSocket::set_only_v6`]
3630 * [`UdpSocket::only_v6`]
3631 * [`UdpSocket::join_multicast_v4`]
3632 * [`UdpSocket::join_multicast_v6`]
3633 * [`UdpSocket::leave_multicast_v4`]
3634 * [`UdpSocket::leave_multicast_v6`]
3635 * [`UdpSocket::take_error`]
3636 * [`UdpSocket::connect`]
3637 * [`UdpSocket::send`]
3638 * [`UdpSocket::recv`]
3639 * [`UdpSocket::set_nonblocking`]
3640
3641 Libraries
3642 ---------
3643
3644 * [`std::sync::Once` is poisoned if its initialization function
3645   fails][1.9o].
3646 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3647 * [Most types implement `fmt::Debug`][1.9db].
3648 * [The default buffer size used by `BufReader` and `BufWriter` was
3649   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3650   used by other languages.
3651 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3652   `Duration` additionally implements `*=` and `/=`][1.9ta].
3653 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3654 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3655 * [`Chain` implements `BufRead`][1.9ch].
3656 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3657
3658 Cargo
3659 -----
3660
3661 * [Cargo can now run concurrently][1.9cc].
3662 * [Top-level overrides allow specific revisions of crates to be
3663   overridden through the entire crate graph][1.9ct].  This is intended
3664   to make upgrades easier for large projects, by allowing crates to be
3665   forked temporarily until they've been upgraded and republished.
3666 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3667 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3668   on the commandline][1.9cf]. `rustc` arguments can also be specified
3669   in the `build.rustflags` configuration key.
3670
3671 Performance
3672 -----------
3673
3674 * [The time complexity of comparing variables for equivalence during type
3675   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3676   to major compilation time improvement in some scenarios.
3677 * [`ToString` is specialized for `str`, giving it the same performance
3678   as `to_owned`][1.9ts].
3679 * [Spawning processes with `Command::output` no longer creates extra
3680   threads][1.9sp].
3681 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3682   for C-like enums][1.9cl].
3683
3684 Misc
3685 ----
3686
3687 * [Passing the `--quiet` flag to a test runner will produce
3688   much-abbreviated output][1.9q].
3689 * The Rust Project now publishes std binaries for the
3690   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3691   `i586-pc-windows-msvc` targets.
3692
3693 Compatibility Notes
3694 -------------------
3695
3696 * [`std::sync::Once` is poisoned if its initialization function
3697   fails][1.9o].
3698 * [It is illegal to define methods with the same name in overlapping
3699   inherent `impl` blocks][1.9sn].
3700 * [`fn` item types are zero sized, and each `fn` names a unique
3701   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3702   `transmute` on a `fn` type will generate a warning for a few cycles,
3703   then will be converted to an error.
3704 * [Improvements to const evaluation may trigger new errors when integer
3705   literals are out of range][1.9ce].
3706
3707
3708 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3709 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3710 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3711 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3712 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3713 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3714 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3715 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3716 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3717 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3718 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3719 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3720 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3721 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3722 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3723 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3724 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3725 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3726 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3727 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3728 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3729 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3730 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3731 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3732 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3733 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3734 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3735 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3736 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3737 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3738 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3739 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3740 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3741 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3742 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3743 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3744 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3745 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3746 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3747 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3748 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3749 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3750 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3751 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3752 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3753 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3754 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3755 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3756 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3757 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3758 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3759 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3760 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3761 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3762 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3763 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3764 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3765 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3766 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3767 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3768 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3769 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3770 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3771 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3772 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3773 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3774 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3775 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3776 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3777 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3778 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3779 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3780 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3781 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3782 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3783 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3784 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3785 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3786 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3787 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3788 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3789 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3790 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3791 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3792 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3793 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3794 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3795 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3796 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3797 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3798 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3799 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3800 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3801 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3802 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3803 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3804 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3805 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3806 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3807 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3808 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3809 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3810 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3811 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3812 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3813 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3814 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3815 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3816 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3817 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3818
3819
3820 Version 1.8.0 (2016-04-14)
3821 ==========================
3822
3823 Language
3824 --------
3825
3826 * Rust supports overloading of compound assignment statements like
3827   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3828   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3829   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3830   traits. [RFC 953].
3831 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3832   addition to the non-braced form, `struct Foo;`. [RFC 218].
3833
3834 Libraries
3835 ---------
3836
3837 * Stabilized APIs:
3838   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3839   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3840   * [`Ref::map`]
3841   * [`RefMut::map`]
3842   * [`ptr::drop_in_place`]
3843   * [`time::Instant`]
3844   * [`time::SystemTime`]
3845   * [`Instant::now`]
3846   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3847   * [`Instant::elapsed`]
3848   * [`SystemTime::now`]
3849   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3850   * [`SystemTime::elapsed`]
3851   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3852   * [`SystemTimeError`]
3853   * [`SystemTimeError::duration`]
3854   * Various impls for `SystemTimeError`
3855   * [`UNIX_EPOCH`]
3856   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3857     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3858     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3859 * [The `write!` and `writeln!` macros correctly emit errors if any of
3860   their arguments can't be formatted][1.8w].
3861 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3862 * [The Unix-specific `raw` modules, which contain a number of
3863   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3864   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3865   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3866   across platforms was making it difficult to implement `std`
3867   correctly. Those that need these definitions should use the `libc`
3868   crate. [RFC 1415].
3869 * The Unix-specific `MetadataExt` traits, including
3870   `os::unix::fs::MetadataExt`, which expose values such as inode
3871   numbers [no longer return platform-specific types][1.8r], but
3872   instead return widened integers. [RFC 1415].
3873 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3874 * [Atomic loads and stores are not volatile][1.8a].
3875 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3876
3877 Performance
3878 -----------
3879
3880 * [Inlining hash functions lead to a 3% compile-time improvement in
3881   some workloads][1.8h].
3882 * When using jemalloc, its symbols are [unprefixed so that it
3883   overrides the libc malloc implementation][1.8h]. This means that for
3884   rustc, LLVM is now using jemalloc, which results in a 6%
3885   compile-time improvement on a specific workload.
3886 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3887
3888 Misc
3889 ----
3890
3891 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3892   i686-pc-windows-msvc is now considered a tier-1 platform.
3893 * [The `--print targets` flag prints a list of supported targets][1.8t].
3894 * [The `--print cfg` flag prints the `cfg`s defined for the current
3895   target][1.8cf].
3896 * [`rustc` can be built with an new Cargo-based build system, written
3897   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3898   build system. To enable it configure with `configure --rustbuild`.
3899 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3900   variants while also indicating the total number of missing variants
3901   if more than 3][1.8m].
3902 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3903 * The Rust Project now publishes binary releases of the standard
3904   library for a number of tier-2 targets:
3905   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3906   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3907   `x86_64-rumprun-netbsd`. These can be installed with
3908   tools such as [multirust][1.8mr].
3909
3910 Cargo
3911 -----
3912
3913 * [`cargo init` creates a new Cargo project in the current
3914   directory][1.8ci].  It is otherwise like `cargo new`.
3915 * [Cargo has configuration keys for `-v` and
3916   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3917   `[term]` section of `.cargo/config`.
3918 * [Configuration keys that evaluate to strings or integers can be set
3919   via environment variables][1.8ce]. For example the `build.jobs` key
3920   can be set via `CARGO_BUILD_JOBS`. Environment variables take
3921   precedence over config files.
3922 * [Target-specific dependencies support Rust `cfg` syntax for
3923   describing targets][1.8cfg] so that dependencies for multiple
3924   targets can be specified together. [RFC 1361].
3925 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
3926   `RUSTDOC` take precedence over the `build.target-dir`,
3927   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
3928 * [The child process tree is killed on Windows when Cargo is
3929   killed][1.8ck].
3930 * [The `build.target` configuration value sets the target platform,
3931   like `--target`][1.8ct].
3932
3933 Compatibility Notes
3934 -------------------
3935
3936 * [Unstable compiler flags have been further restricted][1.8u]. Since
3937   1.0 `-Z` flags have been considered unstable, and other flags that
3938   were considered unstable additionally required passing `-Z
3939   unstable-options` to access. Unlike unstable language and library
3940   features though, these options have been accessible on the stable
3941   release channel. Going forward, *new unstable flags will not be
3942   available on the stable release channel*, and old unstable flags
3943   will warn about their usage. In the future, all unstable flags will
3944   be unavailable on the stable release channel.
3945 * [It is no longer possible to `match` on empty enum variants using
3946   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
3947 * The Unix-specific `MetadataExt` traits, including
3948   `os::unix::fs::MetadataExt`, which expose values such as inode
3949   numbers [no longer return platform-specific types][1.8r], but
3950   instead return widened integers. [RFC 1415].
3951 * [Modules sourced from the filesystem cannot appear within arbitrary
3952   blocks, but only within other modules][1.8mf].
3953 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
3954 * On Unix, [stack overflow triggers a runtime abort instead of a
3955   SIGSEGV][1.8so].
3956 * [`Command::spawn` and its equivalents return an error if any of
3957   its command-line arguments contain interior `NUL`s][1.8n].
3958 * [Tuple and unit enum variants from other crates are in the type
3959   namespace][1.8tn].
3960 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
3961   type instead of `.a` files][1.8st]. Additionally, for the MSVC
3962   toolchain, `rustc` emits import libraries named `foo.dll.lib`
3963   instead of `foo.lib`.
3964
3965
3966 [1.8a]: https://github.com/rust-lang/rust/pull/30962
3967 [1.8b]: https://github.com/rust-lang/rust/pull/31123
3968 [1.8c]: https://github.com/rust-lang/rust/pull/31530
3969 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
3970 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
3971 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
3972 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
3973 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
3974 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
3975 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
3976 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
3977 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
3978 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
3979 [1.8h]: https://github.com/rust-lang/rust/pull/31460
3980 [1.8l]: https://github.com/rust-lang/rust/pull/31668
3981 [1.8m]: https://github.com/rust-lang/rust/pull/31020
3982 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
3983 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
3984 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
3985 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
3986 [1.8n]: https://github.com/rust-lang/rust/pull/31056
3987 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
3988 [1.8r]: https://github.com/rust-lang/rust/pull/31551
3989 [1.8so]: https://github.com/rust-lang/rust/pull/31333
3990 [1.8st]: https://github.com/rust-lang/rust/pull/29520
3991 [1.8t]: https://github.com/rust-lang/rust/pull/31358
3992 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
3993 [1.8u]: https://github.com/rust-lang/rust/pull/31793
3994 [1.8v]: https://github.com/rust-lang/rust/pull/31757
3995 [1.8w]: https://github.com/rust-lang/rust/pull/31904
3996 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
3997 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
3998 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
3999 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4000 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4001 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4002 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4003 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4004 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4005 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4006 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4007 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4008 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4009 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4010 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4011 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4012 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4013 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4014 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4015 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4016 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4017 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4018 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4019 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4020 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4021 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4022 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4023 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4024 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4025 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4026
4027
4028 Version 1.7.0 (2016-03-03)
4029 ==========================
4030
4031 Libraries
4032 ---------
4033
4034 * Stabilized APIs
4035   * `Path`
4036     * [`Path::strip_prefix`][] (renamed from relative_from)
4037     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4038   * `Ipv4Addr`
4039     * [`Ipv4Addr::is_loopback`]
4040     * [`Ipv4Addr::is_private`]
4041     * [`Ipv4Addr::is_link_local`]
4042     * [`Ipv4Addr::is_multicast`]
4043     * [`Ipv4Addr::is_broadcast`]
4044     * [`Ipv4Addr::is_documentation`]
4045   * `Ipv6Addr`
4046     * [`Ipv6Addr::is_unspecified`]
4047     * [`Ipv6Addr::is_loopback`]
4048     * [`Ipv6Addr::is_multicast`]
4049   * `Vec`
4050     * [`Vec::as_slice`]
4051     * [`Vec::as_mut_slice`]
4052   * `String`
4053     * [`String::as_str`]
4054     * [`String::as_mut_str`]
4055   * Slices
4056     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4057     be the same length
4058     * `<[T]>::`[`sort_by_key`]
4059   * checked, saturated, and overflowing operations
4060     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4061     * [`i32::saturating_mul`]
4062     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4063     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4064     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4065     * [`u32::saturating_mul`]
4066     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4067     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4068     * and checked, saturated, and overflowing operations for other primitive types
4069   * FFI
4070     * [`ffi::IntoStringError`]
4071     * [`CString::into_string`]
4072     * [`CString::into_bytes`]
4073     * [`CString::into_bytes_with_nul`]
4074     * `From<CString> for Vec<u8>`
4075   * `IntoStringError`
4076     * [`IntoStringError::into_cstring`]
4077     * [`IntoStringError::utf8_error`]
4078     * `Error for IntoStringError`
4079   * Hashing
4080     * [`std::hash::BuildHasher`]
4081     * [`BuildHasher::Hasher`]
4082     * [`BuildHasher::build_hasher`]
4083     * [`std::hash::BuildHasherDefault`]
4084     * [`HashMap::with_hasher`]
4085     * [`HashMap::with_capacity_and_hasher`]
4086     * [`HashSet::with_hasher`]
4087     * [`HashSet::with_capacity_and_hasher`]
4088     * [`std::collections::hash_map::RandomState`]
4089     * [`RandomState::new`]
4090 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4091   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4092   from bytes is faster.
4093 * [The performance of `LineWriter` (and thus `io::stdout`) was
4094   improved by using `memchr` to search for newlines][1.7m].
4095 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4096   `f64` variants were stabilized previously.
4097 * [`BTreeMap` was rewritten to use less memory and improve the performance
4098   of insertion and iteration, the latter by as much as 5x][1.7bm].
4099 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4100   covariant over their contained type][1.7bt].
4101 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4102   over their contained type][1.7ll].
4103 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4104   searching methods.
4105 * [`Any` is implemented for unsized types][1.7a].
4106 * [`Hash` is implemented for `Duration`][1.7h].
4107
4108 Misc
4109 ----
4110
4111 * [When running tests with `--test`, rustdoc will pass `--cfg`
4112   arguments to the compiler][1.7dt].
4113 * [The compiler is built with RPATH information by default][1.7rpa].
4114   This means that it will be possible to run `rustc` when installed in
4115   unusual configurations without configuring the dynamic linker search
4116   path explicitly.
4117 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4118   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4119   over `LD_LIBRARY_PATH`.
4120
4121 Cargo
4122 -----
4123
4124 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4125   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4126 * [The `rerun-if-changed` build script directive no longer causes the
4127   build script to incorrectly run twice in certain scenarios][1.7rr].
4128
4129 Compatibility Notes
4130 -------------------
4131
4132 * Soundness fixes to the interactions between associated types and
4133   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4134   code that violates the new rules. This is a significant change that
4135   is known to break existing code, so it has emitted warnings for the
4136   new error cases since 1.4 to give crate authors time to adapt. The
4137   details of what is changing are subtle; read the RFC for more.
4138 * [Several bugs in the compiler's visibility calculations were
4139   fixed][1.7v]. Since this was found to break significant amounts of
4140   code, the new errors will be emitted as warnings for several release
4141   cycles, under the `private_in_public` lint.
4142 * Defaulted type parameters were accidentally accepted in positions
4143   that were not intended. In this release, [defaulted type parameters
4144   appearing outside of type definitions will generate a
4145   warning][1.7d], which will become an error in future releases.
4146 * [Parsing "." as a float results in an error instead of 0][1.7p].
4147   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4148 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4149
4150 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4151 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4152 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4153 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4154 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4155 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4156 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4157 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4158 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4159 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4160 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4161 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4162 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4163 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4164 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4165 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4166 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4167 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4168 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4169 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4170 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4171 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4172 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4173 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4174 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4175 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4176 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4177 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4178 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4179 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4180 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4181 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4182 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4183 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4184 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4185 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4186 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4187 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4188 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4189 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4190 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4191 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4192 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4193 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4194 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4195 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4196 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4197 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4198 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4199 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4200 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4201 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4202 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4203 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4204 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4205 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4206 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4207 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4208 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4209 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4210 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4211 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4212 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4213 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4214 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4215 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4216 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4217 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4218 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4219 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4220 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4221 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4222 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4223 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4224 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4225 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4226 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4227 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4228 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4229
4230
4231 Version 1.6.0 (2016-01-21)
4232 ==========================
4233
4234 Language
4235 --------
4236
4237 * The `#![no_std]` attribute causes a crate to not be linked to the
4238   standard library, but only the [core library][1.6co], as described
4239   in [RFC 1184]. The core library defines common types and traits but
4240   has no platform dependencies whatsoever, and is the basis for Rust
4241   software in environments that cannot support a full port of the
4242   standard library, such as operating systems. Most of the core
4243   library is now stable.
4244
4245 Libraries
4246 ---------
4247
4248 * Stabilized APIs:
4249   [`Read::read_exact`],
4250   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4251   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4252   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4253   [`os::unix::fs::DirBuilderExt`],
4254   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4255   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4256   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4257   [`collections::hash_map::Drain`],
4258   [`collections::hash_map::HashMap::drain`],
4259   [`collections::hash_set::Drain`],
4260   [`collections::hash_set::HashSet::drain`],
4261   [`collections::binary_heap::Drain`],
4262   [`collections::binary_heap::BinaryHeap::drain`],
4263   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4264   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4265   [`RwLock::into_inner`],
4266   [`Iterator::min_by_key`][] (renamed from `min_by`),
4267   [`Iterator::max_by_key`][] (renamed from `max_by`).
4268 * The [core library][1.6co] is stable, as are most of its APIs.
4269 * [The `assert_eq!` macro supports arguments that don't implement
4270   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4271   `assert!`.
4272 * Several timer functions that take duration in milliseconds [are
4273   deprecated in favor of those that take `Duration`][1.6ms]. These
4274   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4275   `thread::park_timeout_ms`.
4276 * The algorithm by which `Vec` reserves additional elements was
4277   [tweaked to not allocate excessive space][1.6a] while still growing
4278   exponentially.
4279 * `From` conversions are [implemented from integers to floats][1.6f]
4280   in cases where the conversion is lossless. Thus they are not
4281   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4282   or `f64`. They are also not implemented for `isize` and `usize`
4283   because the implementations would be platform-specific. `From` is
4284   also implemented from `f32` to `f64`.
4285 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4286 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4287 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4288 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4289   improvements.
4290 * Sorting slices that are already sorted [is 50% faster in some
4291   cases][1.6s].
4292
4293 Cargo
4294 -----
4295
4296 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4297 * Cargo build scripts can specify their dependencies by emitting the
4298   [`rerun-if-changed`][1.6rr] key.
4299 * crates.io will reject publication of crates with dependencies that
4300   have a wildcard version constraint. Crates with wildcard
4301   dependencies were seen to cause a variety of problems, as described
4302   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4303   warning.
4304 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4305   release folder.  A variety of artifacts that Cargo failed to clean
4306   are now correctly deleted.
4307
4308 Misc
4309 ----
4310
4311 * The `unreachable_code` lint [warns when a function call's argument
4312   diverges][1.6dv].
4313 * The parser indicates [failures that may be caused by
4314   confusingly-similar Unicode characters][1.6uc]
4315 * Certain macro errors [are reported at definition time][1.6m], not
4316   expansion.
4317
4318 Compatibility Notes
4319 -------------------
4320
4321 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4322   environment variable when locating crates. This was a pre-cargo
4323   feature for integrating with the package manager that was
4324   accidentally never removed.
4325 * [A number of bugs were fixed in the privacy checker][1.6p] that
4326   could cause previously-accepted code to break.
4327 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4328 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4329   struct pattern syntax (`Foo(..)`) can no longer be used to match
4330   unit structs. This is a warning now, but will become an error in
4331   future releases. Patterns that share the same name as a const are
4332   now an error.
4333 * A bug was fixed that causes [rustc not to apply default type
4334   parameters][1.6xc] when resolving certain method implementations of
4335   traits defined in other crates.
4336
4337 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4338 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4339 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4340 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4341 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4342 [1.6co]: http://doc.rust-lang.org/core/index.html
4343 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4344 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4345 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4346 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4347 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4348 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4349 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4350 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4351 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4352 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4353 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4354 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4355 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4356 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4357 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4358 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4359 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4360 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4361 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4362 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4363 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4364 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4365 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4366 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4367 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4368 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4369 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4370 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4371 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4372 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4373 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4374 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4375 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4376 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4377 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4378 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4379 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4380 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4381 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4382 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4383 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4384
4385
4386 Version 1.5.0 (2015-12-10)
4387 ==========================
4388
4389 * ~700 changes, numerous bugfixes
4390
4391 Highlights
4392 ----------
4393
4394 * Stabilized APIs:
4395   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4396   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4397   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4398   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4399   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4400   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4401   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4402   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4403   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4404   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4405   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4406   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4407   [`Path::read_link`], [`Path::symlink_metadata`],
4408   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4409   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4410   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4411   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4412   [`slice::split_first_mut`], [`slice::split_first`],
4413   [`slice::split_last_mut`], [`slice::split_last`],
4414   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4415   [`str::MatchIndices`], [`str::RMatchIndices`],
4416   [`str::match_indices`], [`str::rmatch_indices`],
4417   [`str::slice_mut_unchecked`], [`string::ParseError`].
4418 * Rust applications hosted on crates.io can be installed locally to
4419   `~/.cargo/bin` with the [`cargo install`] command. Among other
4420   things this makes it easier to augment Cargo with new subcommands:
4421   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4422   invoked as `cargo foo`.
4423 * Crates with wildcard (`*`) dependencies will [emit warnings when
4424   published][1.5w]. In 1.6 it will no longer be possible to publish
4425   crates with wildcard dependencies.
4426
4427 Breaking Changes
4428 ----------------
4429
4430 * The rules determining when a particular lifetime must outlive
4431   a particular value (known as '[dropck]') have been [modified
4432   to not rely on parametricity][1.5p].
4433 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4434   and `Arc`][1.5a]. Because these smart pointer types implement
4435   `Deref`, this causes breakage in cases where the interior type
4436   contains methods of the same name.
4437 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4438   that they could drop their content. Soundness fix.
4439 * All method invocations are [properly checked][1.5wf1] for
4440   [well-formedness][1.5wf2]. Soundness fix.
4441 * Traits whose supertraits contain `Self` are [not object
4442   safe][1.5o]. Soundness fix.
4443 * Target specifications support a [`no_default_libraries`][1.5nd]
4444   setting that controls whether `-nodefaultlibs` is passed to the
4445   linker, and in turn the `is_like_windows` setting no longer affects
4446   the `-nodefaultlibs` flag.
4447 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4448 * The `#[inline]` and `#[repr]` attributes [can only appear
4449   in valid locations][1.5at].
4450 * Native libraries linked from the local crate are [passed to
4451   the linker before native libraries from upstream crates][1.5nl].
4452 * Two rarely-used attributes, `#[no_debug]` and
4453   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4454 * Negation of unsigned integers, which has been a warning for
4455   several releases, [is now behind a feature gate and will
4456   generate errors][1.5nu].
4457 * The parser accidentally accepted visibility modifiers on
4458   enum variants, a bug [which has been fixed][1.5ev].
4459 * [A bug was fixed that allowed `use` statements to import unstable
4460   features][1.5use].
4461
4462 Language
4463 --------
4464
4465 * When evaluating expressions at compile-time that are not
4466   compile-time constants (const-evaluating expressions in non-const
4467   contexts), incorrect code such as overlong bitshifts and arithmetic
4468   overflow will [generate a warning instead of an error][1.5ce],
4469   delaying the error until runtime. This will allow the
4470   const-evaluator to be expanded in the future backwards-compatibly.
4471 * The `improper_ctypes` lint [no longer warns about using `isize` and
4472   `usize` in FFI][1.5ict].
4473
4474 Libraries
4475 ---------
4476
4477 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4478   invariant][1.5c].
4479 * `Default` is [implemented for mutable slices][1.5d].
4480 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4481 * There are now `From` conversions [between floating point
4482   types][1.5f] where the conversions are lossless.
4483 * There are now `From` conversions [between integer types][1.5i] where
4484   the conversions are lossless.
4485 * [`fs::Metadata` implements `Clone`][1.5fs].
4486 * The `parse` method [accepts a leading "+" when parsing
4487   integers][1.5pi].
4488 * [`AsMut` is implemented for `Vec`][1.5am].
4489 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4490   been optimized][1.5cf] and no longer rely on the default impl.
4491 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4492   `unsafe extern "C"` function types now [implement `Clone`,
4493   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4494   `fmt::Debug` for up to 12 arguments][1.5fp].
4495 * [Dropping `Vec`s is much faster in unoptimized builds when the
4496   element types don't implement `Drop`][1.5dv].
4497 * A bug that caused in incorrect behavior when [combining `VecDeque`
4498   with zero-sized types][1.5vdz] was resolved.
4499 * [`PartialOrd` for slices is faster][1.5po].
4500
4501 Miscellaneous
4502 -------------
4503
4504 * [Crate metadata size was reduced by 20%][1.5md].
4505 * [Improvements to code generation reduced the size of libcore by 3.3
4506   MB and rustc's memory usage by 18MB][1.5m].
4507 * [Improvements to deref translation increased performance in
4508   unoptimized builds][1.5dr].
4509 * Various errors in trait resolution [are deduplicated to only be
4510   reported once][1.5te].
4511 * Rust has preliminary [support for rumprun kernels][1.5rr].
4512 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4513
4514 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4515 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4516 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4517 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4518 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4519 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4520 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4521 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4522 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4523 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4524 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4525 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4526 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4527 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4528 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4529 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4530 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4531 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4532 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4533 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4534 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4535 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4536 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4537 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4538 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4539 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4540 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4541 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4542 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4543 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4544 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4545 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4546 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4547 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4548 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4549 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4550 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4551 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4552 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4553 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4554 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4555 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4556 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4557 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4558 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4559 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4560 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4561 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4562 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4563 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4564 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4565 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4566 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4567 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4568 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4569 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4570 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4571 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4572 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4573 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4574 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4575 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4576 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4577 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4578 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4579 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4580 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4581 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4582 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4583 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4584 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4585 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4586 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4587 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4588 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4589 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4590 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4591 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4592 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4593 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4594 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4595 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4596 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4597 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4598 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4599 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4600 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4601 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4602 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4603
4604 Version 1.4.0 (2015-10-29)
4605 ==========================
4606
4607 * ~1200 changes, numerous bugfixes
4608
4609 Highlights
4610 ----------
4611
4612 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4613   GNU) are now supported and recommended for use.
4614
4615 Breaking Changes
4616 ----------------
4617
4618 * [Several changes have been made to fix type soundness and improve
4619   the behavior of associated types][sound]. See [RFC 1214]. Although
4620   we have mostly introduced these changes as warnings this release, to
4621   become errors next release, there are still some scenarios that will
4622   see immediate breakage.
4623 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4624   line breaks in addition to `\n`][crlf].
4625 * [Loans of `'static` lifetime extend to the end of a function][stat].
4626 * [`str::parse` no longer introduces avoidable rounding error when
4627   parsing floating point numbers. Together with earlier changes to
4628   float formatting/output, "round trips" like f.to_string().parse()
4629   now preserve the value of f exactly. Additionally, leading plus
4630   signs are now accepted][fp3].
4631
4632
4633 Language
4634 --------
4635
4636 * `use` statements that import multiple items [can now rename
4637   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4638 * [Binops work correctly on fat pointers][binfat].
4639 * `pub extern crate`, which does not behave as expected, [issues a
4640   warning][pec] until a better solution is found.
4641
4642 Libraries
4643 ---------
4644
4645 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4646   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4647   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4648   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4649   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4650   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4651   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4652   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4653   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4654   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4655   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4656   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4657   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4658   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4659   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4660   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4661   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4662   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4663   [`thread::sleep`].
4664 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4665   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4666   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4667   `f64::from_str_radix`.
4668 * [Reverse-searching strings is faster with the 'two-way'
4669   algorithm][s].
4670 * [`std::io::copy` allows `?Sized` arguments][cc].
4671 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4672   [override `count`, `nth` and `last` with an O(1)
4673   implementation][it].
4674 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4675 * [`IntoRawFd` has been added to the Unix-specific prelude,
4676   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4677   prelude][pr].
4678 * [`Extend<String>` and `FromIterator<String` are both implemented for
4679   `String`][es].
4680 * [`IntoIterator` is implemented for references to `Option` and
4681   `Result`][into2].
4682 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4683   Copy`][ext] as part of [RFC 839]. This will cause type inference
4684   breakage in rare situations.
4685 * [`BinaryHeap` implements `Debug`][bh2].
4686 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4687   arrays][bm].
4688 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4689   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4690 * [String comparison is faster][faststr].
4691 * `&mut T` where `T: std::fmt::Write` [also implements
4692   `std::fmt::Write`][mutw].
4693 * [A stable regression in `VecDeque::push_back` and other
4694   capacity-altering methods that caused panics for zero-sized types
4695   was fixed][vd].
4696 * [Function pointers implement traits for up to 12 parameters][fp2].
4697
4698 Miscellaneous
4699 -------------
4700
4701 * The compiler [no longer uses the 'morestack' feature to prevent
4702   stack overflow][mm]. Instead it uses guard pages and stack
4703   probes (though stack probes are not yet implemented on any platform
4704   but Windows).
4705 * [The compiler matches traits faster when projections are involved][p].
4706 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4707   `usize`][ffi].
4708 * [Cargo now displays useful information about what its doing during
4709   `cargo update`][cu].
4710
4711 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4712 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4713 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4714 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4715 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4716 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4717 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4718 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4719 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4720 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4721 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4722 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4723 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4724 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4725 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4726 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4727 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4728 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4729 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4730 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4731 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4732 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4733 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4734 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4735 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4736 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4737 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4738 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4739 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4740 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4741 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4742 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4743 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4744 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4745 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4746 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4747 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4748 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4749 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4750 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4751 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4752 [bh2]: https://github.com/rust-lang/rust/pull/28156
4753 [binfat]: https://github.com/rust-lang/rust/pull/28270
4754 [bm]: https://github.com/rust-lang/rust/pull/28197
4755 [cc]: https://github.com/rust-lang/rust/pull/27531
4756 [crlf]: https://github.com/rust-lang/rust/pull/28034
4757 [cu]: https://github.com/rust-lang/cargo/pull/1931
4758 [d]: https://github.com/rust-lang/rust/pull/27825
4759 [dep]: https://github.com/rust-lang/rust/pull/28339
4760 [es]: https://github.com/rust-lang/rust/pull/27956
4761 [ext]: https://github.com/rust-lang/rust/pull/28094
4762 [faststr]: https://github.com/rust-lang/rust/pull/28338
4763 [ffi]: https://github.com/rust-lang/rust/pull/28779
4764 [fp]: https://github.com/rust-lang/rust/pull/28268
4765 [fp2]: https://github.com/rust-lang/rust/pull/28560
4766 [fp3]: https://github.com/rust-lang/rust/pull/27307
4767 [i]: https://github.com/rust-lang/rust/pull/27451
4768 [into2]: https://github.com/rust-lang/rust/pull/28039
4769 [it]: https://github.com/rust-lang/rust/pull/27652
4770 [mm]: https://github.com/rust-lang/rust/pull/27338
4771 [mutw]: https://github.com/rust-lang/rust/pull/28368
4772 [sound]: https://github.com/rust-lang/rust/pull/27641
4773 [p]: https://github.com/rust-lang/rust/pull/27866
4774 [pec]: https://github.com/rust-lang/rust/pull/28486
4775 [pr]: https://github.com/rust-lang/rust/pull/27896
4776 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4777 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4778 [s]: https://github.com/rust-lang/rust/pull/27474
4779 [stab]: https://github.com/rust-lang/rust/pull/28339
4780 [stat]: https://github.com/rust-lang/rust/pull/28321
4781 [vd]: https://github.com/rust-lang/rust/pull/28494
4782
4783 Version 1.3.0 (2015-09-17)
4784 ==============================
4785
4786 * ~900 changes, numerous bugfixes
4787
4788 Highlights
4789 ----------
4790
4791 * The [new object lifetime defaults][nold] have been [turned
4792   on][nold2] after a cycle of warnings about the change. Now types
4793   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4794   being interpreted as `&'a Box<Trait+'a>` to `&'a
4795   Box<Trait+'static>`.
4796 * [The Rustonomicon][nom] is a new book in the official documentation
4797   that dives into writing unsafe Rust.
4798 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4799   timekeeping is employed by other std APIs, as well as out-of-tree
4800   time crates.
4801
4802 Breaking Changes
4803 ----------------
4804
4805 * The [new object lifetime defaults][nold] have been [turned
4806   on][nold2] after a cycle of warnings about the change.
4807 * There is a known [regression][lr] in how object lifetime elision is
4808   interpreted, the proper solution for which is undetermined.
4809 * The `#[prelude_import]` attribute, an internal implementation
4810   detail, was accidentally stabilized previously. [It has been put
4811   behind the `prelude_import` feature gate][pi]. This change is
4812   believed to break no existing code.
4813 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4814   [more sane for dynamically sized types][dst3]. Code that relied on
4815   the previous behavior is thought to be broken.
4816 * The `dropck` rules, which checks that destructors can't access
4817   destroyed values, [have been updated][dropck] to match the
4818   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4819   cause some previously-compiling code to no longer build.
4820
4821 Language
4822 --------
4823
4824 * The [new object lifetime defaults][nold] have been [turned
4825   on][nold2] after a cycle of warnings about the change.
4826 * Semicolons may [now follow types and paths in
4827   macros](https://github.com/rust-lang/rust/pull/27000).
4828 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4829   [more sane for dynamically sized types][dst3]. Code that relied on
4830   the previous behavior is not known to exist, and suspected to be
4831   broken.
4832 * `'static` variables [may now be recursive][st].
4833 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4834   implementations correctly.
4835 * The `dropck` rules, which checks that destructors can't access
4836   destroyed values, [have been updated][dropck] to match the
4837   [RFC][dropckrfc].
4838
4839 Libraries
4840 ---------
4841
4842 * The [`Duration`] API, [has been stabilized][ds], as well as the
4843   `std::time` module, which presently contains only `Duration`.
4844 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4845 * The owned C string, [`CString`], implements [`Borrow`] and the
4846   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4847   these allow C strings to be borrowed and cloned in generic code.
4848 * [`CStr`] implements [`Debug`].
4849 * [`AtomicPtr`] implements [`Debug`].
4850 * [`Error`] trait objects [can be downcast to their concrete types][e]
4851   in many common configurations, using the [`is`], [`downcast`],
4852   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4853   [`Any`] trait.
4854 * Searching for substrings now [employs the two-way algorithm][search]
4855   instead of doing a naive search. This gives major speedups to a
4856   number of methods, including [`contains`][sc], [`find`][sf],
4857   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4858   [`ends_with`][sew] are also faster.
4859 * The performance of `PartialEq` for slices is [much faster][ps].
4860 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4861   is overridden and optimized by the implementations for scalars.
4862 * The [`Hasher`] trait now has a number of specialized `write_*`
4863   methods for primitive types, for efficiency.
4864 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4865   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4866   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4867   of [`std::error::Error::cause`][iec] also delegates to the inner
4868   error.
4869 * [`process::Child`][pc] gained the [`id`] method, which returns a
4870   `u32` representing the platform-specific process identifier.
4871 * The [`connect`] method on slices is deprecated, replaced by the new
4872   [`join`] method (note that both of these are on the *unstable*
4873   [`SliceConcatExt`] trait, but through the magic of the prelude are
4874   available to stable code anyway).
4875 * The [`Div`] operator is implemented for [`Wrapping`] types.
4876 * [`DerefMut` is implemented for `String`][dms].
4877 * Performance of SipHash (the default hasher for `HashMap`) is
4878   [better for long data][sh].
4879 * [`AtomicPtr`] implements [`Send`].
4880 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4881   are now [specialized to use uninitialized buffers for increased
4882   performance][rte].
4883 * Lifetime parameters of foreign functions [are now resolved
4884   properly][f].
4885
4886 Misc
4887 ----
4888
4889 * Rust can now, with some coercion, [produce programs that run on
4890   Windows XP][xp], though XP is not considered a supported platform.
4891 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4892   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4893   recommended for use in 1.3, though should be fully-functional
4894   in the [64-bit 1.4 beta][b14].
4895 * On Fedora-based systems installation will [properly configure the
4896   dynamic linker][fl].
4897 * The compiler gained many new extended error descriptions, which can
4898   be accessed with the `--explain` flag.
4899 * The `dropck` pass, which checks that destructors can't access
4900   destroyed values, [has been rewritten][dropck]. This fixes some
4901   soundness holes, and as such will cause some previously-compiling
4902   code to no longer build.
4903 * `rustc` now uses [LLVM to write archive files where possible][ar].
4904   Eventually this will eliminate the compiler's dependency on the ar
4905   utility.
4906 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4907   supported FreeBSD on x86_64).
4908 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4909   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4910   more strict.
4911 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4912   will kill the process instead of leaking][nlp].
4913
4914 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4915 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4916 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4917 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4918 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
4919 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4920 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4921 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
4922 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
4923 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
4924 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
4925 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
4926 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
4927 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4928 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
4929 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
4930 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
4931 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
4932 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
4933 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
4934 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
4935 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
4936 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
4937 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4938 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
4939 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
4940 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
4941 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
4942 [ar]: https://github.com/rust-lang/rust/pull/26926
4943 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
4944 [dms]: https://github.com/rust-lang/rust/pull/26241
4945 [dropck]: https://github.com/rust-lang/rust/pull/27261
4946 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
4947 [ds]: https://github.com/rust-lang/rust/pull/26818
4948 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
4949 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
4950 [dst3]: https://github.com/rust-lang/rust/pull/27351
4951 [e]: https://github.com/rust-lang/rust/pull/24793
4952 [f]: https://github.com/rust-lang/rust/pull/26588
4953 [fb]: https://github.com/rust-lang/rust/pull/26959
4954 [fl]: https://github.com/rust-lang/rust-installer/pull/41
4955 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
4956 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
4957 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
4958 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
4959 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
4960 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
4961 [lic]: https://github.com/rust-lang/rust/pull/26583
4962 [lnu]: https://github.com/rust-lang/rust/pull/27026
4963 [lr]: https://github.com/rust-lang/rust/issues/27248
4964 [lum]: https://github.com/rust-lang/rust/pull/26378
4965 [lur]: https://github.com/rust-lang/rust/pull/26783
4966 [nlp]: https://github.com/rust-lang/rust/pull/27176
4967 [nold2]: https://github.com/rust-lang/rust/pull/27045
4968 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
4969 [nom]: http://doc.rust-lang.org/nightly/nomicon/
4970 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
4971 [pi]: https://github.com/rust-lang/rust/pull/26699
4972 [ps]: https://github.com/rust-lang/rust/pull/26884
4973 [rte]: https://github.com/rust-lang/rust/pull/26950
4974 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
4975 [search]: https://github.com/rust-lang/rust/pull/26327
4976 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
4977 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
4978 [sh]: https://github.com/rust-lang/rust/pull/27280
4979 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
4980 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
4981 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
4982 [st]: https://github.com/rust-lang/rust/pull/26630
4983 [win1]: https://github.com/rust-lang/rust/pull/26569
4984 [win2]: https://github.com/rust-lang/rust/pull/26741
4985 [win3]: https://github.com/rust-lang/rust/pull/26741
4986 [win4]: https://github.com/rust-lang/rust/pull/27210
4987 [xp]: https://github.com/rust-lang/rust/pull/26569
4988
4989 Version 1.2.0 (2015-08-07)
4990 ==========================
4991
4992 * ~1200 changes, numerous bugfixes
4993
4994 Highlights
4995 ----------
4996
4997 * [Dynamically-sized-type coercions][dst] allow smart pointer types
4998   like `Rc` to contain types without a fixed size, arrays and trait
4999   objects, finally enabling use of `Rc<[T]>` and completing the
5000   implementation of DST.
5001 * [Parallel codegen][parcodegen] is now working again, which can
5002   substantially speed up large builds in debug mode; It also gets
5003   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5004   jobs). It's not enabled by default, but will be "in the near
5005   future". It can be activated with the `-C codegen-units=N` flag to
5006   `rustc`.
5007 * This is the first release with [experimental support for linking
5008   with the MSVC linker and lib C on Windows (instead of using the GNU
5009   variants via MinGW)][win]. It is yet recommended only for the most
5010   intrepid Rustaceans.
5011 * Benchmark compilations are showing a 30% improvement in
5012   bootstrapping over 1.1.
5013
5014 Breaking Changes
5015 ----------------
5016
5017 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5018   unicode case mapping, which is a previously-planned change in
5019   behavior and considered a bugfix.
5020 * [`mem::align_of`] now specifies [the *minimum alignment* for
5021   T][align], which is usually the alignment programs are interested
5022   in, and the same value reported by clang's
5023   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5024   break real code.
5025 * [The `#[packed]` attribute is no longer silently accepted by the
5026   compiler][packed]. This attribute did nothing and code that
5027   mentioned it likely did not work as intended.
5028 * Associated type defaults are [now behind the
5029   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5030   defaults *did not work*, but could be mentioned syntactically. As
5031   such this breakage has minimal impact.
5032
5033 Language
5034 --------
5035
5036 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5037   matching against dereferenceable values.
5038
5039 Libraries
5040 ---------
5041
5042 * The [`Extend`] trait, which grows a collection from an iterator, is
5043   implemented over iterators of references, for `String`, `Vec`,
5044   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5045   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5046 * The [`iter::once`] function returns an iterator that yields a single
5047   element, and [`iter::empty`] returns an iterator that yields no
5048   elements.
5049 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5050   over substring matches.
5051 * [`Cell`] and [`RefCell`] both implement `Eq`.
5052 * A number of methods for wrapping arithmetic are added to the
5053   integral types, [`wrapping_div`], [`wrapping_rem`],
5054   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5055   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5056   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5057   type.. It is illegal for the default arithmetic operations in Rust
5058   to overflow; the desire to wrap must be explicit.
5059 * The `{:#?}` formatting specifier [displays the alternate,
5060   pretty-printed][debugfmt] form of the `Debug` formatter. This
5061   feature was actually introduced prior to 1.0 with little
5062   fanfare.
5063 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5064   for writing data to formatted strings, similar to [`io::Write`].
5065 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5066   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5067   are used by code generators to emit implementations of [`Debug`].
5068 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5069   methods that convert case, following Unicode case mapping.
5070 * It is now easier to handle poisoned locks. The [`PoisonError`]
5071   type, returned by failing lock operations, exposes `into_inner`,
5072   `get_ref`, and `get_mut`, which all give access to the inner lock
5073   guard, and allow the poisoned lock to continue to operate. The
5074   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5075   poisoned lock without attempting to take the lock.
5076 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5077   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5078   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5079   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5080   `ChildStderr`.
5081 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5082   malformed input.
5083
5084 Misc
5085 ----
5086
5087 * `rustc` employs smarter heuristics for guessing at [typos].
5088 * `rustc` emits more efficient code for [no-op conversions between
5089   unsafe pointers][nop].
5090 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5091   resulting in faster compile times and smaller code.
5092
5093 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5094 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5095 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5096 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5097 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5098 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5099 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5100 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5101 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5102 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5103 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5104 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5105 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5106 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5107 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5108 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5109 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5110 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5111 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5112 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5113 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5114 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5115 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5116 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5117 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5118 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5119 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5120 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5121 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5122 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5123 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5124 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5125 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5126 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5127 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5128 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5129 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5130 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5131 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5132 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5133 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5134 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5135 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5136 [align]: https://github.com/rust-lang/rust/pull/25646
5137 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5138 [typos]: https://github.com/rust-lang/rust/pull/26087
5139 [nop]: https://github.com/rust-lang/rust/pull/26336
5140 [fat]: https://github.com/rust-lang/rust/pull/26411
5141 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5142 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5143 [packed]: https://github.com/rust-lang/rust/pull/25541
5144 [ad]: https://github.com/rust-lang/rust/pull/27382
5145 [win]: https://github.com/rust-lang/rust/pull/25350
5146
5147 Version 1.1.0 (2015-06-25)
5148 =========================
5149
5150 * ~850 changes, numerous bugfixes
5151
5152 Highlights
5153 ----------
5154
5155 * The [`std::fs` module has been expanded][fs] to expand the set of
5156   functionality exposed:
5157   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5158     don't incur a syscall on some platforms.
5159   * A `symlink_metadata` function has been added.
5160   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5161     access to all underlying information.
5162 * The compiler now contains extended explanations of many errors. When an error
5163   with an explanation occurs the compiler suggests using the `--explain` flag
5164   to read the explanation. Error explanations are also [available online][err-index].
5165 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5166   well as other work, the time to bootstrap the compiler decreased by
5167   32%.
5168
5169 Libraries
5170 ---------
5171
5172 * The [`str::split_whitespace`] method splits a string on unicode
5173   whitespace boundaries.
5174 * On both Windows and Unix, new extension traits provide conversion of
5175   I/O types to and from the underlying system handles. On Unix, these
5176   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5177   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5178   `TcpListener`, and `UpdSocket`. Further implementations for
5179   `std::process` will be stabilized later.
5180 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5181   Windows, symlinks can be created with
5182   `std::os::windows::symlink_dir` and
5183   `std::os::windows::symlink_file`.
5184 * The `mpsc::Receiver` type can now be converted into an iterator with
5185   `into_iter` on the [`IntoIterator`] trait.
5186 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5187   implementation of the [`From`] trait.
5188 * The `Debug` implementation for `RangeFull` [creates output that is
5189   more consistent with other implementations][rf].
5190 * [`Debug` is implemented for `File`][file].
5191 * The `Default` implementation for `Arc` [no longer requires `Sync +
5192   Send`][arc].
5193 * [The `Iterator` methods `count`, `nth`, and `last` have been
5194   overridden for slices to have O(1) performance instead of O(n)][si].
5195 * Incorrect handling of paths on Windows has been improved in both the
5196   compiler and the standard library.
5197 * [`AtomicPtr` gained a `Default` implementation][ap].
5198 * In accordance with Rust's policy on arithmetic overflow `abs` now
5199   [panics on overflow when debug assertions are enabled][abs].
5200 * The [`Cloned`] iterator, which was accidentally left unstable for
5201   1.0 [has been stabilized][c].
5202 * The [`Incoming`] iterator, which iterates over incoming TCP
5203   connections, and which was accidentally unnamable in 1.0, [is now
5204   properly exported][inc].
5205 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5206   `sift_up` or `sift_down` panic][bh].
5207 * The [`split_off`] method of `LinkedList` [no longer corrupts
5208   the list in certain scenarios][ll].
5209
5210 Misc
5211 ----
5212
5213 * Type checking performance [has improved notably][sk] with
5214   [multiple improvements][pre].
5215 * The compiler [suggests code changes][ch] for more errors.
5216 * rustc and it's build system have experimental support for [building
5217   toolchains against MUSL][m] instead of glibc on Linux.
5218 * The compiler defines the `target_env` cfg value, which is used for
5219   distinguishing toolchains that are otherwise for the same
5220   platform. Presently this is set to `gnu` for common GNU Linux
5221   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5222 * The [`cargo rustc`][crc] command invokes a build with custom flags
5223   to rustc.
5224 * [Android executables are always position independent][pie].
5225 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5226   with `Drop`][drop].
5227
5228 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5229 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5230 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5231 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5232 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5233 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5234 [rf]: https://github.com/rust-lang/rust/pull/24491
5235 [err-index]: https://doc.rust-lang.org/error-index.html
5236 [sk]: https://github.com/rust-lang/rust/pull/24615
5237 [pre]: https://github.com/rust-lang/rust/pull/25323
5238 [file]: https://github.com/rust-lang/rust/pull/24598
5239 [ch]: https://github.com/rust-lang/rust/pull/24683
5240 [arc]: https://github.com/rust-lang/rust/pull/24695
5241 [si]: https://github.com/rust-lang/rust/pull/24701
5242 [ap]: https://github.com/rust-lang/rust/pull/24834
5243 [m]: https://github.com/rust-lang/rust/pull/24777
5244 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5245 [crc]: https://github.com/rust-lang/cargo/pull/1568
5246 [pie]: https://github.com/rust-lang/rust/pull/24953
5247 [abs]: https://github.com/rust-lang/rust/pull/25441
5248 [c]: https://github.com/rust-lang/rust/pull/25496
5249 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5250 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5251 [inc]: https://github.com/rust-lang/rust/pull/25522
5252 [bh]: https://github.com/rust-lang/rust/pull/25856
5253 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5254 [ll]: https://github.com/rust-lang/rust/pull/26022
5255 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5256 [drop]: https://github.com/rust-lang/rust/pull/24935
5257
5258 Version 1.0.0 (2015-05-15)
5259 ========================
5260
5261 * ~1500 changes, numerous bugfixes
5262
5263 Highlights
5264 ----------
5265
5266 * The vast majority of the standard library is now `#[stable]`. It is
5267   no longer possible to use unstable features with a stable build of
5268   the compiler.
5269 * Many popular crates on [crates.io] now work on the stable release
5270   channel.
5271 * Arithmetic on basic integer types now [checks for overflow in debug
5272   builds][overflow].
5273
5274 Language
5275 --------
5276
5277 * Several [restrictions have been added to trait coherence][coh] in
5278   order to make it easier for upstream authors to change traits
5279   without breaking downstream code.
5280 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5281   improve error messages and macro behavior. For example, `0b1234` is
5282   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5283 * Trait bounds [are always invariant][inv], eliminating the need for
5284   the `PhantomFn` and `MarkerTrait` lang items, which have been
5285   removed.
5286 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5287   "foo" as bar` syntax has been replaced with `extern crate foo as
5288   bar`, and Cargo now automatically translates "-" in *package* names
5289   to underscore for the crate name.
5290 * [Lifetime shadowing is an error][lt].
5291 * [`Send` no longer implies `'static`][send-rfc].
5292 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5293   `MyType::default()`.
5294 * Primitive types [now have inherent methods][prim-inherent],
5295   obviating the need for extension traits like `SliceExt`.
5296 * Methods with `Self: Sized` in their `where` clause are [considered
5297   object-safe][self-sized], allowing many extension traits like
5298   `IteratorExt` to be merged into the traits they extended.
5299 * You can now [refer to associated types][assoc-where] whose
5300   corresponding trait bounds appear only in a `where` clause.
5301 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5302   like `Send` and `Sync` are now library-defined.
5303 * A [Reflect trait][reflect] was introduced, which means that
5304   downcasting via the `Any` trait is effectively limited to concrete
5305   types. This helps retain the potentially-important "parametricity"
5306   property: generic code cannot behave differently for different type
5307   arguments except in minor ways.
5308 * The `unsafe_destructor` feature is now deprecated in favor of the
5309   [new `dropck`][dropck]. This change is a major reduction in unsafe
5310   code.
5311
5312 Libraries
5313 ---------
5314
5315 * The `thread_local` module [has been renamed to `std::thread`][th].
5316 * The methods of `IteratorExt` [have been moved to the `Iterator`
5317   trait itself][ie].
5318 * Several traits that implement Rust's conventions for type
5319   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5320   [centralized in the `std::convert` module][con].
5321 * The `FromError` trait [was removed in favor of `From`][fe].
5322 * The basic sleep function [has moved to
5323   `std::thread::sleep_ms`][slp].
5324 * The `splitn` function now takes an `n` parameter that represents the
5325   number of items yielded by the returned iterator [instead of the
5326   number of 'splits'][spl].
5327 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5328 * [Derived implementations of `PartialOrd` now order enums according
5329   to their explicitly-assigned discriminants][po].
5330 * [Methods for searching strings are generic over `Pattern`s][pat],
5331   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5332   some others.
5333 * [In method resolution, object methods are resolved before inherent
5334   methods][meth].
5335 * [`String::from_str` has been deprecated in favor of the `From` impl,
5336   `String::from`][sf].
5337 * [`io::Error` implements `Sync`][ios].
5338 * [The `words` method on `&str` has been replaced with
5339   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5340   a word?'
5341 * The new path and IO modules are complete and `#[stable]`. This
5342   was the major library focus for this cycle.
5343 * The path API was [revised][path-normalize] to normalize `.`,
5344   adjusting the tradeoffs in favor of the most common usage.
5345 * A large number of remaining APIs in `std` were also stabilized
5346   during this cycle; about 75% of the non-deprecated API surface
5347   is now stable.
5348 * The new [string pattern API][string-pattern] landed, which makes
5349   the string slice API much more internally consistent and flexible.
5350 * A new set of [generic conversion traits][conversion] replaced
5351   many existing ad hoc traits.
5352 * Generic numeric traits were [completely removed][num-traits]. This
5353   was made possible thanks to inherent methods for primitive types,
5354   and the removal gives maximal flexibility for designing a numeric
5355   hierarchy in the future.
5356 * The `Fn` traits are now related via [inheritance][fn-inherit]
5357   and provide ergonomic [blanket implementations][fn-blanket].
5358 * The `Index` and `IndexMut` traits were changed to
5359   [take the index by value][index-value], enabling code like
5360   `hash_map["string"]` to work.
5361 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5362   `Copy` data is known to be `Clone` as well.
5363
5364 Misc
5365 ----
5366
5367 * Many errors now have extended explanations that can be accessed with
5368   the `--explain` flag to `rustc`.
5369 * Many new examples have been added to the standard library
5370   documentation.
5371 * rustdoc has received a number of improvements focused on completion
5372   and polish.
5373 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5374 * Much headway was made on ecosystem-wide CI, making it possible
5375   to [compare builds for breakage][ci-compare].
5376
5377
5378 [crates.io]: http://crates.io
5379 [clo]: https://github.com/rust-lang/rust/pull/24034
5380 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5381 [con]: https://github.com/rust-lang/rust/pull/23875
5382 [cr]: https://github.com/rust-lang/rust/pull/23419
5383 [fe]: https://github.com/rust-lang/rust/pull/23879
5384 [ie]: https://github.com/rust-lang/rust/pull/23300
5385 [inv]: https://github.com/rust-lang/rust/pull/23938
5386 [ios]: https://github.com/rust-lang/rust/pull/24133
5387 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5388 [lt]: https://github.com/rust-lang/rust/pull/24057
5389 [meth]: https://github.com/rust-lang/rust/pull/24056
5390 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5391 [po]: https://github.com/rust-lang/rust/pull/24270
5392 [sf]: https://github.com/rust-lang/rust/pull/24517
5393 [slp]: https://github.com/rust-lang/rust/pull/23949
5394 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5395 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5396 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5397 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5398 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5399 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5400 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5401 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5402 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5403 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5404 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5405 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5406 [reflect]: https://github.com/rust-lang/rust/pull/23712
5407 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5408 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5409 [index-value]: https://github.com/rust-lang/rust/pull/23601
5410 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5411 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5412 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5413 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5414 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5415 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5416
5417
5418 Version 1.0.0-alpha.2 (2015-02-20)
5419 =====================================
5420
5421 * ~1300 changes, numerous bugfixes
5422
5423 * Highlights
5424
5425     * The various I/O modules were [overhauled][io-rfc] to reduce
5426       unnecessary abstractions and provide better interoperation with
5427       the underlying platform. The old `io` module remains temporarily
5428       at `std::old_io`.
5429     * The standard library now [participates in feature gating][feat],
5430       so use of unstable libraries now requires a `#![feature(...)]`
5431       attribute. The impact of this change is [described on the
5432       forum][feat-forum]. [RFC][feat-rfc].
5433
5434 * Language
5435
5436     * `for` loops [now operate on the `IntoIterator` trait][into],
5437       which eliminates the need to call `.iter()`, etc. to iterate
5438       over collections. There are some new subtleties to remember
5439       though regarding what sort of iterators various types yield, in
5440       particular that `for foo in bar { }` yields values from a move
5441       iterator, destroying the original collection. [RFC][into-rfc].
5442     * Objects now have [default lifetime bounds][obj], so you don't
5443       have to write `Box<Trait+'static>` when you don't care about
5444       storing references. [RFC][obj-rfc].
5445     * In types that implement `Drop`, [lifetimes must outlive the
5446       value][drop]. This will soon make it possible to safely
5447       implement `Drop` for types where `#[unsafe_destructor]` is now
5448       required. Read the [gorgeous RFC][drop-rfc] for details.
5449     * The fully qualified <T as Trait>::X syntax lets you set the Self
5450       type for a trait method or associated type. [RFC][ufcs-rfc].
5451     * References to types that implement `Deref<U>` now [automatically
5452       coerce to references][deref] to the dereferenced type `U`,
5453       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5454       should eliminate many unsightly uses of `&*`, as when converting
5455       from references to vectors into references to
5456       slices. [RFC][deref-rfc].
5457     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5458       `|:|`) is obsolete and closure kind is inferred from context.
5459     * [`Self` is a keyword][Self].
5460
5461 * Libraries
5462
5463     * The `Show` and `String` formatting traits [have been
5464       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5465       their related purposes. Automatically getting a string
5466       conversion to use with `format!("{:?}", something_to_debug)` is
5467       now written `#[derive(Debug)]`.
5468     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5469       OsStr}`, provide strings in platform-specific encodings for easier
5470       interop with system APIs. [RFC][osstr-rfc].
5471     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5472       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5473       creating raw pointers.
5474
5475 * Tooling
5476
5477     * Certain long error messages of the form 'expected foo found bar'
5478       are now [split neatly across multiple
5479       lines][multiline]. Examples in the PR.
5480     * On Unix Rust can be [uninstalled][un] by running
5481       `/usr/local/lib/rustlib/uninstall.sh`.
5482     * The `#[rustc_on_unimplemented]` attribute, requiring the
5483       'on_unimplemented' feature, lets rustc [display custom error
5484       messages when a trait is expected to be implemented for a type
5485       but is not][onun].
5486
5487 * Misc
5488
5489     * Rust is tested against a [LALR grammar][lalr], which parses
5490       almost all the Rust files that rustc does.
5491
5492 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5493 [close]: https://github.com/rust-lang/rust/pull/21843
5494 [deref]: https://github.com/rust-lang/rust/pull/21351
5495 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5496 [drop]: https://github.com/rust-lang/rust/pull/21972
5497 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5498 [feat]: https://github.com/rust-lang/rust/pull/21248
5499 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5500 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5501 [fmt]: https://github.com/rust-lang/rust/pull/21457
5502 [into]: https://github.com/rust-lang/rust/pull/20790
5503 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5504 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5505 [lalr]: https://github.com/rust-lang/rust/pull/21452
5506 [multiline]: https://github.com/rust-lang/rust/pull/19870
5507 [obj]: https://github.com/rust-lang/rust/pull/22230
5508 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5509 [onun]: https://github.com/rust-lang/rust/pull/20889
5510 [osstr]: https://github.com/rust-lang/rust/pull/21488
5511 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5512 [Self]: https://github.com/rust-lang/rust/pull/22158
5513 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5514 [un]: https://github.com/rust-lang/rust/pull/22256
5515
5516
5517 Version 1.0.0-alpha (2015-01-09)
5518 ==================================
5519
5520   * ~2400 changes, numerous bugfixes
5521
5522   * Highlights
5523
5524     * The language itself is considered feature complete for 1.0,
5525       though there will be many usability improvements and bugfixes
5526       before the final release.
5527     * Nearly 50% of the public API surface of the standard library has
5528       been declared 'stable'. Those interfaces are unlikely to change
5529       before 1.0.
5530     * The long-running debate over integer types has been
5531       [settled][ints]: Rust will ship with types named `isize` and
5532       `usize`, rather than `int` and `uint`, for pointer-sized
5533       integers. Guidelines will be rolled out during the alpha cycle.
5534     * Most crates that are not `std` have been moved out of the Rust
5535       distribution into the Cargo ecosystem so they can evolve
5536       separately and don't need to be stabilized as quickly, including
5537       'time', 'getopts', 'num', 'regex', and 'term'.
5538     * Documentation continues to be expanded with more API coverage, more
5539       examples, and more in-depth explanations. The guides have been
5540       consolidated into [The Rust Programming Language][trpl].
5541     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5542     * All official Rust binary installers now come with [Cargo], the
5543       Rust package manager.
5544
5545 * Language
5546
5547     * Closures have been [completely redesigned][unboxed] to be
5548       implemented in terms of traits, can now be used as generic type
5549       bounds and thus monomorphized and inlined, or via an opaque
5550       pointer (boxed) as in the old system. The new system is often
5551       referred to as 'unboxed' closures.
5552     * Traits now support [associated types][assoc], allowing families
5553       of related types to be defined together and used generically in
5554       powerful ways.
5555     * Enum variants are [namespaced by their type names][enum].
5556     * [`where` clauses][where] provide a more versatile and attractive
5557       syntax for specifying generic bounds, though the previous syntax
5558       remains valid.
5559     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5560       numeric types.
5561     * Rust [no longer has a runtime][rt] of any description, and only
5562       supports OS threads, not green threads.
5563     * At long last, Rust has been overhauled for 'dynamically-sized
5564       types' ([DST]), which integrates 'fat pointers' (object types,
5565       arrays, and `str`) more deeply into the type system, making it
5566       more consistent.
5567     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5568       `..j` that produce range types and which, when combined with the
5569       `Index` operator and multidispatch, leads to a convenient slice
5570       notation, `[i..j]`.
5571     * The new range syntax revealed an ambiguity in the fixed-length
5572       array syntax, so now fixed length arrays [are written `[T;
5573       N]`][arrays].
5574     * The `Copy` trait is no longer implemented automatically. Unsafe
5575       pointers no longer implement `Sync` and `Send` so types
5576       containing them don't automatically either. `Sync` and `Send`
5577       are now 'unsafe traits' so one can "forcibly" implement them via
5578       `unsafe impl` if a type confirms to the requirements for them
5579       even though the internals do not (e.g. structs containing unsafe
5580       pointers like `Arc`). These changes are intended to prevent some
5581       footguns and are collectively known as [opt-in built-in
5582       traits][oibit] (though `Sync` and `Send` will soon become pure
5583       library types unknown to the compiler).
5584     * Operator traits now take their operands [by value][ops], and
5585       comparison traits can use multidispatch to compare one type
5586       against multiple other types, allowing e.g. `String` to be
5587       compared with `&str`.
5588     * `if let` and `while let` are no longer feature-gated.
5589     * Rust has adopted a more [uniform syntax for escaping unicode
5590       characters][unicode].
5591     * `macro_rules!` [has been declared stable][mac]. Though it is a
5592       flawed system it is sufficiently popular that it must be usable
5593       for 1.0. Effort has gone into [future-proofing][mac-future] it
5594       in ways that will allow other macro systems to be developed in
5595       parallel, and won't otherwise impact the evolution of the
5596       language.
5597     * The prelude has been [pared back significantly][prelude] such
5598       that it is the minimum necessary to support the most pervasive
5599       code patterns, and through [generalized where clauses][where]
5600       many of the prelude extension traits have been consolidated.
5601     * Rust's rudimentary reflection [has been removed][refl], as it
5602       incurred too much code generation for little benefit.
5603     * [Struct variants][structvars] are no longer feature-gated.
5604     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5605       known as 'higher-ranked trait bounds', this crucially allows
5606       unboxed closures to work.
5607     * Macros invocations surrounded by parens or square brackets and
5608       not terminated by a semicolon are [parsed as
5609       expressions][macros], which makes expressions like `vec![1i32,
5610       2, 3].len()` work as expected.
5611     * Trait objects now implement their traits automatically, and
5612       traits that can be coerced to objects now must be [object
5613       safe][objsafe].
5614     * Automatically deriving traits is now done with `#[derive(...)]`
5615       not `#[deriving(...)]` for [consistency with other naming
5616       conventions][derive].
5617     * Importing the containing module or enum at the same time as
5618       items or variants they contain is [now done with `self` instead
5619       of `mod`][self], as in use `foo::{self, bar}`
5620     * Glob imports are no longer feature-gated.
5621     * The `box` operator and `box` patterns have been feature-gated
5622       pending a redesign. For now unique boxes should be allocated
5623       like other containers, with `Box::new`.
5624
5625 * Libraries
5626
5627     * A [series][coll1] of [efforts][coll2] to establish
5628       [conventions][coll3] for collections types has resulted in API
5629       improvements throughout the standard library.
5630     * New [APIs for error handling][err] provide ergonomic interop
5631       between error types, and [new conventions][err-conv] describe
5632       more clearly the recommended error handling strategies in Rust.
5633     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5634       it is easier to discuss failure in the context of error handling
5635       without making clarifications as to whether you are referring to
5636       the 'fail' macro or failure more generally.
5637     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5638       syscall when available.
5639     * The 'serialize' crate has been renamed 'rustc-serialize' and
5640       moved out of the distribution to Cargo. Although it is widely
5641       used now, it is expected to be superseded in the near future.
5642     * The `Show` formatter, typically implemented with
5643       `#[derive(Show)]` is [now requested with the `{:?}`
5644       specifier][show] and is intended for use by all types, for uses
5645       such as `println!` debugging. The new `String` formatter must be
5646       implemented by hand, uses the `{}` specifier, and is intended
5647       for full-fidelity conversions of things that can logically be
5648       represented as strings.
5649
5650 * Tooling
5651
5652     * [Flexible target specification][flex] allows rustc's code
5653       generation to be configured to support otherwise-unsupported
5654       platforms.
5655     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5656       respective debuggers with Rust-appropriate pretty-printing.
5657     * The Windows installation of Rust is distributed with the
5658       MinGW components currently required to link binaries on that
5659       platform.
5660
5661 * Misc
5662
5663     * Nullable enum optimizations have been extended to more types so
5664       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5665       space than the inner types themselves.
5666     * Work has begun on supporting AArch64.
5667
5668 [Cargo]: https://crates.io
5669 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5670 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5671 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5672 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5673 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5674 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5675 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5676 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5677 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5678 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5679 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5680 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5681 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5682 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5683 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5684 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5685 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5686 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5687 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5688 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5689 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5690 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5691 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5692 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5693 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5694 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5695 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5696 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5697 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5698 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5699 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5700 [trpl]: https://doc.rust-lang.org/book/index.html
5701 [rbe]: http://rustbyexample.com/
5702
5703
5704 Version 0.12.0 (2014-10-09)
5705 =============================
5706
5707   * ~1900 changes, numerous bugfixes
5708
5709   * Highlights
5710
5711     * The introductory documentation (now called The Rust Guide) has
5712       been completely rewritten, as have a number of supplementary
5713       guides.
5714     * Rust's package manager, Cargo, continues to improve and is
5715       sometimes considered to be quite awesome.
5716     * Many API's in `std` have been reviewed and updated for
5717       consistency with the in-development Rust coding
5718       guidelines. The standard library documentation tracks
5719       stabilization progress.
5720     * Minor libraries have been moved out-of-tree to the rust-lang org
5721       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5722       be installed with Cargo.
5723     * Lifetime elision allows lifetime annotations to be left off of
5724       function declarations in many common scenarios.
5725     * Rust now works on 64-bit Windows.
5726
5727   * Language
5728     * Indexing can be overloaded with the `Index` and `IndexMut`
5729       traits.
5730     * The `if let` construct takes a branch only if the `let` pattern
5731       matches, currently behind the 'if_let' feature gate.
5732     * 'where clauses', a more flexible syntax for specifying trait
5733       bounds that is more aesthetic, have been added for traits and
5734       free functions. Where clauses will in the future make it
5735       possible to constrain associated types, which would be
5736       impossible with the existing syntax.
5737     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5738       the 'slicing_syntax' feature gate, and can be overloaded with
5739       the `Slice` or `SliceMut` traits.
5740     * The syntax for matching of sub-slices has been changed to use a
5741       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5742       consistency with other uses of `..` and to future-proof
5743       potential additional uses of the syntax.
5744     * The syntax for matching inclusive ranges in patterns has changed
5745       from `0..3` to `0...4` to be consistent with the exclusive range
5746       syntax for slicing.
5747     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5748       c]`) has been put behind the 'advanced_slice_patterns' feature
5749       gate and may be removed in the future.
5750     * Components of tuples and tuple structs can be extracted using
5751       the `value.0` syntax, currently behind the `tuple_indexing`
5752       feature gate.
5753     * The `#[crate_id]` attribute is no longer supported; versioning
5754       is handled by the package manager.
5755     * Renaming crate imports are now written `extern crate foo as bar`
5756       instead of `extern crate bar = foo`.
5757     * Renaming use statements are now written `use foo as bar` instead
5758       of `use bar = foo`.
5759     * `let` and `match` bindings and argument names in macros are now
5760       hygienic.
5761     * The new, more efficient, closure types ('unboxed closures') have
5762       been added under a feature gate, 'unboxed_closures'. These will
5763       soon replace the existing closure types, once higher-ranked
5764       trait lifetimes are added to the language.
5765     * `move` has been added as a keyword, for indicating closures
5766       that capture by value.
5767     * Mutation and assignment is no longer allowed in pattern guards.
5768     * Generic structs and enums can now have trait bounds.
5769     * The `Share` trait is now called `Sync` to free up the term
5770       'shared' to refer to 'shared reference' (the default reference
5771       type.
5772     * Dynamically-sized types have been mostly implemented,
5773       unifying the behavior of fat-pointer types with the rest of the
5774       type system.
5775     * As part of dynamically-sized types, the `Sized` trait has been
5776       introduced, which qualifying types implement by default, and
5777       which type parameters expect by default. To specify that a type
5778       parameter does not need to be sized, write `<Sized? T>`. Most
5779       types are `Sized`, notable exceptions being unsized arrays
5780       (`[T]`) and trait types.
5781     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5782     * Lifetime bounds can now be applied to type parameters and object
5783       types.
5784     * The old, reference counted GC type, `Gc<T>` which was once
5785       denoted by the `@` sigil, has finally been removed. GC will be
5786       revisited in the future.
5787
5788   * Libraries
5789     * Library documentation has been improved for a number of modules.
5790     * Bit-vectors, collections::bitv has been modernized.
5791     * The url crate is deprecated in favor of
5792       http://github.com/servo/rust-url, which can be installed with
5793       Cargo.
5794     * Most I/O stream types can be cloned and subsequently closed from
5795       a different thread.
5796     * A `std::time::Duration` type has been added for use in I/O
5797       methods that rely on timers, as well as in the 'time' crate's
5798       `Timespec` arithmetic.
5799     * The runtime I/O abstraction layer that enabled the green thread
5800       scheduler to do non-thread-blocking I/O has been removed, along
5801       with the libuv-based implementation employed by the green thread
5802       scheduler. This will greatly simplify the future I/O work.
5803     * `collections::btree` has been rewritten to have a more
5804       idiomatic and efficient design.
5805
5806   * Tooling
5807     * rustdoc output now indicates the stability levels of API's.
5808     * The `--crate-name` flag can specify the name of the crate
5809       being compiled, like `#[crate_name]`.
5810     * The `-C metadata` specifies additional metadata to hash into
5811       symbol names, and `-C extra-filename` specifies additional
5812       information to put into the output filename, for use by the
5813       package manager for versioning.
5814     * debug info generation has continued to improve and should be
5815       more reliable under both gdb and lldb.
5816     * rustc has experimental support for compiling in parallel
5817       using the `-C codegen-units` flag.
5818     * rustc no longer encodes rpath information into binaries by
5819       default.
5820
5821   * Misc
5822     * Stack usage has been optimized with LLVM lifetime annotations.
5823     * Official Rust binaries on Linux are more compatible with older
5824       kernels and distributions, built on CentOS 5.10.
5825
5826
5827 Version 0.11.0 (2014-07-02)
5828 ==========================
5829
5830   * ~1700 changes, numerous bugfixes
5831
5832   * Language
5833     * ~[T] has been removed from the language. This type is superseded by
5834       the Vec<T> type.
5835     * ~str has been removed from the language. This type is superseded by
5836       the String type.
5837     * ~T has been removed from the language. This type is superseded by the
5838       Box<T> type.
5839     * @T has been removed from the language. This type is superseded by the
5840       standard library's std::gc::Gc<T> type.
5841     * Struct fields are now all private by default.
5842     * Vector indices and shift amounts are both required to be a `uint`
5843       instead of any integral type.
5844     * Byte character, byte string, and raw byte string literals are now all
5845       supported by prefixing the normal literal with a `b`.
5846     * Multiple ABIs are no longer allowed in an ABI string
5847     * The syntax for lifetimes on closures/procedures has been tweaked
5848       slightly: `<'a>|A, B|: 'b + K -> T`
5849     * Floating point modulus has been removed from the language; however it
5850       is still provided by a library implementation.
5851     * Private enum variants are now disallowed.
5852     * The `priv` keyword has been removed from the language.
5853     * A closure can no longer be invoked through a &-pointer.
5854     * The `use foo, bar, baz;` syntax has been removed from the language.
5855     * The transmute intrinsic no longer works on type parameters.
5856     * Statics now allow blocks/items in their definition.
5857     * Trait bounds are separated from objects with + instead of : now.
5858     * Objects can no longer be read while they are mutably borrowed.
5859     * The address of a static is now marked as insignificant unless the
5860       #[inline(never)] attribute is placed it.
5861     * The #[unsafe_destructor] attribute is now behind a feature gate.
5862     * Struct literals are no longer allowed in ambiguous positions such as
5863       if, while, match, and for..in.
5864     * Declaration of lang items and intrinsics are now feature-gated by
5865       default.
5866     * Integral literals no longer default to `int`, and floating point
5867       literals no longer default to `f64`. Literals must be suffixed with an
5868       appropriate type if inference cannot determine the type of the
5869       literal.
5870     * The Box<T> type is no longer implicitly borrowed to &mut T.
5871     * Procedures are now required to not capture borrowed references.
5872
5873   * Libraries
5874     * The standard library is now a "facade" over a number of underlying
5875       libraries. This means that development on the standard library should
5876       be speedier due to smaller crates, as well as a clearer line between
5877       all dependencies.
5878     * A new library, libcore, lives under the standard library's facade
5879       which is Rust's "0-assumption" library, suitable for embedded and
5880       kernel development for example.
5881     * A regex crate has been added to the standard distribution. This crate
5882       includes statically compiled regular expressions.
5883     * The unwrap/unwrap_err methods on Result require a Show bound for
5884       better error messages.
5885     * The return types of the std::comm primitives have been centralized
5886       around the Result type.
5887     * A number of I/O primitives have gained the ability to time out their
5888       operations.
5889     * A number of I/O primitives have gained the ability to close their
5890       reading/writing halves to cancel pending operations.
5891     * Reverse iterator methods have been removed in favor of `rev()` on
5892       their forward-iteration counterparts.
5893     * A bitflags! macro has been added to enable easy interop with C and
5894       management of bit flags.
5895     * A debug_assert! macro is now provided which is disabled when
5896       `--cfg ndebug` is passed to the compiler.
5897     * A graphviz crate has been added for creating .dot files.
5898     * The std::cast module has been migrated into std::mem.
5899     * The std::local_data api has been migrated from freestanding functions
5900       to being based on methods.
5901     * The Pod trait has been renamed to Copy.
5902     * jemalloc has been added as the default allocator for types.
5903     * The API for allocating memory has been changed to use proper alignment
5904       and sized deallocation
5905     * Connecting a TcpStream or binding a TcpListener is now based on a
5906       string address and a u16 port. This allows connecting to a hostname as
5907       opposed to an IP.
5908     * The Reader trait now contains a core method, read_at_least(), which
5909       correctly handles many repeated 0-length reads.
5910     * The process-spawning API is now centered around a builder-style
5911       Command struct.
5912     * The :? printing qualifier has been moved from the standard library to
5913       an external libdebug crate.
5914     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5915       have been renamed to Eq/Ord.
5916     * The select/plural methods have been removed from format!. The escapes
5917       for { and } have also changed from \{ and \} to {{ and }},
5918       respectively.
5919     * The TaskBuilder API has been re-worked to be a true builder, and
5920       extension traits for spawning native/green tasks have been added.
5921
5922   * Tooling
5923     * All breaking changes to the language or libraries now have their
5924       commit message annotated with `[breaking-change]` to allow for easy
5925       discovery of breaking changes.
5926     * The compiler will now try to suggest how to annotate lifetimes if a
5927       lifetime-related error occurs.
5928     * Debug info continues to be improved greatly with general bug fixes and
5929       better support for situations like link time optimization (LTO).
5930     * Usage of syntax extensions when cross-compiling has been fixed.
5931     * Functionality equivalent to GCC & Clang's -ffunction-sections,
5932       -fdata-sections and --gc-sections has been enabled by default
5933     * The compiler is now stricter about where it will load module files
5934       from when a module is declared via `mod foo;`.
5935     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
5936       Syntax extensions are now discovered via a "plugin registrar" type
5937       which will be extended in the future to other various plugins.
5938     * Lints have been restructured to allow for dynamically loadable lints.
5939     * A number of rustdoc improvements:
5940       * The HTML output has been visually redesigned.
5941       * Markdown is now powered by hoedown instead of sundown.
5942       * Searching heuristics have been greatly improved.
5943       * The search index has been reduced in size by a great amount.
5944       * Cross-crate documentation via `pub use` has been greatly improved.
5945       * Primitive types are now hyperlinked and documented.
5946     * Documentation has been moved from static.rust-lang.org/doc to
5947       doc.rust-lang.org
5948     * A new sandbox, play.rust-lang.org, is available for running and
5949       sharing rust code examples on-line.
5950     * Unused attributes are now more robustly warned about.
5951     * The dead_code lint now warns about unused struct fields.
5952     * Cross-compiling to iOS is now supported.
5953     * Cross-compiling to mipsel is now supported.
5954     * Stability attributes are now inherited by default and no longer apply
5955       to intra-crate usage, only inter-crate usage.
5956     * Error message related to non-exhaustive match expressions have been
5957       greatly improved.
5958
5959
5960 Version 0.10 (2014-04-03)
5961 =========================
5962
5963   * ~1500 changes, numerous bugfixes
5964
5965   * Language
5966     * A new RFC process is now in place for modifying the language.
5967     * Patterns with `@`-pointers have been removed from the language.
5968     * Patterns with unique vectors (`~[T]`) have been removed from the
5969       language.
5970     * Patterns with unique strings (`~str`) have been removed from the
5971       language.
5972     * `@str` has been removed from the language.
5973     * `@[T]` has been removed from the language.
5974     * `@self` has been removed from the language.
5975     * `@Trait` has been removed from the language.
5976     * Headers on `~` allocations which contain `@` boxes inside the type for
5977       reference counting have been removed.
5978     * The semantics around the lifetimes of temporary expressions have changed,
5979       see #3511 and #11585 for more information.
5980     * Cross-crate syntax extensions are now possible, but feature gated. See
5981       #11151 for more information. This includes both `macro_rules!` macros as
5982       well as syntax extensions such as `format!`.
5983     * New lint modes have been added, and older ones have been turned on to be
5984       warn-by-default.
5985       * Unnecessary parentheses
5986       * Uppercase statics
5987       * Camel Case types
5988       * Uppercase variables
5989       * Publicly visible private types
5990       * `#[deriving]` with raw pointers
5991     * Unsafe functions can no longer be coerced to closures.
5992     * Various obscure macros such as `log_syntax!` are now behind feature gates.
5993     * The `#[simd]` attribute is now behind a feature gate.
5994     * Visibility is no longer allowed on `extern crate` statements, and
5995       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
5996     * Trailing commas are now allowed in argument lists and tuple patterns.
5997     * The `do` keyword has been removed, it is now a reserved keyword.
5998     * Default type parameters have been implemented, but are feature gated.
5999     * Borrowed variables through captures in closures are now considered soundly.
6000     * `extern mod` is now `extern crate`
6001     * The `Freeze` trait has been removed.
6002     * The `Share` trait has been added for types that can be shared among
6003       threads.
6004     * Labels in macros are now hygienic.
6005     * Expression/statement macro invocations can be delimited with `{}` now.
6006     * Treatment of types allowed in `static mut` locations has been tweaked.
6007     * The `*` and `.` operators are now overloadable through the `Deref` and
6008       `DerefMut` traits.
6009     * `~Trait` and `proc` no longer have `Send` bounds by default.
6010     * Partial type hints are now supported with the `_` type marker.
6011     * An `Unsafe` type was introduced for interior mutability. It is now
6012       considered undefined to transmute from `&T` to `&mut T` without using the
6013       `Unsafe` type.
6014     * The #[linkage] attribute was implemented for extern statics/functions.
6015     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6016     * `Pod` was renamed to `Copy`.
6017
6018   * Libraries
6019     * The `libextra` library has been removed. It has now been decomposed into
6020       component libraries with smaller and more focused nuggets of
6021       functionality. The full list of libraries can be found on the
6022       documentation index page.
6023     * std: `std::condition` has been removed. All I/O errors are now propagated
6024       through the `Result` type. In order to assist with error handling, a
6025       `try!` macro for unwrapping errors with an early return and a lint for
6026       unused results has been added. See #12039 for more information.
6027     * std: The `vec` module has been renamed to `slice`.
6028     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6029       This will become the only growable vector in the future.
6030     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6031       are now found at `std::io::BufferedReader` instead of
6032       `std::io::buffered::BufferedReader`.
6033     * std: `print` and `println` are no longer in the prelude, the `print!` and
6034       `println!` macros are intended to be used instead.
6035     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6036       attempts to statically prevent cycles.
6037     * std: The standard distribution is adopting the policy of pushing failure
6038       to the user rather than failing in libraries. Many functions (such as
6039       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6040     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6041       deriving mode: `#[deriving(Show)]`.
6042     * std: `ToStr` is now implemented for all types implementing `Show`.
6043     * std: The formatting trait methods now take `&self` instead of `&T`
6044     * std: The `invert()` method on iterators has been renamed to `rev()`
6045     * std: `std::num` has seen a reduction in the genericity of its traits,
6046       consolidating functionality into a few core traits.
6047     * std: Backtraces are now printed on task failure if the environment
6048       variable `RUST_BACKTRACE` is present.
6049     * std: Naming conventions for iterators have been standardized. More details
6050       can be found on the wiki's style guide.
6051     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6052       still implement the function.
6053     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6054     * std: `assert_approx_eq!` has been removed
6055     * std: The `e` and `E` formatting specifiers for floats have been added to
6056       print them in exponential notation.
6057     * std: The `Times` trait has been removed
6058     * std: Indications of variance and opting out of builtin bounds is done
6059       through marker types in `std::kinds::marker` now
6060     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6061       `#[deriving(Hash)]` is now possible.
6062     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6063     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6064     * std: `Chan::new` is now `channel()`.
6065     * std: A new synchronous channel type has been implemented.
6066     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6067     * std: `hashmap` and `trie` have been moved to `libcollections`
6068     * std: `run` has been rolled into `io::process`
6069     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6070     * std: The equality and comparison traits have seen some reorganization.
6071     * std: `rand` has moved to `librand`.
6072     * std: `to_{lower,upper}case` has been implemented for `char`.
6073     * std: Logging has been moved to `liblog`.
6074     * collections: `HashMap` has been rewritten for higher performance and less
6075       memory usage.
6076     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6077       it can be booted manually. The runtime guide has more information and
6078       examples.
6079     * native: All I/O functionality except signals has been implemented.
6080     * green: Task spawning with `libgreen` has been optimized with stack caching
6081       and various trimming of code.
6082     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6083     * sync: The `extra::sync` module has been updated to modern rust (and moved
6084       to the `sync` library), tweaking and improving various interfaces while
6085       dropping redundant functionality.
6086     * sync: A new `Barrier` type has been added to the `sync` library.
6087     * sync: An efficient mutex for native and green tasks has been implemented.
6088     * serialize: The `base64` module has seen some improvement. It treats
6089       newlines better, has non-string error values, and has seen general
6090       cleanup.
6091     * fourcc: A `fourcc!` macro was introduced
6092     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6093       hexadecimal literal.
6094
6095   * Tooling
6096     * `rustpkg` has been deprecated and removed from the main repository. Its
6097       replacement, `cargo`, is under development.
6098     * Nightly builds of rust are now available
6099     * The memory usage of rustc has been improved many times throughout this
6100       release cycle.
6101     * The build process supports disabling rpath support for the rustc binary
6102       itself.
6103     * Code generation has improved in some cases, giving more information to the
6104       LLVM optimization passes to enable more extensive optimizations.
6105     * Debuginfo compatibility with lldb on OSX has been restored.
6106     * The master branch is now gated on an android bot, making building for
6107       android much more reliable.
6108     * Output flags have been centralized into one `--emit` flag.
6109     * Crate type flags have been centralized into one `--crate-type` flag.
6110     * Codegen flags have been consolidated behind a `-C` flag.
6111     * Linking against outdated crates now has improved error messages.
6112     * Error messages with lifetimes will often suggest how to annotate the
6113       function to fix the error.
6114     * Many more types are documented in the standard library, and new guides
6115       were written.
6116     * Many `rustdoc` improvements:
6117       * code blocks are syntax highlighted.
6118       * render standalone markdown files.
6119       * the --test flag tests all code blocks by default.
6120       * exported macros are displayed.
6121       * re-exported types have their documentation inlined at the location of the
6122         first re-export.
6123       * search works across crates that have been rendered to the same output
6124         directory.
6125
6126
6127 Version 0.9 (2014-01-09)
6128 ==========================
6129
6130    * ~1800 changes, numerous bugfixes
6131
6132    * Language
6133       * The `float` type has been removed. Use `f32` or `f64` instead.
6134       * A new facility for enabling experimental features (feature gating) has
6135         been added, using the crate-level `#[feature(foo)]` attribute.
6136       * Managed boxes (@) are now behind a feature gate
6137         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6138         standard library's `Gc` or `Rc` types instead.
6139       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6140       * Jumping back to the top of a loop is now done with `continue` instead of
6141         `loop`.
6142       * Strings can no longer be mutated through index assignment.
6143       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6144         hash delimiters, as in `r###"foo"###`.
6145       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6146         called once.
6147       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6148       * `@fn`s have been removed.
6149       * `do` only works with procs in order to make it obvious what the cost
6150         of `do` is.
6151       * Single-element tuple-like structs can no longer be dereferenced to
6152         obtain the inner value. A more comprehensive solution for overloading
6153         the dereference operator will be provided in the future.
6154       * The `#[link(...)]` attribute has been replaced with
6155         `#[crate_id = "name#vers"]`.
6156       * Empty `impl`s must be terminated with empty braces and may not be
6157         terminated with a semicolon.
6158       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6159         no longer has any special meaning.
6160       * The old `fmt!` string formatting macro has been removed.
6161       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6162         `print!` and `println!`.
6163       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6164       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6165         `extern mod foo = "bar"` instead.
6166       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6167       * Macros can have attributes.
6168       * Macros can expand to items with attributes.
6169       * Macros can expand to multiple items.
6170       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6171       * Comments may be nested.
6172       * Values automatically coerce to trait objects they implement, without
6173         an explicit `as`.
6174       * Enum discriminants are no longer an entire word but as small as needed to
6175         contain all the variants. The `repr` attribute can be used to override
6176         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6177         `#[repr(C)]` to match C enums.
6178       * Non-string literals are not allowed in attributes (they never worked).
6179       * The FFI now supports variadic functions.
6180       * Octal numeric literals, as in `0o7777`.
6181       * The `concat!` syntax extension performs compile-time string concatenation.
6182       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6183         removed as Rust no longer uses segmented stacks.
6184       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6185       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6186         not `*`; ignoring remaining fields of a struct is also done with `..`,
6187         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6188       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6189       * `rustc` supports the "system" calling convention, which defaults to the
6190         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6191         "C" elsewhere.
6192       * The `type_overflow` lint (default: warn) checks literals for overflow.
6193       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6194       * The `attribute_usage` lint (default: warn) warns about unknown
6195         attributes.
6196       * The `unknown_features` lint (default: warn) warns about unknown
6197         feature gates.
6198       * The `dead_code` lint (default: warn) checks for dead code.
6199       * Rust libraries can be linked statically to one another
6200       * `#[link_args]` is behind the `link_args` feature gate.
6201       * Native libraries are now linked with `#[link(name = "foo")]`
6202       * Native libraries can be statically linked to a rust crate
6203         (`#[link(name = "foo", kind = "static")]`).
6204       * Native OS X frameworks are now officially supported
6205         (`#[link(name = "foo", kind = "framework")]`).
6206       * The `#[thread_local]` attribute creates thread-local (not task-local)
6207         variables. Currently behind the `thread_local` feature gate.
6208       * The `return` keyword may be used in closures.
6209       * Types that can be copied via a memcpy implement the `Pod` kind.
6210       * The `cfg` attribute can now be used on struct fields and enum variants.
6211
6212    * Libraries
6213       * std: The `option` and `result` API's have been overhauled to make them
6214         simpler, more consistent, and more composable.
6215       * std: The entire `std::io` module has been replaced with one that is
6216         more comprehensive and that properly interfaces with the underlying
6217         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6218         implemented.
6219       * std: `io::util` contains a number of useful implementations of
6220         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6221         `ZeroReader`, `TeeReader`.
6222       * std: The reference counted pointer type `extra::rc` moved into std.
6223       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6224         just a wrapper around it).
6225       * std: The `Either` type has been removed.
6226       * std: `fmt::Default` can be implemented for any type to provide default
6227         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6228       * std: The `rand` API continues to be tweaked.
6229       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6230         on failure in gdb, is now named `rust_fail`.
6231       * std: The `each_key` and `each_value` methods on `HashMap` have been
6232         replaced by the `keys` and `values` iterators.
6233       * std: Functions dealing with type size and alignment have moved from the
6234         `sys` module to the `mem` module.
6235       * std: The `path` module was written and API changed.
6236       * std: `str::from_utf8` has been changed to cast instead of allocate.
6237       * std: `starts_with` and `ends_with` methods added to vectors via the
6238         `ImmutableEqVector` trait, which is in the prelude.
6239       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6240         if the index is out of bounds.
6241       * std: Task failure no longer propagates between tasks, as the model was
6242         complex, expensive, and incompatible with thread-based tasks.
6243       * std: The `Any` type can be used for dynamic typing.
6244       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6245         `task::try`.
6246       * std: Methods that produce iterators generally do not have an `_iter`
6247         suffix now.
6248       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6249         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6250       * std: `util::ignore` renamed to `prelude::drop`.
6251       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6252         trait.
6253       * std: `vec::raw` has seen a lot of cleanup and API changes.
6254       * std: The standard library no longer includes any C++ code, and very
6255         minimal C, eliminating the dependency on libstdc++.
6256       * std: Runtime scheduling and I/O functionality has been factored out into
6257         extensible interfaces and is now implemented by two different crates:
6258         libnative, for native threading and I/O; and libgreen, for green threading
6259         and I/O. This paves the way for using the standard library in more limited
6260         embedded environments.
6261       * std: The `comm` module has been rewritten to be much faster, have a
6262         simpler, more consistent API, and to work for both native and green
6263         threading.
6264       * std: All libuv dependencies have been moved into the rustuv crate.
6265       * native: New implementations of runtime scheduling on top of OS threads.
6266       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6267         and other I/O.
6268       * green: The green thread scheduler and message passing types are almost
6269         entirely lock-free.
6270       * extra: The `flatpipes` module had bitrotted and was removed.
6271       * extra: All crypto functions have been removed and Rust now has a policy of
6272         not reimplementing crypto in the standard library. In the future crypto
6273         will be provided by external crates with bindings to established libraries.
6274       * extra: `c_vec` has been modernized.
6275       * extra: The `sort` module has been removed. Use the `sort` method on
6276         mutable slices.
6277
6278    * Tooling
6279       * The `rust` and `rusti` commands have been removed, due to lack of
6280         maintenance.
6281       * `rustdoc` was completely rewritten.
6282       * `rustdoc` can test code examples in documentation.
6283       * `rustpkg` can test packages with the argument, 'test'.
6284       * `rustpkg` supports arbitrary dependencies, including C libraries.
6285       * `rustc`'s support for generating debug info is improved again.
6286       * `rustc` has better error reporting for unbalanced delimiters.
6287       * `rustc`'s JIT support was removed due to bitrot.
6288       * Executables and static libraries can be built with LTO (-Z lto)
6289       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6290         build tools.
6291
6292
6293 Version 0.8 (2013-09-26)
6294 ============================
6295
6296    * ~2200 changes, numerous bugfixes
6297
6298    * Language
6299       * The `for` loop syntax has changed to work with the `Iterator` trait.
6300       * At long last, unwinding works on Windows.
6301       * Default methods are ready for use.
6302       * Many trait inheritance bugs fixed.
6303       * Owned and borrowed trait objects work more reliably.
6304       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6305       * rustc can omit emission of code for the `debug!` macro if it is passed
6306         `--cfg ndebug`
6307       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6308         for foo.rs, then foo/mod.rs, and will generate an error when both are
6309         present.
6310       * Strings no longer contain trailing nulls. The new `std::c_str` module
6311         provides new mechanisms for converting to C strings.
6312       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6313       * The FFI has been overhauled such that foreign functions are called directly,
6314         instead of through a stack-switching wrapper.
6315       * Calling a foreign function must be done through a Rust function with the
6316         `#[fixed_stack_segment]` attribute.
6317       * The `externfn!` macro can be used to declare both a foreign function and
6318         a `#[fixed_stack_segment]` wrapper at once.
6319       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6320       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6321       * `priv` is disallowed everywhere except for struct fields and enum variants.
6322       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6323       * `ref` bindings in irrefutable patterns work correctly now.
6324       * `char` is now prevented from containing invalid code points.
6325       * Casting to `bool` is no longer allowed.
6326       * `\0` is now accepted as an escape in chars and strings.
6327       * `yield` is a reserved keyword.
6328       * `typeof` is a reserved keyword.
6329       * Crates may be imported by URL with `extern mod foo = "url";`.
6330       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6331       * Static vectors can be initialized with repeating elements,
6332         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6333       * Static structs can be initialized with functional record update,
6334         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6335       * `cfg!` can be used to conditionally execute code based on the crate
6336         configuration, similarly to `#[cfg(...)]`.
6337       * The `unnecessary_qualification` lint detects unneeded module
6338         prefixes (default: allow).
6339       * Arithmetic operations have been implemented on the SIMD types in
6340         `std::unstable::simd`.
6341       * Exchange allocation headers were removed, reducing memory usage.
6342       * `format!` implements a completely new, extensible, and higher-performance
6343         string formatting system. It will replace `fmt!`.
6344       * `print!` and `println!` write formatted strings (using the `format!`
6345         extension) to stdout.
6346       * `write!` and `writeln!` write formatted strings (using the `format!`
6347         extension) to the new Writers in `std::rt::io`.
6348       * The library section in which a function or static is placed may
6349         be specified with `#[link_section = "..."]`.
6350       * The `proto!` syntax extension for defining bounded message protocols
6351         was removed.
6352       * `macro_rules!` is hygienic for `let` declarations.
6353       * The `#[export_name]` attribute specifies the name of a symbol.
6354       * `unreachable!` can be used to indicate unreachable code, and fails
6355         if executed.
6356
6357    * Libraries
6358       * std: Transitioned to the new runtime, written in Rust.
6359       * std: Added an experimental I/O library, `rt::io`, based on the new
6360         runtime.
6361       * std: A new generic `range` function was added to the prelude, replacing
6362         `uint::range` and friends.
6363       * std: `range_rev` no longer exists. Since range is an iterator it can be
6364         reversed with `range(lo, hi).invert()`.
6365       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6366         renamed to `unwrap_or`.
6367       * std: The `iterator` module was renamed to `iter`.
6368       * std: Integral types now support the `checked_add`, `checked_sub`, and
6369         `checked_mul` operations for detecting overflow.
6370       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6371         consistency.
6372       * std: Methods are standardizing on conventions for casting methods:
6373         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6374         and cheap casts.
6375       * std: The `CString` type in `c_str` provides new ways to convert to and
6376         from C strings.
6377       * std: `DoubleEndedIterator` can yield elements in two directions.
6378       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6379         two splices.
6380       * std: `str::from_bytes` renamed to `str::from_utf8`.
6381       * std: `pop_opt` and `shift_opt` methods added to vectors.
6382       * std: The task-local data interface no longer uses @, and keys are
6383         no longer function pointers.
6384       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6385       * std: Added `SharedPort` to `comm`.
6386       * std: `Eq` has a default method for `ne`; only `eq` is required
6387         in implementations.
6388       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6389         is required in implementations.
6390       * std: `is_utf8` performance is improved, impacting many string functions.
6391       * std: `os::MemoryMap` provides cross-platform mmap.
6392       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6393         are not 'in-bounds' are considered undefined.
6394       * std: Many freestanding functions in `vec` removed in favor of methods.
6395       * std: Many freestanding functions on scalar types removed in favor of
6396         methods.
6397       * std: Many options to task builders were removed since they don't make
6398         sense in the new scheduler design.
6399       * std: More containers implement `FromIterator` so can be created by the
6400         `collect` method.
6401       * std: More complete atomic types in `unstable::atomics`.
6402       * std: `comm::PortSet` removed.
6403       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6404         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6405         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6406         default implementations.
6407       * std: Various `from_str` functions were removed in favor of a generic
6408         `from_str` which is available in the prelude.
6409       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6410       * extra: `dlist`, the doubly-linked list was modernized.
6411       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6412       * extra: Added `glob` module, replacing `std::os::glob`.
6413       * extra: `rope` was removed.
6414       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6415       * extra: `net`, and `timer` were removed. The experimental replacements
6416         are `std::rt::io::net` and `std::rt::io::timer`.
6417       * extra: Iterators implemented for `SmallIntMap`.
6418       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6419       * extra: `SmallIntSet` removed. Use `BitvSet`.
6420       * extra: Performance of JSON parsing greatly improved.
6421       * extra: `semver` updated to SemVer 2.0.0.
6422       * extra: `term` handles more terminals correctly.
6423       * extra: `dbg` module removed.
6424       * extra: `par` module removed.
6425       * extra: `future` was cleaned up, with some method renames.
6426       * extra: Most free functions in `getopts` were converted to methods.
6427
6428    * Other
6429       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6430       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6431         similarly to gcc's `--march` flag.
6432       * rustc's performance compiling small crates is much better.
6433       * rustpkg has received many improvements.
6434       * rustpkg supports git tags as package IDs.
6435       * rustpkg builds into target-specific directories so it can be used for
6436         cross-compiling.
6437       * The number of concurrent test tasks is controlled by the environment
6438         variable RUST_TEST_TASKS.
6439       * The test harness can now report metrics for benchmarks.
6440       * All tools have man pages.
6441       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6442       * The runtime uses jemalloc for allocations.
6443       * Segmented stacks are temporarily disabled as part of the transition to
6444         the new runtime. Stack overflows are possible!
6445       * A new documentation backend, rustdoc_ng, is available for use. It is
6446         still invoked through the normal `rustdoc` command.
6447
6448
6449 Version 0.7 (2013-07-03)
6450 =======================
6451
6452    * ~2000 changes, numerous bugfixes
6453
6454    * Language
6455       * `impl`s no longer accept a visibility qualifier. Put them on methods
6456         instead.
6457       * The borrow checker has been rewritten with flow-sensitivity, fixing
6458         many bugs and inconveniences.
6459       * The `self` parameter no longer implicitly means `&'self self`,
6460         and can be explicitly marked with a lifetime.
6461       * Overloadable compound operators (`+=`, etc.) have been temporarily
6462         removed due to bugs.
6463       * The `for` loop protocol now requires `for`-iterators to return `bool`
6464         so they compose better.
6465       * The `Durable` trait is replaced with the `'static` bounds.
6466       * Trait default methods work more often.
6467       * Structs with the `#[packed]` attribute have byte alignment and
6468         no padding between fields.
6469       * Type parameters bound by `Copy` must now be copied explicitly with
6470         the `copy` keyword.
6471       * It is now illegal to move out of a dereferenced unsafe pointer.
6472       * `Option<~T>` is now represented as a nullable pointer.
6473       * `@mut` does dynamic borrow checks correctly.
6474       * The `main` function is only detected at the topmost level of the crate.
6475         The `#[main]` attribute is still valid anywhere.
6476       * Struct fields may no longer be mutable. Use inherited mutability.
6477       * The `#[no_send]` attribute makes a type that would otherwise be
6478         `Send`, not.
6479       * The `#[no_freeze]` attribute makes a type that would otherwise be
6480         `Freeze`, not.
6481       * Unbounded recursion will abort the process after reaching the limit
6482         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6483       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6484         are never implicitly copyable.
6485       * `#[static_assert]` makes compile-time assertions about static bools.
6486       * At long last, 'argument modes' no longer exist.
6487       * The rarely used `use mod` statement no longer exists.
6488
6489    * Syntax extensions
6490       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6491         argument list.
6492       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6493         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6494         `#[deriving(...)]`.
6495       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6496         and unsuffixed integer literals.
6497
6498    * Libraries
6499       * The `core` crate was renamed to `std`.
6500       * The `std` crate was renamed to `extra`.
6501       * More and improved documentation.
6502       * std: `iterator` module for external iterator objects.
6503       * Many old-style (internal, higher-order function) iterators replaced by
6504         implementations of `Iterator`.
6505       * std: Many old internal vector and string iterators,
6506         incl. `any`, `all`. removed.
6507       * std: The `finalize` method of `Drop` renamed to `drop`.
6508       * std: The `drop` method now takes `&mut self` instead of `&self`.
6509       * std: The prelude no longer re-exports any modules, only types and traits.
6510       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6511         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6512       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6513         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6514       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6515         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6516       * std: Many types implement `Clone`.
6517       * std: `path` type renamed to `Path`.
6518       * std: `mut` module and `Mut` type removed.
6519       * std: Many standalone functions removed in favor of methods and iterators
6520         in `vec`, `str`. In the future methods will also work as functions.
6521       * std: `reinterpret_cast` removed. Use `transmute`.
6522       * std: ascii string handling in `std::ascii`.
6523       * std: `Rand` is implemented for ~/@.
6524       * std: `run` module for spawning processes overhauled.
6525       * std: Various atomic types added to `unstable::atomic`.
6526       * std: Various types implement `Zero`.
6527       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6528       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6529       * std: Added `os::mkdir_recursive`.
6530       * std: Added `os::glob` function performs filesystems globs.
6531       * std: `FuzzyEq` renamed to `ApproxEq`.
6532       * std: `Map` now defines `pop` and `swap` methods.
6533       * std: `Cell` constructors converted to static methods.
6534       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6535       * extra: `flate` module moved from `std` to `extra`.
6536       * extra: `fileinput` module for iterating over a series of files.
6537       * extra: `Complex` number type and `complex` module.
6538       * extra: `Rational` number type and `rational` module.
6539       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6540       * extra: `term` uses terminfo now, is more correct.
6541       * extra: `arc` functions converted to methods.
6542       * extra: Implementation of fixed output size variations of SHA-2.
6543
6544    * Tooling
6545       * `unused_variable`  lint mode for unused variables (default: warn).
6546       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6547         (default: warn).
6548       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6549         (default: warn).
6550       * `dead_assignment` lint mode for unread variables (default: warn).
6551       * `unnecessary_allocation` lint mode detects some heap allocations that are
6552         immediately borrowed so could be written without allocating (default: warn).
6553       * `missing_doc` lint mode (default: allow).
6554       * `unreachable_code` lint mode (default: warn).
6555       * The `rusti` command has been rewritten and a number of bugs addressed.
6556       * rustc outputs in color on more terminals.
6557       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6558       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6559       * Compiling with `-g` will make the binary record information about
6560         dynamic borrowcheck failures for debugging.
6561       * rustdoc has a nicer stylesheet.
6562       * Various improvements to rustdoc.
6563       * Improvements to rustpkg (see the detailed release notes).
6564
6565
6566 Version 0.6 (2013-04-03)
6567 ========================
6568
6569    * ~2100 changes, numerous bugfixes
6570
6571    * Syntax changes
6572       * The self type parameter in traits is now spelled `Self`
6573       * The `self` parameter in trait and impl methods must now be explicitly
6574         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6575       * Static methods no longer require the `static` keyword and instead
6576         are distinguished by the lack of a `self` parameter
6577       * Replaced the `Durable` trait with the `'static` lifetime
6578       * The old closure type syntax with the trailing sigil has been
6579         removed in favor of the more consistent leading sigil
6580       * `super` is a keyword, and may be prefixed to paths
6581       * Trait bounds are separated with `+` instead of whitespace
6582       * Traits are implemented with `impl Trait for Type`
6583         instead of `impl Type: Trait`
6584       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6585       * The `export` keyword has finally been removed
6586       * The `move` keyword has been removed (see "Semantic changes")
6587       * The interior mutability qualifier on vectors, `[mut T]`, has been
6588         removed. Use `&mut [T]`, etc.
6589       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6590       * `fail` is no longer a keyword. Use `fail!()`
6591       * `assert` is no longer a keyword. Use `assert!()`
6592       * `log` is no longer a keyword. use `debug!`, etc.
6593       * 1-tuples may be represented as `(T,)`
6594       * Struct fields may no longer be `mut`. Use inherited mutability,
6595         `@mut T`, `core::mut` or `core::cell`
6596       * `extern mod { ... }` is no longer valid syntax for foreign
6597         function modules. Use extern blocks: `extern { ... }`
6598       * Newtype enums removed. Use tuple-structs.
6599       * Trait implementations no longer support visibility modifiers
6600       * Pattern matching over vectors improved and expanded
6601       * `const` renamed to `static` to correspond to lifetime name,
6602         and make room for future `static mut` unsafe mutable globals.
6603       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6604       * `Clone` implementations can be automatically generated with
6605         `#[deriving(Clone)]`
6606       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6607         instead of `foo as Bar`.
6608       * Fixed length vector types are now written as `[int, .. 3]`
6609         instead of `[int * 3]`.
6610       * Fixed length vector types can express the length as a constant
6611         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6612
6613    * Semantic changes
6614       * Types with owned pointers or custom destructors move by default,
6615         eliminating the `move` keyword
6616       * All foreign functions are considered unsafe
6617       * &mut is now unaliasable
6618       * Writes to borrowed @mut pointers are prevented dynamically
6619       * () has size 0
6620       * The name of the main function can be customized using #[main]
6621       * The default type of an inferred closure is &fn instead of @fn
6622       * `use` statements may no longer be "chained" - they cannot import
6623         identifiers imported by previous `use` statements
6624       * `use` statements are crate relative, importing from the "top"
6625         of the crate by default. Paths may be prefixed with `super::`
6626         or `self::` to change the search behavior.
6627       * Method visibility is inherited from the implementation declaration
6628       * Structural records have been removed
6629       * Many more types can be used in static items, including enums
6630         'static-lifetime pointers and vectors
6631       * Pattern matching over vectors improved and expanded
6632       * Typechecking of closure types has been overhauled to
6633         improve inference and eliminate unsoundness
6634       * Macros leave scope at the end of modules, unless that module is
6635         tagged with #[macro_escape]
6636
6637    * Libraries
6638       * Added big integers to `std::bigint`
6639       * Removed `core::oldcomm` module
6640       * Added pipe-based `core::comm` module
6641       * Numeric traits have been reorganized under `core::num`
6642       * `vec::slice` finally returns a slice
6643       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6644       * Containers reorganized around traits in `core::container`
6645       * `core::dvec` removed, `~[T]` is a drop-in replacement
6646       * `core::send_map` renamed to `core::hashmap`
6647       * `std::map` removed; replaced with `core::hashmap`
6648       * `std::treemap` reimplemented as an owned balanced tree
6649       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6650       * `core::trie` added as a fast ordered map for integer keys
6651       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6652       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6653         overload the comparison operators, whereas `TotalOrd` is used
6654         by certain container types
6655
6656    * Other
6657       * Replaced the 'cargo' package manager with 'rustpkg'
6658       * Added all-purpose 'rust' tool
6659       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6660       * rustc now *attempts* to offer spelling suggestions
6661       * Improved support for ARM and Android
6662       * Preliminary MIPS backend
6663       * Improved foreign function ABI implementation for x86, x86_64
6664       * Various memory usage improvements
6665       * Rust code may be embedded in foreign code under limited circumstances
6666       * Inline assembler supported by new asm!() syntax extension.
6667
6668
6669 Version 0.5 (2012-12-21)
6670 ===========================
6671
6672    * ~900 changes, numerous bugfixes
6673
6674    * Syntax changes
6675       * Removed `<-` move operator
6676       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6677       * Removed old fixed length vector syntax - `[T]/N`
6678       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6679       * Macros may now expand to items and statements
6680       * `a.b()` is always parsed as a method call, never as a field projection
6681       * `Eq` and `IterBytes` implementations can be automatically generated
6682         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6683       * Removed the special crate language for `.rc` files
6684       * Function arguments may consist of any irrefutable pattern
6685
6686    * Semantic changes
6687       * `&` and `~` pointers may point to objects
6688       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6689       * Enum variants may be structs
6690       * Destructors can be added to all nominal types with the Drop trait
6691       * Structs and nullary enum variants may be constants
6692       * Values that cannot be implicitly copied are now automatically moved
6693         without writing `move` explicitly
6694       * `&T` may now be coerced to `*T`
6695       * Coercions happen in `let` statements as well as function calls
6696       * `use` statements now take crate-relative paths
6697       * The module and type namespaces have been merged so that static
6698         method names can be resolved under the trait in which they are
6699         declared
6700
6701    * Improved support for language features
6702       * Trait inheritance works in many scenarios
6703       * More support for explicit self arguments in methods - `self`, `&self`
6704         `@self`, and `~self` all generally work as expected
6705       * Static methods work in more situations
6706       * Experimental: Traits may declare default methods for the implementations
6707         to use
6708
6709    * Libraries
6710       * New condition handling system in `core::condition`
6711       * Timsort added to `std::sort`
6712       * New priority queue, `std::priority_queue`
6713       * Pipes for serializable types, `std::flatpipes'
6714       * Serialization overhauled to be trait-based
6715       * Expanded `getopts` definitions
6716       * Moved futures to `std`
6717       * More functions are pure now
6718       * `core::comm` renamed to `oldcomm`. Still deprecated
6719       * `rustdoc` and `cargo` are libraries now
6720
6721    * Misc
6722       * Added a preliminary REPL, `rusti`
6723       * License changed from MIT to dual MIT/APL2
6724
6725
6726 Version 0.4 (2012-10-15)
6727 ==========================
6728
6729    * ~2000 changes, numerous bugfixes
6730
6731    * Syntax
6732       * All keywords are now strict and may not be used as identifiers anywhere
6733       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6734         'of', 'with', 'to', 'class'.
6735       * Classes are replaced with simpler structs
6736       * Explicit method self types
6737       * `ret` became `return` and `alt` became `match`
6738       * `import` is now `use`; `use is now `extern mod`
6739       * `extern mod { ... }` is now `extern { ... }`
6740       * `use mod` is the recommended way to import modules
6741       * `pub` and `priv` replace deprecated export lists
6742       * The syntax of `match` pattern arms now uses fat arrow (=>)
6743       * `main` no longer accepts an args vector; use `os::args` instead
6744
6745    * Semantics
6746       * Trait implementations are now coherent, ala Haskell typeclasses
6747       * Trait methods may be static
6748       * Argument modes are deprecated
6749       * Borrowed pointers are much more mature and recommended for use
6750       * Strings and vectors in the static region are stored in constant memory
6751       * Typestate was removed
6752       * Resolution rewritten to be more reliable
6753       * Support for 'dual-mode' data structures (freezing and thawing)
6754
6755    * Libraries
6756       * Most binary operators can now be overloaded via the traits in
6757         `core::ops'
6758       * `std::net::url` for representing URLs
6759       * Sendable hash maps in `core::send_map`
6760       * `core::task' gained a (currently unsafe) task-local storage API
6761
6762    * Concurrency
6763       * An efficient new intertask communication primitive called the pipe,
6764         along with a number of higher-level channel types, in `core::pipes`
6765       * `std::arc`, an atomically reference counted, immutable, shared memory
6766         type
6767       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6768       * Futures are now based on pipes and sendable
6769       * More robust linked task failure
6770       * Improved task builder API
6771
6772    * Other
6773       * Improved error reporting
6774       * Preliminary JIT support
6775       * Preliminary work on precise GC
6776       * Extensive architectural improvements to rustc
6777       * Begun a transition away from buggy C++-based reflection (shape) code to
6778         Rust-based (visitor) code
6779       * All hash functions and tables converted to secure, randomized SipHash
6780
6781
6782 Version 0.3  (2012-07-12)
6783 ========================
6784
6785    * ~1900 changes, numerous bugfixes
6786
6787    * New coding conveniences
6788       * Integer-literal suffix inference
6789       * Per-item control over warnings, errors
6790       * #[cfg(windows)] and #[cfg(unix)] attributes
6791       * Documentation comments
6792       * More compact closure syntax
6793       * 'do' expressions for treating higher-order functions as
6794         control structures
6795       * *-patterns (wildcard extended to all constructor fields)
6796
6797    * Semantic cleanup
6798       * Name resolution pass and exhaustiveness checker rewritten
6799       * Region pointers and borrow checking supersede alias
6800         analysis
6801       * Init-ness checking is now provided by a region-based liveness
6802         pass instead of the typestate pass; same for last-use analysis
6803       * Extensive work on region pointers
6804
6805    * Experimental new language features
6806       * Slices and fixed-size, interior-allocated vectors
6807       * #!-comments for lang versioning, shell execution
6808       * Destructors and iface implementation for classes;
6809         type-parameterized classes and class methods
6810       * 'const' type kind for types that can be used to implement
6811         shared-memory concurrency patterns
6812
6813    * Type reflection
6814
6815    * Removal of various obsolete features
6816       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6817                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6818
6819       * Constructs: do-while loops ('do' repurposed), fn binding,
6820                     resources (replaced by destructors)
6821
6822    * Compiler reorganization
6823       * Syntax-layer of compiler split into separate crate
6824       * Clang (from LLVM project) integrated into build
6825       * Typechecker split into sub-modules
6826
6827    * New library code
6828       * New time functions
6829       * Extension methods for many built-in types
6830       * Arc: atomic-refcount read-only / exclusive-use shared cells
6831       * Par: parallel map and search routines
6832       * Extensive work on libuv interface
6833       * Much vector code moved to libraries
6834       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6835         #include, #include_str, #include_bin
6836
6837    * Tool improvements
6838       * Cargo automatically resolves dependencies
6839
6840
6841 Version 0.2  (2012-03-29)
6842 =========================
6843
6844    * >1500 changes, numerous bugfixes
6845
6846    * New docs and doc tooling
6847
6848    * New port: FreeBSD x86_64
6849
6850    * Compilation model enhancements
6851       * Generics now specialized, multiply instantiated
6852       * Functions now inlined across separate crates
6853
6854    * Scheduling, stack and threading fixes
6855       * Noticeably improved message-passing performance
6856       * Explicit schedulers
6857       * Callbacks from C
6858       * Helgrind clean
6859
6860    * Experimental new language features
6861       * Operator overloading
6862       * Region pointers
6863       * Classes
6864
6865    * Various language extensions
6866       * C-callback function types: 'crust fn ...'
6867       * Infinite-loop construct: 'loop { ... }'
6868       * Shorten 'mutable' to 'mut'
6869       * Required mutable-local qualifier: 'let mut ...'
6870       * Basic glob-exporting: 'export foo::*;'
6871       * Alt now exhaustive, 'alt check' for runtime-checked
6872       * Block-function form of 'for' loop, with 'break' and 'ret'.
6873
6874    * New library code
6875       * AST quasi-quote syntax extension
6876       * Revived libuv interface
6877       * New modules: core::{future, iter}, std::arena
6878       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6879       * Extensive cleanup, regularization in libstd, libcore
6880
6881
6882 Version 0.1  (2012-01-20)
6883 ===============================
6884
6885    * Most language features work, including:
6886       * Unique pointers, unique closures, move semantics
6887       * Interface-constrained generics
6888       * Static interface dispatch
6889       * Stack growth
6890       * Multithread task scheduling
6891       * Typestate predicates
6892       * Failure unwinding, destructors
6893       * Pattern matching and destructuring assignment
6894       * Lightweight block-lambda syntax
6895       * Preliminary macro-by-example
6896
6897    * Compiler works with the following configurations:
6898       * Linux: x86 and x86_64 hosts and targets
6899       * macOS: x86 and x86_64 hosts and targets
6900       * Windows: x86 hosts and targets
6901
6902    * Cross compilation / multi-target configuration supported.
6903
6904    * Preliminary API-documentation and package-management tools included.
6905
6906 Known issues:
6907
6908    * Documentation is incomplete.
6909
6910    * Performance is below intended target.
6911
6912    * Standard library APIs are subject to extensive change, reorganization.
6913
6914    * Language-level versioning is not yet operational - future code will
6915      break unexpectedly.