]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
submodules: update clippy from b2601beb to 29bf75cd
[rust.git] / RELEASES.md
1 Version 1.31.0 (2018-12-06)
2 ==========================
3
4 Language
5 --------
6 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉 
7 - [New lifetime elision rules now allow for eliding lifetimes in functions and
8   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
9   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
10   in structs.
11 - [You can now define and use `const` functions.][54835] These are currently
12   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
13   [language reference][const-reference] for what exactly is available.
14 - [You can now use tool lints, which allow you to scope lints from external
15   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
16 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
17   a crate, not just in exported functions.][54451]
18 - [You can now use parentheses in pattern matches.][54497]
19
20 Compiler
21 --------
22 - [Updated musl to 1.1.20][54430]
23
24 Libraries
25 ---------
26 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
27   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
28 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
29   into `Option<&mut T>` using the `From` trait.][53218]
30 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
31
32
33 Stabilized APIs
34 ---------------
35 - [`slice::align_to`]
36 - [`slice::align_to_mut`]
37 - [`slice::chunks_exact`]
38 - [`slice::chunks_exact_mut`]
39 - [`slice::rchunks`]
40 - [`slice::rchunks_mut`]
41 - [`slice::rchunks_exact`]
42 - [`slice::rchunks_exact_mut`]
43 - [`Option::replace`]
44
45 Cargo
46 -----
47 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
48 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
49   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
50
51 [52813]: https://github.com/rust-lang/rust/pull/52813/
52 [53218]: https://github.com/rust-lang/rust/pull/53218/
53 [53555]: https://github.com/rust-lang/rust/issues/53555/
54 [54057]: https://github.com/rust-lang/rust/pull/54057/
55 [54240]: https://github.com/rust-lang/rust/pull/54240/
56 [54430]: https://github.com/rust-lang/rust/pull/54430/
57 [54451]: https://github.com/rust-lang/rust/pull/54451/
58 [54497]: https://github.com/rust-lang/rust/pull/54497/
59 [54778]: https://github.com/rust-lang/rust/pull/54778/
60 [54835]: https://github.com/rust-lang/rust/pull/54835/
61 [54870]: https://github.com/rust-lang/rust/pull/54870/
62 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
63 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
64 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
65 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
66 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
67 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
68 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
69 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
70 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
71 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
72 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
73 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
74 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
75 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
76
77 Version 1.30.1 (2018-11-08)
78 ===========================
79
80 - [Fixed overflow ICE in rustdoc][54199]
81 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
82
83 [54199]: https://github.com/rust-lang/rust/pull/54199
84 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
85
86 Version 1.30.0 (2018-10-25)
87 ==========================
88
89 Language
90 --------
91 - [Procedural macros are now available.][52081] These kinds of macros allow for
92   more powerful code generation. There is a [new chapter available][proc-macros]
93   in the Rust Programming Language book that goes further in depth.
94 - [You can now use keywords as identifiers using the raw identifiers
95   syntax (`r#`),][53236] e.g. `let r#for = true;`
96 - [Using anonymous parameters in traits is now deprecated with a warning and
97   will be a hard error in the 2018 edition.][53272]
98 - [You can now use `crate` in paths.][54404] This allows you to refer to the
99   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
100 - [Using a external crate no longer requires being prefixed with `::`.][54404]
101   Previously, using a external crate in a module without a use statement
102   required `let json = ::serde_json::from_str(foo);` but can now be written
103   as `let json = serde_json::from_str(foo);`.
104 - [You can now apply the `#[used]` attribute to static items to prevent the
105   compiler from optimising them away, even if they appear to be unused,][51363]
106   e.g. `#[used] static FOO: u32 = 1;`
107 - [You can now import and reexport macros from other crates with the `use`
108   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
109   the root module of the crate. If your macro relies on calling other local
110   macros, it is recommended to export with the
111   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
112   those macros.
113 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
114   using the `vis` specifier.][53370]
115 - [Non-macro attributes now allow all forms of literals, not just
116   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
117   write `#[attr(true)]`.
118 - [You can now specify a function to handle a panic in the Rust runtime with the
119   `#[panic_handler]` attribute.][51366]
120
121 Compiler
122 --------
123 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
124 - [Added the `aarch64-unknown-netbsd` target][53165]
125
126 Libraries
127 ---------
128 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
129
130 Stabilized APIs
131 ---------------
132 - [`Ipv4Addr::BROADCAST`]
133 - [`Ipv4Addr::LOCALHOST`]
134 - [`Ipv4Addr::UNSPECIFIED`]
135 - [`Ipv6Addr::LOCALHOST`]
136 - [`Ipv6Addr::UNSPECIFIED`]
137 - [`Iterator::find_map`]
138
139   The following methods are replacement methods for `trim_left`, `trim_right`,
140   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
141   in 1.33.0:
142 - [`str::trim_end_matches`]
143 - [`str::trim_end`]
144 - [`str::trim_start_matches`]
145 - [`str::trim_start`]
146
147 Cargo
148 ----
149 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
150 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
151   equivalent to calling `rustdoc --error-format=json`.
152 - [Cargo will now provide a progress bar for builds.][cargo/5995]
153
154 Misc
155 ----
156 - [`rustdoc` allows you to specify what edition to treat your code as with the
157   `--edition` option.][54057]
158 - [`rustdoc` now has the `--color` (specify whether to output color) and
159   `--error-format` (specify error format, e.g. `json`) options.][53003]
160 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
161   debug symbols.][53774]
162 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
163   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
164
165 [50911]: https://github.com/rust-lang/rust/pull/50911/
166 [51363]: https://github.com/rust-lang/rust/pull/51363/
167 [51366]: https://github.com/rust-lang/rust/pull/51366/
168 [52081]: https://github.com/rust-lang/rust/pull/52081/
169 [53003]: https://github.com/rust-lang/rust/pull/53003/
170 [53033]: https://github.com/rust-lang/rust/pull/53033/
171 [53044]: https://github.com/rust-lang/rust/pull/53044/
172 [53165]: https://github.com/rust-lang/rust/pull/53165/
173 [53213]: https://github.com/rust-lang/rust/pull/53213/
174 [53236]: https://github.com/rust-lang/rust/pull/53236/
175 [53272]: https://github.com/rust-lang/rust/pull/53272/
176 [53370]: https://github.com/rust-lang/rust/pull/53370/
177 [53459]: https://github.com/rust-lang/rust/pull/53459/
178 [53774]: https://github.com/rust-lang/rust/pull/53774/
179 [53822]: https://github.com/rust-lang/rust/pull/53822/
180 [54057]: https://github.com/rust-lang/rust/pull/54057/
181 [54146]: https://github.com/rust-lang/rust/pull/54146/
182 [54404]: https://github.com/rust-lang/rust/pull/54404/
183 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
184 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
185 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
186 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
187
188 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
189 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
190 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
191 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
192 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
193 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
194 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
195 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
196 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
197 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
198
199
200 Version 1.29.2 (2018-10-11)
201 ===========================
202
203 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
204 - The `rls-preview` component on the windows-gnu targets has been restored.
205
206 [54639]: https://github.com/rust-lang/rust/pull/54639
207
208
209 Version 1.29.1 (2018-09-25)
210 ===========================
211
212 Security Notes
213 --------------
214
215 - The standard library's `str::repeat` function contained an out of bounds write
216   caused by an integer overflow. This has been fixed by deterministically
217   panicking when an overflow happens.
218
219   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
220   us.
221
222
223 Version 1.29.0 (2018-09-13)
224 ==========================
225
226 Compiler
227 --------
228 - [Bumped minimum LLVM version to 5.0.][51899]
229 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
230 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
231
232 Libraries
233 ---------
234 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
235 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
236 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
237 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
238   for `&str`.][51178]
239 - [`Cell<T>` now allows `T` to be unsized.][50494]
240 - [`SocketAddr` is now stable on Redox.][52656]
241
242 Stabilized APIs
243 ---------------
244 - [`Arc::downcast`]
245 - [`Iterator::flatten`]
246 - [`Rc::downcast`]
247
248 Cargo
249 -----
250 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
251   `--locked` to disable this behavior.
252 - [`cargo-install` will now allow you to cross compile an install
253   using `--target`.][cargo/5614]
254 - [Added the `cargo-fix` subcommand to automatically move project code from
255   2015 edition to 2018.][cargo/5723]
256 - [`cargo doc` can now optionally document private types using the
257   `--document-private-items` flag.][cargo/5543]
258
259 Misc
260 ----
261 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
262   the specified level to that level.][52354] For example `--cap-lints warn`
263   will demote `deny` and `forbid` lints to `warn`.
264 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
265   fails and `101` if there is a panic.][52197]
266 - [A preview of clippy has been made available through rustup.][51122]
267   You can install the preview with `rustup component add clippy-preview`.
268
269 Compatibility Notes
270 -------------------
271 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
272   Use `str::get_unchecked(begin..end)` instead.
273 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
274   Consider using the `home_dir` function from
275   https://crates.io/crates/dirs instead.
276 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
277 - [`cfg` attributes and `--cfg` command line flags are now more
278   strictly validated.][53893]
279
280 [53893]: https://github.com/rust-lang/rust/pull/53893/
281 [52861]: https://github.com/rust-lang/rust/pull/52861/
282 [52656]: https://github.com/rust-lang/rust/pull/52656/
283 [52239]: https://github.com/rust-lang/rust/pull/52239/
284 [52330]: https://github.com/rust-lang/rust/pull/52330/
285 [52354]: https://github.com/rust-lang/rust/pull/52354/
286 [52402]: https://github.com/rust-lang/rust/pull/52402/
287 [52103]: https://github.com/rust-lang/rust/pull/52103/
288 [52197]: https://github.com/rust-lang/rust/pull/52197/
289 [51807]: https://github.com/rust-lang/rust/pull/51807/
290 [51899]: https://github.com/rust-lang/rust/pull/51899/
291 [51912]: https://github.com/rust-lang/rust/pull/51912/
292 [51511]: https://github.com/rust-lang/rust/pull/51511/
293 [51619]: https://github.com/rust-lang/rust/pull/51619/
294 [51656]: https://github.com/rust-lang/rust/pull/51656/
295 [51178]: https://github.com/rust-lang/rust/pull/51178/
296 [51122]: https://github.com/rust-lang/rust/pull/51122
297 [50494]: https://github.com/rust-lang/rust/pull/50494/
298 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
299 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
300 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
301 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
302 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
303 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
304 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
305
306
307 Version 1.28.0 (2018-08-02)
308 ===========================
309
310 Language
311 --------
312 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
313   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
314   the inner type across Foreign Function Interface (FFI) boundaries.
315 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
316   and can now be used as identifiers.][51196]
317 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
318   stable.][51241] This will allow users to specify a global allocator for
319   their program.
320 - [Unit test functions marked with the `#[test]` attribute can now return
321   `Result<(), E: Debug>` in addition to `()`.][51298]
322 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
323   allows macros to easily target lifetimes.
324
325 Compiler
326 --------
327 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
328   prioritise making smaller binary sizes. `z` is the same as `s` with the
329   exception that it does not vectorise loops, which typically results in an even
330   smaller binary.
331 - [The short error format is now stable.][49546] Specified with
332   `--error-format=short` this option will provide a more compressed output of
333   rust error messages.
334 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
335 - [Reduced the number of allocations in the macro parser.][50855] This can
336   improve compile times of macro heavy crates on average by 5%.
337
338 Libraries
339 ---------
340 - [Implemented `Default` for `&mut str`.][51306]
341 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
342 - [Implemented `Extend` for `()`.][50234]
343 - [The `Debug` implementation of `time::Duration` should now be more easily
344   human readable.][50364] Previously a `Duration` of one second would printed as
345   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
346 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
347   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
348   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
349   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
350   for `PathBuf`.][50170]
351 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
352   and `Wrapping<i128>`.][50465]
353 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
354   possible.][51050] This can provide up to a 40% speed increase.
355 - [Improved error messages when using `format!`.][50610]
356
357 Stabilized APIs
358 ---------------
359 - [`Iterator::step_by`]
360 - [`Path::ancestors`]
361 - [`SystemTime::UNIX_EPOCH`]
362 - [`alloc::GlobalAlloc`]
363 - [`alloc::Layout`]
364 - [`alloc::LayoutErr`]
365 - [`alloc::System`]
366 - [`alloc::alloc`]
367 - [`alloc::alloc_zeroed`]
368 - [`alloc::dealloc`]
369 - [`alloc::realloc`]
370 - [`alloc::handle_alloc_error`]
371 - [`btree_map::Entry::or_default`]
372 - [`fmt::Alignment`]
373 - [`hash_map::Entry::or_default`]
374 - [`iter::repeat_with`]
375 - [`num::NonZeroUsize`]
376 - [`num::NonZeroU128`]
377 - [`num::NonZeroU16`]
378 - [`num::NonZeroU32`]
379 - [`num::NonZeroU64`]
380 - [`num::NonZeroU8`]
381 - [`ops::RangeBounds`]
382 - [`slice::SliceIndex`]
383 - [`slice::from_mut`]
384 - [`slice::from_ref`]
385 - [`{Any + Send + Sync}::downcast_mut`]
386 - [`{Any + Send + Sync}::downcast_ref`]
387 - [`{Any + Send + Sync}::is`]
388
389 Cargo
390 -----
391 - [Cargo will now no longer allow you to publish crates with build scripts that
392   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
393   considered to be immutable.
394
395 Misc
396 ----
397 - [The `suggestion_applicability` field in `rustc`'s json output is now
398   stable.][50486] This will allow dev tools to check whether a code suggestion
399   would apply to them.
400
401 Compatibility Notes
402 -------------------
403 - [Rust will consider trait objects with duplicated constraints to be the same
404   type as without the duplicated constraint.][51276] For example the below code will
405   now fail to compile.
406   ```rust
407   trait Trait {}
408
409   impl Trait + Send {
410       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
411   }
412
413   impl Trait + Send + Send {
414       fn test(&self) { println!("two"); }
415   }
416   ```
417
418 [49546]: https://github.com/rust-lang/rust/pull/49546/
419 [50143]: https://github.com/rust-lang/rust/pull/50143/
420 [50170]: https://github.com/rust-lang/rust/pull/50170/
421 [50234]: https://github.com/rust-lang/rust/pull/50234/
422 [50265]: https://github.com/rust-lang/rust/pull/50265/
423 [50364]: https://github.com/rust-lang/rust/pull/50364/
424 [50385]: https://github.com/rust-lang/rust/pull/50385/
425 [50465]: https://github.com/rust-lang/rust/pull/50465/
426 [50486]: https://github.com/rust-lang/rust/pull/50486/
427 [50554]: https://github.com/rust-lang/rust/pull/50554/
428 [50610]: https://github.com/rust-lang/rust/pull/50610/
429 [50855]: https://github.com/rust-lang/rust/pull/50855/
430 [51050]: https://github.com/rust-lang/rust/pull/51050/
431 [51196]: https://github.com/rust-lang/rust/pull/51196/
432 [51200]: https://github.com/rust-lang/rust/pull/51200/
433 [51241]: https://github.com/rust-lang/rust/pull/51241/
434 [51276]: https://github.com/rust-lang/rust/pull/51276/
435 [51298]: https://github.com/rust-lang/rust/pull/51298/
436 [51306]: https://github.com/rust-lang/rust/pull/51306/
437 [51562]: https://github.com/rust-lang/rust/pull/51562/
438 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
439 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
440 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
441 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
442 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
443 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
444 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
445 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
446 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
447 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
448 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
449 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
450 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
451 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
452 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
453 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
454 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
455 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
456 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
457 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
458 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
459 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
460 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
461 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
462 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
463 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
464 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
465 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
466 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
467 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
468
469 Version 1.27.2 (2018-07-20)
470 ===========================
471
472 Compatibility Notes
473 -------------------
474
475 - The borrow checker was fixed to avoid potential unsoundness when using
476   match ergonomics: [#52213][52213].
477
478 [52213]: https://github.com/rust-lang/rust/issues/52213
479
480 Version 1.27.1 (2018-07-10)
481 ===========================
482
483 Security Notes
484 --------------
485
486 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
487   when running, which enabled executing code as some other user on a
488   given machine. This release fixes that vulnerability; you can read
489   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
490
491   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
492
493 Compatibility Notes
494 -------------------
495
496 - The borrow checker was fixed to avoid an additional potential unsoundness when using
497   match ergonomics: [#51415][51415], [#49534][49534].
498
499 [51415]: https://github.com/rust-lang/rust/issues/51415
500 [49534]: https://github.com/rust-lang/rust/issues/49534
501 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
502 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
503
504 Version 1.27.0 (2018-06-21)
505 ==========================
506
507 Language
508 --------
509 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
510   be used as an identifier.
511 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
512   bare `Trait` syntax, and should make it clearer when being used in tandem with
513   `impl Trait` because it is equivalent to the following syntax:
514   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
515   `Box<Trait> == Box<dyn Trait>`.
516 - [Attributes on generic parameters such as types and lifetimes are
517   now stable.][48851] e.g.
518   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
519 - [The `#[must_use]` attribute can now also be used on functions as well as
520   types.][48925] It provides a lint that by default warns users when the
521   value returned by a function has not been used.
522
523 Compiler
524 --------
525 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
526
527 Libraries
528 ---------
529 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
530   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
531   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
532   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
533   the `cfg` attribute.
534 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
535   std are now available in core.][49896]
536 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
537   to `Self`.][49630]
538 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
539   that the operation isn't done in place.
540 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
541   the `#[must_use]` attribute][49533] to warn about unused potentially
542   expensive allocations.
543
544 Stabilized APIs
545 ---------------
546 - [`DoubleEndedIterator::rfind`]
547 - [`DoubleEndedIterator::rfold`]
548 - [`DoubleEndedIterator::try_rfold`]
549 - [`Duration::from_micros`]
550 - [`Duration::from_nanos`]
551 - [`Duration::subsec_micros`]
552 - [`Duration::subsec_millis`]
553 - [`HashMap::remove_entry`]
554 - [`Iterator::try_fold`]
555 - [`Iterator::try_for_each`]
556 - [`NonNull::cast`]
557 - [`Option::filter`]
558 - [`String::replace_range`]
559 - [`Take::set_limit`]
560 - [`hint::unreachable_unchecked`]
561 - [`os::unix::process::parent_id`]
562 - [`ptr::swap_nonoverlapping`]
563 - [`slice::rsplit_mut`]
564 - [`slice::rsplit`]
565 - [`slice::swap_with_slice`]
566
567 Cargo
568 -----
569 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
570   `readme`, and `repository` fields.][cargo/5386]
571 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
572 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
573   a different directory than `target` for placing compilation artifacts.
574 - [Cargo will be adding automatic target inference for binaries, benchmarks,
575   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
576   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
577   where cargo would infer a binary, Cargo will produce a warning. You can
578   disable this feature ahead of time by setting any of the following to false:
579   `autobins`, `autobenches`, `autoexamples`, `autotests`.
580 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
581   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
582
583 Misc
584 ----
585 - [Added “The Rustc book” into the official documentation.][49707]
586   [“The Rustc book”] documents and teaches how to use the rustc compiler.
587 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
588
589 Compatibility Notes
590 -------------------
591 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
592   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
593   compile, `"".is_empty()` will still compile.
594 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
595   will only print the inner type.][48553] E.g.
596   `print!("{:?}", AtomicBool::new(true))` will print `true`,
597   not `AtomicBool(true)`.
598 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
599   could enter higher numbers but they were not supported by LLVM. Up to 512MB
600   alignment should cover all use cases.
601 - The `.description()` method on the `std::error::Error` trait
602   [has been soft-deprecated][50163]. It is no longer required to implement it.
603
604 [48553]: https://github.com/rust-lang/rust/pull/48553/
605 [48851]: https://github.com/rust-lang/rust/pull/48851/
606 [48925]: https://github.com/rust-lang/rust/pull/48925/
607 [49533]: https://github.com/rust-lang/rust/pull/49533/
608 [49623]: https://github.com/rust-lang/rust/pull/49623/
609 [49630]: https://github.com/rust-lang/rust/pull/49630/
610 [49664]: https://github.com/rust-lang/rust/pull/49664/
611 [49699]: https://github.com/rust-lang/rust/pull/49699/
612 [49707]: https://github.com/rust-lang/rust/pull/49707/
613 [49719]: https://github.com/rust-lang/rust/pull/49719/
614 [49896]: https://github.com/rust-lang/rust/pull/49896/
615 [49968]: https://github.com/rust-lang/rust/pull/49968/
616 [50163]: https://github.com/rust-lang/rust/pull/50163
617 [50177]: https://github.com/rust-lang/rust/pull/50177/
618 [50378]: https://github.com/rust-lang/rust/pull/50378/
619 [50398]: https://github.com/rust-lang/rust/pull/50398/
620 [50423]: https://github.com/rust-lang/rust/pull/50423/
621 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
622 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
623 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
624 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
625 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
626 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
627 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
628 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
629 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
630 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
631 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
632 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
633 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
634 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
635 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
636 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
637 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
638 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
639 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
640 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
641 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
642 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
643 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
644 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
645 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
646 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
647 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
648 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
649 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
650 [“The Rustc book”]: https://doc.rust-lang.org/rustc
651
652
653 Version 1.26.2 (2018-06-05)
654 ==========================
655
656 Compatibility Notes
657 -------------------
658
659 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
660
661 [51117]: https://github.com/rust-lang/rust/issues/51117
662
663
664 Version 1.26.1 (2018-05-29)
665 ==========================
666
667 Tools
668 -----
669
670 - [RLS now works on Windows.][50646]
671 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
672
673
674 Compatibility Notes
675 --------
676
677 - [`fn main() -> impl Trait` no longer works for non-Termination
678   trait.][50656]
679   This reverts an accidental stabilization.
680 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
681 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
682
683 [50646]: https://github.com/rust-lang/rust/issues/50646
684 [50656]: https://github.com/rust-lang/rust/pull/50656
685 [50812]: https://github.com/rust-lang/rust/pull/50812
686 [50950]: https://github.com/rust-lang/rust/issues/50950
687 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
688
689 Version 1.26.0 (2018-05-10)
690 ==========================
691
692 Language
693 --------
694 - [Closures now implement `Copy` and/or `Clone` if all captured variables
695   implement either or both traits.][49299]
696 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
697 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
698   lifetime can be elided.][49458]
699 - [`impl Trait` is now stable allowing you to have abstract types in returns
700    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
701   `fn open(path: impl AsRef<Path>)`.
702 - [Pattern matching will now automatically apply dereferences.][49394]
703 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
704 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
705 - [A lot of operations are now available in a const context.][46882] E.g. You
706   can now index into constant arrays, reference and dereference into constants,
707   and use tuple struct constructors.
708 - [Fixed entry slice patterns are now stable.][48516] E.g.
709   ```rust
710   let points = [1, 2, 3, 4];
711   match points {
712       [1, 2, 3, 4] => println!("All points were sequential."),
713       _ => println!("Not all points were sequential."),
714   }
715   ```
716
717
718 Compiler
719 --------
720 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
721 - [Fixed exponential projection complexity on nested types.][48296]
722   This can provide up to a ~12% reduction in compile times for certain crates.
723 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
724   to remap path prefixes outputted by the compiler.
725 - [Added `powerpc-unknown-netbsd` target.][48281]
726
727 Libraries
728 ---------
729 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
730 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
731   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
732 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
733 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
734 - [`ascii::escape_default` is now available in libcore.][48735]
735 - [Trailing commas are now supported in std and core macros.][48056]
736 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
737 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
738
739 Stabilized APIs
740 ---------------
741 - [`*const T::add`]
742 - [`*const T::copy_to_nonoverlapping`]
743 - [`*const T::copy_to`]
744 - [`*const T::read_unaligned`]
745 - [`*const T::read_volatile`]
746 - [`*const T::read`]
747 - [`*const T::sub`]
748 - [`*const T::wrapping_add`]
749 - [`*const T::wrapping_sub`]
750 - [`*mut T::add`]
751 - [`*mut T::copy_to_nonoverlapping`]
752 - [`*mut T::copy_to`]
753 - [`*mut T::read_unaligned`]
754 - [`*mut T::read_volatile`]
755 - [`*mut T::read`]
756 - [`*mut T::replace`]
757 - [`*mut T::sub`]
758 - [`*mut T::swap`]
759 - [`*mut T::wrapping_add`]
760 - [`*mut T::wrapping_sub`]
761 - [`*mut T::write_bytes`]
762 - [`*mut T::write_unaligned`]
763 - [`*mut T::write_volatile`]
764 - [`*mut T::write`]
765 - [`Box::leak`]
766 - [`FromUtf8Error::as_bytes`]
767 - [`LocalKey::try_with`]
768 - [`Option::cloned`]
769 - [`btree_map::Entry::and_modify`]
770 - [`fs::read_to_string`]
771 - [`fs::read`]
772 - [`fs::write`]
773 - [`hash_map::Entry::and_modify`]
774 - [`iter::FusedIterator`]
775 - [`ops::RangeInclusive`]
776 - [`ops::RangeToInclusive`]
777 - [`process::id`]
778 - [`slice::rotate_left`]
779 - [`slice::rotate_right`]
780 - [`String::retain`]
781
782
783 Cargo
784 -----
785 - [Cargo will now output path to custom commands when `-v` is
786   passed with `--list`][cargo/5041]
787 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
788
789 Misc
790 ----
791 - [The second edition of "The Rust Programming Language" book is now recommended
792   over the first.][48404]
793
794 Compatibility Notes
795 -------------------
796
797 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
798   syntax is now invalid.
799   ```
800   use std::ops::Fn as dyn;
801   fn g(_: Box<dyn(std::fmt::Debug)>) {}
802   ```
803 - [The result of dereferences are no longer promoted to `'static`.][47408]
804   e.g.
805   ```rust
806   fn main() {
807       const PAIR: &(i32, i32) = &(0, 1);
808       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
809   }
810   ```
811 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
812 - [`".e0"` will now no longer parse as `0.0` and will instead cause
813   an error.][48235]
814 - [Removed hoedown from rustdoc.][48274]
815 - [Bounds on higher-kinded lifetimes a hard error.][48326]
816
817 [46882]: https://github.com/rust-lang/rust/pull/46882
818 [47379]: https://github.com/rust-lang/rust/pull/47379
819 [47408]: https://github.com/rust-lang/rust/pull/47408
820 [47813]: https://github.com/rust-lang/rust/pull/47813
821 [48056]: https://github.com/rust-lang/rust/pull/48056
822 [48125]: https://github.com/rust-lang/rust/pull/48125
823 [48166]: https://github.com/rust-lang/rust/pull/48166
824 [48235]: https://github.com/rust-lang/rust/pull/48235
825 [48274]: https://github.com/rust-lang/rust/pull/48274
826 [48281]: https://github.com/rust-lang/rust/pull/48281
827 [48296]: https://github.com/rust-lang/rust/pull/48296
828 [48326]: https://github.com/rust-lang/rust/pull/48326
829 [48359]: https://github.com/rust-lang/rust/pull/48359
830 [48404]: https://github.com/rust-lang/rust/pull/48404
831 [48481]: https://github.com/rust-lang/rust/pull/48481
832 [48516]: https://github.com/rust-lang/rust/pull/48516
833 [48628]: https://github.com/rust-lang/rust/pull/48628
834 [48629]: https://github.com/rust-lang/rust/pull/48629
835 [48657]: https://github.com/rust-lang/rust/pull/48657
836 [48735]: https://github.com/rust-lang/rust/pull/48735
837 [48978]: https://github.com/rust-lang/rust/pull/48978
838 [49101]: https://github.com/rust-lang/rust/pull/49101
839 [49109]: https://github.com/rust-lang/rust/pull/49109
840 [49121]: https://github.com/rust-lang/rust/pull/49121
841 [49162]: https://github.com/rust-lang/rust/pull/49162
842 [49184]: https://github.com/rust-lang/rust/pull/49184
843 [49234]: https://github.com/rust-lang/rust/pull/49234
844 [49255]: https://github.com/rust-lang/rust/pull/49255
845 [49299]: https://github.com/rust-lang/rust/pull/49299
846 [49305]: https://github.com/rust-lang/rust/pull/49305
847 [49394]: https://github.com/rust-lang/rust/pull/49394
848 [49458]: https://github.com/rust-lang/rust/pull/49458
849 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
850 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
851 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
852 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
853 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
854 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
855 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
856 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
857 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
858 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
859 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
860 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
861 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
862 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
863 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
864 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
865 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
866 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
867 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
868 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
869 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
870 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
871 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
872 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
873 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
874 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
875 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
876 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
877 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
878 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
879 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
880 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
881 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
882 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
883 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
884 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
885 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
886 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
887 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
888 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
889 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
890 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
891
892
893 Version 1.25.0 (2018-03-29)
894 ==========================
895
896 Language
897 --------
898 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
899 - [You can now use nested groups of imports.][47948]
900   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
901 - [You can now have `|` at the start of a match arm.][47947] e.g.
902 ```rust
903 enum Foo { A, B, C }
904
905 fn main() {
906     let x = Foo::A;
907     match x {
908         | Foo::A
909         | Foo::B => println!("AB"),
910         | Foo::C => println!("C"),
911     }
912 }
913 ```
914
915 Compiler
916 --------
917 - [Upgraded to LLVM 6.][47828]
918 - [Added `-C lto=val` option.][47521]
919 - [Added `i586-unknown-linux-musl` target][47282]
920
921 Libraries
922 ---------
923 - [Impl Send for `process::Command` on Unix.][47760]
924 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
925 - [`UnsafeCell::into_inner` is now safe.][47204]
926 - [Implement libstd for CloudABI.][47268]
927 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
928 - [Implement `AsRef<Path>` for Component][46985]
929 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
930 - [Moved `Duration` to libcore.][46666]
931
932 Stabilized APIs
933 ---------------
934 - [`Location::column`]
935 - [`ptr::NonNull`]
936
937 The following functions can now be used in a constant expression.
938 eg. `static MINUTE: Duration = Duration::from_secs(60);`
939 - [`Duration::new`][47300]
940 - [`Duration::from_secs`][47300]
941 - [`Duration::from_millis`][47300]
942
943 Cargo
944 -----
945 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
946 - [`cargo new` now defaults to creating a binary crate, instead of a
947   library crate.][cargo/5029]
948
949 Misc
950 ----
951 - [Rust by example is now shipped with new releases][46196]
952
953 Compatibility Notes
954 -------------------
955 - [Deprecated `net::lookup_host`.][47510]
956 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
957 - The borrow checker was sometimes incorrectly permitting overlapping borrows
958   around indexing operations (see [#47349][47349]). This has been fixed (which also
959   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
960 - [Removed deprecated unstable attribute `#[simd]`.][47251]
961
962 [33903]: https://github.com/rust-lang/rust/pull/33903
963 [47947]: https://github.com/rust-lang/rust/pull/47947
964 [47948]: https://github.com/rust-lang/rust/pull/47948
965 [47760]: https://github.com/rust-lang/rust/pull/47760
966 [47790]: https://github.com/rust-lang/rust/pull/47790
967 [47828]: https://github.com/rust-lang/rust/pull/47828
968 [47398]: https://github.com/rust-lang/rust/pull/47398
969 [47510]: https://github.com/rust-lang/rust/pull/47510
970 [47521]: https://github.com/rust-lang/rust/pull/47521
971 [47204]: https://github.com/rust-lang/rust/pull/47204
972 [47251]: https://github.com/rust-lang/rust/pull/47251
973 [47268]: https://github.com/rust-lang/rust/pull/47268
974 [47282]: https://github.com/rust-lang/rust/pull/47282
975 [47300]: https://github.com/rust-lang/rust/pull/47300
976 [47349]: https://github.com/rust-lang/rust/pull/47349
977 [46931]: https://github.com/rust-lang/rust/pull/46931
978 [46985]: https://github.com/rust-lang/rust/pull/46985
979 [47006]: https://github.com/rust-lang/rust/pull/47006
980 [46830]: https://github.com/rust-lang/rust/pull/46830
981 [46095]: https://github.com/rust-lang/rust/pull/46095
982 [46666]: https://github.com/rust-lang/rust/pull/46666
983 [46196]: https://github.com/rust-lang/rust/pull/46196
984 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
985 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
986 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
987 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
988 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
989
990
991 Version 1.24.1 (2018-03-01)
992 ==========================
993
994  - [Do not abort when unwinding through FFI][48251]
995  - [Emit UTF-16 files for linker arguments on Windows][48318]
996  - [Make the error index generator work again][48308]
997  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
998
999 [48251]: https://github.com/rust-lang/rust/issues/48251
1000 [48308]: https://github.com/rust-lang/rust/issues/48308
1001 [48318]: https://github.com/rust-lang/rust/issues/48318
1002 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1003
1004
1005 Version 1.24.0 (2018-02-15)
1006 ==========================
1007
1008 Language
1009 --------
1010 - [External `sysv64` ffi is now available.][46528]
1011   eg. `extern "sysv64" fn foo () {}`
1012
1013 Compiler
1014 --------
1015 - [rustc now uses 16 codegen units by default for release builds.][46910]
1016   For the fastest builds, utilize `codegen-units=1`.
1017 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1018 - [Add `aarch64-unknown-openbsd` support][46760]
1019
1020 Libraries
1021 ---------
1022 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1023   improvement in performance in the majority of cases.
1024 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1025   with Windows.][46798]
1026 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1027 - [impl `From<bool>` for `AtomicBool`][46293]
1028 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1029 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1030 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1031 - [float::from_bits now just uses transmute.][46012] This provides
1032   some optimisations from LLVM.
1033 - [Copied `AsciiExt` methods onto `char`][46077]
1034 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1035 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1036 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1037 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1038
1039 Stabilized APIs
1040 ---------------
1041 - [`RefCell::replace`]
1042 - [`RefCell::swap`]
1043 - [`atomic::spin_loop_hint`]
1044
1045 The following functions can now be used in a constant expression.
1046 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1047
1048 - [`AtomicBool::new`][46287]
1049 - [`AtomicUsize::new`][46287]
1050 - [`AtomicIsize::new`][46287]
1051 - [`AtomicPtr::new`][46287]
1052 - [`Cell::new`][46287]
1053 - [`{integer}::min_value`][46287]
1054 - [`{integer}::max_value`][46287]
1055 - [`mem::size_of`][46287]
1056 - [`mem::align_of`][46287]
1057 - [`ptr::null`][46287]
1058 - [`ptr::null_mut`][46287]
1059 - [`RefCell::new`][46287]
1060 - [`UnsafeCell::new`][46287]
1061
1062 Cargo
1063 -----
1064 - [Added a `workspace.default-members` config that
1065   overrides implied `--all` in virtual workspaces.][cargo/4743]
1066 - [Enable incremental by default on development builds.][cargo/4817] Also added
1067   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1068   per-project or global basis respectively.
1069
1070 Misc
1071 ----
1072
1073 Compatibility Notes
1074 -------------------
1075 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1076 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1077   in accordance with IETF RFC 4291 §2.2.
1078 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1079 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1080   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1081 - [Leading zeros in tuple struct members is now an error][47084]
1082 - [`column!()` macro is one-based instead of zero-based][46977]
1083 - [`fmt::Arguments` can no longer be shared across threads][45198]
1084 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1085 - [Cargo sets a different working directory for the compiler][cargo/4788]
1086
1087 [44884]: https://github.com/rust-lang/rust/pull/44884
1088 [45198]: https://github.com/rust-lang/rust/pull/45198
1089 [45506]: https://github.com/rust-lang/rust/pull/45506
1090 [45904]: https://github.com/rust-lang/rust/pull/45904
1091 [45990]: https://github.com/rust-lang/rust/pull/45990
1092 [46012]: https://github.com/rust-lang/rust/pull/46012
1093 [46077]: https://github.com/rust-lang/rust/pull/46077
1094 [46094]: https://github.com/rust-lang/rust/pull/46094
1095 [46284]: https://github.com/rust-lang/rust/pull/46284
1096 [46287]: https://github.com/rust-lang/rust/pull/46287
1097 [46293]: https://github.com/rust-lang/rust/pull/46293
1098 [46528]: https://github.com/rust-lang/rust/pull/46528
1099 [46671]: https://github.com/rust-lang/rust/pull/46671
1100 [46713]: https://github.com/rust-lang/rust/pull/46713
1101 [46735]: https://github.com/rust-lang/rust/pull/46735
1102 [46749]: https://github.com/rust-lang/rust/pull/46749
1103 [46760]: https://github.com/rust-lang/rust/pull/46760
1104 [46798]: https://github.com/rust-lang/rust/pull/46798
1105 [46828]: https://github.com/rust-lang/rust/pull/46828
1106 [46831]: https://github.com/rust-lang/rust/pull/46831
1107 [46833]: https://github.com/rust-lang/rust/pull/46833
1108 [46910]: https://github.com/rust-lang/rust/pull/46910
1109 [46977]: https://github.com/rust-lang/rust/pull/46977
1110 [47018]: https://github.com/rust-lang/rust/pull/47018
1111 [47080]: https://github.com/rust-lang/rust/pull/47080
1112 [47084]: https://github.com/rust-lang/rust/pull/47084
1113 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1114 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1115 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1116 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1117 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1118 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1119
1120
1121 Version 1.23.0 (2018-01-04)
1122 ==========================
1123
1124 Language
1125 --------
1126 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1127 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1128   Which should fix some confusing errors in some operations.
1129
1130 Compiler
1131 --------
1132 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1133   undefined behavior.][45920]
1134 - [rustc now suggests renaming import if names clash.][45660]
1135 - [Display errors/warnings correctly when there are zero-width or
1136   wide characters.][45711]
1137 - [rustc now avoids unnecessary copies of arguments that are
1138   simple bindings][45380] This should improve memory usage on average by 5-10%.
1139 - [Updated musl used to build musl rustc to 1.1.17][45393]
1140
1141 Libraries
1142 ---------
1143 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1144 - [Implement Hash for raw pointers to unsized types][45483]
1145 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1146 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1147 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1148 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1149   and `<*mut T>::as_mut`][44932]
1150 - [Optimized `Thread::{park, unpark}` implementation][45524]
1151 - [Improved `SliceExt::binary_search` performance.][45333]
1152 - [impl `FromIterator<()>` for `()`][45379]
1153 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1154   is now deprecated.
1155
1156 Stabilized APIs
1157 ---------------
1158
1159 Cargo
1160 -----
1161 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1162   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1163 - [Added unit test checking to `cargo check`][cargo/4592]
1164 - [Cargo now lets you install a specific version
1165   using `cargo install --version`][cargo/4637]
1166
1167 Misc
1168 ----
1169 - [Releases now ship with the Cargo book documentation.][45692]
1170 - [rustdoc now prints rendering warnings on every run.][45324]
1171
1172 Compatibility Notes
1173 -------------------
1174 - [Changes have been made to type equality to make it more correct,
1175   in rare cases this could break some code.][45853] [Tracking issue for
1176   further information][45852]
1177 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1178 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1179   Android 9, the minimum supported version is Android 14.
1180 - [Bumped the minimum LLVM to 3.9][45326]
1181
1182 [44042]: https://github.com/rust-lang/rust/pull/44042
1183 [44932]: https://github.com/rust-lang/rust/pull/44932
1184 [45267]: https://github.com/rust-lang/rust/pull/45267
1185 [45324]: https://github.com/rust-lang/rust/pull/45324
1186 [45326]: https://github.com/rust-lang/rust/pull/45326
1187 [45333]: https://github.com/rust-lang/rust/pull/45333
1188 [45379]: https://github.com/rust-lang/rust/pull/45379
1189 [45380]: https://github.com/rust-lang/rust/pull/45380
1190 [45393]: https://github.com/rust-lang/rust/pull/45393
1191 [45435]: https://github.com/rust-lang/rust/pull/45435
1192 [45483]: https://github.com/rust-lang/rust/pull/45483
1193 [45524]: https://github.com/rust-lang/rust/pull/45524
1194 [45571]: https://github.com/rust-lang/rust/pull/45571
1195 [45580]: https://github.com/rust-lang/rust/pull/45580
1196 [45610]: https://github.com/rust-lang/rust/pull/45610
1197 [45660]: https://github.com/rust-lang/rust/pull/45660
1198 [45692]: https://github.com/rust-lang/rust/pull/45692
1199 [45711]: https://github.com/rust-lang/rust/pull/45711
1200 [45772]: https://github.com/rust-lang/rust/pull/45772
1201 [45852]: https://github.com/rust-lang/rust/issues/45852
1202 [45853]: https://github.com/rust-lang/rust/pull/45853
1203 [45887]: https://github.com/rust-lang/rust/pull/45887
1204 [45920]: https://github.com/rust-lang/rust/pull/45920
1205 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1206 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1207 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1208
1209
1210 Version 1.22.1 (2017-11-22)
1211 ==========================
1212
1213 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1214
1215 [46183]: https://github.com/rust-lang/rust/pull/46183
1216
1217 Version 1.22.0 (2017-11-22)
1218 ==========================
1219
1220 Language
1221 --------
1222 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1223 - [Now accepts underscores in unicode escapes][43716]
1224 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1225 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1226
1227 Compiler
1228 --------
1229 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1230 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1231   This should decrease compile times for debug builds.
1232 - [strict memory alignment now enabled on ARMv6][45094]
1233 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1234
1235 Libraries
1236 ---------
1237 - [Allow atomic operations up to 32 bits
1238   on `armv5te_unknown_linux_gnueabi`][44978]
1239 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1240 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1241 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1242 - [Properly detect overflow in `Instant += Duration`.][44220]
1243 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1244 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1245 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1246
1247 Stabilized APIs
1248 ---------------
1249
1250 Cargo
1251 -----
1252 - [Cargo will now build multi file examples in subdirectories of the `examples`
1253   folder that have a `main.rs` file.][cargo/4496]
1254 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1255   the old format will continue to work and can be updated with `cargo update`.
1256 - [Now supports vendoring git repositories][cargo/3992]
1257
1258 Misc
1259 ----
1260 - [`libbacktrace` is now available on Apple platforms.][44251]
1261 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1262   This now lets you specify that a given code example will fail to compile.
1263
1264 Compatibility Notes
1265 -------------------
1266 - [The minimum Android version that rustc can build for has been bumped
1267   to `4.0` from `2.3`][45656]
1268 - [Allowing `T op= &T` for numeric types has broken some type
1269   inference cases][45480]
1270
1271
1272 [42526]: https://github.com/rust-lang/rust/pull/42526
1273 [43017]: https://github.com/rust-lang/rust/pull/43017
1274 [43716]: https://github.com/rust-lang/rust/pull/43716
1275 [43949]: https://github.com/rust-lang/rust/pull/43949
1276 [44015]: https://github.com/rust-lang/rust/pull/44015
1277 [44220]: https://github.com/rust-lang/rust/pull/44220
1278 [44251]: https://github.com/rust-lang/rust/pull/44251
1279 [44287]: https://github.com/rust-lang/rust/pull/44287
1280 [44303]: https://github.com/rust-lang/rust/pull/44303
1281 [44456]: https://github.com/rust-lang/rust/pull/44456
1282 [44466]: https://github.com/rust-lang/rust/pull/44466
1283 [44895]: https://github.com/rust-lang/rust/pull/44895
1284 [44966]: https://github.com/rust-lang/rust/pull/44966
1285 [44978]: https://github.com/rust-lang/rust/pull/44978
1286 [45041]: https://github.com/rust-lang/rust/pull/45041
1287 [45064]: https://github.com/rust-lang/rust/pull/45064
1288 [45075]: https://github.com/rust-lang/rust/pull/45075
1289 [45094]: https://github.com/rust-lang/rust/pull/45094
1290 [45095]: https://github.com/rust-lang/rust/pull/45095
1291 [45480]: https://github.com/rust-lang/rust/issues/45480
1292 [45656]: https://github.com/rust-lang/rust/pull/45656
1293 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1294 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1295 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1296
1297
1298
1299
1300
1301
1302 Version 1.21.0 (2017-10-12)
1303 ==========================
1304
1305 Language
1306 --------
1307 - [You can now use static references for literals.][43838]
1308   Example:
1309   ```rust
1310   fn main() {
1311       let x: &'static u32 = &0;
1312   }
1313   ```
1314 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1315   Example:
1316   ```rust
1317   my_macro!(Vec<i32>::new); // Always worked
1318   my_macro!(Vec::<i32>::new); // Now works
1319   ```
1320
1321 Compiler
1322 --------
1323 - [Upgraded jemalloc to 4.5.0][43911]
1324 - [Enabled unwinding panics on Redox][43917]
1325 - [Now runs LLVM in parallel during translation phase.][43506]
1326   This should reduce peak memory usage.
1327
1328 Libraries
1329 ---------
1330 - [Generate builtin impls for `Clone` for all arrays and tuples that
1331   are `T: Clone`][43690]
1332 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1333 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1334   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1335
1336 Stabilized APIs
1337 ---------------
1338
1339 [`std::mem::discriminant`]
1340
1341 Cargo
1342 -----
1343 - [You can now call `cargo install` with multiple package names][cargo/4216]
1344 - [Cargo commands inside a virtual workspace will now implicitly
1345   pass `--all`][cargo/4335]
1346 - [Added a `[patch]` section to `Cargo.toml` to handle
1347   prepublication dependencies][cargo/4123] [RFC 1969]
1348 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1349   like patterns][cargo/4270]
1350 - [Added the `--all-targets` option][cargo/4400]
1351 - [Using required dependencies as a feature is now deprecated and emits
1352   a warning][cargo/4364]
1353
1354
1355 Misc
1356 ----
1357 - [Cargo docs are moving][43916]
1358   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1359 - [The rustdoc book is now available][43863]
1360   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1361 - [Added a preview of RLS has been made available through rustup][44204]
1362   Install with `rustup component add rls-preview`
1363 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1364   Previously only showed `std::os::unix`.
1365
1366 Compatibility Notes
1367 -------------------
1368 - [Changes in method matching against higher-ranked types][43880] This may cause
1369   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1370 - [rustc's JSON error output's byte position start at top of file.][42973]
1371   Was previously relative to the rustc's internal `CodeMap` struct which
1372   required the unstable library `libsyntax` to correctly use.
1373 - [`unused_results` lint no longer ignores booleans][43728]
1374
1375 [42565]: https://github.com/rust-lang/rust/pull/42565
1376 [42973]: https://github.com/rust-lang/rust/pull/42973
1377 [43348]: https://github.com/rust-lang/rust/pull/43348
1378 [43459]: https://github.com/rust-lang/rust/pull/43459
1379 [43506]: https://github.com/rust-lang/rust/pull/43506
1380 [43540]: https://github.com/rust-lang/rust/pull/43540
1381 [43690]: https://github.com/rust-lang/rust/pull/43690
1382 [43728]: https://github.com/rust-lang/rust/pull/43728
1383 [43838]: https://github.com/rust-lang/rust/pull/43838
1384 [43863]: https://github.com/rust-lang/rust/pull/43863
1385 [43880]: https://github.com/rust-lang/rust/pull/43880
1386 [43911]: https://github.com/rust-lang/rust/pull/43911
1387 [43916]: https://github.com/rust-lang/rust/pull/43916
1388 [43917]: https://github.com/rust-lang/rust/pull/43917
1389 [44204]: https://github.com/rust-lang/rust/pull/44204
1390 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1391 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1392 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1393 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1394 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1395 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1396 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1397 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1398 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1399
1400 Version 1.20.0 (2017-08-31)
1401 ===========================
1402
1403 Language
1404 --------
1405 - [Associated constants are now stabilised.][42809]
1406 - [A lot of macro bugs are now fixed.][42913]
1407
1408 Compiler
1409 --------
1410
1411 - [Struct fields are now properly coerced to the expected field type.][42807]
1412 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1413   `wasm32-experimental-emscripten` target.
1414 - [Changed some of the error messages to be more helpful.][42033]
1415 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1416   it.][43170]
1417 - [rustc now reports the total number of errors on compilation failure][43015]
1418   previously this was only the number of errors in the pass that failed.
1419 - [Expansion in rustc has been sped up 29x.][42533]
1420 - [added `msp430-none-elf` target.][43099]
1421 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1422   applicable][43178]
1423 - [Fixes backtraces on Redox][43228]
1424 - [rustc now identifies different versions of same crate when absolute paths of
1425   different types match in an error message.][42826]
1426
1427 Libraries
1428 ---------
1429
1430
1431 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1432 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1433   tuples.][43011]
1434 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1435   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1436 - [Impl `Clone` for `DefaultHasher`.][42799]
1437 - [Impl `Sync` for `SyncSender`.][42397]
1438 - [Impl `FromStr` for `char`][42271]
1439 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1440   NaN.][42431]
1441 - [allow messages in the `unimplemented!()` macro.][42155]
1442   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1443 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1444 - [Upgrade to Unicode 10.0.0][42999]
1445 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1446 - [Skip the main thread's manual stack guard on Linux][43072]
1447 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1448 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1449   previously 2^15.
1450 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1451
1452 Stabilized APIs
1453 ---------------
1454
1455 - [`CStr::into_c_string`]
1456 - [`CString::as_c_str`]
1457 - [`CString::into_boxed_c_str`]
1458 - [`Chain::get_mut`]
1459 - [`Chain::get_ref`]
1460 - [`Chain::into_inner`]
1461 - [`Option::get_or_insert_with`]
1462 - [`Option::get_or_insert`]
1463 - [`OsStr::into_os_string`]
1464 - [`OsString::into_boxed_os_str`]
1465 - [`Take::get_mut`]
1466 - [`Take::get_ref`]
1467 - [`Utf8Error::error_len`]
1468 - [`char::EscapeDebug`]
1469 - [`char::escape_debug`]
1470 - [`compile_error!`]
1471 - [`f32::from_bits`]
1472 - [`f32::to_bits`]
1473 - [`f64::from_bits`]
1474 - [`f64::to_bits`]
1475 - [`mem::ManuallyDrop`]
1476 - [`slice::sort_unstable_by_key`]
1477 - [`slice::sort_unstable_by`]
1478 - [`slice::sort_unstable`]
1479 - [`str::from_boxed_utf8_unchecked`]
1480 - [`str::as_bytes_mut`]
1481 - [`str::as_bytes_mut`]
1482 - [`str::from_utf8_mut`]
1483 - [`str::from_utf8_unchecked_mut`]
1484 - [`str::get_mut`]
1485 - [`str::get_unchecked_mut`]
1486 - [`str::get_unchecked`]
1487 - [`str::get`]
1488 - [`str::into_boxed_bytes`]
1489
1490
1491 Cargo
1492 -----
1493 - [Cargo API token location moved from `~/.cargo/config` to
1494   `~/.cargo/credentials`.][cargo/3978]
1495 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1496   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1497   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1498 - [You can now specify version of a binary when installed through
1499   `cargo install` using `--vers`.][cargo/4229]
1500 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1501   failure.][cargo/4248]
1502 - [Changed the convention around which file is the crate root.][cargo/4259]
1503 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1504   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1505
1506 Compatibility Notes
1507 -------------------
1508
1509 - [Functions with `'static` in their return types will now not be as usable as
1510   if they were using lifetime parameters instead.][42417]
1511 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1512   takes the sign of NaN into account where previously didn't.][42430]
1513
1514 [42033]: https://github.com/rust-lang/rust/pull/42033
1515 [42155]: https://github.com/rust-lang/rust/pull/42155
1516 [42271]: https://github.com/rust-lang/rust/pull/42271
1517 [42397]: https://github.com/rust-lang/rust/pull/42397
1518 [42417]: https://github.com/rust-lang/rust/pull/42417
1519 [42430]: https://github.com/rust-lang/rust/pull/42430
1520 [42431]: https://github.com/rust-lang/rust/pull/42431
1521 [42533]: https://github.com/rust-lang/rust/pull/42533
1522 [42571]: https://github.com/rust-lang/rust/pull/42571
1523 [42613]: https://github.com/rust-lang/rust/pull/42613
1524 [42799]: https://github.com/rust-lang/rust/pull/42799
1525 [42807]: https://github.com/rust-lang/rust/pull/42807
1526 [42809]: https://github.com/rust-lang/rust/pull/42809
1527 [42822]: https://github.com/rust-lang/rust/pull/42822
1528 [42826]: https://github.com/rust-lang/rust/pull/42826
1529 [42854]: https://github.com/rust-lang/rust/pull/42854
1530 [42913]: https://github.com/rust-lang/rust/pull/42913
1531 [42999]: https://github.com/rust-lang/rust/pull/42999
1532 [43011]: https://github.com/rust-lang/rust/pull/43011
1533 [43015]: https://github.com/rust-lang/rust/pull/43015
1534 [43072]: https://github.com/rust-lang/rust/pull/43072
1535 [43077]: https://github.com/rust-lang/rust/pull/43077
1536 [43097]: https://github.com/rust-lang/rust/pull/43097
1537 [43099]: https://github.com/rust-lang/rust/pull/43099
1538 [43170]: https://github.com/rust-lang/rust/pull/43170
1539 [43178]: https://github.com/rust-lang/rust/pull/43178
1540 [43185]: https://github.com/rust-lang/rust/pull/43185
1541 [43228]: https://github.com/rust-lang/rust/pull/43228
1542 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1543 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1544 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1545 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1546 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1547 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1548 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1549 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1550 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1551 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1552 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1553 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1554 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1555 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1556 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1557 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1558 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1559 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1560 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1561 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1562 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1563 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1564 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1565 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1566 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1567 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1568 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1569 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1570 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1571 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1572 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1573 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1574 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1575 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1576 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1577 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1578 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1579 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1580 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1581
1582
1583 Version 1.19.0 (2017-07-20)
1584 ===========================
1585
1586 Language
1587 --------
1588
1589 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1590   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1591 - [Macro recursion limit increased to 1024 from 64.][41676]
1592 - [Added lint for detecting unused macros.][41907]
1593 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1594   For example: `let x = loop { break 7; };`
1595 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1596   contain `Copy` types and cannot have a `Drop` implementation.
1597   Example: `union Foo { bar: u8, baz: usize }`
1598 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1599   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1600
1601 Compiler
1602 --------
1603
1604 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1605 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1606   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1607   you should use `--target armv7-linux-androideabi`.
1608 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1609 - [Minor optimisation of string operations.][42037]
1610 - [Compiler error message is now `aborting due to previous error(s)` instead of
1611   `aborting due to N previous errors`][42150] This was previously inaccurate and
1612   would only count certain kinds of errors.
1613 - [The compiler now supports Visual Studio 2017][42225]
1614 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1615 - [Added a lot][42264] of [new error codes][42302]
1616 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1617   libraries with C Run-time Libraries(CRT) to be statically linked.
1618 - [Fixed various ARM codegen bugs][42740]
1619
1620 Libraries
1621 ---------
1622
1623 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1624   `Extend<Cow<'a, str>>`][41449]
1625 - [`Vec` now implements `From<&mut [T]>`][41530]
1626 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1627 - [`SplitWhitespace` now implements `Clone`][41659]
1628 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1629   1.5x faster][41764]
1630 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1631   macros, but for printing to stderr.
1632
1633 Stabilized APIs
1634 ---------------
1635
1636 - [`OsString::shrink_to_fit`]
1637 - [`cmp::Reverse`]
1638 - [`Command::envs`]
1639 - [`thread::ThreadId`]
1640
1641 Cargo
1642 -----
1643
1644 - [Build scripts can now add environment variables to the environment
1645   the crate is being compiled in.
1646   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1647 - [Subcommands now replace the current process rather than spawning a new
1648   child process][cargo/3970]
1649 - [Workspace members can now accept glob file patterns][cargo/3979]
1650 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1651   the members in a given workspace.][cargo/3988]
1652 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1653 - [Target directory path is now in the cargo metadata][cargo/4022]
1654 - [Cargo no longer checks out a local working directory for the
1655   crates.io index][cargo/4026] This should provide smaller file size for the
1656   registry, and improve cloning times, especially on Windows machines.
1657 - [Added an `--exclude` option for excluding certain packages when using the
1658   `--all` option][cargo/4031]
1659 - [Cargo will now automatically retry when receiving a 5xx error
1660   from crates.io][cargo/4032]
1661 - [The `--features` option now accepts multiple comma or space
1662   delimited values.][cargo/4084]
1663 - [Added support for custom target specific runners][cargo/3954]
1664
1665 Misc
1666 ----
1667
1668 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1669   Windows Debugger.
1670 - [Rust will now release XZ compressed packages][rust-installer/57]
1671 - [rustup will now prefer to download rust packages with
1672   XZ compression][rustup/1100] over GZip packages.
1673 - [Added the ability to escape `#` in rust documentation][41785] By adding
1674   additional `#`'s ie. `##` is now `#`
1675
1676 Compatibility Notes
1677 -------------------
1678
1679 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1680 - [`-Z` flags are now no longer allowed to be used on the stable
1681   compiler.][41751] This has been a warning for a year previous to this.
1682 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1683   longer works][42844]. Users should migrate to the built-in `check`
1684   command, which has been available since 1.16.
1685 - [Ending a float literal with `._` is now a hard error.
1686   Example: `42._` .][41946]
1687 - [Any use of a private `extern crate` outside of its module is now a
1688   hard error.][36886] This was previously a warning.
1689 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1690   relative while the `::` prefix makes a path absolute, but was ignored and the
1691   path was relative regardless.
1692 - [Floating point constants in match patterns is now a hard error][36890]
1693   This was previously a warning.
1694 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1695   match patterns is now a hard error][36891] This was previously a warning.
1696 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1697   a warning.
1698 - [From the pound escape, lines consisting of multiple `#`s are
1699   now visible][41785]
1700 - [It is an error to re-export private enum variants][42460]. This is
1701   known to break a number of crates that depend on an older version of
1702   mustache.
1703 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1704   to use it to find the linker, and the build will fail where it did
1705   not previously][42607]
1706
1707 [36886]: https://github.com/rust-lang/rust/issues/36886
1708 [36888]: https://github.com/rust-lang/rust/issues/36888
1709 [36890]: https://github.com/rust-lang/rust/issues/36890
1710 [36891]: https://github.com/rust-lang/rust/issues/36891
1711 [36892]: https://github.com/rust-lang/rust/issues/36892
1712 [37406]: https://github.com/rust-lang/rust/issues/37406
1713 [39983]: https://github.com/rust-lang/rust/pull/39983
1714 [41145]: https://github.com/rust-lang/rust/pull/41145
1715 [41192]: https://github.com/rust-lang/rust/pull/41192
1716 [41258]: https://github.com/rust-lang/rust/pull/41258
1717 [41370]: https://github.com/rust-lang/rust/pull/41370
1718 [41449]: https://github.com/rust-lang/rust/pull/41449
1719 [41530]: https://github.com/rust-lang/rust/pull/41530
1720 [41624]: https://github.com/rust-lang/rust/pull/41624
1721 [41656]: https://github.com/rust-lang/rust/pull/41656
1722 [41659]: https://github.com/rust-lang/rust/pull/41659
1723 [41676]: https://github.com/rust-lang/rust/pull/41676
1724 [41751]: https://github.com/rust-lang/rust/pull/41751
1725 [41764]: https://github.com/rust-lang/rust/pull/41764
1726 [41785]: https://github.com/rust-lang/rust/pull/41785
1727 [41873]: https://github.com/rust-lang/rust/pull/41873
1728 [41907]: https://github.com/rust-lang/rust/pull/41907
1729 [41946]: https://github.com/rust-lang/rust/pull/41946
1730 [42016]: https://github.com/rust-lang/rust/pull/42016
1731 [42037]: https://github.com/rust-lang/rust/pull/42037
1732 [42068]: https://github.com/rust-lang/rust/pull/42068
1733 [42150]: https://github.com/rust-lang/rust/pull/42150
1734 [42162]: https://github.com/rust-lang/rust/pull/42162
1735 [42225]: https://github.com/rust-lang/rust/pull/42225
1736 [42264]: https://github.com/rust-lang/rust/pull/42264
1737 [42302]: https://github.com/rust-lang/rust/pull/42302
1738 [42460]: https://github.com/rust-lang/rust/issues/42460
1739 [42607]: https://github.com/rust-lang/rust/issues/42607
1740 [42740]: https://github.com/rust-lang/rust/pull/42740
1741 [42844]: https://github.com/rust-lang/rust/issues/42844
1742 [42948]: https://github.com/rust-lang/rust/pull/42948
1743 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1744 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1745 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1746 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1747 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1748 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1749 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1750 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1751 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1752 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1753 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1754 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1755 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1756 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1757 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1758 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1759 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1760 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1761 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1762 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1763 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1764 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1765
1766
1767 Version 1.18.0 (2017-06-08)
1768 ===========================
1769
1770 Language
1771 --------
1772
1773 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1774   make the item visible to just that module tree. Also accepts the keyword
1775   `crate` to make something public to the whole crate but not users of the
1776   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1777 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1778   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1779 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1780   types like `Write + Send`, trailing `+` are now supported in trait objects,
1781   and better error reporting for trait objects starting with `?Sized`.
1782 - [0e+10 is now a valid floating point literal][40589]
1783 - [Now warns if you bind a lifetime parameter to 'static][40734]
1784 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1785   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1786   representation in some cases.][40377]
1787
1788 Compiler
1789 --------
1790
1791 - [rustc can now emit mir with `--emit mir`][39891]
1792 - [Improved LLVM IR for trivial functions][40367]
1793 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1794 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1795   opportunities found through profiling
1796 - [Improved backtrace formatting when panicking][38165]
1797
1798 Libraries
1799 ---------
1800
1801 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1802   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1803   iteration or reallocation.
1804 - [Simplified HashMap Bucket interface][40561] provides performance
1805   improvements for iterating and cloning.
1806 - [Specialize Vec::from_elem to use calloc][40409]
1807 - [Fixed Race condition in fs::create_dir_all][39799]
1808 - [No longer caching stdio on Windows][40516]
1809 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1810   2.50%~ faster and in one case now 12.50% faster.
1811 - [Optimized `AtomicBool::fetch_nand`][41143]
1812
1813 Stabilized APIs
1814 ---------------
1815
1816 - [`Child::try_wait`]
1817 - [`HashMap::retain`]
1818 - [`HashSet::retain`]
1819 - [`PeekMut::pop`]
1820 - [`TcpStream::peek`]
1821 - [`UdpSocket::peek`]
1822 - [`UdpSocket::peek_from`]
1823
1824 Cargo
1825 -----
1826
1827 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1828   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1829 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1830 - [Added Android build support][cargo/3885]
1831 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1832   of a certain type, for example `cargo build --bins` will build all
1833   binaries.
1834 - [Added support for haiku][cargo/3952]
1835
1836 Misc
1837 ----
1838
1839 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1840 - [Added rust-windbg script for better debugging on Windows][39983]
1841 - [Rust now uses the official cross compiler for NetBSD][40612]
1842 - [rustdoc now accepts `#` at the start of files][40828]
1843 - [Fixed jemalloc support for musl][41168]
1844
1845 Compatibility Notes
1846 -------------------
1847
1848 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1849   always placed after the sign if it exists and before the digits. With the `#`
1850   flag the zeroes are placed after the prefix and before the digits.
1851 - [Due to the struct field optimisation][40377], using `transmute` on structs
1852   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1853   always been undefined behavior, but is now more likely to break in practice.
1854 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1855   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1856   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1857 - [Overlapping inherent `impl`s are now a hard error][40728]
1858 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1859 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1860   `out.asm` and `out.ll` instead of only one of the filetypes.
1861 - [ calling a function that returns `Self` will no longer work][41805] when
1862   the size of `Self` cannot be statically determined.
1863 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1864   this has caused a few regressions namely:
1865
1866   - Changed the link order of local static/dynamic libraries (respecting the
1867     order on given rather than having the compiler reorder).
1868   - Changed how MinGW is linked, native code linked to dynamic libraries
1869     may require manually linking to the gcc support library (for the native
1870     code itself)
1871
1872 [38165]: https://github.com/rust-lang/rust/pull/38165
1873 [39799]: https://github.com/rust-lang/rust/pull/39799
1874 [39891]: https://github.com/rust-lang/rust/pull/39891
1875 [39983]: https://github.com/rust-lang/rust/pull/39983
1876 [40043]: https://github.com/rust-lang/rust/pull/40043
1877 [40241]: https://github.com/rust-lang/rust/pull/40241
1878 [40338]: https://github.com/rust-lang/rust/pull/40338
1879 [40367]: https://github.com/rust-lang/rust/pull/40367
1880 [40377]: https://github.com/rust-lang/rust/pull/40377
1881 [40409]: https://github.com/rust-lang/rust/pull/40409
1882 [40516]: https://github.com/rust-lang/rust/pull/40516
1883 [40556]: https://github.com/rust-lang/rust/pull/40556
1884 [40561]: https://github.com/rust-lang/rust/pull/40561
1885 [40589]: https://github.com/rust-lang/rust/pull/40589
1886 [40612]: https://github.com/rust-lang/rust/pull/40612
1887 [40723]: https://github.com/rust-lang/rust/pull/40723
1888 [40728]: https://github.com/rust-lang/rust/pull/40728
1889 [40731]: https://github.com/rust-lang/rust/pull/40731
1890 [40734]: https://github.com/rust-lang/rust/pull/40734
1891 [40805]: https://github.com/rust-lang/rust/pull/40805
1892 [40807]: https://github.com/rust-lang/rust/pull/40807
1893 [40828]: https://github.com/rust-lang/rust/pull/40828
1894 [40870]: https://github.com/rust-lang/rust/pull/40870
1895 [41085]: https://github.com/rust-lang/rust/pull/41085
1896 [41143]: https://github.com/rust-lang/rust/pull/41143
1897 [41168]: https://github.com/rust-lang/rust/pull/41168
1898 [41270]: https://github.com/rust-lang/rust/issues/41270
1899 [41469]: https://github.com/rust-lang/rust/pull/41469
1900 [41805]: https://github.com/rust-lang/rust/issues/41805
1901 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1902 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1903 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1904 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1905 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1906 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1907 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1908 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1909 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1910 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1911 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1912 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1913 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1914 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1915
1916
1917 Version 1.17.0 (2017-04-27)
1918 ===========================
1919
1920 Language
1921 --------
1922
1923 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1924 * [Fields of structs may be initialized without duplicating the field/variable
1925   names][39761]. [RFC 1682]
1926 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1927 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1928   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1929   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1930   `'b`. Soundness fix.
1931 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1932 * [Static variables may contain references to other statics][40027]
1933
1934 Compiler
1935 --------
1936
1937 * [Exit quickly on only `--emit dep-info`][40336]
1938 * [Make `-C relocation-model` more correctly determine whether the linker
1939   creates a position-independent executable][40245]
1940 * [Add `-C overflow-checks` to directly control whether integer overflow
1941   panics][40037]
1942 * [The rustc type checker now checks items on demand instead of in a single
1943   in-order pass][40008]. This is mostly an internal refactoring in support of
1944   future work, including incremental type checking, but also resolves [RFC
1945   1647], allowing `Self` to appear in `impl` `where` clauses.
1946 * [Optimize vtable loads][39995]
1947 * [Turn off vectorization for Emscripten targets][39990]
1948 * [Provide suggestions for unknown macros imported with `use`][39953]
1949 * [Fix ICEs in path resolution][39939]
1950 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1951 * [Add clearer error message using `&str + &str`][39116]
1952
1953 Stabilized APIs
1954 ---------------
1955
1956 * [`Arc::into_raw`]
1957 * [`Arc::from_raw`]
1958 * [`Arc::ptr_eq`]
1959 * [`Rc::into_raw`]
1960 * [`Rc::from_raw`]
1961 * [`Rc::ptr_eq`]
1962 * [`Ordering::then`]
1963 * [`Ordering::then_with`]
1964 * [`BTreeMap::range`]
1965 * [`BTreeMap::range_mut`]
1966 * [`collections::Bound`]
1967 * [`process::abort`]
1968 * [`ptr::read_unaligned`]
1969 * [`ptr::write_unaligned`]
1970 * [`Result::expect_err`]
1971 * [`Cell::swap`]
1972 * [`Cell::replace`]
1973 * [`Cell::into_inner`]
1974 * [`Cell::take`]
1975
1976 Libraries
1977 ---------
1978
1979 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1980 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1981 * [`String` implements `FromIterator<&char>`][40028]
1982 * `Box` [implements][40009] a number of new conversions:
1983   `From<Box<str>> for String`,
1984   `From<Box<[T]>> for Vec<T>`,
1985   `From<Box<CStr>> for CString`,
1986   `From<Box<OsStr>> for OsString`,
1987   `From<Box<Path>> for PathBuf`,
1988   `Into<Box<str>> for String`,
1989   `Into<Box<[T]>> for Vec<T>`,
1990   `Into<Box<CStr>> for CString`,
1991   `Into<Box<OsStr>> for OsString`,
1992   `Into<Box<Path>> for PathBuf`,
1993   `Default for Box<str>`,
1994   `Default for Box<CStr>`,
1995   `Default for Box<OsStr>`,
1996   `From<&CStr> for Box<CStr>`,
1997   `From<&OsStr> for Box<OsStr>`,
1998   `From<&Path> for Box<Path>`
1999 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2000 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2001 * [Slightly optimize `slice::sort`][39538]
2002 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2003 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2004   `Box<str>` implements `From<&str>`][39438]
2005 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2006   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2007 * [`format!` estimates the needed capacity before writing a string][39356]
2008 * [Support unprivileged symlink creation in Windows][38921]
2009 * [`PathBuf` implements `Default`][38764]
2010 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2011 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2012   and poor hash functions.
2013
2014 Cargo
2015 -----
2016
2017 * [Add `cargo check --all`][cargo/3731]
2018 * [Add an option to ignore SSL revocation checking][cargo/3699]
2019 * [Add `cargo run --package`][cargo/3691]
2020 * [Add `required_features`][cargo/3667]
2021 * [Assume `build.rs` is a build script][cargo/3664]
2022 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2023
2024 Misc
2025 ----
2026
2027 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2028   `rustbook`][39633]
2029 * [The "Unstable Book" documents nightly-only features][ubook]
2030 * [Improve the style of the sidebar in rustdoc output][40265]
2031 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2032 * [Fix MSP430 breakage due to `i128`][40257]
2033 * [Preliminary Solaris/SPARCv9 support][39903]
2034 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2035   run without installing the MSVC runtime.
2036 * [`rustdoc --test` includes file names in test names][39788]
2037 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2038   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2039 * [Initial support for `aarch64-unknown-freebsd`][39491]
2040 * [Initial support for `i686-unknown-netbsd`][39426]
2041 * [This release no longer includes the old makefile build system][39431]. Rust
2042   is built with a custom build system, written in Rust, and with Cargo.
2043 * [Add Debug implementations for libcollection structs][39002]
2044 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2045 * [`--test-threads=0` produces an error][38945]
2046 * [`rustup` installs documentation by default][40526]
2047 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2048   WinDbg and Visual Studio to improve the debugging experience.
2049
2050 Compatibility Notes
2051 -------------------
2052
2053 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2054   workaround, either use MSVC 2015 or run vcvars.bat.
2055 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2056   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2057   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2058   fix.
2059 * [`format!` and `Display::to_string` panic if an underlying formatting
2060   implementation returns an error][40117]. Previously the error was silently
2061   ignored. It is incorrect for `write_fmt` to return an error when writing
2062   to a string.
2063 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2064   crates were marked stable and could be accessed from the stable toolchain.
2065 * [Rust git source no longer includes vendored crates][39728]. Those that need
2066   to build with vendored crates should build from release tarballs.
2067 * [Fix inert attributes from `proc_macro_derives`][39572]
2068 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2069   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2070   build system.
2071 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2072   existing code generally ignores the type of dead-code unless a type-hint is
2073   provided; this can cause surprising inference interactions particularly around
2074   defaulting. The new code uniformly ignores the result type of dead-code.
2075 * [Tuple-struct constructors with private fields are no longer visible][38932]
2076 * [Lifetime parameters that do not appear in the arguments are now considered
2077   early-bound][38897], resolving a soundness bug (#[32330]). The
2078   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2079   April of 2016.
2080 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2081 * [Make transmuting from fn item types to pointer-sized types a hard
2082   error][34198]
2083
2084 [27787]: https://github.com/rust-lang/rust/issues/27787
2085 [32330]: https://github.com/rust-lang/rust/issues/32330
2086 [34198]: https://github.com/rust-lang/rust/pull/34198
2087 [38161]: https://github.com/rust-lang/rust/pull/38161
2088 [38368]: https://github.com/rust-lang/rust/pull/38368
2089 [38584]: https://github.com/rust-lang/rust/issues/38584
2090 [38661]: https://github.com/rust-lang/rust/pull/38661
2091 [38764]: https://github.com/rust-lang/rust/pull/38764
2092 [38864]: https://github.com/rust-lang/rust/issues/38864
2093 [38897]: https://github.com/rust-lang/rust/pull/38897
2094 [38921]: https://github.com/rust-lang/rust/pull/38921
2095 [38932]: https://github.com/rust-lang/rust/pull/38932
2096 [38945]: https://github.com/rust-lang/rust/pull/38945
2097 [38981]: https://github.com/rust-lang/rust/pull/38981
2098 [39002]: https://github.com/rust-lang/rust/pull/39002
2099 [39116]: https://github.com/rust-lang/rust/pull/39116
2100 [39193]: https://github.com/rust-lang/rust/pull/39193
2101 [39265]: https://github.com/rust-lang/rust/pull/39265
2102 [39356]: https://github.com/rust-lang/rust/pull/39356
2103 [39372]: https://github.com/rust-lang/rust/pull/39372
2104 [39426]: https://github.com/rust-lang/rust/pull/39426
2105 [39431]: https://github.com/rust-lang/rust/pull/39431
2106 [39438]: https://github.com/rust-lang/rust/pull/39438
2107 [39440]: https://github.com/rust-lang/rust/pull/39440
2108 [39485]: https://github.com/rust-lang/rust/pull/39485
2109 [39491]: https://github.com/rust-lang/rust/pull/39491
2110 [39518]: https://github.com/rust-lang/rust/pull/39518
2111 [39538]: https://github.com/rust-lang/rust/pull/39538
2112 [39572]: https://github.com/rust-lang/rust/pull/39572
2113 [39633]: https://github.com/rust-lang/rust/pull/39633
2114 [39642]: https://github.com/rust-lang/rust/pull/39642
2115 [39728]: https://github.com/rust-lang/rust/pull/39728
2116 [39761]: https://github.com/rust-lang/rust/pull/39761
2117 [39788]: https://github.com/rust-lang/rust/pull/39788
2118 [39793]: https://github.com/rust-lang/rust/pull/39793
2119 [39837]: https://github.com/rust-lang/rust/pull/39837
2120 [39843]: https://github.com/rust-lang/rust/pull/39843
2121 [39851]: https://github.com/rust-lang/rust/pull/39851
2122 [39903]: https://github.com/rust-lang/rust/pull/39903
2123 [39939]: https://github.com/rust-lang/rust/pull/39939
2124 [39953]: https://github.com/rust-lang/rust/pull/39953
2125 [39960]: https://github.com/rust-lang/rust/pull/39960
2126 [39990]: https://github.com/rust-lang/rust/pull/39990
2127 [39995]: https://github.com/rust-lang/rust/pull/39995
2128 [40008]: https://github.com/rust-lang/rust/pull/40008
2129 [40009]: https://github.com/rust-lang/rust/pull/40009
2130 [40027]: https://github.com/rust-lang/rust/pull/40027
2131 [40028]: https://github.com/rust-lang/rust/pull/40028
2132 [40037]: https://github.com/rust-lang/rust/pull/40037
2133 [40117]: https://github.com/rust-lang/rust/pull/40117
2134 [40166]: https://github.com/rust-lang/rust/pull/40166
2135 [40245]: https://github.com/rust-lang/rust/pull/40245
2136 [40257]: https://github.com/rust-lang/rust/pull/40257
2137 [40261]: https://github.com/rust-lang/rust/pull/40261
2138 [40265]: https://github.com/rust-lang/rust/pull/40265
2139 [40319]: https://github.com/rust-lang/rust/pull/40319
2140 [40336]: https://github.com/rust-lang/rust/pull/40336
2141 [40526]: https://github.com/rust-lang/rust/pull/40526
2142 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2143 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2144 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2145 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2146 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2147 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2148 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2149 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2150 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2151 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2152 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2153 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2154 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2155 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2156 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2157 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2158 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2159 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2160 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2161 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2162 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2163 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2164 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2165 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2166 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2167 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2168 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2169 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2170 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2171 [mdbook]: https://crates.io/crates/mdbook
2172 [ubook]: https://doc.rust-lang.org/unstable-book/
2173
2174
2175 Version 1.16.0 (2017-03-16)
2176 ===========================
2177
2178 Language
2179 --------
2180
2181 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2182 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2183   match patterns][38069]
2184 * [Clean up semantics of `self` in an import list][38313]
2185 * [`Self` may appear in `impl` headers][38920]
2186 * [`Self` may appear in struct expressions][39282]
2187
2188 Compiler
2189 --------
2190
2191 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2192   a `.rmeta` file containing only crate metadata][38571]. This can be
2193   used by tools like the Rust Language Service to perform
2194   metadata-only builds.
2195 * [Levenshtein based typo suggestions now work in most places, while
2196   previously they worked only for fields and sometimes for local
2197   variables][38927]. Together with the overhaul of "no
2198   resolution"/"unexpected resolution" errors (#[38154]) they result in
2199   large and systematic improvement in resolution diagnostics.
2200 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2201   `U`][38670]
2202 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2203 * [`rustc` no longer attempts to provide "consider using an explicit
2204   lifetime" suggestions][37057]. They were inaccurate.
2205
2206 Stabilized APIs
2207 ---------------
2208
2209 * [`VecDeque::truncate`]
2210 * [`VecDeque::resize`]
2211 * [`String::insert_str`]
2212 * [`Duration::checked_add`]
2213 * [`Duration::checked_sub`]
2214 * [`Duration::checked_div`]
2215 * [`Duration::checked_mul`]
2216 * [`str::replacen`]
2217 * [`str::repeat`]
2218 * [`SocketAddr::is_ipv4`]
2219 * [`SocketAddr::is_ipv6`]
2220 * [`IpAddr::is_ipv4`]
2221 * [`IpAddr::is_ipv6`]
2222 * [`Vec::dedup_by`]
2223 * [`Vec::dedup_by_key`]
2224 * [`Result::unwrap_or_default`]
2225 * [`<*const T>::wrapping_offset`]
2226 * [`<*mut T>::wrapping_offset`]
2227 * `CommandExt::creation_flags`
2228 * [`File::set_permissions`]
2229 * [`String::split_off`]
2230
2231 Libraries
2232 ---------
2233
2234 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2235   their argument by `Borrow` parameter][37761]
2236 * [All public types in std implement `Debug`][38006]
2237 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2238 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2239 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2240   Windows][38274]
2241 * [std: Fix partial writes in `LineWriter`][38062]
2242 * [std: Clamp max read/write sizes on Unix][38062]
2243 * [Use more specific panic message for `&str` slicing errors][38066]
2244 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2245   functionality cannot be achieved in std currently.
2246 * [`writeln!`, like `println!`, now accepts a form with no string
2247   or formatting arguments, to just print a newline][38469]
2248 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2249 * [Reduce the size of static data in `std_unicode::tables`][38781]
2250 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2251   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2252   `Display`][38909]
2253 * [`Duration` implements `Sum`][38712]
2254 * [`String` implements `ToSocketAddrs`][39048]
2255
2256 Cargo
2257 -----
2258
2259 * [The `cargo check` command does a type check of a project without
2260   building it][cargo/3296]
2261 * [crates.io will display CI badges from Travis and AppVeyor, if
2262   specified in Cargo.toml][cargo/3546]
2263 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2264 * [Compilation profiles accept integer values for `debug`, in addition
2265   to `true` and `false`. These are passed to `rustc` as the value to
2266   `-C debuginfo`][cargo/3534]
2267 * [Implement `cargo --version --verbose`][cargo/3604]
2268 * [All builds now output 'dep-info' build dependencies compatible with
2269   make and ninja][cargo/3557]
2270 * [Build all workspace members with `build --all`][cargo/3511]
2271 * [Document all workspace members with `doc --all`][cargo/3515]
2272 * [Path deps outside workspace are not members][cargo/3443]
2273
2274 Misc
2275 ----
2276
2277 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2278   the path to the Rust implementation][38589]
2279 * [The `armv7-linux-androideabi` target no longer enables NEON
2280   extensions, per Google's ABI guide][38413]
2281 * [The stock standard library can be compiled for Redox OS][38401]
2282 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2283   available.
2284 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2285   builds available.
2286 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2287
2288 Compatibility Notes
2289 -------------------
2290
2291 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2292   match patterns][38069]
2293 * In this release, references to uninhabited types can not be
2294   pattern-matched. This was accidentally allowed in 1.15.
2295 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2296 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2297   Windows][38274]
2298 * [Clean up semantics of `self` in an import list][38313]
2299 * Reimplemented lifetime elision. This change was almost entirely compatible
2300   with existing code, but it did close a number of small bugs and loopholes,
2301   as well as being more accepting in some other [cases][41105].
2302
2303 [37057]: https://github.com/rust-lang/rust/pull/37057
2304 [37761]: https://github.com/rust-lang/rust/pull/37761
2305 [38006]: https://github.com/rust-lang/rust/pull/38006
2306 [38051]: https://github.com/rust-lang/rust/pull/38051
2307 [38062]: https://github.com/rust-lang/rust/pull/38062
2308 [38062]: https://github.com/rust-lang/rust/pull/38622
2309 [38066]: https://github.com/rust-lang/rust/pull/38066
2310 [38069]: https://github.com/rust-lang/rust/pull/38069
2311 [38131]: https://github.com/rust-lang/rust/pull/38131
2312 [38154]: https://github.com/rust-lang/rust/pull/38154
2313 [38274]: https://github.com/rust-lang/rust/pull/38274
2314 [38304]: https://github.com/rust-lang/rust/pull/38304
2315 [38313]: https://github.com/rust-lang/rust/pull/38313
2316 [38314]: https://github.com/rust-lang/rust/pull/38314
2317 [38327]: https://github.com/rust-lang/rust/pull/38327
2318 [38401]: https://github.com/rust-lang/rust/pull/38401
2319 [38413]: https://github.com/rust-lang/rust/pull/38413
2320 [38469]: https://github.com/rust-lang/rust/pull/38469
2321 [38559]: https://github.com/rust-lang/rust/pull/38559
2322 [38571]: https://github.com/rust-lang/rust/pull/38571
2323 [38580]: https://github.com/rust-lang/rust/pull/38580
2324 [38589]: https://github.com/rust-lang/rust/pull/38589
2325 [38670]: https://github.com/rust-lang/rust/pull/38670
2326 [38712]: https://github.com/rust-lang/rust/pull/38712
2327 [38726]: https://github.com/rust-lang/rust/pull/38726
2328 [38781]: https://github.com/rust-lang/rust/pull/38781
2329 [38798]: https://github.com/rust-lang/rust/pull/38798
2330 [38909]: https://github.com/rust-lang/rust/pull/38909
2331 [38920]: https://github.com/rust-lang/rust/pull/38920
2332 [38927]: https://github.com/rust-lang/rust/pull/38927
2333 [39048]: https://github.com/rust-lang/rust/pull/39048
2334 [39282]: https://github.com/rust-lang/rust/pull/39282
2335 [39379]: https://github.com/rust-lang/rust/pull/39379
2336 [41105]: https://github.com/rust-lang/rust/issues/41105
2337 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2338 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2339 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2340 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2341 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2342 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2343 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2344 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2345 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2346 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2347 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2348 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2349 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2350 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2351 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2352 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2353 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2354 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2355 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2356 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2357 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2358 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2359 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2360 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2361 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2362 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2363 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2364 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2365 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2366 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2367
2368
2369 Version 1.15.1 (2017-02-09)
2370 ===========================
2371
2372 * [Fix IntoIter::as_mut_slice's signature][39466]
2373 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2374
2375 [39466]: https://github.com/rust-lang/rust/pull/39466
2376 [39523]: https://github.com/rust-lang/rust/pull/39523
2377
2378
2379 Version 1.15.0 (2017-02-02)
2380 ===========================
2381
2382 Language
2383 --------
2384
2385 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2386   stable. This allows popular code-generating crates like Serde and Diesel to
2387   work ergonomically. [RFC 1681].
2388 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2389   with curly braces][36868]. Part of [RFC 1506].
2390 * [A number of minor changes to name resolution have been activated][37127].
2391   They add up to more consistent semantics, allowing for future evolution of
2392   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2393   details of what is different. The breaking changes here have been transitioned
2394   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2395 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2396   bounds][38279]
2397 * [`?Sized` can be used in `where` clauses][37791]
2398 * [There is now a limit on the size of monomorphized types and it can be
2399   modified with the `#![type_size_limit]` crate attribute, similarly to
2400   the `#![recursion_limit]` attribute][37789]
2401
2402 Compiler
2403 --------
2404
2405 * [On Windows, the compiler will apply dllimport attributes when linking to
2406   extern functions][37973]. Additional attributes and flags can control which
2407   library kind is linked and its name. [RFC 1717].
2408 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2409 * [The `--test` flag works with procedural macro crates][38107]
2410 * [Fix `extern "aapcs" fn` ABI][37814]
2411 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2412 * [The `format!` expander recognizes incorrect `printf` and shell-style
2413   formatting directives and suggests the correct format][37613].
2414 * [Only report one error for all unused imports in an import list][37456]
2415
2416 Compiler Performance
2417 --------------------
2418
2419 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2420 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2421 * [Don't clone in `UnificationTable::probe`][37848]
2422 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2423 * [Use small vectors in type walker][37760]
2424 * [Macro expansion performance was improved][37701]
2425 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2426 * [Replace FNV with a faster hash function][37229]
2427
2428 Stabilized APIs
2429 ---------------
2430
2431 * [`std::iter::Iterator::min_by`]
2432 * [`std::iter::Iterator::max_by`]
2433 * [`std::os::*::fs::FileExt`]
2434 * [`std::sync::atomic::Atomic*::get_mut`]
2435 * [`std::sync::atomic::Atomic*::into_inner`]
2436 * [`std::vec::IntoIter::as_slice`]
2437 * [`std::vec::IntoIter::as_mut_slice`]
2438 * [`std::sync::mpsc::Receiver::try_iter`]
2439 * [`std::os::unix::process::CommandExt::before_exec`]
2440 * [`std::rc::Rc::strong_count`]
2441 * [`std::rc::Rc::weak_count`]
2442 * [`std::sync::Arc::strong_count`]
2443 * [`std::sync::Arc::weak_count`]
2444 * [`std::char::encode_utf8`]
2445 * [`std::char::encode_utf16`]
2446 * [`std::cell::Ref::clone`]
2447 * [`std::io::Take::into_inner`]
2448
2449 Libraries
2450 ---------
2451
2452 * [The standard sorting algorithm has been rewritten for dramatic performance
2453   improvements][38192]. It is a hybrid merge sort, drawing influences from
2454   Timsort. Previously it was a naive merge sort.
2455 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2456 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2457   performance.
2458 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2459   and `char_indices().last()`][37882]
2460 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2461 * [Chinese characters display correctly in `fmt::Debug`][37855]
2462 * [Derive `Default` for `Duration`][37699]
2463 * [Support creation of anonymous pipes on WinXP/2k][37677]
2464 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2465 * [Don't pass overlapped handles to processes][38835]
2466
2467 Cargo
2468 -----
2469
2470 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2471   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2472   should instead check the variable at runtime with `std::env`. That the value
2473   was set at build time was a bug, and incorrect when cross-compiling. This
2474   change is known to cause breakage.
2475 * [Add `--all` flag to `cargo test`][cargo/3221]
2476 * [Compile statically against the MSVC CRT][cargo/3363]
2477 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2478 * [Link OpenSSL statically on OSX][cargo/3311]
2479 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2480 * [Test for bad path overrides with summaries][cargo/3336]
2481 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2482 * [Fix retrying crate downloads for network errors][cargo/3348]
2483 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2484 * [Emit more info on --message-format=json][cargo/3319]
2485 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2486 * [Don't ignore errors in workspace manifest][cargo/3409]
2487 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2488
2489 Tooling
2490 -------
2491
2492 * [Test runners (binaries built with `--test`) now support a `--list` argument
2493   that lists the tests it contains][38185]
2494 * [Test runners now support a `--exact` argument that makes the test filter
2495   match exactly, instead of matching only a substring of the test name][38181]
2496 * [rustdoc supports a `--playground-url` flag][37763]
2497 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2498
2499 Misc
2500 ----
2501
2502 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2503   continue to be used in this release by passing `--disable-rustbuild` to the
2504   configure script, but they will be deleted soon. Note that the new build
2505   system uses a different on-disk layout that will likely affect any scripts
2506   building Rust.
2507 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2508   releases.
2509 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2510 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2511   releases.
2512
2513 Compatibility Notes
2514 -------------------
2515
2516 * [A number of minor changes to name resolution have been activated][37127].
2517   They add up to more consistent semantics, allowing for future evolution of
2518   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2519   details of what is different. The breaking changes here have been transitioned
2520   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2521 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2522   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2523   should instead check the variable at runtime with `std::env`. That the value
2524   was set at build time was a bug, and incorrect when cross-compiling. This
2525   change is known to cause breakage.
2526 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2527   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2528   1.10 and is now an error by default. It will become a hard error in the near
2529   future.
2530 * [The semantics relating modules to file system directories are changing in
2531   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2532   lint, which is a warning in this release, and will become a hard error in the
2533   future.
2534 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2535 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2536   the underlying iterator][37834]
2537
2538 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2539 [33685]: https://github.com/rust-lang/rust/issues/33685
2540 [36868]: https://github.com/rust-lang/rust/pull/36868
2541 [37127]: https://github.com/rust-lang/rust/pull/37127
2542 [37229]: https://github.com/rust-lang/rust/pull/37229
2543 [37456]: https://github.com/rust-lang/rust/pull/37456
2544 [37527]: https://github.com/rust-lang/rust/pull/37527
2545 [37602]: https://github.com/rust-lang/rust/pull/37602
2546 [37613]: https://github.com/rust-lang/rust/pull/37613
2547 [37615]: https://github.com/rust-lang/rust/pull/37615
2548 [37636]: https://github.com/rust-lang/rust/pull/37636
2549 [37627]: https://github.com/rust-lang/rust/pull/37627
2550 [37642]: https://github.com/rust-lang/rust/pull/37642
2551 [37677]: https://github.com/rust-lang/rust/pull/37677
2552 [37699]: https://github.com/rust-lang/rust/pull/37699
2553 [37701]: https://github.com/rust-lang/rust/pull/37701
2554 [37705]: https://github.com/rust-lang/rust/pull/37705
2555 [37749]: https://github.com/rust-lang/rust/pull/37749
2556 [37760]: https://github.com/rust-lang/rust/pull/37760
2557 [37763]: https://github.com/rust-lang/rust/pull/37763
2558 [37764]: https://github.com/rust-lang/rust/pull/37764
2559 [37789]: https://github.com/rust-lang/rust/pull/37789
2560 [37791]: https://github.com/rust-lang/rust/pull/37791
2561 [37814]: https://github.com/rust-lang/rust/pull/37814
2562 [37817]: https://github.com/rust-lang/rust/pull/37817
2563 [37834]: https://github.com/rust-lang/rust/pull/37834
2564 [37848]: https://github.com/rust-lang/rust/pull/37848
2565 [37855]: https://github.com/rust-lang/rust/pull/37855
2566 [37882]: https://github.com/rust-lang/rust/pull/37882
2567 [37888]: https://github.com/rust-lang/rust/pull/37888
2568 [37973]: https://github.com/rust-lang/rust/pull/37973
2569 [37979]: https://github.com/rust-lang/rust/pull/37979
2570 [38086]: https://github.com/rust-lang/rust/pull/38086
2571 [38107]: https://github.com/rust-lang/rust/pull/38107
2572 [38117]: https://github.com/rust-lang/rust/pull/38117
2573 [38134]: https://github.com/rust-lang/rust/pull/38134
2574 [38146]: https://github.com/rust-lang/rust/pull/38146
2575 [38181]: https://github.com/rust-lang/rust/pull/38181
2576 [38182]: https://github.com/rust-lang/rust/pull/38182
2577 [38185]: https://github.com/rust-lang/rust/pull/38185
2578 [38192]: https://github.com/rust-lang/rust/pull/38192
2579 [38279]: https://github.com/rust-lang/rust/pull/38279
2580 [38835]: https://github.com/rust-lang/rust/pull/38835
2581 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2582 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2583 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2584 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2585 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2586 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2587 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2588 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2589 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2590 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2591 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2592 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2593 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2594 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2595 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2596 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2597 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2598 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2599 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2600 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2601 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2602 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2603 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2604 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2605 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2606 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2607 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2608 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2609 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2610 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2611 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2612 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2613 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2614 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2615 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2616 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2617 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2618 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2619
2620
2621 Version 1.14.0 (2016-12-22)
2622 ===========================
2623
2624 Language
2625 --------
2626
2627 * [`..` matches multiple tuple fields in enum variants, structs
2628   and tuples][36843]. [RFC 1492].
2629 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2630 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2631 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2632   dereferencing][36822]
2633
2634 Compiler
2635 --------
2636
2637 * [Mark enums with non-zero discriminant as non-zero][37224]
2638 * [Lower-case `static mut` names are linted like other
2639   statics and consts][37162]
2640 * [Fix ICE on some macros in const integer positions
2641    (e.g. `[u8; m!()]`)][36819]
2642 * [Improve error message and snippet for "did you mean `x`"][36798]
2643 * [Add a panic-strategy field to the target specification][36794]
2644 * [Include LLVM version in `--version --verbose`][37200]
2645
2646 Compile-time Optimizations
2647 --------------------------
2648
2649 * [Improve macro expansion performance][37569]
2650 * [Shrink `Expr_::ExprInlineAsm`][37445]
2651 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2652 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2653 * [Avoid more allocations when compiling html5ever][37373]
2654 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2655 * [Avoid some allocations in the macro parser][37318]
2656 * [Use a faster deflate setting][37298]
2657 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2658   during interning of slices][37270]
2659 * [Optimize `write_metadata`][37267]
2660 * [Don't process obligation forest cycles when stalled][37231]
2661 * [Avoid many `CrateConfig` clones][37161]
2662 * [Optimize `Substs::super_fold_with`][37108]
2663 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2664 * [Speed up `plug_leaks`][36917]
2665
2666 Libraries
2667 ---------
2668
2669 * [`println!()`, with no arguments, prints newline][36825].
2670   Previously, an empty string was required to achieve the same.
2671 * [`Wrapping` impls standard binary and unary operators, as well as
2672    the `Sum` and `Product` iterators][37356]
2673 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2674   Vec<T>`][37326]
2675 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2676   `VecDeque` iterators][37315]
2677 * [Improve `SipHasher` performance on small values][37312]
2678 * [Add Iterator trait TrustedLen to enable better FromIterator /
2679   Extend][37306]
2680 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2681 * [`ReadDir` implements `Debug`][37221]
2682 * [Implement `RefUnwindSafe` for atomic types][37178]
2683 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2684 * [Avoid allocations in `Decoder::read_str`][37064]
2685 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2686 * [Impl `Debug` for raw pointers to unsized data][36880]
2687 * [Don't reuse `HashMap` random seeds][37470]
2688 * [The internal memory layout of `HashMap` is more cache-friendly, for
2689   significant improvements in some operations][36692]
2690 * [`HashMap` uses less memory on 32-bit architectures][36595]
2691 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2692
2693 Cargo
2694 -----
2695
2696 * [Expose rustc cfg values to build scripts][cargo/3243]
2697 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2698 * [Fix passing --features when testing multiple packages][cargo/3280]
2699 * [Use a single profile set per workspace][cargo/3249]
2700 * [Load `replace` sections from lock files][cargo/3220]
2701 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2702
2703 Tooling
2704 -------
2705
2706 * [rustup is the recommended Rust installation method][1.14rustup]
2707 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2708   S390x. These are [tier 2] platforms and may have major defects. Follow the
2709   instructions on the website to install, or add the targets to an existing
2710   installation with `rustup target add`. The new target triples are:
2711   - `mips-unknown-linux-gnu`
2712   - `mipsel-unknown-linux-gnu`
2713   - `mips64-unknown-linux-gnuabi64`
2714   - `mips64el-unknown-linux-gnuabi64 `
2715   - `powerpc-unknown-linux-gnu`
2716   - `powerpc64-unknown-linux-gnu`
2717   - `powerpc64le-unknown-linux-gnu`
2718   - `s390x-unknown-linux-gnu `
2719 * This release includes target (std) builds for ARM Linux running MUSL
2720   libc. These are [tier 2] platforms and may have major defects. Add the
2721   following triples to an existing rustup installation with `rustup target add`:
2722   - `arm-unknown-linux-musleabi`
2723   - `arm-unknown-linux-musleabihf`
2724   - `armv7-unknown-linux-musleabihf`
2725 * This release includes [experimental support for WebAssembly][1.14wasm], via
2726   the `wasm32-unknown-emscripten` target. This target is known to have major
2727   defects. Please test, report, and fix.
2728 * rustup no longer installs documentation by default. Run `rustup
2729   component add rust-docs` to install.
2730 * [Fix line stepping in debugger][37310]
2731 * [Enable line number debuginfo in releases][37280]
2732
2733 Misc
2734 ----
2735
2736 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2737 * [Add support for Fuchsia OS][37313]
2738 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2739
2740 Compatibility Notes
2741 -------------------
2742
2743 * [A number of forward-compatibility lints used by the compiler
2744   to gradually introduce language changes have been converted
2745   to deny by default][36894]:
2746   - ["use of inaccessible extern crate erroneously allowed"][36886]
2747   - ["type parameter default erroneously allowed in invalid location"][36887]
2748   - ["detects super or self keywords at the beginning of global path"][36888]
2749   - ["two overlapping inherent impls define an item with the same name
2750     were erroneously allowed"][36889]
2751   - ["floating-point constants cannot be used in patterns"][36890]
2752   - ["constants of struct or enum type can only be used in a pattern if
2753      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2754   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2755 * [Prohibit patterns in trait methods without bodies][37378]
2756 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2757 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2758 * [The `$crate` macro variable is accepted in fewer locations][37213]
2759 * [Impls specifying extra region requirements beyond the trait
2760   they implement are rejected][37167]
2761 * [Enums may not be unsized][37111]. Unsized enums are intended to
2762   work but never have. For now they are forbidden.
2763 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2764
2765 [tier 2]: https://forge.rust-lang.org/platform-support.html
2766 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2767 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2768 [36430]: https://github.com/rust-lang/rust/pull/36430
2769 [36595]: https://github.com/rust-lang/rust/pull/36595
2770 [36595]: https://github.com/rust-lang/rust/pull/36595
2771 [36692]: https://github.com/rust-lang/rust/pull/36692
2772 [36767]: https://github.com/rust-lang/rust/pull/36767
2773 [36794]: https://github.com/rust-lang/rust/pull/36794
2774 [36798]: https://github.com/rust-lang/rust/pull/36798
2775 [36819]: https://github.com/rust-lang/rust/pull/36819
2776 [36822]: https://github.com/rust-lang/rust/pull/36822
2777 [36825]: https://github.com/rust-lang/rust/pull/36825
2778 [36843]: https://github.com/rust-lang/rust/pull/36843
2779 [36880]: https://github.com/rust-lang/rust/pull/36880
2780 [36886]: https://github.com/rust-lang/rust/issues/36886
2781 [36887]: https://github.com/rust-lang/rust/issues/36887
2782 [36888]: https://github.com/rust-lang/rust/issues/36888
2783 [36889]: https://github.com/rust-lang/rust/issues/36889
2784 [36890]: https://github.com/rust-lang/rust/issues/36890
2785 [36891]: https://github.com/rust-lang/rust/issues/36891
2786 [36892]: https://github.com/rust-lang/rust/issues/36892
2787 [36894]: https://github.com/rust-lang/rust/pull/36894
2788 [36917]: https://github.com/rust-lang/rust/pull/36917
2789 [36993]: https://github.com/rust-lang/rust/pull/36993
2790 [37037]: https://github.com/rust-lang/rust/pull/37037
2791 [37064]: https://github.com/rust-lang/rust/pull/37064
2792 [37094]: https://github.com/rust-lang/rust/pull/37094
2793 [37108]: https://github.com/rust-lang/rust/pull/37108
2794 [37111]: https://github.com/rust-lang/rust/pull/37111
2795 [37161]: https://github.com/rust-lang/rust/pull/37161
2796 [37162]: https://github.com/rust-lang/rust/pull/37162
2797 [37167]: https://github.com/rust-lang/rust/pull/37167
2798 [37178]: https://github.com/rust-lang/rust/pull/37178
2799 [37200]: https://github.com/rust-lang/rust/pull/37200
2800 [37213]: https://github.com/rust-lang/rust/pull/37213
2801 [37221]: https://github.com/rust-lang/rust/pull/37221
2802 [37224]: https://github.com/rust-lang/rust/pull/37224
2803 [37230]: https://github.com/rust-lang/rust/pull/37230
2804 [37231]: https://github.com/rust-lang/rust/pull/37231
2805 [37247]: https://github.com/rust-lang/rust/pull/37247
2806 [37267]: https://github.com/rust-lang/rust/pull/37267
2807 [37270]: https://github.com/rust-lang/rust/pull/37270
2808 [37273]: https://github.com/rust-lang/rust/pull/37273
2809 [37280]: https://github.com/rust-lang/rust/pull/37280
2810 [37298]: https://github.com/rust-lang/rust/pull/37298
2811 [37306]: https://github.com/rust-lang/rust/pull/37306
2812 [37310]: https://github.com/rust-lang/rust/pull/37310
2813 [37312]: https://github.com/rust-lang/rust/pull/37312
2814 [37313]: https://github.com/rust-lang/rust/pull/37313
2815 [37315]: https://github.com/rust-lang/rust/pull/37315
2816 [37318]: https://github.com/rust-lang/rust/pull/37318
2817 [37322]: https://github.com/rust-lang/rust/pull/37322
2818 [37326]: https://github.com/rust-lang/rust/pull/37326
2819 [37351]: https://github.com/rust-lang/rust/pull/37351
2820 [37356]: https://github.com/rust-lang/rust/pull/37356
2821 [37367]: https://github.com/rust-lang/rust/pull/37367
2822 [37373]: https://github.com/rust-lang/rust/pull/37373
2823 [37378]: https://github.com/rust-lang/rust/pull/37378
2824 [37389]: https://github.com/rust-lang/rust/pull/37389
2825 [37392]: https://github.com/rust-lang/rust/pull/37392
2826 [37427]: https://github.com/rust-lang/rust/pull/37427
2827 [37439]: https://github.com/rust-lang/rust/pull/37439
2828 [37445]: https://github.com/rust-lang/rust/pull/37445
2829 [37470]: https://github.com/rust-lang/rust/pull/37470
2830 [37569]: https://github.com/rust-lang/rust/pull/37569
2831 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2832 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2833 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2834 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2835 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2836 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2837 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2838
2839
2840 Version 1.13.0 (2016-11-10)
2841 ===========================
2842
2843 Language
2844 --------
2845
2846 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2847   errors, like the `try!` macro, described in [RFC 0243].
2848 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2849 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2850 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2851 * [Fix lifetime rules for 'if' conditions][36029]
2852 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2853
2854 Compiler
2855 --------
2856
2857 * [Add the `-C link-arg` argument][36574]
2858 * [Remove the old AST-based backend from rustc_trans][35764]
2859 * [Don't enable NEON by default on armv7 Linux][35814]
2860 * [Fix debug line number info for macro expansions][35238]
2861 * [Do not emit "class method" debuginfo for types that are not
2862   DICompositeType][36008]
2863 * [Warn about multiple conflicting #[repr] hints][34623]
2864 * [When sizing DST, don't double-count nested struct prefixes][36351]
2865 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2866 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2867 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2868 * [Expand macros without recursing to avoid stack overflows][36214]
2869
2870 Diagnostics
2871 -----------
2872
2873 * [Replace macro backtraces with labeled local uses][35702]
2874 * [Improve error message for misplaced doc comments][33922]
2875 * [Buffer unix and lock windows to prevent message interleaving][35975]
2876 * [Update lifetime errors to specifically note temporaries][36171]
2877 * [Special case a few colors for Windows][36178]
2878 * [Suggest `use self` when such an import resolves][36289]
2879 * [Be more specific when type parameter shadows primitive type][36338]
2880 * Many minor improvements
2881
2882 Compile-time Optimizations
2883 --------------------------
2884
2885 * [Compute and cache HIR hashes at beginning][35854]
2886 * [Don't hash types in loan paths][36004]
2887 * [Cache projections in trans][35761]
2888 * [Optimize the parser's last token handling][36527]
2889 * [Only instantiate #[inline] functions in codegen units referencing
2890   them][36524]. This leads to big improvements in cases where crates export
2891   define many inline functions without using them directly.
2892 * [Lazily allocate TypedArena's first chunk][36592]
2893 * [Don't allocate during default HashSet creation][36734]
2894
2895 Stabilized APIs
2896 ---------------
2897
2898 * [`checked_abs`]
2899 * [`wrapping_abs`]
2900 * [`overflowing_abs`]
2901 * [`RefCell::try_borrow`]
2902 * [`RefCell::try_borrow_mut`]
2903
2904 Libraries
2905 ---------
2906
2907 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2908 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2909   covariant][35354]
2910 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2911 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2912 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2913 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2914 * [Use arc4rand on FreeBSD][35884]
2915 * [memrchr: Correct aligned offset computation][35969]
2916 * [Improve Demangling of Rust Symbols][36059]
2917 * [Use monotonic time in condition variables][35048]
2918 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2919 * [Implement conversion traits for `char`][35755]
2920 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2921 * [Zero first byte of CString on drop][36264]
2922 * [Inherit overflow checks for sum and product][36372]
2923 * [Add missing Eq implementations][36423]
2924 * [Implement `Debug` for `DirEntry`][36631]
2925 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2926   `errno`][36754]
2927 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2928 * [Implement more traits for `std::io::ErrorKind`][35911]
2929 * [Optimize BinaryHeap bounds checking][36072]
2930 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2931   `extend_with_element`][36355]
2932 * [Fix overflow checking in unsigned pow()][34942]
2933
2934 Cargo
2935 -----
2936
2937 * This release includes security fixes to both curl and OpenSSL.
2938 * [Fix transitive doctests when panic=abort][cargo/3021]
2939 * [Add --all-features flag to cargo][cargo/3038]
2940 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2941 * [Don't parse the home directory more than once][cargo/3078]
2942 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2943 * [Update OpenSSL to 1.0.2j][cargo/3121]
2944 * [Add license and license_file to cargo metadata output][cargo/3110]
2945 * [Make crates-io registry URL optional in config; ignore all changes to
2946   source.crates-io][cargo/3089]
2947 * [Don't download dependencies from other platforms][cargo/3123]
2948 * [Build transitive dev-dependencies when needed][cargo/3125]
2949 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2950 * [Avoid updating registry when adding existing deps][cargo/3144]
2951 * [Warn about path overrides that won't work][cargo/3136]
2952 * [Use workspaces during `cargo install`][cargo/3146]
2953 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2954 * [Add --message-format flag][cargo/3000]
2955 * [Pass target environment for rustdoc][cargo/3205]
2956 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2957 * [Update curl and curl-sys][cargo/3241]
2958 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2959
2960 Tooling
2961 -------
2962
2963 * [rustdoc: Add the `--sysroot` argument][36586]
2964 * [rustdoc: Fix a couple of issues with the search results][35655]
2965 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2966 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2967 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2968
2969 Misc
2970 ----
2971
2972 * [Remove unmaintained style guide][35124]
2973 * [Add s390x support][36369]
2974 * [Initial work at Haiku OS support][36727]
2975 * [Add mips-uclibc targets][35734]
2976 * [Crate-ify compiler-rt into compiler-builtins][35021]
2977 * [Add rustc version info (git hash + date) to dist tarball][36213]
2978 * Many documentation improvements
2979
2980 Compatibility Notes
2981 -------------------
2982
2983 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2984 * [Deny (by default) transmuting from fn item types to pointer-sized
2985   types][34923]. Continuing the long transition to zero-sized fn items,
2986   per [RFC 401].
2987 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2988   Part of [RFC 1506].
2989 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2990 * [Fix lifetime rules for 'if' conditions][36029].
2991 * [Inherit overflow checks for sum and product][36372].
2992 * [Forbid user-defined macros named "macro_rules"][36730].
2993
2994 [33922]: https://github.com/rust-lang/rust/pull/33922
2995 [34623]: https://github.com/rust-lang/rust/pull/34623
2996 [34923]: https://github.com/rust-lang/rust/pull/34923
2997 [34942]: https://github.com/rust-lang/rust/pull/34942
2998 [34982]: https://github.com/rust-lang/rust/pull/34982
2999 [35021]: https://github.com/rust-lang/rust/pull/35021
3000 [35048]: https://github.com/rust-lang/rust/pull/35048
3001 [35074]: https://github.com/rust-lang/rust/pull/35074
3002 [35124]: https://github.com/rust-lang/rust/pull/35124
3003 [35234]: https://github.com/rust-lang/rust/pull/35234
3004 [35238]: https://github.com/rust-lang/rust/pull/35238
3005 [35354]: https://github.com/rust-lang/rust/pull/35354
3006 [35559]: https://github.com/rust-lang/rust/pull/35559
3007 [35585]: https://github.com/rust-lang/rust/pull/35585
3008 [35627]: https://github.com/rust-lang/rust/pull/35627
3009 [35655]: https://github.com/rust-lang/rust/pull/35655
3010 [35702]: https://github.com/rust-lang/rust/pull/35702
3011 [35707]: https://github.com/rust-lang/rust/pull/35707
3012 [35728]: https://github.com/rust-lang/rust/pull/35728
3013 [35734]: https://github.com/rust-lang/rust/pull/35734
3014 [35755]: https://github.com/rust-lang/rust/pull/35755
3015 [35761]: https://github.com/rust-lang/rust/pull/35761
3016 [35764]: https://github.com/rust-lang/rust/pull/35764
3017 [35814]: https://github.com/rust-lang/rust/pull/35814
3018 [35854]: https://github.com/rust-lang/rust/pull/35854
3019 [35871]: https://github.com/rust-lang/rust/pull/35871
3020 [35884]: https://github.com/rust-lang/rust/pull/35884
3021 [35911]: https://github.com/rust-lang/rust/pull/35911
3022 [35969]: https://github.com/rust-lang/rust/pull/35969
3023 [35975]: https://github.com/rust-lang/rust/pull/35975
3024 [36004]: https://github.com/rust-lang/rust/pull/36004
3025 [36008]: https://github.com/rust-lang/rust/pull/36008
3026 [36014]: https://github.com/rust-lang/rust/pull/36014
3027 [36029]: https://github.com/rust-lang/rust/pull/36029
3028 [36059]: https://github.com/rust-lang/rust/pull/36059
3029 [36072]: https://github.com/rust-lang/rust/pull/36072
3030 [36101]: https://github.com/rust-lang/rust/pull/36101
3031 [36104]: https://github.com/rust-lang/rust/pull/36104
3032 [36171]: https://github.com/rust-lang/rust/pull/36171
3033 [36173]: https://github.com/rust-lang/rust/pull/36173
3034 [36178]: https://github.com/rust-lang/rust/pull/36178
3035 [36213]: https://github.com/rust-lang/rust/pull/36213
3036 [36214]: https://github.com/rust-lang/rust/pull/36214
3037 [36264]: https://github.com/rust-lang/rust/pull/36264
3038 [36266]: https://github.com/rust-lang/rust/pull/36266
3039 [36289]: https://github.com/rust-lang/rust/pull/36289
3040 [36338]: https://github.com/rust-lang/rust/pull/36338
3041 [36351]: https://github.com/rust-lang/rust/pull/36351
3042 [36355]: https://github.com/rust-lang/rust/pull/36355
3043 [36369]: https://github.com/rust-lang/rust/pull/36369
3044 [36372]: https://github.com/rust-lang/rust/pull/36372
3045 [36423]: https://github.com/rust-lang/rust/pull/36423
3046 [36482]: https://github.com/rust-lang/rust/pull/36482
3047 [36505]: https://github.com/rust-lang/rust/pull/36505
3048 [36524]: https://github.com/rust-lang/rust/pull/36524
3049 [36527]: https://github.com/rust-lang/rust/pull/36527
3050 [36551]: https://github.com/rust-lang/rust/pull/36551
3051 [36574]: https://github.com/rust-lang/rust/pull/36574
3052 [36586]: https://github.com/rust-lang/rust/pull/36586
3053 [36592]: https://github.com/rust-lang/rust/pull/36592
3054 [36631]: https://github.com/rust-lang/rust/pull/36631
3055 [36639]: https://github.com/rust-lang/rust/pull/36639
3056 [36721]: https://github.com/rust-lang/rust/pull/36721
3057 [36727]: https://github.com/rust-lang/rust/pull/36727
3058 [36730]: https://github.com/rust-lang/rust/pull/36730
3059 [36734]: https://github.com/rust-lang/rust/pull/36734
3060 [36754]: https://github.com/rust-lang/rust/pull/36754
3061 [36995]: https://github.com/rust-lang/rust/pull/36995
3062 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3063 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3064 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3065 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3066 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3067 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3068 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3069 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3070 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3071 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3072 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3073 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3074 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3075 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3076 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3077 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3078 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3079 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3080 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3081 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3082 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3083 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3084 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3085 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3086 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3087 [rustup]: https://www.rustup.rs
3088 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3089 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3090 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3091 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3092 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3093 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3094 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3095
3096
3097 Version 1.12.1 (2016-10-20)
3098 ===========================
3099
3100 Regression Fixes
3101 ----------------
3102
3103 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3104 * [Confusion with double negation and booleans][36856]
3105 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3106 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3107 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3108 * [Corrupted memory after updated to 1.12][36936]
3109 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3110 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3111 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3112
3113 [36381]: https://github.com/rust-lang/rust/issues/36381
3114 [36856]: https://github.com/rust-lang/rust/issues/36856
3115 [36875]: https://github.com/rust-lang/rust/issues/36875
3116 [36924]: https://github.com/rust-lang/rust/issues/36924
3117 [36926]: https://github.com/rust-lang/rust/issues/36926
3118 [36936]: https://github.com/rust-lang/rust/issues/36936
3119 [37026]: https://github.com/rust-lang/rust/issues/37026
3120 [37112]: https://github.com/rust-lang/rust/issues/37112
3121 [37153]: https://github.com/rust-lang/rust/issues/37153
3122
3123
3124 Version 1.12.0 (2016-09-29)
3125 ===========================
3126
3127 Highlights
3128 ----------
3129
3130 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3131   This translation pass is far simpler than the previous AST->LLVM pass, and
3132   creates opportunities to perform new optimizations directly on the MIR. It
3133   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3134 * [`rustc` presents a new, more readable error format, along with
3135   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3136   Most common editors supporting Rust have been updated to work with it. It was
3137   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3138
3139 Compiler
3140 --------
3141
3142 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3143   This translation pass is far simpler than the previous AST->LLVM pass, and
3144   creates opportunities to perform new optimizations directly on the MIR. It
3145   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3146 * [Print the Rust target name, not the LLVM target name, with
3147   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3148 * [The computation of `TypeId` is correct in some cases where it was previously
3149   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3150 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3151 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3152   `--print relocation-models`, and `--print code-models` print the available
3153   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3154   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3155 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3156   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3157   These targets produce statically-linked binaries. There are no binary release
3158   builds yet though.
3159
3160 Diagnostics
3161 -----------
3162
3163 * [`rustc` presents a new, more readable error format, along with
3164   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3165   Most common editors supporting Rust have been updated to work with it. It was
3166   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3167 * [In error descriptions, references are now described in plain English,
3168   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3169 * [In error type descriptions, unknown numeric types are named `{integer}` or
3170   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3171 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3172
3173 Language
3174 --------
3175
3176 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3177 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3178 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3179   useful](https://github.com/rust-lang/rust/pull/34908)
3180 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3181   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3182 * [Semicolons are properly required as statement delimiters inside
3183   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3184 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3185
3186 Stabilized APIs
3187 ---------------
3188
3189 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3190 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3191 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3192 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3193 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3194 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3195 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3196 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3197 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3198 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3199   Both on Unix and Windows.
3200 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3201 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3202 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3203 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3204 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3205 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3206 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3207 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3208
3209 Libraries
3210 ---------
3211
3212 * [The `format!` macro and friends now allow a single argument to be formatted
3213   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3214 * [The lifetime bounds on `[T]::binary_search_by` and
3215   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3216 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3217 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3218 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3219 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3220 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3221 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3222 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3223 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3224   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3225 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3226   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3227 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3228 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3229   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3230 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3231 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3232 * [`mpsc::sync_channel` `Receiver`s return any available message before
3233   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3234 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3235 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3236
3237 Cargo
3238 -----
3239
3240 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3241 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3242 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3243 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3244 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3245 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3246 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3247 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3248 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3249 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3250 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3251 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3252 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3253 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3254 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3255 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3256
3257 Performance
3258 -----------
3259
3260 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3261 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3262
3263 Tooling
3264 -------
3265
3266 * [Test binaries now support a `--test-threads` argument to specify the number
3267   of threads used to run tests, and which acts the same as the
3268   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3269 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3270 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3271 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3272 * [Rust releases now come with source packages that can be installed by rustup
3273   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3274   The resulting source code can be used by tools and IDES, located in the
3275   sysroot under `lib/rustlib/src`.
3276
3277 Misc
3278 ----
3279
3280 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3281 * Many minor improvements to the documentation.
3282 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3283
3284 Compatibility Notes
3285 -------------------
3286
3287 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3288   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3289 * [When formatting strings, if "precision" is specified, the "fill",
3290   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3291 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3292
3293
3294 Version 1.11.0 (2016-08-18)
3295 ===========================
3296
3297 Language
3298 --------
3299
3300 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3301 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3302 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3303 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3304 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3305
3306 Stabilized APIs
3307 ---------------
3308
3309 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3310 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3311 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3312 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3313 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3314 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3315   (in libcore - previously stabilized in libstd)
3316 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3317   (in libcore - previously stabilized in libstd)
3318 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3319   (in libcore - previously stabilized in libstd)
3320 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3321   (in libcore - previously stabilized in libstd)
3322 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3323 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3324 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3325 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3326
3327 Libraries
3328 ---------
3329
3330 * [The `thread_local!` macro supports multiple definitions in a single
3331    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3332 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3333 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3334   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3335 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3336 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3337 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3338 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3339
3340 Cargo
3341 -----
3342
3343 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3344 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3345 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3346 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3347 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3348   and `-vv` prints warnings for all crates.
3349 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3350 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3351   This provides room for expansion by arbitrary tools.
3352 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3353 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3354 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3355 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3356 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3357 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3358 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3359
3360 Performance
3361 -----------
3362
3363 * [Caching projections speeds up type check dramatically for some
3364   workloads](https://github.com/rust-lang/rust/pull/33816)
3365 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3366   This hasher is faster, but is believed to provide sufficient
3367   protection from collision attacks.
3368 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3369
3370 Rustdoc
3371 -------
3372
3373 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3374 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3375 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3376 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3377 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3378
3379 Tooling
3380 -------
3381
3382 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3383 * [When emitting debug info, rustc emits frame pointers for closures,
3384   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3385 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3386 * Many more errors have been given error codes and extended
3387   explanations
3388 * API documentation continues to be improved, with many new examples
3389
3390 Misc
3391 ----
3392
3393 * [rustc no longer hangs when dependencies recursively re-export
3394   submodules](https://github.com/rust-lang/rust/pull/34542)
3395 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3396 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3397   rewritten](https://github.com/rust-lang/rust/pull/33895)
3398 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3399   No targets use this yet, but it works toward AVR support.
3400
3401 Compatibility Notes
3402 -------------------
3403
3404 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3405 * [The new follow-set rules that place restrictions on `macro_rules!`
3406   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3407   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3408   and has been a warning since 1.10.
3409 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3410   This causes breakage in some corner cases.
3411
3412
3413 Version 1.10.0 (2016-07-07)
3414 ===========================
3415
3416 Language
3417 --------
3418
3419 * [Allow `concat_idents!` in type positions as well as in expression
3420   positions](https://github.com/rust-lang/rust/pull/33735).
3421 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3422   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3423 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3424 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3425 * [`panic!` can be converted to a runtime abort with the
3426   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3427   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3428 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3429   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3430   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3431   Note that Cargo does not yet directly support cdylibs.
3432
3433 Stabilized APIs
3434 ---------------
3435
3436 * `os::windows::fs::OpenOptionsExt::access_mode`
3437 * `os::windows::fs::OpenOptionsExt::share_mode`
3438 * `os::windows::fs::OpenOptionsExt::custom_flags`
3439 * `os::windows::fs::OpenOptionsExt::attributes`
3440 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3441 * `os::unix::fs::OpenOptionsExt::custom_flags`
3442 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3443 * `Default for sync::Weak`
3444 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3445 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3446 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3447 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3448 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3449 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3450 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3451 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3452 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3453 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3454 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3455 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3456 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3457 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3458 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3459 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3460 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3461 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3462 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3463 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3464 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3465 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3466 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3467 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3468 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3469 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3470 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3471 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3472 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3473 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3474 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3475 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3476 * Read/Write/RawFd impls for `UnixStream`
3477 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3478 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3479 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3480 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3481 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3482 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3483 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3484 * RawFd impls for `UnixListener`
3485 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3486 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3487 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3488 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3489 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3490 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3491 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3492 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3493 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3494 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3495 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3496 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3497 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3498 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3499 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3500 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3501 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3502 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3503 * RawFd impls for `UnixDatagram`
3504 * `{BTree,Hash}Map::values_mut`
3505 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3506
3507 Libraries
3508 ---------
3509
3510 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3511   The semantics of this minor method are subtle and probably not what
3512   most people want.
3513 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3514 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3515   will fall back to `/dev/urandom` temporarily to avoid blocking
3516   during early boot](https://github.com/rust-lang/rust/pull/33086).
3517 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3518 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3519 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3520 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3521 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3522 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3523   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3524
3525 Cargo
3526 -----
3527 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3528   This controls the runtime behavior of the `panic!` macro
3529   and can be either "unwind" (the default), or "abort".
3530   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3531 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3532 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3533 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3534   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3535 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3536 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3537 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3538   By default they are retried twice, which can be customized with the
3539   `net.retry` value in `.cargo/config`.
3540 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3541 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3542 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3543 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3544   Makes it possible to install multiple crates in parallel.
3545 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3546 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3547 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3548 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3549 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3550 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3551
3552 Performance
3553 -----------
3554
3555 * [rustc memory usage was reduced by refactoring the context used for
3556   type checking](https://github.com/rust-lang/rust/pull/33425).
3557 * [Speed up creation of `HashMap`s by caching the random keys used
3558   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3559 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3560 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3561 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3562   10x faster than the previous lookup tables.
3563 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3564
3565 Usability
3566 ---------
3567
3568 * Many incremental improvements to documentation and rustdoc.
3569 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3570 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3571 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3572 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3573 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3574 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3575 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3576
3577 Misc
3578 ----
3579
3580 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3581 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3582 * [`std` no longer prints backtraces on platforms where the running
3583   module must be loaded with `env::current_exe`, which can't be relied
3584   on](https://github.com/rust-lang/rust/pull/33554).
3585 * This release includes std binaries for the i586-unknown-linux-gnu,
3586   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3587   i586 target is for old x86 hardware without SSE2, and the armv7
3588   target is for Android running on modern ARM architectures.
3589 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3590   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3591 * [On Unix the runtime aborts by calling `libc::abort` instead of
3592   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3593 * [Rust is now bootstrapped from the previous release of Rust,
3594   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3595
3596 Compatibility Notes
3597 -------------------
3598
3599 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3600 * [`target_env` for Linux ARM targets is just `gnu`, not
3601   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3602 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3603 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3604 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3605   Affects how macros are parsed.
3606 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3607 * [Feature-gated attributes on macro-generated macro invocations are
3608   now rejected](https://github.com/rust-lang/rust/pull/32791).
3609 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3610   This caused some minor changes to type inference.
3611
3612
3613 Version 1.9.0 (2016-05-26)
3614 ==========================
3615
3616 Language
3617 --------
3618
3619 * The `#[deprecated]` attribute when applied to an API will generate
3620   warnings when used. The warnings may be suppressed with
3621   `#[allow(deprecated)]`. [RFC 1270].
3622 * [`fn` item types are zero sized, and each `fn` names a unique
3623   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3624   `transmute` on a `fn` type will generate a warning for a few cycles,
3625   then will be converted to an error.
3626 * [Field and method resolution understand visibility, so private
3627   fields and methods cannot prevent the proper use of public fields
3628   and methods][1.9fv].
3629 * [The parser considers unicode codepoints in the
3630   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3631
3632 Stabilized APIs
3633 ---------------
3634
3635 * [`std::panic`]
3636 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3637 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3638 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3639 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3640 * [`str::is_char_boundary`]
3641 * [`<*const T>::as_ref`]
3642 * [`<*mut T>::as_ref`]
3643 * [`<*mut T>::as_mut`]
3644 * [`AsciiExt::make_ascii_uppercase`]
3645 * [`AsciiExt::make_ascii_lowercase`]
3646 * [`char::decode_utf16`]
3647 * [`char::DecodeUtf16`]
3648 * [`char::DecodeUtf16Error`]
3649 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3650 * [`BTreeSet::take`]
3651 * [`BTreeSet::replace`]
3652 * [`BTreeSet::get`]
3653 * [`HashSet::take`]
3654 * [`HashSet::replace`]
3655 * [`HashSet::get`]
3656 * [`OsString::with_capacity`]
3657 * [`OsString::clear`]
3658 * [`OsString::capacity`]
3659 * [`OsString::reserve`]
3660 * [`OsString::reserve_exact`]
3661 * [`OsStr::is_empty`]
3662 * [`OsStr::len`]
3663 * [`std::os::unix::thread`]
3664 * [`RawPthread`]
3665 * [`JoinHandleExt`]
3666 * [`JoinHandleExt::as_pthread_t`]
3667 * [`JoinHandleExt::into_pthread_t`]
3668 * [`HashSet::hasher`]
3669 * [`HashMap::hasher`]
3670 * [`CommandExt::exec`]
3671 * [`File::try_clone`]
3672 * [`SocketAddr::set_ip`]
3673 * [`SocketAddr::set_port`]
3674 * [`SocketAddrV4::set_ip`]
3675 * [`SocketAddrV4::set_port`]
3676 * [`SocketAddrV6::set_ip`]
3677 * [`SocketAddrV6::set_port`]
3678 * [`SocketAddrV6::set_flowinfo`]
3679 * [`SocketAddrV6::set_scope_id`]
3680 * [`slice::copy_from_slice`]
3681 * [`ptr::read_volatile`]
3682 * [`ptr::write_volatile`]
3683 * [`OpenOptions::create_new`]
3684 * [`TcpStream::set_nodelay`]
3685 * [`TcpStream::nodelay`]
3686 * [`TcpStream::set_ttl`]
3687 * [`TcpStream::ttl`]
3688 * [`TcpStream::set_only_v6`]
3689 * [`TcpStream::only_v6`]
3690 * [`TcpStream::take_error`]
3691 * [`TcpStream::set_nonblocking`]
3692 * [`TcpListener::set_ttl`]
3693 * [`TcpListener::ttl`]
3694 * [`TcpListener::set_only_v6`]
3695 * [`TcpListener::only_v6`]
3696 * [`TcpListener::take_error`]
3697 * [`TcpListener::set_nonblocking`]
3698 * [`UdpSocket::set_broadcast`]
3699 * [`UdpSocket::broadcast`]
3700 * [`UdpSocket::set_multicast_loop_v4`]
3701 * [`UdpSocket::multicast_loop_v4`]
3702 * [`UdpSocket::set_multicast_ttl_v4`]
3703 * [`UdpSocket::multicast_ttl_v4`]
3704 * [`UdpSocket::set_multicast_loop_v6`]
3705 * [`UdpSocket::multicast_loop_v6`]
3706 * [`UdpSocket::set_multicast_ttl_v6`]
3707 * [`UdpSocket::multicast_ttl_v6`]
3708 * [`UdpSocket::set_ttl`]
3709 * [`UdpSocket::ttl`]
3710 * [`UdpSocket::set_only_v6`]
3711 * [`UdpSocket::only_v6`]
3712 * [`UdpSocket::join_multicast_v4`]
3713 * [`UdpSocket::join_multicast_v6`]
3714 * [`UdpSocket::leave_multicast_v4`]
3715 * [`UdpSocket::leave_multicast_v6`]
3716 * [`UdpSocket::take_error`]
3717 * [`UdpSocket::connect`]
3718 * [`UdpSocket::send`]
3719 * [`UdpSocket::recv`]
3720 * [`UdpSocket::set_nonblocking`]
3721
3722 Libraries
3723 ---------
3724
3725 * [`std::sync::Once` is poisoned if its initialization function
3726   fails][1.9o].
3727 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3728 * [Most types implement `fmt::Debug`][1.9db].
3729 * [The default buffer size used by `BufReader` and `BufWriter` was
3730   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3731   used by other languages.
3732 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3733   `Duration` additionally implements `*=` and `/=`][1.9ta].
3734 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3735 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3736 * [`Chain` implements `BufRead`][1.9ch].
3737 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3738
3739 Cargo
3740 -----
3741
3742 * [Cargo can now run concurrently][1.9cc].
3743 * [Top-level overrides allow specific revisions of crates to be
3744   overridden through the entire crate graph][1.9ct].  This is intended
3745   to make upgrades easier for large projects, by allowing crates to be
3746   forked temporarily until they've been upgraded and republished.
3747 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3748 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3749   on the commandline][1.9cf]. `rustc` arguments can also be specified
3750   in the `build.rustflags` configuration key.
3751
3752 Performance
3753 -----------
3754
3755 * [The time complexity of comparing variables for equivalence during type
3756   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3757   to major compilation time improvement in some scenarios.
3758 * [`ToString` is specialized for `str`, giving it the same performance
3759   as `to_owned`][1.9ts].
3760 * [Spawning processes with `Command::output` no longer creates extra
3761   threads][1.9sp].
3762 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3763   for C-like enums][1.9cl].
3764
3765 Misc
3766 ----
3767
3768 * [Passing the `--quiet` flag to a test runner will produce
3769   much-abbreviated output][1.9q].
3770 * The Rust Project now publishes std binaries for the
3771   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3772   `i586-pc-windows-msvc` targets.
3773
3774 Compatibility Notes
3775 -------------------
3776
3777 * [`std::sync::Once` is poisoned if its initialization function
3778   fails][1.9o].
3779 * [It is illegal to define methods with the same name in overlapping
3780   inherent `impl` blocks][1.9sn].
3781 * [`fn` item types are zero sized, and each `fn` names a unique
3782   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3783   `transmute` on a `fn` type will generate a warning for a few cycles,
3784   then will be converted to an error.
3785 * [Improvements to const evaluation may trigger new errors when integer
3786   literals are out of range][1.9ce].
3787
3788
3789 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3790 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3791 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3792 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3793 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3794 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3795 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3796 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3797 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3798 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3799 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3800 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3801 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3802 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3803 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3804 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3805 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3806 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3807 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3808 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3809 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3810 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3811 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3812 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3813 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3814 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3815 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3816 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3817 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3818 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3819 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3820 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3821 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3822 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3823 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3824 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3825 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3826 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3827 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3828 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3829 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3830 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3831 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3832 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3833 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3834 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3835 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3836 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3837 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3838 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3839 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3840 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3841 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3842 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3843 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3844 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3845 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3846 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3847 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3848 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3849 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3850 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3851 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3852 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3853 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3854 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3855 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3856 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3857 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3858 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3859 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3860 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3861 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3862 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3863 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3864 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3865 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3866 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3867 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3868 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3869 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3870 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3871 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3872 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3873 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3874 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3875 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3876 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3877 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3878 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3879 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3880 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3881 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3882 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3883 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3884 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3885 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3886 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3887 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3888 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3889 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3890 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3891 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3892 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3893 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3894 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3895 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3896 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3897 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3898 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3899
3900
3901 Version 1.8.0 (2016-04-14)
3902 ==========================
3903
3904 Language
3905 --------
3906
3907 * Rust supports overloading of compound assignment statements like
3908   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3909   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3910   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3911   traits. [RFC 953].
3912 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3913   addition to the non-braced form, `struct Foo;`. [RFC 218].
3914
3915 Libraries
3916 ---------
3917
3918 * Stabilized APIs:
3919   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3920   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3921   * [`Ref::map`]
3922   * [`RefMut::map`]
3923   * [`ptr::drop_in_place`]
3924   * [`time::Instant`]
3925   * [`time::SystemTime`]
3926   * [`Instant::now`]
3927   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3928   * [`Instant::elapsed`]
3929   * [`SystemTime::now`]
3930   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3931   * [`SystemTime::elapsed`]
3932   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3933   * [`SystemTimeError`]
3934   * [`SystemTimeError::duration`]
3935   * Various impls for `SystemTimeError`
3936   * [`UNIX_EPOCH`]
3937   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3938     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3939     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3940 * [The `write!` and `writeln!` macros correctly emit errors if any of
3941   their arguments can't be formatted][1.8w].
3942 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3943 * [The Unix-specific `raw` modules, which contain a number of
3944   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3945   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3946   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3947   across platforms was making it difficult to implement `std`
3948   correctly. Those that need these definitions should use the `libc`
3949   crate. [RFC 1415].
3950 * The Unix-specific `MetadataExt` traits, including
3951   `os::unix::fs::MetadataExt`, which expose values such as inode
3952   numbers [no longer return platform-specific types][1.8r], but
3953   instead return widened integers. [RFC 1415].
3954 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3955 * [Atomic loads and stores are not volatile][1.8a].
3956 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3957
3958 Performance
3959 -----------
3960
3961 * [Inlining hash functions lead to a 3% compile-time improvement in
3962   some workloads][1.8h].
3963 * When using jemalloc, its symbols are [unprefixed so that it
3964   overrides the libc malloc implementation][1.8h]. This means that for
3965   rustc, LLVM is now using jemalloc, which results in a 6%
3966   compile-time improvement on a specific workload.
3967 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3968
3969 Misc
3970 ----
3971
3972 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3973   i686-pc-windows-msvc is now considered a tier-1 platform.
3974 * [The `--print targets` flag prints a list of supported targets][1.8t].
3975 * [The `--print cfg` flag prints the `cfg`s defined for the current
3976   target][1.8cf].
3977 * [`rustc` can be built with an new Cargo-based build system, written
3978   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3979   build system. To enable it configure with `configure --rustbuild`.
3980 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3981   variants while also indicating the total number of missing variants
3982   if more than 3][1.8m].
3983 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3984 * The Rust Project now publishes binary releases of the standard
3985   library for a number of tier-2 targets:
3986   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3987   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3988   `x86_64-rumprun-netbsd`. These can be installed with
3989   tools such as [multirust][1.8mr].
3990
3991 Cargo
3992 -----
3993
3994 * [`cargo init` creates a new Cargo project in the current
3995   directory][1.8ci].  It is otherwise like `cargo new`.
3996 * [Cargo has configuration keys for `-v` and
3997   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3998   `[term]` section of `.cargo/config`.
3999 * [Configuration keys that evaluate to strings or integers can be set
4000   via environment variables][1.8ce]. For example the `build.jobs` key
4001   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4002   precedence over config files.
4003 * [Target-specific dependencies support Rust `cfg` syntax for
4004   describing targets][1.8cfg] so that dependencies for multiple
4005   targets can be specified together. [RFC 1361].
4006 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4007   `RUSTDOC` take precedence over the `build.target-dir`,
4008   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4009 * [The child process tree is killed on Windows when Cargo is
4010   killed][1.8ck].
4011 * [The `build.target` configuration value sets the target platform,
4012   like `--target`][1.8ct].
4013
4014 Compatibility Notes
4015 -------------------
4016
4017 * [Unstable compiler flags have been further restricted][1.8u]. Since
4018   1.0 `-Z` flags have been considered unstable, and other flags that
4019   were considered unstable additionally required passing `-Z
4020   unstable-options` to access. Unlike unstable language and library
4021   features though, these options have been accessible on the stable
4022   release channel. Going forward, *new unstable flags will not be
4023   available on the stable release channel*, and old unstable flags
4024   will warn about their usage. In the future, all unstable flags will
4025   be unavailable on the stable release channel.
4026 * [It is no longer possible to `match` on empty enum variants using
4027   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4028 * The Unix-specific `MetadataExt` traits, including
4029   `os::unix::fs::MetadataExt`, which expose values such as inode
4030   numbers [no longer return platform-specific types][1.8r], but
4031   instead return widened integers. [RFC 1415].
4032 * [Modules sourced from the filesystem cannot appear within arbitrary
4033   blocks, but only within other modules][1.8mf].
4034 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4035 * On Unix, [stack overflow triggers a runtime abort instead of a
4036   SIGSEGV][1.8so].
4037 * [`Command::spawn` and its equivalents return an error if any of
4038   its command-line arguments contain interior `NUL`s][1.8n].
4039 * [Tuple and unit enum variants from other crates are in the type
4040   namespace][1.8tn].
4041 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4042   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4043   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4044   instead of `foo.lib`.
4045
4046
4047 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4048 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4049 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4050 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4051 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4052 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4053 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4054 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4055 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4056 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4057 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4058 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4059 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4060 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4061 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4062 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4063 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4064 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4065 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4066 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4067 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4068 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4069 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4070 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4071 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4072 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4073 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4074 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4075 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4076 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4077 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4078 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4079 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4080 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4081 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4082 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4083 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4084 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4085 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4086 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4087 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4088 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4089 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4090 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4091 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4092 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4093 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4094 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4095 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4096 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4097 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4098 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4099 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4100 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4101 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4102 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4103 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4104 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4105 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4106 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4107
4108
4109 Version 1.7.0 (2016-03-03)
4110 ==========================
4111
4112 Libraries
4113 ---------
4114
4115 * Stabilized APIs
4116   * `Path`
4117     * [`Path::strip_prefix`][] (renamed from relative_from)
4118     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4119   * `Ipv4Addr`
4120     * [`Ipv4Addr::is_loopback`]
4121     * [`Ipv4Addr::is_private`]
4122     * [`Ipv4Addr::is_link_local`]
4123     * [`Ipv4Addr::is_multicast`]
4124     * [`Ipv4Addr::is_broadcast`]
4125     * [`Ipv4Addr::is_documentation`]
4126   * `Ipv6Addr`
4127     * [`Ipv6Addr::is_unspecified`]
4128     * [`Ipv6Addr::is_loopback`]
4129     * [`Ipv6Addr::is_multicast`]
4130   * `Vec`
4131     * [`Vec::as_slice`]
4132     * [`Vec::as_mut_slice`]
4133   * `String`
4134     * [`String::as_str`]
4135     * [`String::as_mut_str`]
4136   * Slices
4137     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4138     be the same length
4139     * `<[T]>::`[`sort_by_key`]
4140   * checked, saturated, and overflowing operations
4141     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4142     * [`i32::saturating_mul`]
4143     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4144     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4145     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4146     * [`u32::saturating_mul`]
4147     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4148     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4149     * and checked, saturated, and overflowing operations for other primitive types
4150   * FFI
4151     * [`ffi::IntoStringError`]
4152     * [`CString::into_string`]
4153     * [`CString::into_bytes`]
4154     * [`CString::into_bytes_with_nul`]
4155     * `From<CString> for Vec<u8>`
4156   * `IntoStringError`
4157     * [`IntoStringError::into_cstring`]
4158     * [`IntoStringError::utf8_error`]
4159     * `Error for IntoStringError`
4160   * Hashing
4161     * [`std::hash::BuildHasher`]
4162     * [`BuildHasher::Hasher`]
4163     * [`BuildHasher::build_hasher`]
4164     * [`std::hash::BuildHasherDefault`]
4165     * [`HashMap::with_hasher`]
4166     * [`HashMap::with_capacity_and_hasher`]
4167     * [`HashSet::with_hasher`]
4168     * [`HashSet::with_capacity_and_hasher`]
4169     * [`std::collections::hash_map::RandomState`]
4170     * [`RandomState::new`]
4171 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4172   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4173   from bytes is faster.
4174 * [The performance of `LineWriter` (and thus `io::stdout`) was
4175   improved by using `memchr` to search for newlines][1.7m].
4176 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4177   `f64` variants were stabilized previously.
4178 * [`BTreeMap` was rewritten to use less memory and improve the performance
4179   of insertion and iteration, the latter by as much as 5x][1.7bm].
4180 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4181   covariant over their contained type][1.7bt].
4182 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4183   over their contained type][1.7ll].
4184 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4185   searching methods.
4186 * [`Any` is implemented for unsized types][1.7a].
4187 * [`Hash` is implemented for `Duration`][1.7h].
4188
4189 Misc
4190 ----
4191
4192 * [When running tests with `--test`, rustdoc will pass `--cfg`
4193   arguments to the compiler][1.7dt].
4194 * [The compiler is built with RPATH information by default][1.7rpa].
4195   This means that it will be possible to run `rustc` when installed in
4196   unusual configurations without configuring the dynamic linker search
4197   path explicitly.
4198 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4199   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4200   over `LD_LIBRARY_PATH`.
4201
4202 Cargo
4203 -----
4204
4205 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4206   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4207 * [The `rerun-if-changed` build script directive no longer causes the
4208   build script to incorrectly run twice in certain scenarios][1.7rr].
4209
4210 Compatibility Notes
4211 -------------------
4212
4213 * Soundness fixes to the interactions between associated types and
4214   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4215   code that violates the new rules. This is a significant change that
4216   is known to break existing code, so it has emitted warnings for the
4217   new error cases since 1.4 to give crate authors time to adapt. The
4218   details of what is changing are subtle; read the RFC for more.
4219 * [Several bugs in the compiler's visibility calculations were
4220   fixed][1.7v]. Since this was found to break significant amounts of
4221   code, the new errors will be emitted as warnings for several release
4222   cycles, under the `private_in_public` lint.
4223 * Defaulted type parameters were accidentally accepted in positions
4224   that were not intended. In this release, [defaulted type parameters
4225   appearing outside of type definitions will generate a
4226   warning][1.7d], which will become an error in future releases.
4227 * [Parsing "." as a float results in an error instead of 0][1.7p].
4228   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4229 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4230
4231 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4232 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4233 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4234 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4235 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4236 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4237 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4238 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4239 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4240 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4241 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4242 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4243 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4244 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4245 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4246 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4247 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4248 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4249 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4250 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4251 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4252 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4253 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4254 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4255 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4256 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4257 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4258 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4259 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4260 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4261 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4262 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4263 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4264 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4265 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4266 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4267 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4268 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4269 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4270 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4271 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4272 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4273 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4274 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4275 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4276 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4277 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4278 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4279 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4280 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4281 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4282 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4283 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4284 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4285 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4286 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4287 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4288 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4289 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4290 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4291 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4292 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4293 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4294 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4295 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4296 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4297 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4298 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4299 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4300 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4301 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4302 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4303 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4304 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4305 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4306 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4307 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4308 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4309 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4310
4311
4312 Version 1.6.0 (2016-01-21)
4313 ==========================
4314
4315 Language
4316 --------
4317
4318 * The `#![no_std]` attribute causes a crate to not be linked to the
4319   standard library, but only the [core library][1.6co], as described
4320   in [RFC 1184]. The core library defines common types and traits but
4321   has no platform dependencies whatsoever, and is the basis for Rust
4322   software in environments that cannot support a full port of the
4323   standard library, such as operating systems. Most of the core
4324   library is now stable.
4325
4326 Libraries
4327 ---------
4328
4329 * Stabilized APIs:
4330   [`Read::read_exact`],
4331   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4332   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4333   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4334   [`os::unix::fs::DirBuilderExt`],
4335   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4336   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4337   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4338   [`collections::hash_map::Drain`],
4339   [`collections::hash_map::HashMap::drain`],
4340   [`collections::hash_set::Drain`],
4341   [`collections::hash_set::HashSet::drain`],
4342   [`collections::binary_heap::Drain`],
4343   [`collections::binary_heap::BinaryHeap::drain`],
4344   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4345   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4346   [`RwLock::into_inner`],
4347   [`Iterator::min_by_key`][] (renamed from `min_by`),
4348   [`Iterator::max_by_key`][] (renamed from `max_by`).
4349 * The [core library][1.6co] is stable, as are most of its APIs.
4350 * [The `assert_eq!` macro supports arguments that don't implement
4351   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4352   `assert!`.
4353 * Several timer functions that take duration in milliseconds [are
4354   deprecated in favor of those that take `Duration`][1.6ms]. These
4355   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4356   `thread::park_timeout_ms`.
4357 * The algorithm by which `Vec` reserves additional elements was
4358   [tweaked to not allocate excessive space][1.6a] while still growing
4359   exponentially.
4360 * `From` conversions are [implemented from integers to floats][1.6f]
4361   in cases where the conversion is lossless. Thus they are not
4362   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4363   or `f64`. They are also not implemented for `isize` and `usize`
4364   because the implementations would be platform-specific. `From` is
4365   also implemented from `f32` to `f64`.
4366 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4367 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4368 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4369 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4370   improvements.
4371 * Sorting slices that are already sorted [is 50% faster in some
4372   cases][1.6s].
4373
4374 Cargo
4375 -----
4376
4377 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4378 * Cargo build scripts can specify their dependencies by emitting the
4379   [`rerun-if-changed`][1.6rr] key.
4380 * crates.io will reject publication of crates with dependencies that
4381   have a wildcard version constraint. Crates with wildcard
4382   dependencies were seen to cause a variety of problems, as described
4383   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4384   warning.
4385 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4386   release folder.  A variety of artifacts that Cargo failed to clean
4387   are now correctly deleted.
4388
4389 Misc
4390 ----
4391
4392 * The `unreachable_code` lint [warns when a function call's argument
4393   diverges][1.6dv].
4394 * The parser indicates [failures that may be caused by
4395   confusingly-similar Unicode characters][1.6uc]
4396 * Certain macro errors [are reported at definition time][1.6m], not
4397   expansion.
4398
4399 Compatibility Notes
4400 -------------------
4401
4402 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4403   environment variable when locating crates. This was a pre-cargo
4404   feature for integrating with the package manager that was
4405   accidentally never removed.
4406 * [A number of bugs were fixed in the privacy checker][1.6p] that
4407   could cause previously-accepted code to break.
4408 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4409 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4410   struct pattern syntax (`Foo(..)`) can no longer be used to match
4411   unit structs. This is a warning now, but will become an error in
4412   future releases. Patterns that share the same name as a const are
4413   now an error.
4414 * A bug was fixed that causes [rustc not to apply default type
4415   parameters][1.6xc] when resolving certain method implementations of
4416   traits defined in other crates.
4417
4418 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4419 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4420 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4421 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4422 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4423 [1.6co]: http://doc.rust-lang.org/core/index.html
4424 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4425 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4426 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4427 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4428 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4429 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4430 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4431 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4432 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4433 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4434 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4435 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4436 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4437 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4438 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4439 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4440 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4441 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4442 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4443 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4444 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4445 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4446 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4447 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4448 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4449 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4450 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4451 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4452 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4453 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4454 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4455 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4456 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4457 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4458 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4459 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4460 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4461 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4462 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4463 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4464 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4465
4466
4467 Version 1.5.0 (2015-12-10)
4468 ==========================
4469
4470 * ~700 changes, numerous bugfixes
4471
4472 Highlights
4473 ----------
4474
4475 * Stabilized APIs:
4476   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4477   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4478   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4479   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4480   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4481   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4482   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4483   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4484   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4485   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4486   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4487   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4488   [`Path::read_link`], [`Path::symlink_metadata`],
4489   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4490   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4491   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4492   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4493   [`slice::split_first_mut`], [`slice::split_first`],
4494   [`slice::split_last_mut`], [`slice::split_last`],
4495   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4496   [`str::MatchIndices`], [`str::RMatchIndices`],
4497   [`str::match_indices`], [`str::rmatch_indices`],
4498   [`str::slice_mut_unchecked`], [`string::ParseError`].
4499 * Rust applications hosted on crates.io can be installed locally to
4500   `~/.cargo/bin` with the [`cargo install`] command. Among other
4501   things this makes it easier to augment Cargo with new subcommands:
4502   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4503   invoked as `cargo foo`.
4504 * Crates with wildcard (`*`) dependencies will [emit warnings when
4505   published][1.5w]. In 1.6 it will no longer be possible to publish
4506   crates with wildcard dependencies.
4507
4508 Breaking Changes
4509 ----------------
4510
4511 * The rules determining when a particular lifetime must outlive
4512   a particular value (known as '[dropck]') have been [modified
4513   to not rely on parametricity][1.5p].
4514 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4515   and `Arc`][1.5a]. Because these smart pointer types implement
4516   `Deref`, this causes breakage in cases where the interior type
4517   contains methods of the same name.
4518 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4519   that they could drop their content. Soundness fix.
4520 * All method invocations are [properly checked][1.5wf1] for
4521   [well-formedness][1.5wf2]. Soundness fix.
4522 * Traits whose supertraits contain `Self` are [not object
4523   safe][1.5o]. Soundness fix.
4524 * Target specifications support a [`no_default_libraries`][1.5nd]
4525   setting that controls whether `-nodefaultlibs` is passed to the
4526   linker, and in turn the `is_like_windows` setting no longer affects
4527   the `-nodefaultlibs` flag.
4528 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4529 * The `#[inline]` and `#[repr]` attributes [can only appear
4530   in valid locations][1.5at].
4531 * Native libraries linked from the local crate are [passed to
4532   the linker before native libraries from upstream crates][1.5nl].
4533 * Two rarely-used attributes, `#[no_debug]` and
4534   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4535 * Negation of unsigned integers, which has been a warning for
4536   several releases, [is now behind a feature gate and will
4537   generate errors][1.5nu].
4538 * The parser accidentally accepted visibility modifiers on
4539   enum variants, a bug [which has been fixed][1.5ev].
4540 * [A bug was fixed that allowed `use` statements to import unstable
4541   features][1.5use].
4542
4543 Language
4544 --------
4545
4546 * When evaluating expressions at compile-time that are not
4547   compile-time constants (const-evaluating expressions in non-const
4548   contexts), incorrect code such as overlong bitshifts and arithmetic
4549   overflow will [generate a warning instead of an error][1.5ce],
4550   delaying the error until runtime. This will allow the
4551   const-evaluator to be expanded in the future backwards-compatibly.
4552 * The `improper_ctypes` lint [no longer warns about using `isize` and
4553   `usize` in FFI][1.5ict].
4554
4555 Libraries
4556 ---------
4557
4558 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4559   invariant][1.5c].
4560 * `Default` is [implemented for mutable slices][1.5d].
4561 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4562 * There are now `From` conversions [between floating point
4563   types][1.5f] where the conversions are lossless.
4564 * There are now `From` conversions [between integer types][1.5i] where
4565   the conversions are lossless.
4566 * [`fs::Metadata` implements `Clone`][1.5fs].
4567 * The `parse` method [accepts a leading "+" when parsing
4568   integers][1.5pi].
4569 * [`AsMut` is implemented for `Vec`][1.5am].
4570 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4571   been optimized][1.5cf] and no longer rely on the default impl.
4572 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4573   `unsafe extern "C"` function types now [implement `Clone`,
4574   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4575   `fmt::Debug` for up to 12 arguments][1.5fp].
4576 * [Dropping `Vec`s is much faster in unoptimized builds when the
4577   element types don't implement `Drop`][1.5dv].
4578 * A bug that caused in incorrect behavior when [combining `VecDeque`
4579   with zero-sized types][1.5vdz] was resolved.
4580 * [`PartialOrd` for slices is faster][1.5po].
4581
4582 Miscellaneous
4583 -------------
4584
4585 * [Crate metadata size was reduced by 20%][1.5md].
4586 * [Improvements to code generation reduced the size of libcore by 3.3
4587   MB and rustc's memory usage by 18MB][1.5m].
4588 * [Improvements to deref translation increased performance in
4589   unoptimized builds][1.5dr].
4590 * Various errors in trait resolution [are deduplicated to only be
4591   reported once][1.5te].
4592 * Rust has preliminary [support for rumprun kernels][1.5rr].
4593 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4594
4595 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4596 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4597 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4598 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4599 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4600 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4601 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4602 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4603 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4604 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4605 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4606 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4607 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4608 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4609 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4610 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4611 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4612 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4613 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4614 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4615 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4616 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4617 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4618 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4619 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4620 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4621 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4622 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4623 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4624 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4625 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4626 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4627 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4628 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4629 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4630 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4631 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4632 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4633 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4634 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4635 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4636 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4637 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4638 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4639 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4640 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4641 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4642 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4643 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4644 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4645 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4646 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4647 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4648 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4649 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4650 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4651 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4652 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4653 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4654 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4655 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4656 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4657 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4658 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4659 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4660 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4661 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4662 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4663 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4664 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4665 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4666 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4667 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4668 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4669 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4670 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4671 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4672 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4673 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4674 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4675 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4676 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4677 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4678 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4679 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4680 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4681 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4682 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4683 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4684
4685 Version 1.4.0 (2015-10-29)
4686 ==========================
4687
4688 * ~1200 changes, numerous bugfixes
4689
4690 Highlights
4691 ----------
4692
4693 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4694   GNU) are now supported and recommended for use.
4695
4696 Breaking Changes
4697 ----------------
4698
4699 * [Several changes have been made to fix type soundness and improve
4700   the behavior of associated types][sound]. See [RFC 1214]. Although
4701   we have mostly introduced these changes as warnings this release, to
4702   become errors next release, there are still some scenarios that will
4703   see immediate breakage.
4704 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4705   line breaks in addition to `\n`][crlf].
4706 * [Loans of `'static` lifetime extend to the end of a function][stat].
4707 * [`str::parse` no longer introduces avoidable rounding error when
4708   parsing floating point numbers. Together with earlier changes to
4709   float formatting/output, "round trips" like f.to_string().parse()
4710   now preserve the value of f exactly. Additionally, leading plus
4711   signs are now accepted][fp3].
4712
4713
4714 Language
4715 --------
4716
4717 * `use` statements that import multiple items [can now rename
4718   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4719 * [Binops work correctly on fat pointers][binfat].
4720 * `pub extern crate`, which does not behave as expected, [issues a
4721   warning][pec] until a better solution is found.
4722
4723 Libraries
4724 ---------
4725
4726 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4727   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4728   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4729   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4730   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4731   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4732   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4733   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4734   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4735   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4736   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4737   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4738   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4739   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4740   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4741   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4742   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4743   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4744   [`thread::sleep`].
4745 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4746   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4747   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4748   `f64::from_str_radix`.
4749 * [Reverse-searching strings is faster with the 'two-way'
4750   algorithm][s].
4751 * [`std::io::copy` allows `?Sized` arguments][cc].
4752 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4753   [override `count`, `nth` and `last` with an O(1)
4754   implementation][it].
4755 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4756 * [`IntoRawFd` has been added to the Unix-specific prelude,
4757   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4758   prelude][pr].
4759 * [`Extend<String>` and `FromIterator<String` are both implemented for
4760   `String`][es].
4761 * [`IntoIterator` is implemented for references to `Option` and
4762   `Result`][into2].
4763 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4764   Copy`][ext] as part of [RFC 839]. This will cause type inference
4765   breakage in rare situations.
4766 * [`BinaryHeap` implements `Debug`][bh2].
4767 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4768   arrays][bm].
4769 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4770   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4771 * [String comparison is faster][faststr].
4772 * `&mut T` where `T: std::fmt::Write` [also implements
4773   `std::fmt::Write`][mutw].
4774 * [A stable regression in `VecDeque::push_back` and other
4775   capacity-altering methods that caused panics for zero-sized types
4776   was fixed][vd].
4777 * [Function pointers implement traits for up to 12 parameters][fp2].
4778
4779 Miscellaneous
4780 -------------
4781
4782 * The compiler [no longer uses the 'morestack' feature to prevent
4783   stack overflow][mm]. Instead it uses guard pages and stack
4784   probes (though stack probes are not yet implemented on any platform
4785   but Windows).
4786 * [The compiler matches traits faster when projections are involved][p].
4787 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4788   `usize`][ffi].
4789 * [Cargo now displays useful information about what its doing during
4790   `cargo update`][cu].
4791
4792 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4793 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4794 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4795 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4796 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4797 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4798 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4799 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4800 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4801 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4802 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4803 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4804 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4805 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4806 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4807 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4808 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4809 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4810 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4811 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4812 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4813 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4814 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4815 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4816 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4817 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4818 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4819 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4820 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4821 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4822 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4823 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4824 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4825 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4826 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4827 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4828 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4829 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4830 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4831 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4832 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4833 [bh2]: https://github.com/rust-lang/rust/pull/28156
4834 [binfat]: https://github.com/rust-lang/rust/pull/28270
4835 [bm]: https://github.com/rust-lang/rust/pull/28197
4836 [cc]: https://github.com/rust-lang/rust/pull/27531
4837 [crlf]: https://github.com/rust-lang/rust/pull/28034
4838 [cu]: https://github.com/rust-lang/cargo/pull/1931
4839 [d]: https://github.com/rust-lang/rust/pull/27825
4840 [dep]: https://github.com/rust-lang/rust/pull/28339
4841 [es]: https://github.com/rust-lang/rust/pull/27956
4842 [ext]: https://github.com/rust-lang/rust/pull/28094
4843 [faststr]: https://github.com/rust-lang/rust/pull/28338
4844 [ffi]: https://github.com/rust-lang/rust/pull/28779
4845 [fp]: https://github.com/rust-lang/rust/pull/28268
4846 [fp2]: https://github.com/rust-lang/rust/pull/28560
4847 [fp3]: https://github.com/rust-lang/rust/pull/27307
4848 [i]: https://github.com/rust-lang/rust/pull/27451
4849 [into2]: https://github.com/rust-lang/rust/pull/28039
4850 [it]: https://github.com/rust-lang/rust/pull/27652
4851 [mm]: https://github.com/rust-lang/rust/pull/27338
4852 [mutw]: https://github.com/rust-lang/rust/pull/28368
4853 [sound]: https://github.com/rust-lang/rust/pull/27641
4854 [p]: https://github.com/rust-lang/rust/pull/27866
4855 [pec]: https://github.com/rust-lang/rust/pull/28486
4856 [pr]: https://github.com/rust-lang/rust/pull/27896
4857 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4858 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4859 [s]: https://github.com/rust-lang/rust/pull/27474
4860 [stab]: https://github.com/rust-lang/rust/pull/28339
4861 [stat]: https://github.com/rust-lang/rust/pull/28321
4862 [vd]: https://github.com/rust-lang/rust/pull/28494
4863
4864 Version 1.3.0 (2015-09-17)
4865 ==============================
4866
4867 * ~900 changes, numerous bugfixes
4868
4869 Highlights
4870 ----------
4871
4872 * The [new object lifetime defaults][nold] have been [turned
4873   on][nold2] after a cycle of warnings about the change. Now types
4874   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4875   being interpreted as `&'a Box<Trait+'a>` to `&'a
4876   Box<Trait+'static>`.
4877 * [The Rustonomicon][nom] is a new book in the official documentation
4878   that dives into writing unsafe Rust.
4879 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4880   timekeeping is employed by other std APIs, as well as out-of-tree
4881   time crates.
4882
4883 Breaking Changes
4884 ----------------
4885
4886 * The [new object lifetime defaults][nold] have been [turned
4887   on][nold2] after a cycle of warnings about the change.
4888 * There is a known [regression][lr] in how object lifetime elision is
4889   interpreted, the proper solution for which is undetermined.
4890 * The `#[prelude_import]` attribute, an internal implementation
4891   detail, was accidentally stabilized previously. [It has been put
4892   behind the `prelude_import` feature gate][pi]. This change is
4893   believed to break no existing code.
4894 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4895   [more sane for dynamically sized types][dst3]. Code that relied on
4896   the previous behavior is thought to be broken.
4897 * The `dropck` rules, which checks that destructors can't access
4898   destroyed values, [have been updated][dropck] to match the
4899   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4900   cause some previously-compiling code to no longer build.
4901
4902 Language
4903 --------
4904
4905 * The [new object lifetime defaults][nold] have been [turned
4906   on][nold2] after a cycle of warnings about the change.
4907 * Semicolons may [now follow types and paths in
4908   macros](https://github.com/rust-lang/rust/pull/27000).
4909 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4910   [more sane for dynamically sized types][dst3]. Code that relied on
4911   the previous behavior is not known to exist, and suspected to be
4912   broken.
4913 * `'static` variables [may now be recursive][st].
4914 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4915   implementations correctly.
4916 * The `dropck` rules, which checks that destructors can't access
4917   destroyed values, [have been updated][dropck] to match the
4918   [RFC][dropckrfc].
4919
4920 Libraries
4921 ---------
4922
4923 * The [`Duration`] API, [has been stabilized][ds], as well as the
4924   `std::time` module, which presently contains only `Duration`.
4925 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4926 * The owned C string, [`CString`], implements [`Borrow`] and the
4927   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4928   these allow C strings to be borrowed and cloned in generic code.
4929 * [`CStr`] implements [`Debug`].
4930 * [`AtomicPtr`] implements [`Debug`].
4931 * [`Error`] trait objects [can be downcast to their concrete types][e]
4932   in many common configurations, using the [`is`], [`downcast`],
4933   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4934   [`Any`] trait.
4935 * Searching for substrings now [employs the two-way algorithm][search]
4936   instead of doing a naive search. This gives major speedups to a
4937   number of methods, including [`contains`][sc], [`find`][sf],
4938   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4939   [`ends_with`][sew] are also faster.
4940 * The performance of `PartialEq` for slices is [much faster][ps].
4941 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4942   is overridden and optimized by the implementations for scalars.
4943 * The [`Hasher`] trait now has a number of specialized `write_*`
4944   methods for primitive types, for efficiency.
4945 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4946   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4947   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4948   of [`std::error::Error::cause`][iec] also delegates to the inner
4949   error.
4950 * [`process::Child`][pc] gained the [`id`] method, which returns a
4951   `u32` representing the platform-specific process identifier.
4952 * The [`connect`] method on slices is deprecated, replaced by the new
4953   [`join`] method (note that both of these are on the *unstable*
4954   [`SliceConcatExt`] trait, but through the magic of the prelude are
4955   available to stable code anyway).
4956 * The [`Div`] operator is implemented for [`Wrapping`] types.
4957 * [`DerefMut` is implemented for `String`][dms].
4958 * Performance of SipHash (the default hasher for `HashMap`) is
4959   [better for long data][sh].
4960 * [`AtomicPtr`] implements [`Send`].
4961 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4962   are now [specialized to use uninitialized buffers for increased
4963   performance][rte].
4964 * Lifetime parameters of foreign functions [are now resolved
4965   properly][f].
4966
4967 Misc
4968 ----
4969
4970 * Rust can now, with some coercion, [produce programs that run on
4971   Windows XP][xp], though XP is not considered a supported platform.
4972 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4973   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4974   recommended for use in 1.3, though should be fully-functional
4975   in the [64-bit 1.4 beta][b14].
4976 * On Fedora-based systems installation will [properly configure the
4977   dynamic linker][fl].
4978 * The compiler gained many new extended error descriptions, which can
4979   be accessed with the `--explain` flag.
4980 * The `dropck` pass, which checks that destructors can't access
4981   destroyed values, [has been rewritten][dropck]. This fixes some
4982   soundness holes, and as such will cause some previously-compiling
4983   code to no longer build.
4984 * `rustc` now uses [LLVM to write archive files where possible][ar].
4985   Eventually this will eliminate the compiler's dependency on the ar
4986   utility.
4987 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4988   supported FreeBSD on x86_64).
4989 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4990   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4991   more strict.
4992 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4993   will kill the process instead of leaking][nlp].
4994
4995 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4996 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4997 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4998 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4999 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5000 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5001 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5002 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5003 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5004 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5005 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5006 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5007 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5008 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5009 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5010 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5011 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5012 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5013 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5014 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5015 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5016 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5017 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5018 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5019 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5020 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5021 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5022 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5023 [ar]: https://github.com/rust-lang/rust/pull/26926
5024 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5025 [dms]: https://github.com/rust-lang/rust/pull/26241
5026 [dropck]: https://github.com/rust-lang/rust/pull/27261
5027 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5028 [ds]: https://github.com/rust-lang/rust/pull/26818
5029 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5030 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5031 [dst3]: https://github.com/rust-lang/rust/pull/27351
5032 [e]: https://github.com/rust-lang/rust/pull/24793
5033 [f]: https://github.com/rust-lang/rust/pull/26588
5034 [fb]: https://github.com/rust-lang/rust/pull/26959
5035 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5036 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5037 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5038 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5039 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5040 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5041 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5042 [lic]: https://github.com/rust-lang/rust/pull/26583
5043 [lnu]: https://github.com/rust-lang/rust/pull/27026
5044 [lr]: https://github.com/rust-lang/rust/issues/27248
5045 [lum]: https://github.com/rust-lang/rust/pull/26378
5046 [lur]: https://github.com/rust-lang/rust/pull/26783
5047 [nlp]: https://github.com/rust-lang/rust/pull/27176
5048 [nold2]: https://github.com/rust-lang/rust/pull/27045
5049 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5050 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5051 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5052 [pi]: https://github.com/rust-lang/rust/pull/26699
5053 [ps]: https://github.com/rust-lang/rust/pull/26884
5054 [rte]: https://github.com/rust-lang/rust/pull/26950
5055 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5056 [search]: https://github.com/rust-lang/rust/pull/26327
5057 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5058 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5059 [sh]: https://github.com/rust-lang/rust/pull/27280
5060 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5061 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5062 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5063 [st]: https://github.com/rust-lang/rust/pull/26630
5064 [win1]: https://github.com/rust-lang/rust/pull/26569
5065 [win2]: https://github.com/rust-lang/rust/pull/26741
5066 [win3]: https://github.com/rust-lang/rust/pull/26741
5067 [win4]: https://github.com/rust-lang/rust/pull/27210
5068 [xp]: https://github.com/rust-lang/rust/pull/26569
5069
5070 Version 1.2.0 (2015-08-07)
5071 ==========================
5072
5073 * ~1200 changes, numerous bugfixes
5074
5075 Highlights
5076 ----------
5077
5078 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5079   like `Rc` to contain types without a fixed size, arrays and trait
5080   objects, finally enabling use of `Rc<[T]>` and completing the
5081   implementation of DST.
5082 * [Parallel codegen][parcodegen] is now working again, which can
5083   substantially speed up large builds in debug mode; It also gets
5084   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5085   jobs). It's not enabled by default, but will be "in the near
5086   future". It can be activated with the `-C codegen-units=N` flag to
5087   `rustc`.
5088 * This is the first release with [experimental support for linking
5089   with the MSVC linker and lib C on Windows (instead of using the GNU
5090   variants via MinGW)][win]. It is yet recommended only for the most
5091   intrepid Rustaceans.
5092 * Benchmark compilations are showing a 30% improvement in
5093   bootstrapping over 1.1.
5094
5095 Breaking Changes
5096 ----------------
5097
5098 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5099   unicode case mapping, which is a previously-planned change in
5100   behavior and considered a bugfix.
5101 * [`mem::align_of`] now specifies [the *minimum alignment* for
5102   T][align], which is usually the alignment programs are interested
5103   in, and the same value reported by clang's
5104   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5105   break real code.
5106 * [The `#[packed]` attribute is no longer silently accepted by the
5107   compiler][packed]. This attribute did nothing and code that
5108   mentioned it likely did not work as intended.
5109 * Associated type defaults are [now behind the
5110   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5111   defaults *did not work*, but could be mentioned syntactically. As
5112   such this breakage has minimal impact.
5113
5114 Language
5115 --------
5116
5117 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5118   matching against dereferenceable values.
5119
5120 Libraries
5121 ---------
5122
5123 * The [`Extend`] trait, which grows a collection from an iterator, is
5124   implemented over iterators of references, for `String`, `Vec`,
5125   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5126   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5127 * The [`iter::once`] function returns an iterator that yields a single
5128   element, and [`iter::empty`] returns an iterator that yields no
5129   elements.
5130 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5131   over substring matches.
5132 * [`Cell`] and [`RefCell`] both implement `Eq`.
5133 * A number of methods for wrapping arithmetic are added to the
5134   integral types, [`wrapping_div`], [`wrapping_rem`],
5135   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5136   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5137   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5138   type.. It is illegal for the default arithmetic operations in Rust
5139   to overflow; the desire to wrap must be explicit.
5140 * The `{:#?}` formatting specifier [displays the alternate,
5141   pretty-printed][debugfmt] form of the `Debug` formatter. This
5142   feature was actually introduced prior to 1.0 with little
5143   fanfare.
5144 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5145   for writing data to formatted strings, similar to [`io::Write`].
5146 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5147   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5148   are used by code generators to emit implementations of [`Debug`].
5149 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5150   methods that convert case, following Unicode case mapping.
5151 * It is now easier to handle poisoned locks. The [`PoisonError`]
5152   type, returned by failing lock operations, exposes `into_inner`,
5153   `get_ref`, and `get_mut`, which all give access to the inner lock
5154   guard, and allow the poisoned lock to continue to operate. The
5155   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5156   poisoned lock without attempting to take the lock.
5157 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5158   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5159   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5160   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5161   `ChildStderr`.
5162 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5163   malformed input.
5164
5165 Misc
5166 ----
5167
5168 * `rustc` employs smarter heuristics for guessing at [typos].
5169 * `rustc` emits more efficient code for [no-op conversions between
5170   unsafe pointers][nop].
5171 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5172   resulting in faster compile times and smaller code.
5173
5174 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5175 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5176 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5177 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5178 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5179 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5180 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5181 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5182 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5183 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5184 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5185 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5186 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5187 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5188 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5189 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5190 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5191 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5192 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5193 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5194 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5195 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5196 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5197 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5198 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5199 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5200 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5201 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5202 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5203 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5204 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5205 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5206 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5207 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5208 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5209 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5210 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5211 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5212 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5213 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5214 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5215 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5216 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5217 [align]: https://github.com/rust-lang/rust/pull/25646
5218 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5219 [typos]: https://github.com/rust-lang/rust/pull/26087
5220 [nop]: https://github.com/rust-lang/rust/pull/26336
5221 [fat]: https://github.com/rust-lang/rust/pull/26411
5222 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5223 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5224 [packed]: https://github.com/rust-lang/rust/pull/25541
5225 [ad]: https://github.com/rust-lang/rust/pull/27382
5226 [win]: https://github.com/rust-lang/rust/pull/25350
5227
5228 Version 1.1.0 (2015-06-25)
5229 =========================
5230
5231 * ~850 changes, numerous bugfixes
5232
5233 Highlights
5234 ----------
5235
5236 * The [`std::fs` module has been expanded][fs] to expand the set of
5237   functionality exposed:
5238   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5239     don't incur a syscall on some platforms.
5240   * A `symlink_metadata` function has been added.
5241   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5242     access to all underlying information.
5243 * The compiler now contains extended explanations of many errors. When an error
5244   with an explanation occurs the compiler suggests using the `--explain` flag
5245   to read the explanation. Error explanations are also [available online][err-index].
5246 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5247   well as other work, the time to bootstrap the compiler decreased by
5248   32%.
5249
5250 Libraries
5251 ---------
5252
5253 * The [`str::split_whitespace`] method splits a string on unicode
5254   whitespace boundaries.
5255 * On both Windows and Unix, new extension traits provide conversion of
5256   I/O types to and from the underlying system handles. On Unix, these
5257   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5258   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5259   `TcpListener`, and `UpdSocket`. Further implementations for
5260   `std::process` will be stabilized later.
5261 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5262   Windows, symlinks can be created with
5263   `std::os::windows::symlink_dir` and
5264   `std::os::windows::symlink_file`.
5265 * The `mpsc::Receiver` type can now be converted into an iterator with
5266   `into_iter` on the [`IntoIterator`] trait.
5267 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5268   implementation of the [`From`] trait.
5269 * The `Debug` implementation for `RangeFull` [creates output that is
5270   more consistent with other implementations][rf].
5271 * [`Debug` is implemented for `File`][file].
5272 * The `Default` implementation for `Arc` [no longer requires `Sync +
5273   Send`][arc].
5274 * [The `Iterator` methods `count`, `nth`, and `last` have been
5275   overridden for slices to have O(1) performance instead of O(n)][si].
5276 * Incorrect handling of paths on Windows has been improved in both the
5277   compiler and the standard library.
5278 * [`AtomicPtr` gained a `Default` implementation][ap].
5279 * In accordance with Rust's policy on arithmetic overflow `abs` now
5280   [panics on overflow when debug assertions are enabled][abs].
5281 * The [`Cloned`] iterator, which was accidentally left unstable for
5282   1.0 [has been stabilized][c].
5283 * The [`Incoming`] iterator, which iterates over incoming TCP
5284   connections, and which was accidentally unnamable in 1.0, [is now
5285   properly exported][inc].
5286 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5287   `sift_up` or `sift_down` panic][bh].
5288 * The [`split_off`] method of `LinkedList` [no longer corrupts
5289   the list in certain scenarios][ll].
5290
5291 Misc
5292 ----
5293
5294 * Type checking performance [has improved notably][sk] with
5295   [multiple improvements][pre].
5296 * The compiler [suggests code changes][ch] for more errors.
5297 * rustc and it's build system have experimental support for [building
5298   toolchains against MUSL][m] instead of glibc on Linux.
5299 * The compiler defines the `target_env` cfg value, which is used for
5300   distinguishing toolchains that are otherwise for the same
5301   platform. Presently this is set to `gnu` for common GNU Linux
5302   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5303 * The [`cargo rustc`][crc] command invokes a build with custom flags
5304   to rustc.
5305 * [Android executables are always position independent][pie].
5306 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5307   with `Drop`][drop].
5308
5309 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5310 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5311 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5312 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5313 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5314 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5315 [rf]: https://github.com/rust-lang/rust/pull/24491
5316 [err-index]: https://doc.rust-lang.org/error-index.html
5317 [sk]: https://github.com/rust-lang/rust/pull/24615
5318 [pre]: https://github.com/rust-lang/rust/pull/25323
5319 [file]: https://github.com/rust-lang/rust/pull/24598
5320 [ch]: https://github.com/rust-lang/rust/pull/24683
5321 [arc]: https://github.com/rust-lang/rust/pull/24695
5322 [si]: https://github.com/rust-lang/rust/pull/24701
5323 [ap]: https://github.com/rust-lang/rust/pull/24834
5324 [m]: https://github.com/rust-lang/rust/pull/24777
5325 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5326 [crc]: https://github.com/rust-lang/cargo/pull/1568
5327 [pie]: https://github.com/rust-lang/rust/pull/24953
5328 [abs]: https://github.com/rust-lang/rust/pull/25441
5329 [c]: https://github.com/rust-lang/rust/pull/25496
5330 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5331 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5332 [inc]: https://github.com/rust-lang/rust/pull/25522
5333 [bh]: https://github.com/rust-lang/rust/pull/25856
5334 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5335 [ll]: https://github.com/rust-lang/rust/pull/26022
5336 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5337 [drop]: https://github.com/rust-lang/rust/pull/24935
5338
5339 Version 1.0.0 (2015-05-15)
5340 ========================
5341
5342 * ~1500 changes, numerous bugfixes
5343
5344 Highlights
5345 ----------
5346
5347 * The vast majority of the standard library is now `#[stable]`. It is
5348   no longer possible to use unstable features with a stable build of
5349   the compiler.
5350 * Many popular crates on [crates.io] now work on the stable release
5351   channel.
5352 * Arithmetic on basic integer types now [checks for overflow in debug
5353   builds][overflow].
5354
5355 Language
5356 --------
5357
5358 * Several [restrictions have been added to trait coherence][coh] in
5359   order to make it easier for upstream authors to change traits
5360   without breaking downstream code.
5361 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5362   improve error messages and macro behavior. For example, `0b1234` is
5363   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5364 * Trait bounds [are always invariant][inv], eliminating the need for
5365   the `PhantomFn` and `MarkerTrait` lang items, which have been
5366   removed.
5367 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5368   "foo" as bar` syntax has been replaced with `extern crate foo as
5369   bar`, and Cargo now automatically translates "-" in *package* names
5370   to underscore for the crate name.
5371 * [Lifetime shadowing is an error][lt].
5372 * [`Send` no longer implies `'static`][send-rfc].
5373 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5374   `MyType::default()`.
5375 * Primitive types [now have inherent methods][prim-inherent],
5376   obviating the need for extension traits like `SliceExt`.
5377 * Methods with `Self: Sized` in their `where` clause are [considered
5378   object-safe][self-sized], allowing many extension traits like
5379   `IteratorExt` to be merged into the traits they extended.
5380 * You can now [refer to associated types][assoc-where] whose
5381   corresponding trait bounds appear only in a `where` clause.
5382 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5383   like `Send` and `Sync` are now library-defined.
5384 * A [Reflect trait][reflect] was introduced, which means that
5385   downcasting via the `Any` trait is effectively limited to concrete
5386   types. This helps retain the potentially-important "parametricity"
5387   property: generic code cannot behave differently for different type
5388   arguments except in minor ways.
5389 * The `unsafe_destructor` feature is now deprecated in favor of the
5390   [new `dropck`][dropck]. This change is a major reduction in unsafe
5391   code.
5392
5393 Libraries
5394 ---------
5395
5396 * The `thread_local` module [has been renamed to `std::thread`][th].
5397 * The methods of `IteratorExt` [have been moved to the `Iterator`
5398   trait itself][ie].
5399 * Several traits that implement Rust's conventions for type
5400   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5401   [centralized in the `std::convert` module][con].
5402 * The `FromError` trait [was removed in favor of `From`][fe].
5403 * The basic sleep function [has moved to
5404   `std::thread::sleep_ms`][slp].
5405 * The `splitn` function now takes an `n` parameter that represents the
5406   number of items yielded by the returned iterator [instead of the
5407   number of 'splits'][spl].
5408 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5409 * [Derived implementations of `PartialOrd` now order enums according
5410   to their explicitly-assigned discriminants][po].
5411 * [Methods for searching strings are generic over `Pattern`s][pat],
5412   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5413   some others.
5414 * [In method resolution, object methods are resolved before inherent
5415   methods][meth].
5416 * [`String::from_str` has been deprecated in favor of the `From` impl,
5417   `String::from`][sf].
5418 * [`io::Error` implements `Sync`][ios].
5419 * [The `words` method on `&str` has been replaced with
5420   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5421   a word?'
5422 * The new path and IO modules are complete and `#[stable]`. This
5423   was the major library focus for this cycle.
5424 * The path API was [revised][path-normalize] to normalize `.`,
5425   adjusting the tradeoffs in favor of the most common usage.
5426 * A large number of remaining APIs in `std` were also stabilized
5427   during this cycle; about 75% of the non-deprecated API surface
5428   is now stable.
5429 * The new [string pattern API][string-pattern] landed, which makes
5430   the string slice API much more internally consistent and flexible.
5431 * A new set of [generic conversion traits][conversion] replaced
5432   many existing ad hoc traits.
5433 * Generic numeric traits were [completely removed][num-traits]. This
5434   was made possible thanks to inherent methods for primitive types,
5435   and the removal gives maximal flexibility for designing a numeric
5436   hierarchy in the future.
5437 * The `Fn` traits are now related via [inheritance][fn-inherit]
5438   and provide ergonomic [blanket implementations][fn-blanket].
5439 * The `Index` and `IndexMut` traits were changed to
5440   [take the index by value][index-value], enabling code like
5441   `hash_map["string"]` to work.
5442 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5443   `Copy` data is known to be `Clone` as well.
5444
5445 Misc
5446 ----
5447
5448 * Many errors now have extended explanations that can be accessed with
5449   the `--explain` flag to `rustc`.
5450 * Many new examples have been added to the standard library
5451   documentation.
5452 * rustdoc has received a number of improvements focused on completion
5453   and polish.
5454 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5455 * Much headway was made on ecosystem-wide CI, making it possible
5456   to [compare builds for breakage][ci-compare].
5457
5458
5459 [crates.io]: http://crates.io
5460 [clo]: https://github.com/rust-lang/rust/pull/24034
5461 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5462 [con]: https://github.com/rust-lang/rust/pull/23875
5463 [cr]: https://github.com/rust-lang/rust/pull/23419
5464 [fe]: https://github.com/rust-lang/rust/pull/23879
5465 [ie]: https://github.com/rust-lang/rust/pull/23300
5466 [inv]: https://github.com/rust-lang/rust/pull/23938
5467 [ios]: https://github.com/rust-lang/rust/pull/24133
5468 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5469 [lt]: https://github.com/rust-lang/rust/pull/24057
5470 [meth]: https://github.com/rust-lang/rust/pull/24056
5471 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5472 [po]: https://github.com/rust-lang/rust/pull/24270
5473 [sf]: https://github.com/rust-lang/rust/pull/24517
5474 [slp]: https://github.com/rust-lang/rust/pull/23949
5475 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5476 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5477 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5478 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5479 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5480 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5481 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5482 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5483 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5484 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5485 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5486 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5487 [reflect]: https://github.com/rust-lang/rust/pull/23712
5488 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5489 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5490 [index-value]: https://github.com/rust-lang/rust/pull/23601
5491 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5492 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5493 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5494 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5495 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5496 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5497
5498
5499 Version 1.0.0-alpha.2 (2015-02-20)
5500 =====================================
5501
5502 * ~1300 changes, numerous bugfixes
5503
5504 * Highlights
5505
5506     * The various I/O modules were [overhauled][io-rfc] to reduce
5507       unnecessary abstractions and provide better interoperation with
5508       the underlying platform. The old `io` module remains temporarily
5509       at `std::old_io`.
5510     * The standard library now [participates in feature gating][feat],
5511       so use of unstable libraries now requires a `#![feature(...)]`
5512       attribute. The impact of this change is [described on the
5513       forum][feat-forum]. [RFC][feat-rfc].
5514
5515 * Language
5516
5517     * `for` loops [now operate on the `IntoIterator` trait][into],
5518       which eliminates the need to call `.iter()`, etc. to iterate
5519       over collections. There are some new subtleties to remember
5520       though regarding what sort of iterators various types yield, in
5521       particular that `for foo in bar { }` yields values from a move
5522       iterator, destroying the original collection. [RFC][into-rfc].
5523     * Objects now have [default lifetime bounds][obj], so you don't
5524       have to write `Box<Trait+'static>` when you don't care about
5525       storing references. [RFC][obj-rfc].
5526     * In types that implement `Drop`, [lifetimes must outlive the
5527       value][drop]. This will soon make it possible to safely
5528       implement `Drop` for types where `#[unsafe_destructor]` is now
5529       required. Read the [gorgeous RFC][drop-rfc] for details.
5530     * The fully qualified <T as Trait>::X syntax lets you set the Self
5531       type for a trait method or associated type. [RFC][ufcs-rfc].
5532     * References to types that implement `Deref<U>` now [automatically
5533       coerce to references][deref] to the dereferenced type `U`,
5534       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5535       should eliminate many unsightly uses of `&*`, as when converting
5536       from references to vectors into references to
5537       slices. [RFC][deref-rfc].
5538     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5539       `|:|`) is obsolete and closure kind is inferred from context.
5540     * [`Self` is a keyword][Self].
5541
5542 * Libraries
5543
5544     * The `Show` and `String` formatting traits [have been
5545       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5546       their related purposes. Automatically getting a string
5547       conversion to use with `format!("{:?}", something_to_debug)` is
5548       now written `#[derive(Debug)]`.
5549     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5550       OsStr}`, provide strings in platform-specific encodings for easier
5551       interop with system APIs. [RFC][osstr-rfc].
5552     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5553       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5554       creating raw pointers.
5555
5556 * Tooling
5557
5558     * Certain long error messages of the form 'expected foo found bar'
5559       are now [split neatly across multiple
5560       lines][multiline]. Examples in the PR.
5561     * On Unix Rust can be [uninstalled][un] by running
5562       `/usr/local/lib/rustlib/uninstall.sh`.
5563     * The `#[rustc_on_unimplemented]` attribute, requiring the
5564       'on_unimplemented' feature, lets rustc [display custom error
5565       messages when a trait is expected to be implemented for a type
5566       but is not][onun].
5567
5568 * Misc
5569
5570     * Rust is tested against a [LALR grammar][lalr], which parses
5571       almost all the Rust files that rustc does.
5572
5573 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5574 [close]: https://github.com/rust-lang/rust/pull/21843
5575 [deref]: https://github.com/rust-lang/rust/pull/21351
5576 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5577 [drop]: https://github.com/rust-lang/rust/pull/21972
5578 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5579 [feat]: https://github.com/rust-lang/rust/pull/21248
5580 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5581 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5582 [fmt]: https://github.com/rust-lang/rust/pull/21457
5583 [into]: https://github.com/rust-lang/rust/pull/20790
5584 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5585 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5586 [lalr]: https://github.com/rust-lang/rust/pull/21452
5587 [multiline]: https://github.com/rust-lang/rust/pull/19870
5588 [obj]: https://github.com/rust-lang/rust/pull/22230
5589 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5590 [onun]: https://github.com/rust-lang/rust/pull/20889
5591 [osstr]: https://github.com/rust-lang/rust/pull/21488
5592 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5593 [Self]: https://github.com/rust-lang/rust/pull/22158
5594 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5595 [un]: https://github.com/rust-lang/rust/pull/22256
5596
5597
5598 Version 1.0.0-alpha (2015-01-09)
5599 ==================================
5600
5601   * ~2400 changes, numerous bugfixes
5602
5603   * Highlights
5604
5605     * The language itself is considered feature complete for 1.0,
5606       though there will be many usability improvements and bugfixes
5607       before the final release.
5608     * Nearly 50% of the public API surface of the standard library has
5609       been declared 'stable'. Those interfaces are unlikely to change
5610       before 1.0.
5611     * The long-running debate over integer types has been
5612       [settled][ints]: Rust will ship with types named `isize` and
5613       `usize`, rather than `int` and `uint`, for pointer-sized
5614       integers. Guidelines will be rolled out during the alpha cycle.
5615     * Most crates that are not `std` have been moved out of the Rust
5616       distribution into the Cargo ecosystem so they can evolve
5617       separately and don't need to be stabilized as quickly, including
5618       'time', 'getopts', 'num', 'regex', and 'term'.
5619     * Documentation continues to be expanded with more API coverage, more
5620       examples, and more in-depth explanations. The guides have been
5621       consolidated into [The Rust Programming Language][trpl].
5622     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5623     * All official Rust binary installers now come with [Cargo], the
5624       Rust package manager.
5625
5626 * Language
5627
5628     * Closures have been [completely redesigned][unboxed] to be
5629       implemented in terms of traits, can now be used as generic type
5630       bounds and thus monomorphized and inlined, or via an opaque
5631       pointer (boxed) as in the old system. The new system is often
5632       referred to as 'unboxed' closures.
5633     * Traits now support [associated types][assoc], allowing families
5634       of related types to be defined together and used generically in
5635       powerful ways.
5636     * Enum variants are [namespaced by their type names][enum].
5637     * [`where` clauses][where] provide a more versatile and attractive
5638       syntax for specifying generic bounds, though the previous syntax
5639       remains valid.
5640     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5641       numeric types.
5642     * Rust [no longer has a runtime][rt] of any description, and only
5643       supports OS threads, not green threads.
5644     * At long last, Rust has been overhauled for 'dynamically-sized
5645       types' ([DST]), which integrates 'fat pointers' (object types,
5646       arrays, and `str`) more deeply into the type system, making it
5647       more consistent.
5648     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5649       `..j` that produce range types and which, when combined with the
5650       `Index` operator and multidispatch, leads to a convenient slice
5651       notation, `[i..j]`.
5652     * The new range syntax revealed an ambiguity in the fixed-length
5653       array syntax, so now fixed length arrays [are written `[T;
5654       N]`][arrays].
5655     * The `Copy` trait is no longer implemented automatically. Unsafe
5656       pointers no longer implement `Sync` and `Send` so types
5657       containing them don't automatically either. `Sync` and `Send`
5658       are now 'unsafe traits' so one can "forcibly" implement them via
5659       `unsafe impl` if a type confirms to the requirements for them
5660       even though the internals do not (e.g. structs containing unsafe
5661       pointers like `Arc`). These changes are intended to prevent some
5662       footguns and are collectively known as [opt-in built-in
5663       traits][oibit] (though `Sync` and `Send` will soon become pure
5664       library types unknown to the compiler).
5665     * Operator traits now take their operands [by value][ops], and
5666       comparison traits can use multidispatch to compare one type
5667       against multiple other types, allowing e.g. `String` to be
5668       compared with `&str`.
5669     * `if let` and `while let` are no longer feature-gated.
5670     * Rust has adopted a more [uniform syntax for escaping unicode
5671       characters][unicode].
5672     * `macro_rules!` [has been declared stable][mac]. Though it is a
5673       flawed system it is sufficiently popular that it must be usable
5674       for 1.0. Effort has gone into [future-proofing][mac-future] it
5675       in ways that will allow other macro systems to be developed in
5676       parallel, and won't otherwise impact the evolution of the
5677       language.
5678     * The prelude has been [pared back significantly][prelude] such
5679       that it is the minimum necessary to support the most pervasive
5680       code patterns, and through [generalized where clauses][where]
5681       many of the prelude extension traits have been consolidated.
5682     * Rust's rudimentary reflection [has been removed][refl], as it
5683       incurred too much code generation for little benefit.
5684     * [Struct variants][structvars] are no longer feature-gated.
5685     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5686       known as 'higher-ranked trait bounds', this crucially allows
5687       unboxed closures to work.
5688     * Macros invocations surrounded by parens or square brackets and
5689       not terminated by a semicolon are [parsed as
5690       expressions][macros], which makes expressions like `vec![1i32,
5691       2, 3].len()` work as expected.
5692     * Trait objects now implement their traits automatically, and
5693       traits that can be coerced to objects now must be [object
5694       safe][objsafe].
5695     * Automatically deriving traits is now done with `#[derive(...)]`
5696       not `#[deriving(...)]` for [consistency with other naming
5697       conventions][derive].
5698     * Importing the containing module or enum at the same time as
5699       items or variants they contain is [now done with `self` instead
5700       of `mod`][self], as in use `foo::{self, bar}`
5701     * Glob imports are no longer feature-gated.
5702     * The `box` operator and `box` patterns have been feature-gated
5703       pending a redesign. For now unique boxes should be allocated
5704       like other containers, with `Box::new`.
5705
5706 * Libraries
5707
5708     * A [series][coll1] of [efforts][coll2] to establish
5709       [conventions][coll3] for collections types has resulted in API
5710       improvements throughout the standard library.
5711     * New [APIs for error handling][err] provide ergonomic interop
5712       between error types, and [new conventions][err-conv] describe
5713       more clearly the recommended error handling strategies in Rust.
5714     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5715       it is easier to discuss failure in the context of error handling
5716       without making clarifications as to whether you are referring to
5717       the 'fail' macro or failure more generally.
5718     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5719       syscall when available.
5720     * The 'serialize' crate has been renamed 'rustc-serialize' and
5721       moved out of the distribution to Cargo. Although it is widely
5722       used now, it is expected to be superseded in the near future.
5723     * The `Show` formatter, typically implemented with
5724       `#[derive(Show)]` is [now requested with the `{:?}`
5725       specifier][show] and is intended for use by all types, for uses
5726       such as `println!` debugging. The new `String` formatter must be
5727       implemented by hand, uses the `{}` specifier, and is intended
5728       for full-fidelity conversions of things that can logically be
5729       represented as strings.
5730
5731 * Tooling
5732
5733     * [Flexible target specification][flex] allows rustc's code
5734       generation to be configured to support otherwise-unsupported
5735       platforms.
5736     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5737       respective debuggers with Rust-appropriate pretty-printing.
5738     * The Windows installation of Rust is distributed with the
5739       MinGW components currently required to link binaries on that
5740       platform.
5741
5742 * Misc
5743
5744     * Nullable enum optimizations have been extended to more types so
5745       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5746       space than the inner types themselves.
5747     * Work has begun on supporting AArch64.
5748
5749 [Cargo]: https://crates.io
5750 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5751 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5752 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5753 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5754 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5755 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5756 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5757 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5758 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5759 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5760 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5761 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5762 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5763 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5764 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5765 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5766 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5767 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5768 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5769 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5770 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5771 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5772 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5773 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5774 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5775 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5776 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5777 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5778 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5779 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5780 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5781 [trpl]: https://doc.rust-lang.org/book/index.html
5782 [rbe]: http://rustbyexample.com/
5783
5784
5785 Version 0.12.0 (2014-10-09)
5786 =============================
5787
5788   * ~1900 changes, numerous bugfixes
5789
5790   * Highlights
5791
5792     * The introductory documentation (now called The Rust Guide) has
5793       been completely rewritten, as have a number of supplementary
5794       guides.
5795     * Rust's package manager, Cargo, continues to improve and is
5796       sometimes considered to be quite awesome.
5797     * Many API's in `std` have been reviewed and updated for
5798       consistency with the in-development Rust coding
5799       guidelines. The standard library documentation tracks
5800       stabilization progress.
5801     * Minor libraries have been moved out-of-tree to the rust-lang org
5802       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5803       be installed with Cargo.
5804     * Lifetime elision allows lifetime annotations to be left off of
5805       function declarations in many common scenarios.
5806     * Rust now works on 64-bit Windows.
5807
5808   * Language
5809     * Indexing can be overloaded with the `Index` and `IndexMut`
5810       traits.
5811     * The `if let` construct takes a branch only if the `let` pattern
5812       matches, currently behind the 'if_let' feature gate.
5813     * 'where clauses', a more flexible syntax for specifying trait
5814       bounds that is more aesthetic, have been added for traits and
5815       free functions. Where clauses will in the future make it
5816       possible to constrain associated types, which would be
5817       impossible with the existing syntax.
5818     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5819       the 'slicing_syntax' feature gate, and can be overloaded with
5820       the `Slice` or `SliceMut` traits.
5821     * The syntax for matching of sub-slices has been changed to use a
5822       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5823       consistency with other uses of `..` and to future-proof
5824       potential additional uses of the syntax.
5825     * The syntax for matching inclusive ranges in patterns has changed
5826       from `0..3` to `0...4` to be consistent with the exclusive range
5827       syntax for slicing.
5828     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5829       c]`) has been put behind the 'advanced_slice_patterns' feature
5830       gate and may be removed in the future.
5831     * Components of tuples and tuple structs can be extracted using
5832       the `value.0` syntax, currently behind the `tuple_indexing`
5833       feature gate.
5834     * The `#[crate_id]` attribute is no longer supported; versioning
5835       is handled by the package manager.
5836     * Renaming crate imports are now written `extern crate foo as bar`
5837       instead of `extern crate bar = foo`.
5838     * Renaming use statements are now written `use foo as bar` instead
5839       of `use bar = foo`.
5840     * `let` and `match` bindings and argument names in macros are now
5841       hygienic.
5842     * The new, more efficient, closure types ('unboxed closures') have
5843       been added under a feature gate, 'unboxed_closures'. These will
5844       soon replace the existing closure types, once higher-ranked
5845       trait lifetimes are added to the language.
5846     * `move` has been added as a keyword, for indicating closures
5847       that capture by value.
5848     * Mutation and assignment is no longer allowed in pattern guards.
5849     * Generic structs and enums can now have trait bounds.
5850     * The `Share` trait is now called `Sync` to free up the term
5851       'shared' to refer to 'shared reference' (the default reference
5852       type.
5853     * Dynamically-sized types have been mostly implemented,
5854       unifying the behavior of fat-pointer types with the rest of the
5855       type system.
5856     * As part of dynamically-sized types, the `Sized` trait has been
5857       introduced, which qualifying types implement by default, and
5858       which type parameters expect by default. To specify that a type
5859       parameter does not need to be sized, write `<Sized? T>`. Most
5860       types are `Sized`, notable exceptions being unsized arrays
5861       (`[T]`) and trait types.
5862     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5863     * Lifetime bounds can now be applied to type parameters and object
5864       types.
5865     * The old, reference counted GC type, `Gc<T>` which was once
5866       denoted by the `@` sigil, has finally been removed. GC will be
5867       revisited in the future.
5868
5869   * Libraries
5870     * Library documentation has been improved for a number of modules.
5871     * Bit-vectors, collections::bitv has been modernized.
5872     * The url crate is deprecated in favor of
5873       http://github.com/servo/rust-url, which can be installed with
5874       Cargo.
5875     * Most I/O stream types can be cloned and subsequently closed from
5876       a different thread.
5877     * A `std::time::Duration` type has been added for use in I/O
5878       methods that rely on timers, as well as in the 'time' crate's
5879       `Timespec` arithmetic.
5880     * The runtime I/O abstraction layer that enabled the green thread
5881       scheduler to do non-thread-blocking I/O has been removed, along
5882       with the libuv-based implementation employed by the green thread
5883       scheduler. This will greatly simplify the future I/O work.
5884     * `collections::btree` has been rewritten to have a more
5885       idiomatic and efficient design.
5886
5887   * Tooling
5888     * rustdoc output now indicates the stability levels of API's.
5889     * The `--crate-name` flag can specify the name of the crate
5890       being compiled, like `#[crate_name]`.
5891     * The `-C metadata` specifies additional metadata to hash into
5892       symbol names, and `-C extra-filename` specifies additional
5893       information to put into the output filename, for use by the
5894       package manager for versioning.
5895     * debug info generation has continued to improve and should be
5896       more reliable under both gdb and lldb.
5897     * rustc has experimental support for compiling in parallel
5898       using the `-C codegen-units` flag.
5899     * rustc no longer encodes rpath information into binaries by
5900       default.
5901
5902   * Misc
5903     * Stack usage has been optimized with LLVM lifetime annotations.
5904     * Official Rust binaries on Linux are more compatible with older
5905       kernels and distributions, built on CentOS 5.10.
5906
5907
5908 Version 0.11.0 (2014-07-02)
5909 ==========================
5910
5911   * ~1700 changes, numerous bugfixes
5912
5913   * Language
5914     * ~[T] has been removed from the language. This type is superseded by
5915       the Vec<T> type.
5916     * ~str has been removed from the language. This type is superseded by
5917       the String type.
5918     * ~T has been removed from the language. This type is superseded by the
5919       Box<T> type.
5920     * @T has been removed from the language. This type is superseded by the
5921       standard library's std::gc::Gc<T> type.
5922     * Struct fields are now all private by default.
5923     * Vector indices and shift amounts are both required to be a `uint`
5924       instead of any integral type.
5925     * Byte character, byte string, and raw byte string literals are now all
5926       supported by prefixing the normal literal with a `b`.
5927     * Multiple ABIs are no longer allowed in an ABI string
5928     * The syntax for lifetimes on closures/procedures has been tweaked
5929       slightly: `<'a>|A, B|: 'b + K -> T`
5930     * Floating point modulus has been removed from the language; however it
5931       is still provided by a library implementation.
5932     * Private enum variants are now disallowed.
5933     * The `priv` keyword has been removed from the language.
5934     * A closure can no longer be invoked through a &-pointer.
5935     * The `use foo, bar, baz;` syntax has been removed from the language.
5936     * The transmute intrinsic no longer works on type parameters.
5937     * Statics now allow blocks/items in their definition.
5938     * Trait bounds are separated from objects with + instead of : now.
5939     * Objects can no longer be read while they are mutably borrowed.
5940     * The address of a static is now marked as insignificant unless the
5941       #[inline(never)] attribute is placed it.
5942     * The #[unsafe_destructor] attribute is now behind a feature gate.
5943     * Struct literals are no longer allowed in ambiguous positions such as
5944       if, while, match, and for..in.
5945     * Declaration of lang items and intrinsics are now feature-gated by
5946       default.
5947     * Integral literals no longer default to `int`, and floating point
5948       literals no longer default to `f64`. Literals must be suffixed with an
5949       appropriate type if inference cannot determine the type of the
5950       literal.
5951     * The Box<T> type is no longer implicitly borrowed to &mut T.
5952     * Procedures are now required to not capture borrowed references.
5953
5954   * Libraries
5955     * The standard library is now a "facade" over a number of underlying
5956       libraries. This means that development on the standard library should
5957       be speedier due to smaller crates, as well as a clearer line between
5958       all dependencies.
5959     * A new library, libcore, lives under the standard library's facade
5960       which is Rust's "0-assumption" library, suitable for embedded and
5961       kernel development for example.
5962     * A regex crate has been added to the standard distribution. This crate
5963       includes statically compiled regular expressions.
5964     * The unwrap/unwrap_err methods on Result require a Show bound for
5965       better error messages.
5966     * The return types of the std::comm primitives have been centralized
5967       around the Result type.
5968     * A number of I/O primitives have gained the ability to time out their
5969       operations.
5970     * A number of I/O primitives have gained the ability to close their
5971       reading/writing halves to cancel pending operations.
5972     * Reverse iterator methods have been removed in favor of `rev()` on
5973       their forward-iteration counterparts.
5974     * A bitflags! macro has been added to enable easy interop with C and
5975       management of bit flags.
5976     * A debug_assert! macro is now provided which is disabled when
5977       `--cfg ndebug` is passed to the compiler.
5978     * A graphviz crate has been added for creating .dot files.
5979     * The std::cast module has been migrated into std::mem.
5980     * The std::local_data api has been migrated from freestanding functions
5981       to being based on methods.
5982     * The Pod trait has been renamed to Copy.
5983     * jemalloc has been added as the default allocator for types.
5984     * The API for allocating memory has been changed to use proper alignment
5985       and sized deallocation
5986     * Connecting a TcpStream or binding a TcpListener is now based on a
5987       string address and a u16 port. This allows connecting to a hostname as
5988       opposed to an IP.
5989     * The Reader trait now contains a core method, read_at_least(), which
5990       correctly handles many repeated 0-length reads.
5991     * The process-spawning API is now centered around a builder-style
5992       Command struct.
5993     * The :? printing qualifier has been moved from the standard library to
5994       an external libdebug crate.
5995     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5996       have been renamed to Eq/Ord.
5997     * The select/plural methods have been removed from format!. The escapes
5998       for { and } have also changed from \{ and \} to {{ and }},
5999       respectively.
6000     * The TaskBuilder API has been re-worked to be a true builder, and
6001       extension traits for spawning native/green tasks have been added.
6002
6003   * Tooling
6004     * All breaking changes to the language or libraries now have their
6005       commit message annotated with `[breaking-change]` to allow for easy
6006       discovery of breaking changes.
6007     * The compiler will now try to suggest how to annotate lifetimes if a
6008       lifetime-related error occurs.
6009     * Debug info continues to be improved greatly with general bug fixes and
6010       better support for situations like link time optimization (LTO).
6011     * Usage of syntax extensions when cross-compiling has been fixed.
6012     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6013       -fdata-sections and --gc-sections has been enabled by default
6014     * The compiler is now stricter about where it will load module files
6015       from when a module is declared via `mod foo;`.
6016     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6017       Syntax extensions are now discovered via a "plugin registrar" type
6018       which will be extended in the future to other various plugins.
6019     * Lints have been restructured to allow for dynamically loadable lints.
6020     * A number of rustdoc improvements:
6021       * The HTML output has been visually redesigned.
6022       * Markdown is now powered by hoedown instead of sundown.
6023       * Searching heuristics have been greatly improved.
6024       * The search index has been reduced in size by a great amount.
6025       * Cross-crate documentation via `pub use` has been greatly improved.
6026       * Primitive types are now hyperlinked and documented.
6027     * Documentation has been moved from static.rust-lang.org/doc to
6028       doc.rust-lang.org
6029     * A new sandbox, play.rust-lang.org, is available for running and
6030       sharing rust code examples on-line.
6031     * Unused attributes are now more robustly warned about.
6032     * The dead_code lint now warns about unused struct fields.
6033     * Cross-compiling to iOS is now supported.
6034     * Cross-compiling to mipsel is now supported.
6035     * Stability attributes are now inherited by default and no longer apply
6036       to intra-crate usage, only inter-crate usage.
6037     * Error message related to non-exhaustive match expressions have been
6038       greatly improved.
6039
6040
6041 Version 0.10 (2014-04-03)
6042 =========================
6043
6044   * ~1500 changes, numerous bugfixes
6045
6046   * Language
6047     * A new RFC process is now in place for modifying the language.
6048     * Patterns with `@`-pointers have been removed from the language.
6049     * Patterns with unique vectors (`~[T]`) have been removed from the
6050       language.
6051     * Patterns with unique strings (`~str`) have been removed from the
6052       language.
6053     * `@str` has been removed from the language.
6054     * `@[T]` has been removed from the language.
6055     * `@self` has been removed from the language.
6056     * `@Trait` has been removed from the language.
6057     * Headers on `~` allocations which contain `@` boxes inside the type for
6058       reference counting have been removed.
6059     * The semantics around the lifetimes of temporary expressions have changed,
6060       see #3511 and #11585 for more information.
6061     * Cross-crate syntax extensions are now possible, but feature gated. See
6062       #11151 for more information. This includes both `macro_rules!` macros as
6063       well as syntax extensions such as `format!`.
6064     * New lint modes have been added, and older ones have been turned on to be
6065       warn-by-default.
6066       * Unnecessary parentheses
6067       * Uppercase statics
6068       * Camel Case types
6069       * Uppercase variables
6070       * Publicly visible private types
6071       * `#[deriving]` with raw pointers
6072     * Unsafe functions can no longer be coerced to closures.
6073     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6074     * The `#[simd]` attribute is now behind a feature gate.
6075     * Visibility is no longer allowed on `extern crate` statements, and
6076       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6077     * Trailing commas are now allowed in argument lists and tuple patterns.
6078     * The `do` keyword has been removed, it is now a reserved keyword.
6079     * Default type parameters have been implemented, but are feature gated.
6080     * Borrowed variables through captures in closures are now considered soundly.
6081     * `extern mod` is now `extern crate`
6082     * The `Freeze` trait has been removed.
6083     * The `Share` trait has been added for types that can be shared among
6084       threads.
6085     * Labels in macros are now hygienic.
6086     * Expression/statement macro invocations can be delimited with `{}` now.
6087     * Treatment of types allowed in `static mut` locations has been tweaked.
6088     * The `*` and `.` operators are now overloadable through the `Deref` and
6089       `DerefMut` traits.
6090     * `~Trait` and `proc` no longer have `Send` bounds by default.
6091     * Partial type hints are now supported with the `_` type marker.
6092     * An `Unsafe` type was introduced for interior mutability. It is now
6093       considered undefined to transmute from `&T` to `&mut T` without using the
6094       `Unsafe` type.
6095     * The #[linkage] attribute was implemented for extern statics/functions.
6096     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6097     * `Pod` was renamed to `Copy`.
6098
6099   * Libraries
6100     * The `libextra` library has been removed. It has now been decomposed into
6101       component libraries with smaller and more focused nuggets of
6102       functionality. The full list of libraries can be found on the
6103       documentation index page.
6104     * std: `std::condition` has been removed. All I/O errors are now propagated
6105       through the `Result` type. In order to assist with error handling, a
6106       `try!` macro for unwrapping errors with an early return and a lint for
6107       unused results has been added. See #12039 for more information.
6108     * std: The `vec` module has been renamed to `slice`.
6109     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6110       This will become the only growable vector in the future.
6111     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6112       are now found at `std::io::BufferedReader` instead of
6113       `std::io::buffered::BufferedReader`.
6114     * std: `print` and `println` are no longer in the prelude, the `print!` and
6115       `println!` macros are intended to be used instead.
6116     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6117       attempts to statically prevent cycles.
6118     * std: The standard distribution is adopting the policy of pushing failure
6119       to the user rather than failing in libraries. Many functions (such as
6120       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6121     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6122       deriving mode: `#[deriving(Show)]`.
6123     * std: `ToStr` is now implemented for all types implementing `Show`.
6124     * std: The formatting trait methods now take `&self` instead of `&T`
6125     * std: The `invert()` method on iterators has been renamed to `rev()`
6126     * std: `std::num` has seen a reduction in the genericity of its traits,
6127       consolidating functionality into a few core traits.
6128     * std: Backtraces are now printed on task failure if the environment
6129       variable `RUST_BACKTRACE` is present.
6130     * std: Naming conventions for iterators have been standardized. More details
6131       can be found on the wiki's style guide.
6132     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6133       still implement the function.
6134     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6135     * std: `assert_approx_eq!` has been removed
6136     * std: The `e` and `E` formatting specifiers for floats have been added to
6137       print them in exponential notation.
6138     * std: The `Times` trait has been removed
6139     * std: Indications of variance and opting out of builtin bounds is done
6140       through marker types in `std::kinds::marker` now
6141     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6142       `#[deriving(Hash)]` is now possible.
6143     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6144     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6145     * std: `Chan::new` is now `channel()`.
6146     * std: A new synchronous channel type has been implemented.
6147     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6148     * std: `hashmap` and `trie` have been moved to `libcollections`
6149     * std: `run` has been rolled into `io::process`
6150     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6151     * std: The equality and comparison traits have seen some reorganization.
6152     * std: `rand` has moved to `librand`.
6153     * std: `to_{lower,upper}case` has been implemented for `char`.
6154     * std: Logging has been moved to `liblog`.
6155     * collections: `HashMap` has been rewritten for higher performance and less
6156       memory usage.
6157     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6158       it can be booted manually. The runtime guide has more information and
6159       examples.
6160     * native: All I/O functionality except signals has been implemented.
6161     * green: Task spawning with `libgreen` has been optimized with stack caching
6162       and various trimming of code.
6163     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6164     * sync: The `extra::sync` module has been updated to modern rust (and moved
6165       to the `sync` library), tweaking and improving various interfaces while
6166       dropping redundant functionality.
6167     * sync: A new `Barrier` type has been added to the `sync` library.
6168     * sync: An efficient mutex for native and green tasks has been implemented.
6169     * serialize: The `base64` module has seen some improvement. It treats
6170       newlines better, has non-string error values, and has seen general
6171       cleanup.
6172     * fourcc: A `fourcc!` macro was introduced
6173     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6174       hexadecimal literal.
6175
6176   * Tooling
6177     * `rustpkg` has been deprecated and removed from the main repository. Its
6178       replacement, `cargo`, is under development.
6179     * Nightly builds of rust are now available
6180     * The memory usage of rustc has been improved many times throughout this
6181       release cycle.
6182     * The build process supports disabling rpath support for the rustc binary
6183       itself.
6184     * Code generation has improved in some cases, giving more information to the
6185       LLVM optimization passes to enable more extensive optimizations.
6186     * Debuginfo compatibility with lldb on OSX has been restored.
6187     * The master branch is now gated on an android bot, making building for
6188       android much more reliable.
6189     * Output flags have been centralized into one `--emit` flag.
6190     * Crate type flags have been centralized into one `--crate-type` flag.
6191     * Codegen flags have been consolidated behind a `-C` flag.
6192     * Linking against outdated crates now has improved error messages.
6193     * Error messages with lifetimes will often suggest how to annotate the
6194       function to fix the error.
6195     * Many more types are documented in the standard library, and new guides
6196       were written.
6197     * Many `rustdoc` improvements:
6198       * code blocks are syntax highlighted.
6199       * render standalone markdown files.
6200       * the --test flag tests all code blocks by default.
6201       * exported macros are displayed.
6202       * re-exported types have their documentation inlined at the location of the
6203         first re-export.
6204       * search works across crates that have been rendered to the same output
6205         directory.
6206
6207
6208 Version 0.9 (2014-01-09)
6209 ==========================
6210
6211    * ~1800 changes, numerous bugfixes
6212
6213    * Language
6214       * The `float` type has been removed. Use `f32` or `f64` instead.
6215       * A new facility for enabling experimental features (feature gating) has
6216         been added, using the crate-level `#[feature(foo)]` attribute.
6217       * Managed boxes (@) are now behind a feature gate
6218         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6219         standard library's `Gc` or `Rc` types instead.
6220       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6221       * Jumping back to the top of a loop is now done with `continue` instead of
6222         `loop`.
6223       * Strings can no longer be mutated through index assignment.
6224       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6225         hash delimiters, as in `r###"foo"###`.
6226       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6227         called once.
6228       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6229       * `@fn`s have been removed.
6230       * `do` only works with procs in order to make it obvious what the cost
6231         of `do` is.
6232       * Single-element tuple-like structs can no longer be dereferenced to
6233         obtain the inner value. A more comprehensive solution for overloading
6234         the dereference operator will be provided in the future.
6235       * The `#[link(...)]` attribute has been replaced with
6236         `#[crate_id = "name#vers"]`.
6237       * Empty `impl`s must be terminated with empty braces and may not be
6238         terminated with a semicolon.
6239       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6240         no longer has any special meaning.
6241       * The old `fmt!` string formatting macro has been removed.
6242       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6243         `print!` and `println!`.
6244       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6245       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6246         `extern mod foo = "bar"` instead.
6247       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6248       * Macros can have attributes.
6249       * Macros can expand to items with attributes.
6250       * Macros can expand to multiple items.
6251       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6252       * Comments may be nested.
6253       * Values automatically coerce to trait objects they implement, without
6254         an explicit `as`.
6255       * Enum discriminants are no longer an entire word but as small as needed to
6256         contain all the variants. The `repr` attribute can be used to override
6257         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6258         `#[repr(C)]` to match C enums.
6259       * Non-string literals are not allowed in attributes (they never worked).
6260       * The FFI now supports variadic functions.
6261       * Octal numeric literals, as in `0o7777`.
6262       * The `concat!` syntax extension performs compile-time string concatenation.
6263       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6264         removed as Rust no longer uses segmented stacks.
6265       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6266       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6267         not `*`; ignoring remaining fields of a struct is also done with `..`,
6268         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6269       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6270       * `rustc` supports the "system" calling convention, which defaults to the
6271         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6272         "C" elsewhere.
6273       * The `type_overflow` lint (default: warn) checks literals for overflow.
6274       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6275       * The `attribute_usage` lint (default: warn) warns about unknown
6276         attributes.
6277       * The `unknown_features` lint (default: warn) warns about unknown
6278         feature gates.
6279       * The `dead_code` lint (default: warn) checks for dead code.
6280       * Rust libraries can be linked statically to one another
6281       * `#[link_args]` is behind the `link_args` feature gate.
6282       * Native libraries are now linked with `#[link(name = "foo")]`
6283       * Native libraries can be statically linked to a rust crate
6284         (`#[link(name = "foo", kind = "static")]`).
6285       * Native OS X frameworks are now officially supported
6286         (`#[link(name = "foo", kind = "framework")]`).
6287       * The `#[thread_local]` attribute creates thread-local (not task-local)
6288         variables. Currently behind the `thread_local` feature gate.
6289       * The `return` keyword may be used in closures.
6290       * Types that can be copied via a memcpy implement the `Pod` kind.
6291       * The `cfg` attribute can now be used on struct fields and enum variants.
6292
6293    * Libraries
6294       * std: The `option` and `result` API's have been overhauled to make them
6295         simpler, more consistent, and more composable.
6296       * std: The entire `std::io` module has been replaced with one that is
6297         more comprehensive and that properly interfaces with the underlying
6298         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6299         implemented.
6300       * std: `io::util` contains a number of useful implementations of
6301         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6302         `ZeroReader`, `TeeReader`.
6303       * std: The reference counted pointer type `extra::rc` moved into std.
6304       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6305         just a wrapper around it).
6306       * std: The `Either` type has been removed.
6307       * std: `fmt::Default` can be implemented for any type to provide default
6308         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6309       * std: The `rand` API continues to be tweaked.
6310       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6311         on failure in gdb, is now named `rust_fail`.
6312       * std: The `each_key` and `each_value` methods on `HashMap` have been
6313         replaced by the `keys` and `values` iterators.
6314       * std: Functions dealing with type size and alignment have moved from the
6315         `sys` module to the `mem` module.
6316       * std: The `path` module was written and API changed.
6317       * std: `str::from_utf8` has been changed to cast instead of allocate.
6318       * std: `starts_with` and `ends_with` methods added to vectors via the
6319         `ImmutableEqVector` trait, which is in the prelude.
6320       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6321         if the index is out of bounds.
6322       * std: Task failure no longer propagates between tasks, as the model was
6323         complex, expensive, and incompatible with thread-based tasks.
6324       * std: The `Any` type can be used for dynamic typing.
6325       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6326         `task::try`.
6327       * std: Methods that produce iterators generally do not have an `_iter`
6328         suffix now.
6329       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6330         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6331       * std: `util::ignore` renamed to `prelude::drop`.
6332       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6333         trait.
6334       * std: `vec::raw` has seen a lot of cleanup and API changes.
6335       * std: The standard library no longer includes any C++ code, and very
6336         minimal C, eliminating the dependency on libstdc++.
6337       * std: Runtime scheduling and I/O functionality has been factored out into
6338         extensible interfaces and is now implemented by two different crates:
6339         libnative, for native threading and I/O; and libgreen, for green threading
6340         and I/O. This paves the way for using the standard library in more limited
6341         embedded environments.
6342       * std: The `comm` module has been rewritten to be much faster, have a
6343         simpler, more consistent API, and to work for both native and green
6344         threading.
6345       * std: All libuv dependencies have been moved into the rustuv crate.
6346       * native: New implementations of runtime scheduling on top of OS threads.
6347       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6348         and other I/O.
6349       * green: The green thread scheduler and message passing types are almost
6350         entirely lock-free.
6351       * extra: The `flatpipes` module had bitrotted and was removed.
6352       * extra: All crypto functions have been removed and Rust now has a policy of
6353         not reimplementing crypto in the standard library. In the future crypto
6354         will be provided by external crates with bindings to established libraries.
6355       * extra: `c_vec` has been modernized.
6356       * extra: The `sort` module has been removed. Use the `sort` method on
6357         mutable slices.
6358
6359    * Tooling
6360       * The `rust` and `rusti` commands have been removed, due to lack of
6361         maintenance.
6362       * `rustdoc` was completely rewritten.
6363       * `rustdoc` can test code examples in documentation.
6364       * `rustpkg` can test packages with the argument, 'test'.
6365       * `rustpkg` supports arbitrary dependencies, including C libraries.
6366       * `rustc`'s support for generating debug info is improved again.
6367       * `rustc` has better error reporting for unbalanced delimiters.
6368       * `rustc`'s JIT support was removed due to bitrot.
6369       * Executables and static libraries can be built with LTO (-Z lto)
6370       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6371         build tools.
6372
6373
6374 Version 0.8 (2013-09-26)
6375 ============================
6376
6377    * ~2200 changes, numerous bugfixes
6378
6379    * Language
6380       * The `for` loop syntax has changed to work with the `Iterator` trait.
6381       * At long last, unwinding works on Windows.
6382       * Default methods are ready for use.
6383       * Many trait inheritance bugs fixed.
6384       * Owned and borrowed trait objects work more reliably.
6385       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6386       * rustc can omit emission of code for the `debug!` macro if it is passed
6387         `--cfg ndebug`
6388       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6389         for foo.rs, then foo/mod.rs, and will generate an error when both are
6390         present.
6391       * Strings no longer contain trailing nulls. The new `std::c_str` module
6392         provides new mechanisms for converting to C strings.
6393       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6394       * The FFI has been overhauled such that foreign functions are called directly,
6395         instead of through a stack-switching wrapper.
6396       * Calling a foreign function must be done through a Rust function with the
6397         `#[fixed_stack_segment]` attribute.
6398       * The `externfn!` macro can be used to declare both a foreign function and
6399         a `#[fixed_stack_segment]` wrapper at once.
6400       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6401       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6402       * `priv` is disallowed everywhere except for struct fields and enum variants.
6403       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6404       * `ref` bindings in irrefutable patterns work correctly now.
6405       * `char` is now prevented from containing invalid code points.
6406       * Casting to `bool` is no longer allowed.
6407       * `\0` is now accepted as an escape in chars and strings.
6408       * `yield` is a reserved keyword.
6409       * `typeof` is a reserved keyword.
6410       * Crates may be imported by URL with `extern mod foo = "url";`.
6411       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6412       * Static vectors can be initialized with repeating elements,
6413         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6414       * Static structs can be initialized with functional record update,
6415         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6416       * `cfg!` can be used to conditionally execute code based on the crate
6417         configuration, similarly to `#[cfg(...)]`.
6418       * The `unnecessary_qualification` lint detects unneeded module
6419         prefixes (default: allow).
6420       * Arithmetic operations have been implemented on the SIMD types in
6421         `std::unstable::simd`.
6422       * Exchange allocation headers were removed, reducing memory usage.
6423       * `format!` implements a completely new, extensible, and higher-performance
6424         string formatting system. It will replace `fmt!`.
6425       * `print!` and `println!` write formatted strings (using the `format!`
6426         extension) to stdout.
6427       * `write!` and `writeln!` write formatted strings (using the `format!`
6428         extension) to the new Writers in `std::rt::io`.
6429       * The library section in which a function or static is placed may
6430         be specified with `#[link_section = "..."]`.
6431       * The `proto!` syntax extension for defining bounded message protocols
6432         was removed.
6433       * `macro_rules!` is hygienic for `let` declarations.
6434       * The `#[export_name]` attribute specifies the name of a symbol.
6435       * `unreachable!` can be used to indicate unreachable code, and fails
6436         if executed.
6437
6438    * Libraries
6439       * std: Transitioned to the new runtime, written in Rust.
6440       * std: Added an experimental I/O library, `rt::io`, based on the new
6441         runtime.
6442       * std: A new generic `range` function was added to the prelude, replacing
6443         `uint::range` and friends.
6444       * std: `range_rev` no longer exists. Since range is an iterator it can be
6445         reversed with `range(lo, hi).invert()`.
6446       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6447         renamed to `unwrap_or`.
6448       * std: The `iterator` module was renamed to `iter`.
6449       * std: Integral types now support the `checked_add`, `checked_sub`, and
6450         `checked_mul` operations for detecting overflow.
6451       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6452         consistency.
6453       * std: Methods are standardizing on conventions for casting methods:
6454         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6455         and cheap casts.
6456       * std: The `CString` type in `c_str` provides new ways to convert to and
6457         from C strings.
6458       * std: `DoubleEndedIterator` can yield elements in two directions.
6459       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6460         two splices.
6461       * std: `str::from_bytes` renamed to `str::from_utf8`.
6462       * std: `pop_opt` and `shift_opt` methods added to vectors.
6463       * std: The task-local data interface no longer uses @, and keys are
6464         no longer function pointers.
6465       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6466       * std: Added `SharedPort` to `comm`.
6467       * std: `Eq` has a default method for `ne`; only `eq` is required
6468         in implementations.
6469       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6470         is required in implementations.
6471       * std: `is_utf8` performance is improved, impacting many string functions.
6472       * std: `os::MemoryMap` provides cross-platform mmap.
6473       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6474         are not 'in-bounds' are considered undefined.
6475       * std: Many freestanding functions in `vec` removed in favor of methods.
6476       * std: Many freestanding functions on scalar types removed in favor of
6477         methods.
6478       * std: Many options to task builders were removed since they don't make
6479         sense in the new scheduler design.
6480       * std: More containers implement `FromIterator` so can be created by the
6481         `collect` method.
6482       * std: More complete atomic types in `unstable::atomics`.
6483       * std: `comm::PortSet` removed.
6484       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6485         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6486         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6487         default implementations.
6488       * std: Various `from_str` functions were removed in favor of a generic
6489         `from_str` which is available in the prelude.
6490       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6491       * extra: `dlist`, the doubly-linked list was modernized.
6492       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6493       * extra: Added `glob` module, replacing `std::os::glob`.
6494       * extra: `rope` was removed.
6495       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6496       * extra: `net`, and `timer` were removed. The experimental replacements
6497         are `std::rt::io::net` and `std::rt::io::timer`.
6498       * extra: Iterators implemented for `SmallIntMap`.
6499       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6500       * extra: `SmallIntSet` removed. Use `BitvSet`.
6501       * extra: Performance of JSON parsing greatly improved.
6502       * extra: `semver` updated to SemVer 2.0.0.
6503       * extra: `term` handles more terminals correctly.
6504       * extra: `dbg` module removed.
6505       * extra: `par` module removed.
6506       * extra: `future` was cleaned up, with some method renames.
6507       * extra: Most free functions in `getopts` were converted to methods.
6508
6509    * Other
6510       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6511       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6512         similarly to gcc's `--march` flag.
6513       * rustc's performance compiling small crates is much better.
6514       * rustpkg has received many improvements.
6515       * rustpkg supports git tags as package IDs.
6516       * rustpkg builds into target-specific directories so it can be used for
6517         cross-compiling.
6518       * The number of concurrent test tasks is controlled by the environment
6519         variable RUST_TEST_TASKS.
6520       * The test harness can now report metrics for benchmarks.
6521       * All tools have man pages.
6522       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6523       * The runtime uses jemalloc for allocations.
6524       * Segmented stacks are temporarily disabled as part of the transition to
6525         the new runtime. Stack overflows are possible!
6526       * A new documentation backend, rustdoc_ng, is available for use. It is
6527         still invoked through the normal `rustdoc` command.
6528
6529
6530 Version 0.7 (2013-07-03)
6531 =======================
6532
6533    * ~2000 changes, numerous bugfixes
6534
6535    * Language
6536       * `impl`s no longer accept a visibility qualifier. Put them on methods
6537         instead.
6538       * The borrow checker has been rewritten with flow-sensitivity, fixing
6539         many bugs and inconveniences.
6540       * The `self` parameter no longer implicitly means `&'self self`,
6541         and can be explicitly marked with a lifetime.
6542       * Overloadable compound operators (`+=`, etc.) have been temporarily
6543         removed due to bugs.
6544       * The `for` loop protocol now requires `for`-iterators to return `bool`
6545         so they compose better.
6546       * The `Durable` trait is replaced with the `'static` bounds.
6547       * Trait default methods work more often.
6548       * Structs with the `#[packed]` attribute have byte alignment and
6549         no padding between fields.
6550       * Type parameters bound by `Copy` must now be copied explicitly with
6551         the `copy` keyword.
6552       * It is now illegal to move out of a dereferenced unsafe pointer.
6553       * `Option<~T>` is now represented as a nullable pointer.
6554       * `@mut` does dynamic borrow checks correctly.
6555       * The `main` function is only detected at the topmost level of the crate.
6556         The `#[main]` attribute is still valid anywhere.
6557       * Struct fields may no longer be mutable. Use inherited mutability.
6558       * The `#[no_send]` attribute makes a type that would otherwise be
6559         `Send`, not.
6560       * The `#[no_freeze]` attribute makes a type that would otherwise be
6561         `Freeze`, not.
6562       * Unbounded recursion will abort the process after reaching the limit
6563         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6564       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6565         are never implicitly copyable.
6566       * `#[static_assert]` makes compile-time assertions about static bools.
6567       * At long last, 'argument modes' no longer exist.
6568       * The rarely used `use mod` statement no longer exists.
6569
6570    * Syntax extensions
6571       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6572         argument list.
6573       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6574         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6575         `#[deriving(...)]`.
6576       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6577         and unsuffixed integer literals.
6578
6579    * Libraries
6580       * The `core` crate was renamed to `std`.
6581       * The `std` crate was renamed to `extra`.
6582       * More and improved documentation.
6583       * std: `iterator` module for external iterator objects.
6584       * Many old-style (internal, higher-order function) iterators replaced by
6585         implementations of `Iterator`.
6586       * std: Many old internal vector and string iterators,
6587         incl. `any`, `all`. removed.
6588       * std: The `finalize` method of `Drop` renamed to `drop`.
6589       * std: The `drop` method now takes `&mut self` instead of `&self`.
6590       * std: The prelude no longer re-exports any modules, only types and traits.
6591       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6592         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6593       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6594         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6595       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6596         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6597       * std: Many types implement `Clone`.
6598       * std: `path` type renamed to `Path`.
6599       * std: `mut` module and `Mut` type removed.
6600       * std: Many standalone functions removed in favor of methods and iterators
6601         in `vec`, `str`. In the future methods will also work as functions.
6602       * std: `reinterpret_cast` removed. Use `transmute`.
6603       * std: ascii string handling in `std::ascii`.
6604       * std: `Rand` is implemented for ~/@.
6605       * std: `run` module for spawning processes overhauled.
6606       * std: Various atomic types added to `unstable::atomic`.
6607       * std: Various types implement `Zero`.
6608       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6609       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6610       * std: Added `os::mkdir_recursive`.
6611       * std: Added `os::glob` function performs filesystems globs.
6612       * std: `FuzzyEq` renamed to `ApproxEq`.
6613       * std: `Map` now defines `pop` and `swap` methods.
6614       * std: `Cell` constructors converted to static methods.
6615       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6616       * extra: `flate` module moved from `std` to `extra`.
6617       * extra: `fileinput` module for iterating over a series of files.
6618       * extra: `Complex` number type and `complex` module.
6619       * extra: `Rational` number type and `rational` module.
6620       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6621       * extra: `term` uses terminfo now, is more correct.
6622       * extra: `arc` functions converted to methods.
6623       * extra: Implementation of fixed output size variations of SHA-2.
6624
6625    * Tooling
6626       * `unused_variable`  lint mode for unused variables (default: warn).
6627       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6628         (default: warn).
6629       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6630         (default: warn).
6631       * `dead_assignment` lint mode for unread variables (default: warn).
6632       * `unnecessary_allocation` lint mode detects some heap allocations that are
6633         immediately borrowed so could be written without allocating (default: warn).
6634       * `missing_doc` lint mode (default: allow).
6635       * `unreachable_code` lint mode (default: warn).
6636       * The `rusti` command has been rewritten and a number of bugs addressed.
6637       * rustc outputs in color on more terminals.
6638       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6639       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6640       * Compiling with `-g` will make the binary record information about
6641         dynamic borrowcheck failures for debugging.
6642       * rustdoc has a nicer stylesheet.
6643       * Various improvements to rustdoc.
6644       * Improvements to rustpkg (see the detailed release notes).
6645
6646
6647 Version 0.6 (2013-04-03)
6648 ========================
6649
6650    * ~2100 changes, numerous bugfixes
6651
6652    * Syntax changes
6653       * The self type parameter in traits is now spelled `Self`
6654       * The `self` parameter in trait and impl methods must now be explicitly
6655         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6656       * Static methods no longer require the `static` keyword and instead
6657         are distinguished by the lack of a `self` parameter
6658       * Replaced the `Durable` trait with the `'static` lifetime
6659       * The old closure type syntax with the trailing sigil has been
6660         removed in favor of the more consistent leading sigil
6661       * `super` is a keyword, and may be prefixed to paths
6662       * Trait bounds are separated with `+` instead of whitespace
6663       * Traits are implemented with `impl Trait for Type`
6664         instead of `impl Type: Trait`
6665       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6666       * The `export` keyword has finally been removed
6667       * The `move` keyword has been removed (see "Semantic changes")
6668       * The interior mutability qualifier on vectors, `[mut T]`, has been
6669         removed. Use `&mut [T]`, etc.
6670       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6671       * `fail` is no longer a keyword. Use `fail!()`
6672       * `assert` is no longer a keyword. Use `assert!()`
6673       * `log` is no longer a keyword. use `debug!`, etc.
6674       * 1-tuples may be represented as `(T,)`
6675       * Struct fields may no longer be `mut`. Use inherited mutability,
6676         `@mut T`, `core::mut` or `core::cell`
6677       * `extern mod { ... }` is no longer valid syntax for foreign
6678         function modules. Use extern blocks: `extern { ... }`
6679       * Newtype enums removed. Use tuple-structs.
6680       * Trait implementations no longer support visibility modifiers
6681       * Pattern matching over vectors improved and expanded
6682       * `const` renamed to `static` to correspond to lifetime name,
6683         and make room for future `static mut` unsafe mutable globals.
6684       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6685       * `Clone` implementations can be automatically generated with
6686         `#[deriving(Clone)]`
6687       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6688         instead of `foo as Bar`.
6689       * Fixed length vector types are now written as `[int, .. 3]`
6690         instead of `[int * 3]`.
6691       * Fixed length vector types can express the length as a constant
6692         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6693
6694    * Semantic changes
6695       * Types with owned pointers or custom destructors move by default,
6696         eliminating the `move` keyword
6697       * All foreign functions are considered unsafe
6698       * &mut is now unaliasable
6699       * Writes to borrowed @mut pointers are prevented dynamically
6700       * () has size 0
6701       * The name of the main function can be customized using #[main]
6702       * The default type of an inferred closure is &fn instead of @fn
6703       * `use` statements may no longer be "chained" - they cannot import
6704         identifiers imported by previous `use` statements
6705       * `use` statements are crate relative, importing from the "top"
6706         of the crate by default. Paths may be prefixed with `super::`
6707         or `self::` to change the search behavior.
6708       * Method visibility is inherited from the implementation declaration
6709       * Structural records have been removed
6710       * Many more types can be used in static items, including enums
6711         'static-lifetime pointers and vectors
6712       * Pattern matching over vectors improved and expanded
6713       * Typechecking of closure types has been overhauled to
6714         improve inference and eliminate unsoundness
6715       * Macros leave scope at the end of modules, unless that module is
6716         tagged with #[macro_escape]
6717
6718    * Libraries
6719       * Added big integers to `std::bigint`
6720       * Removed `core::oldcomm` module
6721       * Added pipe-based `core::comm` module
6722       * Numeric traits have been reorganized under `core::num`
6723       * `vec::slice` finally returns a slice
6724       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6725       * Containers reorganized around traits in `core::container`
6726       * `core::dvec` removed, `~[T]` is a drop-in replacement
6727       * `core::send_map` renamed to `core::hashmap`
6728       * `std::map` removed; replaced with `core::hashmap`
6729       * `std::treemap` reimplemented as an owned balanced tree
6730       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6731       * `core::trie` added as a fast ordered map for integer keys
6732       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6733       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6734         overload the comparison operators, whereas `TotalOrd` is used
6735         by certain container types
6736
6737    * Other
6738       * Replaced the 'cargo' package manager with 'rustpkg'
6739       * Added all-purpose 'rust' tool
6740       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6741       * rustc now *attempts* to offer spelling suggestions
6742       * Improved support for ARM and Android
6743       * Preliminary MIPS backend
6744       * Improved foreign function ABI implementation for x86, x86_64
6745       * Various memory usage improvements
6746       * Rust code may be embedded in foreign code under limited circumstances
6747       * Inline assembler supported by new asm!() syntax extension.
6748
6749
6750 Version 0.5 (2012-12-21)
6751 ===========================
6752
6753    * ~900 changes, numerous bugfixes
6754
6755    * Syntax changes
6756       * Removed `<-` move operator
6757       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6758       * Removed old fixed length vector syntax - `[T]/N`
6759       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6760       * Macros may now expand to items and statements
6761       * `a.b()` is always parsed as a method call, never as a field projection
6762       * `Eq` and `IterBytes` implementations can be automatically generated
6763         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6764       * Removed the special crate language for `.rc` files
6765       * Function arguments may consist of any irrefutable pattern
6766
6767    * Semantic changes
6768       * `&` and `~` pointers may point to objects
6769       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6770       * Enum variants may be structs
6771       * Destructors can be added to all nominal types with the Drop trait
6772       * Structs and nullary enum variants may be constants
6773       * Values that cannot be implicitly copied are now automatically moved
6774         without writing `move` explicitly
6775       * `&T` may now be coerced to `*T`
6776       * Coercions happen in `let` statements as well as function calls
6777       * `use` statements now take crate-relative paths
6778       * The module and type namespaces have been merged so that static
6779         method names can be resolved under the trait in which they are
6780         declared
6781
6782    * Improved support for language features
6783       * Trait inheritance works in many scenarios
6784       * More support for explicit self arguments in methods - `self`, `&self`
6785         `@self`, and `~self` all generally work as expected
6786       * Static methods work in more situations
6787       * Experimental: Traits may declare default methods for the implementations
6788         to use
6789
6790    * Libraries
6791       * New condition handling system in `core::condition`
6792       * Timsort added to `std::sort`
6793       * New priority queue, `std::priority_queue`
6794       * Pipes for serializable types, `std::flatpipes'
6795       * Serialization overhauled to be trait-based
6796       * Expanded `getopts` definitions
6797       * Moved futures to `std`
6798       * More functions are pure now
6799       * `core::comm` renamed to `oldcomm`. Still deprecated
6800       * `rustdoc` and `cargo` are libraries now
6801
6802    * Misc
6803       * Added a preliminary REPL, `rusti`
6804       * License changed from MIT to dual MIT/APL2
6805
6806
6807 Version 0.4 (2012-10-15)
6808 ==========================
6809
6810    * ~2000 changes, numerous bugfixes
6811
6812    * Syntax
6813       * All keywords are now strict and may not be used as identifiers anywhere
6814       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6815         'of', 'with', 'to', 'class'.
6816       * Classes are replaced with simpler structs
6817       * Explicit method self types
6818       * `ret` became `return` and `alt` became `match`
6819       * `import` is now `use`; `use is now `extern mod`
6820       * `extern mod { ... }` is now `extern { ... }`
6821       * `use mod` is the recommended way to import modules
6822       * `pub` and `priv` replace deprecated export lists
6823       * The syntax of `match` pattern arms now uses fat arrow (=>)
6824       * `main` no longer accepts an args vector; use `os::args` instead
6825
6826    * Semantics
6827       * Trait implementations are now coherent, ala Haskell typeclasses
6828       * Trait methods may be static
6829       * Argument modes are deprecated
6830       * Borrowed pointers are much more mature and recommended for use
6831       * Strings and vectors in the static region are stored in constant memory
6832       * Typestate was removed
6833       * Resolution rewritten to be more reliable
6834       * Support for 'dual-mode' data structures (freezing and thawing)
6835
6836    * Libraries
6837       * Most binary operators can now be overloaded via the traits in
6838         `core::ops'
6839       * `std::net::url` for representing URLs
6840       * Sendable hash maps in `core::send_map`
6841       * `core::task' gained a (currently unsafe) task-local storage API
6842
6843    * Concurrency
6844       * An efficient new intertask communication primitive called the pipe,
6845         along with a number of higher-level channel types, in `core::pipes`
6846       * `std::arc`, an atomically reference counted, immutable, shared memory
6847         type
6848       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6849       * Futures are now based on pipes and sendable
6850       * More robust linked task failure
6851       * Improved task builder API
6852
6853    * Other
6854       * Improved error reporting
6855       * Preliminary JIT support
6856       * Preliminary work on precise GC
6857       * Extensive architectural improvements to rustc
6858       * Begun a transition away from buggy C++-based reflection (shape) code to
6859         Rust-based (visitor) code
6860       * All hash functions and tables converted to secure, randomized SipHash
6861
6862
6863 Version 0.3  (2012-07-12)
6864 ========================
6865
6866    * ~1900 changes, numerous bugfixes
6867
6868    * New coding conveniences
6869       * Integer-literal suffix inference
6870       * Per-item control over warnings, errors
6871       * #[cfg(windows)] and #[cfg(unix)] attributes
6872       * Documentation comments
6873       * More compact closure syntax
6874       * 'do' expressions for treating higher-order functions as
6875         control structures
6876       * *-patterns (wildcard extended to all constructor fields)
6877
6878    * Semantic cleanup
6879       * Name resolution pass and exhaustiveness checker rewritten
6880       * Region pointers and borrow checking supersede alias
6881         analysis
6882       * Init-ness checking is now provided by a region-based liveness
6883         pass instead of the typestate pass; same for last-use analysis
6884       * Extensive work on region pointers
6885
6886    * Experimental new language features
6887       * Slices and fixed-size, interior-allocated vectors
6888       * #!-comments for lang versioning, shell execution
6889       * Destructors and iface implementation for classes;
6890         type-parameterized classes and class methods
6891       * 'const' type kind for types that can be used to implement
6892         shared-memory concurrency patterns
6893
6894    * Type reflection
6895
6896    * Removal of various obsolete features
6897       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6898                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6899
6900       * Constructs: do-while loops ('do' repurposed), fn binding,
6901                     resources (replaced by destructors)
6902
6903    * Compiler reorganization
6904       * Syntax-layer of compiler split into separate crate
6905       * Clang (from LLVM project) integrated into build
6906       * Typechecker split into sub-modules
6907
6908    * New library code
6909       * New time functions
6910       * Extension methods for many built-in types
6911       * Arc: atomic-refcount read-only / exclusive-use shared cells
6912       * Par: parallel map and search routines
6913       * Extensive work on libuv interface
6914       * Much vector code moved to libraries
6915       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6916         #include, #include_str, #include_bin
6917
6918    * Tool improvements
6919       * Cargo automatically resolves dependencies
6920
6921
6922 Version 0.2  (2012-03-29)
6923 =========================
6924
6925    * >1500 changes, numerous bugfixes
6926
6927    * New docs and doc tooling
6928
6929    * New port: FreeBSD x86_64
6930
6931    * Compilation model enhancements
6932       * Generics now specialized, multiply instantiated
6933       * Functions now inlined across separate crates
6934
6935    * Scheduling, stack and threading fixes
6936       * Noticeably improved message-passing performance
6937       * Explicit schedulers
6938       * Callbacks from C
6939       * Helgrind clean
6940
6941    * Experimental new language features
6942       * Operator overloading
6943       * Region pointers
6944       * Classes
6945
6946    * Various language extensions
6947       * C-callback function types: 'crust fn ...'
6948       * Infinite-loop construct: 'loop { ... }'
6949       * Shorten 'mutable' to 'mut'
6950       * Required mutable-local qualifier: 'let mut ...'
6951       * Basic glob-exporting: 'export foo::*;'
6952       * Alt now exhaustive, 'alt check' for runtime-checked
6953       * Block-function form of 'for' loop, with 'break' and 'ret'.
6954
6955    * New library code
6956       * AST quasi-quote syntax extension
6957       * Revived libuv interface
6958       * New modules: core::{future, iter}, std::arena
6959       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6960       * Extensive cleanup, regularization in libstd, libcore
6961
6962
6963 Version 0.1  (2012-01-20)
6964 ===============================
6965
6966    * Most language features work, including:
6967       * Unique pointers, unique closures, move semantics
6968       * Interface-constrained generics
6969       * Static interface dispatch
6970       * Stack growth
6971       * Multithread task scheduling
6972       * Typestate predicates
6973       * Failure unwinding, destructors
6974       * Pattern matching and destructuring assignment
6975       * Lightweight block-lambda syntax
6976       * Preliminary macro-by-example
6977
6978    * Compiler works with the following configurations:
6979       * Linux: x86 and x86_64 hosts and targets
6980       * macOS: x86 and x86_64 hosts and targets
6981       * Windows: x86 hosts and targets
6982
6983    * Cross compilation / multi-target configuration supported.
6984
6985    * Preliminary API-documentation and package-management tools included.
6986
6987 Known issues:
6988
6989    * Documentation is incomplete.
6990
6991    * Performance is below intended target.
6992
6993    * Standard library APIs are subject to extensive change, reorganization.
6994
6995    * Language-level versioning is not yet operational - future code will
6996      break unexpectedly.