]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Reword label as per review comment
[rust.git] / RELEASES.md
1 Version 1.31.1 (2018-12-20)
2 ===========================
3
4 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
5 - [Fix broken go-to-definition in RLS][rls/1171]
6 - [Fix infinite loop on hover in RLS][rls/1170]
7
8 [56562]: https://github.com/rust-lang/rust/pull/56562
9 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
10 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
11
12 Version 1.31.0 (2018-12-06)
13 ==========================
14
15 Language
16 --------
17 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉 
18 - [New lifetime elision rules now allow for eliding lifetimes in functions and
19   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
20   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
21   in structs.
22 - [You can now define and use `const` functions.][54835] These are currently
23   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
24   [language reference][const-reference] for what exactly is available.
25 - [You can now use tool lints, which allow you to scope lints from external
26   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
27 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
28   a crate, not just in exported functions.][54451]
29 - [You can now use parentheses in pattern matches.][54497]
30
31 Compiler
32 --------
33 - [Updated musl to 1.1.20][54430]
34
35 Libraries
36 ---------
37 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
38   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
39 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
40   into `Option<&mut T>` using the `From` trait.][53218]
41 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
42
43
44 Stabilized APIs
45 ---------------
46 - [`slice::align_to`]
47 - [`slice::align_to_mut`]
48 - [`slice::chunks_exact`]
49 - [`slice::chunks_exact_mut`]
50 - [`slice::rchunks`]
51 - [`slice::rchunks_mut`]
52 - [`slice::rchunks_exact`]
53 - [`slice::rchunks_exact_mut`]
54 - [`Option::replace`]
55
56 Cargo
57 -----
58 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
59 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
60   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
61
62 [52813]: https://github.com/rust-lang/rust/pull/52813/
63 [53218]: https://github.com/rust-lang/rust/pull/53218/
64 [53555]: https://github.com/rust-lang/rust/issues/53555/
65 [54057]: https://github.com/rust-lang/rust/pull/54057/
66 [54240]: https://github.com/rust-lang/rust/pull/54240/
67 [54430]: https://github.com/rust-lang/rust/pull/54430/
68 [54451]: https://github.com/rust-lang/rust/pull/54451/
69 [54497]: https://github.com/rust-lang/rust/pull/54497/
70 [54778]: https://github.com/rust-lang/rust/pull/54778/
71 [54835]: https://github.com/rust-lang/rust/pull/54835/
72 [54870]: https://github.com/rust-lang/rust/pull/54870/
73 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
74 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
75 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
76 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
77 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
78 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
79 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
80 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
81 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
82 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
83 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
84 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
85 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
86 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
87
88 Version 1.30.1 (2018-11-08)
89 ===========================
90
91 - [Fixed overflow ICE in rustdoc][54199]
92 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
93
94 [54199]: https://github.com/rust-lang/rust/pull/54199
95 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
96
97 Version 1.30.0 (2018-10-25)
98 ==========================
99
100 Language
101 --------
102 - [Procedural macros are now available.][52081] These kinds of macros allow for
103   more powerful code generation. There is a [new chapter available][proc-macros]
104   in the Rust Programming Language book that goes further in depth.
105 - [You can now use keywords as identifiers using the raw identifiers
106   syntax (`r#`),][53236] e.g. `let r#for = true;`
107 - [Using anonymous parameters in traits is now deprecated with a warning and
108   will be a hard error in the 2018 edition.][53272]
109 - [You can now use `crate` in paths.][54404] This allows you to refer to the
110   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
111 - [Using a external crate no longer requires being prefixed with `::`.][54404]
112   Previously, using a external crate in a module without a use statement
113   required `let json = ::serde_json::from_str(foo);` but can now be written
114   as `let json = serde_json::from_str(foo);`.
115 - [You can now apply the `#[used]` attribute to static items to prevent the
116   compiler from optimising them away, even if they appear to be unused,][51363]
117   e.g. `#[used] static FOO: u32 = 1;`
118 - [You can now import and reexport macros from other crates with the `use`
119   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
120   the root module of the crate. If your macro relies on calling other local
121   macros, it is recommended to export with the
122   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
123   those macros.
124 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
125   using the `vis` specifier.][53370]
126 - [Non-macro attributes now allow all forms of literals, not just
127   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
128   write `#[attr(true)]`.
129 - [You can now specify a function to handle a panic in the Rust runtime with the
130   `#[panic_handler]` attribute.][51366]
131
132 Compiler
133 --------
134 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
135 - [Added the `aarch64-unknown-netbsd` target][53165]
136
137 Libraries
138 ---------
139 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
140
141 Stabilized APIs
142 ---------------
143 - [`Ipv4Addr::BROADCAST`]
144 - [`Ipv4Addr::LOCALHOST`]
145 - [`Ipv4Addr::UNSPECIFIED`]
146 - [`Ipv6Addr::LOCALHOST`]
147 - [`Ipv6Addr::UNSPECIFIED`]
148 - [`Iterator::find_map`]
149
150   The following methods are replacement methods for `trim_left`, `trim_right`,
151   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
152   in 1.33.0:
153 - [`str::trim_end_matches`]
154 - [`str::trim_end`]
155 - [`str::trim_start_matches`]
156 - [`str::trim_start`]
157
158 Cargo
159 ----
160 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
161 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
162   equivalent to calling `rustdoc --error-format=json`.
163 - [Cargo will now provide a progress bar for builds.][cargo/5995]
164
165 Misc
166 ----
167 - [`rustdoc` allows you to specify what edition to treat your code as with the
168   `--edition` option.][54057]
169 - [`rustdoc` now has the `--color` (specify whether to output color) and
170   `--error-format` (specify error format, e.g. `json`) options.][53003]
171 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
172   debug symbols.][53774]
173 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
174   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
175
176 [50911]: https://github.com/rust-lang/rust/pull/50911/
177 [51363]: https://github.com/rust-lang/rust/pull/51363/
178 [51366]: https://github.com/rust-lang/rust/pull/51366/
179 [52081]: https://github.com/rust-lang/rust/pull/52081/
180 [53003]: https://github.com/rust-lang/rust/pull/53003/
181 [53033]: https://github.com/rust-lang/rust/pull/53033/
182 [53044]: https://github.com/rust-lang/rust/pull/53044/
183 [53165]: https://github.com/rust-lang/rust/pull/53165/
184 [53213]: https://github.com/rust-lang/rust/pull/53213/
185 [53236]: https://github.com/rust-lang/rust/pull/53236/
186 [53272]: https://github.com/rust-lang/rust/pull/53272/
187 [53370]: https://github.com/rust-lang/rust/pull/53370/
188 [53459]: https://github.com/rust-lang/rust/pull/53459/
189 [53774]: https://github.com/rust-lang/rust/pull/53774/
190 [53822]: https://github.com/rust-lang/rust/pull/53822/
191 [54057]: https://github.com/rust-lang/rust/pull/54057/
192 [54146]: https://github.com/rust-lang/rust/pull/54146/
193 [54404]: https://github.com/rust-lang/rust/pull/54404/
194 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
195 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
196 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
197 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
198
199 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
200 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
201 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
202 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
203 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
204 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
205 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
206 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
207 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
208 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
209
210
211 Version 1.29.2 (2018-10-11)
212 ===========================
213
214 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
215 - The `rls-preview` component on the windows-gnu targets has been restored.
216
217 [54639]: https://github.com/rust-lang/rust/pull/54639
218
219
220 Version 1.29.1 (2018-09-25)
221 ===========================
222
223 Security Notes
224 --------------
225
226 - The standard library's `str::repeat` function contained an out of bounds write
227   caused by an integer overflow. This has been fixed by deterministically
228   panicking when an overflow happens.
229
230   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
231   us.
232
233
234 Version 1.29.0 (2018-09-13)
235 ==========================
236
237 Compiler
238 --------
239 - [Bumped minimum LLVM version to 5.0.][51899]
240 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
241 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
242
243 Libraries
244 ---------
245 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
246 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
247 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
248 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
249   for `&str`.][51178]
250 - [`Cell<T>` now allows `T` to be unsized.][50494]
251 - [`SocketAddr` is now stable on Redox.][52656]
252
253 Stabilized APIs
254 ---------------
255 - [`Arc::downcast`]
256 - [`Iterator::flatten`]
257 - [`Rc::downcast`]
258
259 Cargo
260 -----
261 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
262   `--locked` to disable this behavior.
263 - [`cargo-install` will now allow you to cross compile an install
264   using `--target`.][cargo/5614]
265 - [Added the `cargo-fix` subcommand to automatically move project code from
266   2015 edition to 2018.][cargo/5723]
267 - [`cargo doc` can now optionally document private types using the
268   `--document-private-items` flag.][cargo/5543]
269
270 Misc
271 ----
272 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
273   the specified level to that level.][52354] For example `--cap-lints warn`
274   will demote `deny` and `forbid` lints to `warn`.
275 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
276   fails and `101` if there is a panic.][52197]
277 - [A preview of clippy has been made available through rustup.][51122]
278   You can install the preview with `rustup component add clippy-preview`.
279
280 Compatibility Notes
281 -------------------
282 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
283   Use `str::get_unchecked(begin..end)` instead.
284 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
285   Consider using the `home_dir` function from
286   https://crates.io/crates/dirs instead.
287 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
288 - [`cfg` attributes and `--cfg` command line flags are now more
289   strictly validated.][53893]
290
291 [53893]: https://github.com/rust-lang/rust/pull/53893/
292 [52861]: https://github.com/rust-lang/rust/pull/52861/
293 [52656]: https://github.com/rust-lang/rust/pull/52656/
294 [52239]: https://github.com/rust-lang/rust/pull/52239/
295 [52330]: https://github.com/rust-lang/rust/pull/52330/
296 [52354]: https://github.com/rust-lang/rust/pull/52354/
297 [52402]: https://github.com/rust-lang/rust/pull/52402/
298 [52103]: https://github.com/rust-lang/rust/pull/52103/
299 [52197]: https://github.com/rust-lang/rust/pull/52197/
300 [51807]: https://github.com/rust-lang/rust/pull/51807/
301 [51899]: https://github.com/rust-lang/rust/pull/51899/
302 [51912]: https://github.com/rust-lang/rust/pull/51912/
303 [51511]: https://github.com/rust-lang/rust/pull/51511/
304 [51619]: https://github.com/rust-lang/rust/pull/51619/
305 [51656]: https://github.com/rust-lang/rust/pull/51656/
306 [51178]: https://github.com/rust-lang/rust/pull/51178/
307 [51122]: https://github.com/rust-lang/rust/pull/51122
308 [50494]: https://github.com/rust-lang/rust/pull/50494/
309 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
310 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
311 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
312 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
313 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
314 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
315 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
316
317
318 Version 1.28.0 (2018-08-02)
319 ===========================
320
321 Language
322 --------
323 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
324   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
325   the inner type across Foreign Function Interface (FFI) boundaries.
326 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
327   and can now be used as identifiers.][51196]
328 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
329   stable.][51241] This will allow users to specify a global allocator for
330   their program.
331 - [Unit test functions marked with the `#[test]` attribute can now return
332   `Result<(), E: Debug>` in addition to `()`.][51298]
333 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
334   allows macros to easily target lifetimes.
335
336 Compiler
337 --------
338 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
339   prioritise making smaller binary sizes. `z` is the same as `s` with the
340   exception that it does not vectorise loops, which typically results in an even
341   smaller binary.
342 - [The short error format is now stable.][49546] Specified with
343   `--error-format=short` this option will provide a more compressed output of
344   rust error messages.
345 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
346 - [Reduced the number of allocations in the macro parser.][50855] This can
347   improve compile times of macro heavy crates on average by 5%.
348
349 Libraries
350 ---------
351 - [Implemented `Default` for `&mut str`.][51306]
352 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
353 - [Implemented `Extend` for `()`.][50234]
354 - [The `Debug` implementation of `time::Duration` should now be more easily
355   human readable.][50364] Previously a `Duration` of one second would printed as
356   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
357 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
358   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
359   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
360   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
361   for `PathBuf`.][50170]
362 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
363   and `Wrapping<i128>`.][50465]
364 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
365   possible.][51050] This can provide up to a 40% speed increase.
366 - [Improved error messages when using `format!`.][50610]
367
368 Stabilized APIs
369 ---------------
370 - [`Iterator::step_by`]
371 - [`Path::ancestors`]
372 - [`SystemTime::UNIX_EPOCH`]
373 - [`alloc::GlobalAlloc`]
374 - [`alloc::Layout`]
375 - [`alloc::LayoutErr`]
376 - [`alloc::System`]
377 - [`alloc::alloc`]
378 - [`alloc::alloc_zeroed`]
379 - [`alloc::dealloc`]
380 - [`alloc::realloc`]
381 - [`alloc::handle_alloc_error`]
382 - [`btree_map::Entry::or_default`]
383 - [`fmt::Alignment`]
384 - [`hash_map::Entry::or_default`]
385 - [`iter::repeat_with`]
386 - [`num::NonZeroUsize`]
387 - [`num::NonZeroU128`]
388 - [`num::NonZeroU16`]
389 - [`num::NonZeroU32`]
390 - [`num::NonZeroU64`]
391 - [`num::NonZeroU8`]
392 - [`ops::RangeBounds`]
393 - [`slice::SliceIndex`]
394 - [`slice::from_mut`]
395 - [`slice::from_ref`]
396 - [`{Any + Send + Sync}::downcast_mut`]
397 - [`{Any + Send + Sync}::downcast_ref`]
398 - [`{Any + Send + Sync}::is`]
399
400 Cargo
401 -----
402 - [Cargo will now no longer allow you to publish crates with build scripts that
403   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
404   considered to be immutable.
405
406 Misc
407 ----
408 - [The `suggestion_applicability` field in `rustc`'s json output is now
409   stable.][50486] This will allow dev tools to check whether a code suggestion
410   would apply to them.
411
412 Compatibility Notes
413 -------------------
414 - [Rust will consider trait objects with duplicated constraints to be the same
415   type as without the duplicated constraint.][51276] For example the below code will
416   now fail to compile.
417   ```rust
418   trait Trait {}
419
420   impl Trait + Send {
421       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
422   }
423
424   impl Trait + Send + Send {
425       fn test(&self) { println!("two"); }
426   }
427   ```
428
429 [49546]: https://github.com/rust-lang/rust/pull/49546/
430 [50143]: https://github.com/rust-lang/rust/pull/50143/
431 [50170]: https://github.com/rust-lang/rust/pull/50170/
432 [50234]: https://github.com/rust-lang/rust/pull/50234/
433 [50265]: https://github.com/rust-lang/rust/pull/50265/
434 [50364]: https://github.com/rust-lang/rust/pull/50364/
435 [50385]: https://github.com/rust-lang/rust/pull/50385/
436 [50465]: https://github.com/rust-lang/rust/pull/50465/
437 [50486]: https://github.com/rust-lang/rust/pull/50486/
438 [50554]: https://github.com/rust-lang/rust/pull/50554/
439 [50610]: https://github.com/rust-lang/rust/pull/50610/
440 [50855]: https://github.com/rust-lang/rust/pull/50855/
441 [51050]: https://github.com/rust-lang/rust/pull/51050/
442 [51196]: https://github.com/rust-lang/rust/pull/51196/
443 [51200]: https://github.com/rust-lang/rust/pull/51200/
444 [51241]: https://github.com/rust-lang/rust/pull/51241/
445 [51276]: https://github.com/rust-lang/rust/pull/51276/
446 [51298]: https://github.com/rust-lang/rust/pull/51298/
447 [51306]: https://github.com/rust-lang/rust/pull/51306/
448 [51562]: https://github.com/rust-lang/rust/pull/51562/
449 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
450 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
451 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
452 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
453 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
454 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
455 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
456 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
457 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
458 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
459 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
460 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
461 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
462 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
463 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
464 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
465 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
466 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
467 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
468 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
469 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
470 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
471 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
472 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
473 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
474 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
475 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
476 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
477 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
478 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
479
480 Version 1.27.2 (2018-07-20)
481 ===========================
482
483 Compatibility Notes
484 -------------------
485
486 - The borrow checker was fixed to avoid potential unsoundness when using
487   match ergonomics: [#52213][52213].
488
489 [52213]: https://github.com/rust-lang/rust/issues/52213
490
491 Version 1.27.1 (2018-07-10)
492 ===========================
493
494 Security Notes
495 --------------
496
497 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
498   when running, which enabled executing code as some other user on a
499   given machine. This release fixes that vulnerability; you can read
500   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
501
502   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
503
504 Compatibility Notes
505 -------------------
506
507 - The borrow checker was fixed to avoid an additional potential unsoundness when using
508   match ergonomics: [#51415][51415], [#49534][49534].
509
510 [51415]: https://github.com/rust-lang/rust/issues/51415
511 [49534]: https://github.com/rust-lang/rust/issues/49534
512 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
513 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
514
515 Version 1.27.0 (2018-06-21)
516 ==========================
517
518 Language
519 --------
520 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
521   be used as an identifier.
522 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
523   bare `Trait` syntax, and should make it clearer when being used in tandem with
524   `impl Trait` because it is equivalent to the following syntax:
525   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
526   `Box<Trait> == Box<dyn Trait>`.
527 - [Attributes on generic parameters such as types and lifetimes are
528   now stable.][48851] e.g.
529   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
530 - [The `#[must_use]` attribute can now also be used on functions as well as
531   types.][48925] It provides a lint that by default warns users when the
532   value returned by a function has not been used.
533
534 Compiler
535 --------
536 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
537
538 Libraries
539 ---------
540 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
541   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
542   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
543   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
544   the `cfg` attribute.
545 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
546   std are now available in core.][49896]
547 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
548   to `Self`.][49630]
549 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
550   that the operation isn't done in place.
551 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
552   the `#[must_use]` attribute][49533] to warn about unused potentially
553   expensive allocations.
554
555 Stabilized APIs
556 ---------------
557 - [`DoubleEndedIterator::rfind`]
558 - [`DoubleEndedIterator::rfold`]
559 - [`DoubleEndedIterator::try_rfold`]
560 - [`Duration::from_micros`]
561 - [`Duration::from_nanos`]
562 - [`Duration::subsec_micros`]
563 - [`Duration::subsec_millis`]
564 - [`HashMap::remove_entry`]
565 - [`Iterator::try_fold`]
566 - [`Iterator::try_for_each`]
567 - [`NonNull::cast`]
568 - [`Option::filter`]
569 - [`String::replace_range`]
570 - [`Take::set_limit`]
571 - [`hint::unreachable_unchecked`]
572 - [`os::unix::process::parent_id`]
573 - [`ptr::swap_nonoverlapping`]
574 - [`slice::rsplit_mut`]
575 - [`slice::rsplit`]
576 - [`slice::swap_with_slice`]
577
578 Cargo
579 -----
580 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
581   `readme`, and `repository` fields.][cargo/5386]
582 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
583 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
584   a different directory than `target` for placing compilation artifacts.
585 - [Cargo will be adding automatic target inference for binaries, benchmarks,
586   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
587   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
588   where cargo would infer a binary, Cargo will produce a warning. You can
589   disable this feature ahead of time by setting any of the following to false:
590   `autobins`, `autobenches`, `autoexamples`, `autotests`.
591 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
592   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
593
594 Misc
595 ----
596 - [Added “The Rustc book” into the official documentation.][49707]
597   [“The Rustc book”] documents and teaches how to use the rustc compiler.
598 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
599
600 Compatibility Notes
601 -------------------
602 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
603   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
604   compile, `"".is_empty()` will still compile.
605 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
606   will only print the inner type.][48553] E.g.
607   `print!("{:?}", AtomicBool::new(true))` will print `true`,
608   not `AtomicBool(true)`.
609 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
610   could enter higher numbers but they were not supported by LLVM. Up to 512MB
611   alignment should cover all use cases.
612 - The `.description()` method on the `std::error::Error` trait
613   [has been soft-deprecated][50163]. It is no longer required to implement it.
614
615 [48553]: https://github.com/rust-lang/rust/pull/48553/
616 [48851]: https://github.com/rust-lang/rust/pull/48851/
617 [48925]: https://github.com/rust-lang/rust/pull/48925/
618 [49533]: https://github.com/rust-lang/rust/pull/49533/
619 [49623]: https://github.com/rust-lang/rust/pull/49623/
620 [49630]: https://github.com/rust-lang/rust/pull/49630/
621 [49664]: https://github.com/rust-lang/rust/pull/49664/
622 [49699]: https://github.com/rust-lang/rust/pull/49699/
623 [49707]: https://github.com/rust-lang/rust/pull/49707/
624 [49719]: https://github.com/rust-lang/rust/pull/49719/
625 [49896]: https://github.com/rust-lang/rust/pull/49896/
626 [49968]: https://github.com/rust-lang/rust/pull/49968/
627 [50163]: https://github.com/rust-lang/rust/pull/50163
628 [50177]: https://github.com/rust-lang/rust/pull/50177/
629 [50378]: https://github.com/rust-lang/rust/pull/50378/
630 [50398]: https://github.com/rust-lang/rust/pull/50398/
631 [50423]: https://github.com/rust-lang/rust/pull/50423/
632 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
633 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
634 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
635 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
636 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
637 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
638 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
639 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
640 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
641 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
642 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
643 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
644 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
645 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
646 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
647 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
648 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
649 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
650 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
651 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
652 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
653 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
654 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
655 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
656 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
657 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
658 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
659 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
660 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
661 [“The Rustc book”]: https://doc.rust-lang.org/rustc
662
663
664 Version 1.26.2 (2018-06-05)
665 ==========================
666
667 Compatibility Notes
668 -------------------
669
670 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
671
672 [51117]: https://github.com/rust-lang/rust/issues/51117
673
674
675 Version 1.26.1 (2018-05-29)
676 ==========================
677
678 Tools
679 -----
680
681 - [RLS now works on Windows.][50646]
682 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
683
684
685 Compatibility Notes
686 --------
687
688 - [`fn main() -> impl Trait` no longer works for non-Termination
689   trait.][50656]
690   This reverts an accidental stabilization.
691 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
692 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
693
694 [50646]: https://github.com/rust-lang/rust/issues/50646
695 [50656]: https://github.com/rust-lang/rust/pull/50656
696 [50812]: https://github.com/rust-lang/rust/pull/50812
697 [50950]: https://github.com/rust-lang/rust/issues/50950
698 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
699
700 Version 1.26.0 (2018-05-10)
701 ==========================
702
703 Language
704 --------
705 - [Closures now implement `Copy` and/or `Clone` if all captured variables
706   implement either or both traits.][49299]
707 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
708 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
709   lifetime can be elided.][49458]
710 - [`impl Trait` is now stable allowing you to have abstract types in returns
711    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
712   `fn open(path: impl AsRef<Path>)`.
713 - [Pattern matching will now automatically apply dereferences.][49394]
714 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
715 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
716 - [A lot of operations are now available in a const context.][46882] E.g. You
717   can now index into constant arrays, reference and dereference into constants,
718   and use tuple struct constructors.
719 - [Fixed entry slice patterns are now stable.][48516] E.g.
720   ```rust
721   let points = [1, 2, 3, 4];
722   match points {
723       [1, 2, 3, 4] => println!("All points were sequential."),
724       _ => println!("Not all points were sequential."),
725   }
726   ```
727
728
729 Compiler
730 --------
731 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
732 - [Fixed exponential projection complexity on nested types.][48296]
733   This can provide up to a ~12% reduction in compile times for certain crates.
734 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
735   to remap path prefixes outputted by the compiler.
736 - [Added `powerpc-unknown-netbsd` target.][48281]
737
738 Libraries
739 ---------
740 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
741 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
742   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
743 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
744 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
745 - [`ascii::escape_default` is now available in libcore.][48735]
746 - [Trailing commas are now supported in std and core macros.][48056]
747 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
748 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
749
750 Stabilized APIs
751 ---------------
752 - [`*const T::add`]
753 - [`*const T::copy_to_nonoverlapping`]
754 - [`*const T::copy_to`]
755 - [`*const T::read_unaligned`]
756 - [`*const T::read_volatile`]
757 - [`*const T::read`]
758 - [`*const T::sub`]
759 - [`*const T::wrapping_add`]
760 - [`*const T::wrapping_sub`]
761 - [`*mut T::add`]
762 - [`*mut T::copy_to_nonoverlapping`]
763 - [`*mut T::copy_to`]
764 - [`*mut T::read_unaligned`]
765 - [`*mut T::read_volatile`]
766 - [`*mut T::read`]
767 - [`*mut T::replace`]
768 - [`*mut T::sub`]
769 - [`*mut T::swap`]
770 - [`*mut T::wrapping_add`]
771 - [`*mut T::wrapping_sub`]
772 - [`*mut T::write_bytes`]
773 - [`*mut T::write_unaligned`]
774 - [`*mut T::write_volatile`]
775 - [`*mut T::write`]
776 - [`Box::leak`]
777 - [`FromUtf8Error::as_bytes`]
778 - [`LocalKey::try_with`]
779 - [`Option::cloned`]
780 - [`btree_map::Entry::and_modify`]
781 - [`fs::read_to_string`]
782 - [`fs::read`]
783 - [`fs::write`]
784 - [`hash_map::Entry::and_modify`]
785 - [`iter::FusedIterator`]
786 - [`ops::RangeInclusive`]
787 - [`ops::RangeToInclusive`]
788 - [`process::id`]
789 - [`slice::rotate_left`]
790 - [`slice::rotate_right`]
791 - [`String::retain`]
792
793
794 Cargo
795 -----
796 - [Cargo will now output path to custom commands when `-v` is
797   passed with `--list`][cargo/5041]
798 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
799
800 Misc
801 ----
802 - [The second edition of "The Rust Programming Language" book is now recommended
803   over the first.][48404]
804
805 Compatibility Notes
806 -------------------
807
808 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
809   syntax is now invalid.
810   ```
811   use std::ops::Fn as dyn;
812   fn g(_: Box<dyn(std::fmt::Debug)>) {}
813   ```
814 - [The result of dereferences are no longer promoted to `'static`.][47408]
815   e.g.
816   ```rust
817   fn main() {
818       const PAIR: &(i32, i32) = &(0, 1);
819       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
820   }
821   ```
822 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
823 - [`".e0"` will now no longer parse as `0.0` and will instead cause
824   an error.][48235]
825 - [Removed hoedown from rustdoc.][48274]
826 - [Bounds on higher-kinded lifetimes a hard error.][48326]
827
828 [46882]: https://github.com/rust-lang/rust/pull/46882
829 [47379]: https://github.com/rust-lang/rust/pull/47379
830 [47408]: https://github.com/rust-lang/rust/pull/47408
831 [47813]: https://github.com/rust-lang/rust/pull/47813
832 [48056]: https://github.com/rust-lang/rust/pull/48056
833 [48125]: https://github.com/rust-lang/rust/pull/48125
834 [48166]: https://github.com/rust-lang/rust/pull/48166
835 [48235]: https://github.com/rust-lang/rust/pull/48235
836 [48274]: https://github.com/rust-lang/rust/pull/48274
837 [48281]: https://github.com/rust-lang/rust/pull/48281
838 [48296]: https://github.com/rust-lang/rust/pull/48296
839 [48326]: https://github.com/rust-lang/rust/pull/48326
840 [48359]: https://github.com/rust-lang/rust/pull/48359
841 [48404]: https://github.com/rust-lang/rust/pull/48404
842 [48481]: https://github.com/rust-lang/rust/pull/48481
843 [48516]: https://github.com/rust-lang/rust/pull/48516
844 [48628]: https://github.com/rust-lang/rust/pull/48628
845 [48629]: https://github.com/rust-lang/rust/pull/48629
846 [48657]: https://github.com/rust-lang/rust/pull/48657
847 [48735]: https://github.com/rust-lang/rust/pull/48735
848 [48978]: https://github.com/rust-lang/rust/pull/48978
849 [49101]: https://github.com/rust-lang/rust/pull/49101
850 [49109]: https://github.com/rust-lang/rust/pull/49109
851 [49121]: https://github.com/rust-lang/rust/pull/49121
852 [49162]: https://github.com/rust-lang/rust/pull/49162
853 [49184]: https://github.com/rust-lang/rust/pull/49184
854 [49234]: https://github.com/rust-lang/rust/pull/49234
855 [49255]: https://github.com/rust-lang/rust/pull/49255
856 [49299]: https://github.com/rust-lang/rust/pull/49299
857 [49305]: https://github.com/rust-lang/rust/pull/49305
858 [49394]: https://github.com/rust-lang/rust/pull/49394
859 [49458]: https://github.com/rust-lang/rust/pull/49458
860 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
861 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
862 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
863 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
864 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
865 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
866 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
867 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
868 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
869 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
870 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
871 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
872 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
873 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
874 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
875 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
876 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
877 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
878 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
879 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
880 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
881 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
882 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
883 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
884 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
885 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
886 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
887 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
888 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
889 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
890 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
891 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
892 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
893 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
894 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
895 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
896 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
897 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
898 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
899 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
900 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
901 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
902
903
904 Version 1.25.0 (2018-03-29)
905 ==========================
906
907 Language
908 --------
909 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
910 - [You can now use nested groups of imports.][47948]
911   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
912 - [You can now have `|` at the start of a match arm.][47947] e.g.
913 ```rust
914 enum Foo { A, B, C }
915
916 fn main() {
917     let x = Foo::A;
918     match x {
919         | Foo::A
920         | Foo::B => println!("AB"),
921         | Foo::C => println!("C"),
922     }
923 }
924 ```
925
926 Compiler
927 --------
928 - [Upgraded to LLVM 6.][47828]
929 - [Added `-C lto=val` option.][47521]
930 - [Added `i586-unknown-linux-musl` target][47282]
931
932 Libraries
933 ---------
934 - [Impl Send for `process::Command` on Unix.][47760]
935 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
936 - [`UnsafeCell::into_inner` is now safe.][47204]
937 - [Implement libstd for CloudABI.][47268]
938 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
939 - [Implement `AsRef<Path>` for Component][46985]
940 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
941 - [Moved `Duration` to libcore.][46666]
942
943 Stabilized APIs
944 ---------------
945 - [`Location::column`]
946 - [`ptr::NonNull`]
947
948 The following functions can now be used in a constant expression.
949 eg. `static MINUTE: Duration = Duration::from_secs(60);`
950 - [`Duration::new`][47300]
951 - [`Duration::from_secs`][47300]
952 - [`Duration::from_millis`][47300]
953
954 Cargo
955 -----
956 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
957 - [`cargo new` now defaults to creating a binary crate, instead of a
958   library crate.][cargo/5029]
959
960 Misc
961 ----
962 - [Rust by example is now shipped with new releases][46196]
963
964 Compatibility Notes
965 -------------------
966 - [Deprecated `net::lookup_host`.][47510]
967 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
968 - The borrow checker was sometimes incorrectly permitting overlapping borrows
969   around indexing operations (see [#47349][47349]). This has been fixed (which also
970   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
971 - [Removed deprecated unstable attribute `#[simd]`.][47251]
972
973 [33903]: https://github.com/rust-lang/rust/pull/33903
974 [47947]: https://github.com/rust-lang/rust/pull/47947
975 [47948]: https://github.com/rust-lang/rust/pull/47948
976 [47760]: https://github.com/rust-lang/rust/pull/47760
977 [47790]: https://github.com/rust-lang/rust/pull/47790
978 [47828]: https://github.com/rust-lang/rust/pull/47828
979 [47398]: https://github.com/rust-lang/rust/pull/47398
980 [47510]: https://github.com/rust-lang/rust/pull/47510
981 [47521]: https://github.com/rust-lang/rust/pull/47521
982 [47204]: https://github.com/rust-lang/rust/pull/47204
983 [47251]: https://github.com/rust-lang/rust/pull/47251
984 [47268]: https://github.com/rust-lang/rust/pull/47268
985 [47282]: https://github.com/rust-lang/rust/pull/47282
986 [47300]: https://github.com/rust-lang/rust/pull/47300
987 [47349]: https://github.com/rust-lang/rust/pull/47349
988 [46931]: https://github.com/rust-lang/rust/pull/46931
989 [46985]: https://github.com/rust-lang/rust/pull/46985
990 [47006]: https://github.com/rust-lang/rust/pull/47006
991 [46830]: https://github.com/rust-lang/rust/pull/46830
992 [46095]: https://github.com/rust-lang/rust/pull/46095
993 [46666]: https://github.com/rust-lang/rust/pull/46666
994 [46196]: https://github.com/rust-lang/rust/pull/46196
995 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
996 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
997 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
998 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
999 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
1000
1001
1002 Version 1.24.1 (2018-03-01)
1003 ==========================
1004
1005  - [Do not abort when unwinding through FFI][48251]
1006  - [Emit UTF-16 files for linker arguments on Windows][48318]
1007  - [Make the error index generator work again][48308]
1008  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
1009
1010 [48251]: https://github.com/rust-lang/rust/issues/48251
1011 [48308]: https://github.com/rust-lang/rust/issues/48308
1012 [48318]: https://github.com/rust-lang/rust/issues/48318
1013 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
1014
1015
1016 Version 1.24.0 (2018-02-15)
1017 ==========================
1018
1019 Language
1020 --------
1021 - [External `sysv64` ffi is now available.][46528]
1022   eg. `extern "sysv64" fn foo () {}`
1023
1024 Compiler
1025 --------
1026 - [rustc now uses 16 codegen units by default for release builds.][46910]
1027   For the fastest builds, utilize `codegen-units=1`.
1028 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1029 - [Add `aarch64-unknown-openbsd` support][46760]
1030
1031 Libraries
1032 ---------
1033 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1034   improvement in performance in the majority of cases.
1035 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1036   with Windows.][46798]
1037 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1038 - [impl `From<bool>` for `AtomicBool`][46293]
1039 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1040 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1041 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1042 - [float::from_bits now just uses transmute.][46012] This provides
1043   some optimisations from LLVM.
1044 - [Copied `AsciiExt` methods onto `char`][46077]
1045 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1046 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1047 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1048 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1049
1050 Stabilized APIs
1051 ---------------
1052 - [`RefCell::replace`]
1053 - [`RefCell::swap`]
1054 - [`atomic::spin_loop_hint`]
1055
1056 The following functions can now be used in a constant expression.
1057 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1058
1059 - [`AtomicBool::new`][46287]
1060 - [`AtomicUsize::new`][46287]
1061 - [`AtomicIsize::new`][46287]
1062 - [`AtomicPtr::new`][46287]
1063 - [`Cell::new`][46287]
1064 - [`{integer}::min_value`][46287]
1065 - [`{integer}::max_value`][46287]
1066 - [`mem::size_of`][46287]
1067 - [`mem::align_of`][46287]
1068 - [`ptr::null`][46287]
1069 - [`ptr::null_mut`][46287]
1070 - [`RefCell::new`][46287]
1071 - [`UnsafeCell::new`][46287]
1072
1073 Cargo
1074 -----
1075 - [Added a `workspace.default-members` config that
1076   overrides implied `--all` in virtual workspaces.][cargo/4743]
1077 - [Enable incremental by default on development builds.][cargo/4817] Also added
1078   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1079   per-project or global basis respectively.
1080
1081 Misc
1082 ----
1083
1084 Compatibility Notes
1085 -------------------
1086 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1087 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1088   in accordance with IETF RFC 4291 §2.2.
1089 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1090 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1091   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1092 - [Leading zeros in tuple struct members is now an error][47084]
1093 - [`column!()` macro is one-based instead of zero-based][46977]
1094 - [`fmt::Arguments` can no longer be shared across threads][45198]
1095 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1096 - [Cargo sets a different working directory for the compiler][cargo/4788]
1097
1098 [44884]: https://github.com/rust-lang/rust/pull/44884
1099 [45198]: https://github.com/rust-lang/rust/pull/45198
1100 [45506]: https://github.com/rust-lang/rust/pull/45506
1101 [45904]: https://github.com/rust-lang/rust/pull/45904
1102 [45990]: https://github.com/rust-lang/rust/pull/45990
1103 [46012]: https://github.com/rust-lang/rust/pull/46012
1104 [46077]: https://github.com/rust-lang/rust/pull/46077
1105 [46094]: https://github.com/rust-lang/rust/pull/46094
1106 [46284]: https://github.com/rust-lang/rust/pull/46284
1107 [46287]: https://github.com/rust-lang/rust/pull/46287
1108 [46293]: https://github.com/rust-lang/rust/pull/46293
1109 [46528]: https://github.com/rust-lang/rust/pull/46528
1110 [46671]: https://github.com/rust-lang/rust/pull/46671
1111 [46713]: https://github.com/rust-lang/rust/pull/46713
1112 [46735]: https://github.com/rust-lang/rust/pull/46735
1113 [46749]: https://github.com/rust-lang/rust/pull/46749
1114 [46760]: https://github.com/rust-lang/rust/pull/46760
1115 [46798]: https://github.com/rust-lang/rust/pull/46798
1116 [46828]: https://github.com/rust-lang/rust/pull/46828
1117 [46831]: https://github.com/rust-lang/rust/pull/46831
1118 [46833]: https://github.com/rust-lang/rust/pull/46833
1119 [46910]: https://github.com/rust-lang/rust/pull/46910
1120 [46977]: https://github.com/rust-lang/rust/pull/46977
1121 [47018]: https://github.com/rust-lang/rust/pull/47018
1122 [47080]: https://github.com/rust-lang/rust/pull/47080
1123 [47084]: https://github.com/rust-lang/rust/pull/47084
1124 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1125 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1126 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1127 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1128 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1129 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1130
1131
1132 Version 1.23.0 (2018-01-04)
1133 ==========================
1134
1135 Language
1136 --------
1137 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1138 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1139   Which should fix some confusing errors in some operations.
1140
1141 Compiler
1142 --------
1143 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1144   undefined behavior.][45920]
1145 - [rustc now suggests renaming import if names clash.][45660]
1146 - [Display errors/warnings correctly when there are zero-width or
1147   wide characters.][45711]
1148 - [rustc now avoids unnecessary copies of arguments that are
1149   simple bindings][45380] This should improve memory usage on average by 5-10%.
1150 - [Updated musl used to build musl rustc to 1.1.17][45393]
1151
1152 Libraries
1153 ---------
1154 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1155 - [Implement Hash for raw pointers to unsized types][45483]
1156 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1157 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1158 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1159 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1160   and `<*mut T>::as_mut`][44932]
1161 - [Optimized `Thread::{park, unpark}` implementation][45524]
1162 - [Improved `SliceExt::binary_search` performance.][45333]
1163 - [impl `FromIterator<()>` for `()`][45379]
1164 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1165   is now deprecated.
1166
1167 Stabilized APIs
1168 ---------------
1169
1170 Cargo
1171 -----
1172 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1173   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1174 - [Added unit test checking to `cargo check`][cargo/4592]
1175 - [Cargo now lets you install a specific version
1176   using `cargo install --version`][cargo/4637]
1177
1178 Misc
1179 ----
1180 - [Releases now ship with the Cargo book documentation.][45692]
1181 - [rustdoc now prints rendering warnings on every run.][45324]
1182
1183 Compatibility Notes
1184 -------------------
1185 - [Changes have been made to type equality to make it more correct,
1186   in rare cases this could break some code.][45853] [Tracking issue for
1187   further information][45852]
1188 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1189 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1190   Android 9, the minimum supported version is Android 14.
1191 - [Bumped the minimum LLVM to 3.9][45326]
1192
1193 [44042]: https://github.com/rust-lang/rust/pull/44042
1194 [44932]: https://github.com/rust-lang/rust/pull/44932
1195 [45267]: https://github.com/rust-lang/rust/pull/45267
1196 [45324]: https://github.com/rust-lang/rust/pull/45324
1197 [45326]: https://github.com/rust-lang/rust/pull/45326
1198 [45333]: https://github.com/rust-lang/rust/pull/45333
1199 [45379]: https://github.com/rust-lang/rust/pull/45379
1200 [45380]: https://github.com/rust-lang/rust/pull/45380
1201 [45393]: https://github.com/rust-lang/rust/pull/45393
1202 [45435]: https://github.com/rust-lang/rust/pull/45435
1203 [45483]: https://github.com/rust-lang/rust/pull/45483
1204 [45524]: https://github.com/rust-lang/rust/pull/45524
1205 [45571]: https://github.com/rust-lang/rust/pull/45571
1206 [45580]: https://github.com/rust-lang/rust/pull/45580
1207 [45610]: https://github.com/rust-lang/rust/pull/45610
1208 [45660]: https://github.com/rust-lang/rust/pull/45660
1209 [45692]: https://github.com/rust-lang/rust/pull/45692
1210 [45711]: https://github.com/rust-lang/rust/pull/45711
1211 [45772]: https://github.com/rust-lang/rust/pull/45772
1212 [45852]: https://github.com/rust-lang/rust/issues/45852
1213 [45853]: https://github.com/rust-lang/rust/pull/45853
1214 [45887]: https://github.com/rust-lang/rust/pull/45887
1215 [45920]: https://github.com/rust-lang/rust/pull/45920
1216 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1217 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1218 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1219
1220
1221 Version 1.22.1 (2017-11-22)
1222 ==========================
1223
1224 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1225
1226 [46183]: https://github.com/rust-lang/rust/pull/46183
1227
1228 Version 1.22.0 (2017-11-22)
1229 ==========================
1230
1231 Language
1232 --------
1233 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1234 - [Now accepts underscores in unicode escapes][43716]
1235 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1236 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1237
1238 Compiler
1239 --------
1240 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1241 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1242   This should decrease compile times for debug builds.
1243 - [strict memory alignment now enabled on ARMv6][45094]
1244 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1245
1246 Libraries
1247 ---------
1248 - [Allow atomic operations up to 32 bits
1249   on `armv5te_unknown_linux_gnueabi`][44978]
1250 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1251 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1252 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1253 - [Properly detect overflow in `Instant += Duration`.][44220]
1254 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1255 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1256 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1257
1258 Stabilized APIs
1259 ---------------
1260
1261 Cargo
1262 -----
1263 - [Cargo will now build multi file examples in subdirectories of the `examples`
1264   folder that have a `main.rs` file.][cargo/4496]
1265 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1266   the old format will continue to work and can be updated with `cargo update`.
1267 - [Now supports vendoring git repositories][cargo/3992]
1268
1269 Misc
1270 ----
1271 - [`libbacktrace` is now available on Apple platforms.][44251]
1272 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1273   This now lets you specify that a given code example will fail to compile.
1274
1275 Compatibility Notes
1276 -------------------
1277 - [The minimum Android version that rustc can build for has been bumped
1278   to `4.0` from `2.3`][45656]
1279 - [Allowing `T op= &T` for numeric types has broken some type
1280   inference cases][45480]
1281
1282
1283 [42526]: https://github.com/rust-lang/rust/pull/42526
1284 [43017]: https://github.com/rust-lang/rust/pull/43017
1285 [43716]: https://github.com/rust-lang/rust/pull/43716
1286 [43949]: https://github.com/rust-lang/rust/pull/43949
1287 [44015]: https://github.com/rust-lang/rust/pull/44015
1288 [44220]: https://github.com/rust-lang/rust/pull/44220
1289 [44251]: https://github.com/rust-lang/rust/pull/44251
1290 [44287]: https://github.com/rust-lang/rust/pull/44287
1291 [44303]: https://github.com/rust-lang/rust/pull/44303
1292 [44456]: https://github.com/rust-lang/rust/pull/44456
1293 [44466]: https://github.com/rust-lang/rust/pull/44466
1294 [44895]: https://github.com/rust-lang/rust/pull/44895
1295 [44966]: https://github.com/rust-lang/rust/pull/44966
1296 [44978]: https://github.com/rust-lang/rust/pull/44978
1297 [45041]: https://github.com/rust-lang/rust/pull/45041
1298 [45064]: https://github.com/rust-lang/rust/pull/45064
1299 [45075]: https://github.com/rust-lang/rust/pull/45075
1300 [45094]: https://github.com/rust-lang/rust/pull/45094
1301 [45095]: https://github.com/rust-lang/rust/pull/45095
1302 [45480]: https://github.com/rust-lang/rust/issues/45480
1303 [45656]: https://github.com/rust-lang/rust/pull/45656
1304 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1305 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1306 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1307
1308
1309
1310
1311
1312
1313 Version 1.21.0 (2017-10-12)
1314 ==========================
1315
1316 Language
1317 --------
1318 - [You can now use static references for literals.][43838]
1319   Example:
1320   ```rust
1321   fn main() {
1322       let x: &'static u32 = &0;
1323   }
1324   ```
1325 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1326   Example:
1327   ```rust
1328   my_macro!(Vec<i32>::new); // Always worked
1329   my_macro!(Vec::<i32>::new); // Now works
1330   ```
1331
1332 Compiler
1333 --------
1334 - [Upgraded jemalloc to 4.5.0][43911]
1335 - [Enabled unwinding panics on Redox][43917]
1336 - [Now runs LLVM in parallel during translation phase.][43506]
1337   This should reduce peak memory usage.
1338
1339 Libraries
1340 ---------
1341 - [Generate builtin impls for `Clone` for all arrays and tuples that
1342   are `T: Clone`][43690]
1343 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1344 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1345   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1346
1347 Stabilized APIs
1348 ---------------
1349
1350 [`std::mem::discriminant`]
1351
1352 Cargo
1353 -----
1354 - [You can now call `cargo install` with multiple package names][cargo/4216]
1355 - [Cargo commands inside a virtual workspace will now implicitly
1356   pass `--all`][cargo/4335]
1357 - [Added a `[patch]` section to `Cargo.toml` to handle
1358   prepublication dependencies][cargo/4123] [RFC 1969]
1359 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1360   like patterns][cargo/4270]
1361 - [Added the `--all-targets` option][cargo/4400]
1362 - [Using required dependencies as a feature is now deprecated and emits
1363   a warning][cargo/4364]
1364
1365
1366 Misc
1367 ----
1368 - [Cargo docs are moving][43916]
1369   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1370 - [The rustdoc book is now available][43863]
1371   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1372 - [Added a preview of RLS has been made available through rustup][44204]
1373   Install with `rustup component add rls-preview`
1374 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1375   Previously only showed `std::os::unix`.
1376
1377 Compatibility Notes
1378 -------------------
1379 - [Changes in method matching against higher-ranked types][43880] This may cause
1380   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1381 - [rustc's JSON error output's byte position start at top of file.][42973]
1382   Was previously relative to the rustc's internal `CodeMap` struct which
1383   required the unstable library `libsyntax` to correctly use.
1384 - [`unused_results` lint no longer ignores booleans][43728]
1385
1386 [42565]: https://github.com/rust-lang/rust/pull/42565
1387 [42973]: https://github.com/rust-lang/rust/pull/42973
1388 [43348]: https://github.com/rust-lang/rust/pull/43348
1389 [43459]: https://github.com/rust-lang/rust/pull/43459
1390 [43506]: https://github.com/rust-lang/rust/pull/43506
1391 [43540]: https://github.com/rust-lang/rust/pull/43540
1392 [43690]: https://github.com/rust-lang/rust/pull/43690
1393 [43728]: https://github.com/rust-lang/rust/pull/43728
1394 [43838]: https://github.com/rust-lang/rust/pull/43838
1395 [43863]: https://github.com/rust-lang/rust/pull/43863
1396 [43880]: https://github.com/rust-lang/rust/pull/43880
1397 [43911]: https://github.com/rust-lang/rust/pull/43911
1398 [43916]: https://github.com/rust-lang/rust/pull/43916
1399 [43917]: https://github.com/rust-lang/rust/pull/43917
1400 [44204]: https://github.com/rust-lang/rust/pull/44204
1401 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1402 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1403 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1404 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1405 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1406 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1407 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1408 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1409 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1410
1411 Version 1.20.0 (2017-08-31)
1412 ===========================
1413
1414 Language
1415 --------
1416 - [Associated constants are now stabilised.][42809]
1417 - [A lot of macro bugs are now fixed.][42913]
1418
1419 Compiler
1420 --------
1421
1422 - [Struct fields are now properly coerced to the expected field type.][42807]
1423 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1424   `wasm32-experimental-emscripten` target.
1425 - [Changed some of the error messages to be more helpful.][42033]
1426 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1427   it.][43170]
1428 - [rustc now reports the total number of errors on compilation failure][43015]
1429   previously this was only the number of errors in the pass that failed.
1430 - [Expansion in rustc has been sped up 29x.][42533]
1431 - [added `msp430-none-elf` target.][43099]
1432 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1433   applicable][43178]
1434 - [Fixes backtraces on Redox][43228]
1435 - [rustc now identifies different versions of same crate when absolute paths of
1436   different types match in an error message.][42826]
1437
1438 Libraries
1439 ---------
1440
1441
1442 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1443 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1444   tuples.][43011]
1445 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1446   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1447 - [Impl `Clone` for `DefaultHasher`.][42799]
1448 - [Impl `Sync` for `SyncSender`.][42397]
1449 - [Impl `FromStr` for `char`][42271]
1450 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1451   NaN.][42431]
1452 - [allow messages in the `unimplemented!()` macro.][42155]
1453   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1454 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1455 - [Upgrade to Unicode 10.0.0][42999]
1456 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1457 - [Skip the main thread's manual stack guard on Linux][43072]
1458 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1459 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1460   previously 2^15.
1461 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1462
1463 Stabilized APIs
1464 ---------------
1465
1466 - [`CStr::into_c_string`]
1467 - [`CString::as_c_str`]
1468 - [`CString::into_boxed_c_str`]
1469 - [`Chain::get_mut`]
1470 - [`Chain::get_ref`]
1471 - [`Chain::into_inner`]
1472 - [`Option::get_or_insert_with`]
1473 - [`Option::get_or_insert`]
1474 - [`OsStr::into_os_string`]
1475 - [`OsString::into_boxed_os_str`]
1476 - [`Take::get_mut`]
1477 - [`Take::get_ref`]
1478 - [`Utf8Error::error_len`]
1479 - [`char::EscapeDebug`]
1480 - [`char::escape_debug`]
1481 - [`compile_error!`]
1482 - [`f32::from_bits`]
1483 - [`f32::to_bits`]
1484 - [`f64::from_bits`]
1485 - [`f64::to_bits`]
1486 - [`mem::ManuallyDrop`]
1487 - [`slice::sort_unstable_by_key`]
1488 - [`slice::sort_unstable_by`]
1489 - [`slice::sort_unstable`]
1490 - [`str::from_boxed_utf8_unchecked`]
1491 - [`str::as_bytes_mut`]
1492 - [`str::as_bytes_mut`]
1493 - [`str::from_utf8_mut`]
1494 - [`str::from_utf8_unchecked_mut`]
1495 - [`str::get_mut`]
1496 - [`str::get_unchecked_mut`]
1497 - [`str::get_unchecked`]
1498 - [`str::get`]
1499 - [`str::into_boxed_bytes`]
1500
1501
1502 Cargo
1503 -----
1504 - [Cargo API token location moved from `~/.cargo/config` to
1505   `~/.cargo/credentials`.][cargo/3978]
1506 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1507   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1508   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1509 - [You can now specify version of a binary when installed through
1510   `cargo install` using `--vers`.][cargo/4229]
1511 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1512   failure.][cargo/4248]
1513 - [Changed the convention around which file is the crate root.][cargo/4259]
1514 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1515   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1516
1517 Compatibility Notes
1518 -------------------
1519
1520 - [Functions with `'static` in their return types will now not be as usable as
1521   if they were using lifetime parameters instead.][42417]
1522 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1523   takes the sign of NaN into account where previously didn't.][42430]
1524
1525 [42033]: https://github.com/rust-lang/rust/pull/42033
1526 [42155]: https://github.com/rust-lang/rust/pull/42155
1527 [42271]: https://github.com/rust-lang/rust/pull/42271
1528 [42397]: https://github.com/rust-lang/rust/pull/42397
1529 [42417]: https://github.com/rust-lang/rust/pull/42417
1530 [42430]: https://github.com/rust-lang/rust/pull/42430
1531 [42431]: https://github.com/rust-lang/rust/pull/42431
1532 [42533]: https://github.com/rust-lang/rust/pull/42533
1533 [42571]: https://github.com/rust-lang/rust/pull/42571
1534 [42613]: https://github.com/rust-lang/rust/pull/42613
1535 [42799]: https://github.com/rust-lang/rust/pull/42799
1536 [42807]: https://github.com/rust-lang/rust/pull/42807
1537 [42809]: https://github.com/rust-lang/rust/pull/42809
1538 [42822]: https://github.com/rust-lang/rust/pull/42822
1539 [42826]: https://github.com/rust-lang/rust/pull/42826
1540 [42854]: https://github.com/rust-lang/rust/pull/42854
1541 [42913]: https://github.com/rust-lang/rust/pull/42913
1542 [42999]: https://github.com/rust-lang/rust/pull/42999
1543 [43011]: https://github.com/rust-lang/rust/pull/43011
1544 [43015]: https://github.com/rust-lang/rust/pull/43015
1545 [43072]: https://github.com/rust-lang/rust/pull/43072
1546 [43077]: https://github.com/rust-lang/rust/pull/43077
1547 [43097]: https://github.com/rust-lang/rust/pull/43097
1548 [43099]: https://github.com/rust-lang/rust/pull/43099
1549 [43170]: https://github.com/rust-lang/rust/pull/43170
1550 [43178]: https://github.com/rust-lang/rust/pull/43178
1551 [43185]: https://github.com/rust-lang/rust/pull/43185
1552 [43228]: https://github.com/rust-lang/rust/pull/43228
1553 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1554 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1555 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1556 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1557 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1558 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1559 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1560 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1561 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1562 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1563 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1564 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1565 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1566 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1567 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1568 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1569 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1570 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1571 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1572 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1573 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1574 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1575 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1576 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1577 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1578 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1579 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1580 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1581 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1582 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1583 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1584 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1585 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1586 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1587 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1588 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1589 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1590 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1591 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1592
1593
1594 Version 1.19.0 (2017-07-20)
1595 ===========================
1596
1597 Language
1598 --------
1599
1600 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1601   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1602 - [Macro recursion limit increased to 1024 from 64.][41676]
1603 - [Added lint for detecting unused macros.][41907]
1604 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1605   For example: `let x = loop { break 7; };`
1606 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1607   contain `Copy` types and cannot have a `Drop` implementation.
1608   Example: `union Foo { bar: u8, baz: usize }`
1609 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1610   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1611
1612 Compiler
1613 --------
1614
1615 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1616 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1617   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1618   you should use `--target armv7-linux-androideabi`.
1619 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1620 - [Minor optimisation of string operations.][42037]
1621 - [Compiler error message is now `aborting due to previous error(s)` instead of
1622   `aborting due to N previous errors`][42150] This was previously inaccurate and
1623   would only count certain kinds of errors.
1624 - [The compiler now supports Visual Studio 2017][42225]
1625 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1626 - [Added a lot][42264] of [new error codes][42302]
1627 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1628   libraries with C Run-time Libraries(CRT) to be statically linked.
1629 - [Fixed various ARM codegen bugs][42740]
1630
1631 Libraries
1632 ---------
1633
1634 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1635   `Extend<Cow<'a, str>>`][41449]
1636 - [`Vec` now implements `From<&mut [T]>`][41530]
1637 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1638 - [`SplitWhitespace` now implements `Clone`][41659]
1639 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1640   1.5x faster][41764]
1641 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1642   macros, but for printing to stderr.
1643
1644 Stabilized APIs
1645 ---------------
1646
1647 - [`OsString::shrink_to_fit`]
1648 - [`cmp::Reverse`]
1649 - [`Command::envs`]
1650 - [`thread::ThreadId`]
1651
1652 Cargo
1653 -----
1654
1655 - [Build scripts can now add environment variables to the environment
1656   the crate is being compiled in.
1657   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1658 - [Subcommands now replace the current process rather than spawning a new
1659   child process][cargo/3970]
1660 - [Workspace members can now accept glob file patterns][cargo/3979]
1661 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1662   the members in a given workspace.][cargo/3988]
1663 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1664 - [Target directory path is now in the cargo metadata][cargo/4022]
1665 - [Cargo no longer checks out a local working directory for the
1666   crates.io index][cargo/4026] This should provide smaller file size for the
1667   registry, and improve cloning times, especially on Windows machines.
1668 - [Added an `--exclude` option for excluding certain packages when using the
1669   `--all` option][cargo/4031]
1670 - [Cargo will now automatically retry when receiving a 5xx error
1671   from crates.io][cargo/4032]
1672 - [The `--features` option now accepts multiple comma or space
1673   delimited values.][cargo/4084]
1674 - [Added support for custom target specific runners][cargo/3954]
1675
1676 Misc
1677 ----
1678
1679 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1680   Windows Debugger.
1681 - [Rust will now release XZ compressed packages][rust-installer/57]
1682 - [rustup will now prefer to download rust packages with
1683   XZ compression][rustup/1100] over GZip packages.
1684 - [Added the ability to escape `#` in rust documentation][41785] By adding
1685   additional `#`'s ie. `##` is now `#`
1686
1687 Compatibility Notes
1688 -------------------
1689
1690 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1691 - [`-Z` flags are now no longer allowed to be used on the stable
1692   compiler.][41751] This has been a warning for a year previous to this.
1693 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1694   longer works][42844]. Users should migrate to the built-in `check`
1695   command, which has been available since 1.16.
1696 - [Ending a float literal with `._` is now a hard error.
1697   Example: `42._` .][41946]
1698 - [Any use of a private `extern crate` outside of its module is now a
1699   hard error.][36886] This was previously a warning.
1700 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1701   relative while the `::` prefix makes a path absolute, but was ignored and the
1702   path was relative regardless.
1703 - [Floating point constants in match patterns is now a hard error][36890]
1704   This was previously a warning.
1705 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1706   match patterns is now a hard error][36891] This was previously a warning.
1707 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1708   a warning.
1709 - [From the pound escape, lines consisting of multiple `#`s are
1710   now visible][41785]
1711 - [It is an error to re-export private enum variants][42460]. This is
1712   known to break a number of crates that depend on an older version of
1713   mustache.
1714 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1715   to use it to find the linker, and the build will fail where it did
1716   not previously][42607]
1717
1718 [36886]: https://github.com/rust-lang/rust/issues/36886
1719 [36888]: https://github.com/rust-lang/rust/issues/36888
1720 [36890]: https://github.com/rust-lang/rust/issues/36890
1721 [36891]: https://github.com/rust-lang/rust/issues/36891
1722 [36892]: https://github.com/rust-lang/rust/issues/36892
1723 [37406]: https://github.com/rust-lang/rust/issues/37406
1724 [39983]: https://github.com/rust-lang/rust/pull/39983
1725 [41145]: https://github.com/rust-lang/rust/pull/41145
1726 [41192]: https://github.com/rust-lang/rust/pull/41192
1727 [41258]: https://github.com/rust-lang/rust/pull/41258
1728 [41370]: https://github.com/rust-lang/rust/pull/41370
1729 [41449]: https://github.com/rust-lang/rust/pull/41449
1730 [41530]: https://github.com/rust-lang/rust/pull/41530
1731 [41624]: https://github.com/rust-lang/rust/pull/41624
1732 [41656]: https://github.com/rust-lang/rust/pull/41656
1733 [41659]: https://github.com/rust-lang/rust/pull/41659
1734 [41676]: https://github.com/rust-lang/rust/pull/41676
1735 [41751]: https://github.com/rust-lang/rust/pull/41751
1736 [41764]: https://github.com/rust-lang/rust/pull/41764
1737 [41785]: https://github.com/rust-lang/rust/pull/41785
1738 [41873]: https://github.com/rust-lang/rust/pull/41873
1739 [41907]: https://github.com/rust-lang/rust/pull/41907
1740 [41946]: https://github.com/rust-lang/rust/pull/41946
1741 [42016]: https://github.com/rust-lang/rust/pull/42016
1742 [42037]: https://github.com/rust-lang/rust/pull/42037
1743 [42068]: https://github.com/rust-lang/rust/pull/42068
1744 [42150]: https://github.com/rust-lang/rust/pull/42150
1745 [42162]: https://github.com/rust-lang/rust/pull/42162
1746 [42225]: https://github.com/rust-lang/rust/pull/42225
1747 [42264]: https://github.com/rust-lang/rust/pull/42264
1748 [42302]: https://github.com/rust-lang/rust/pull/42302
1749 [42460]: https://github.com/rust-lang/rust/issues/42460
1750 [42607]: https://github.com/rust-lang/rust/issues/42607
1751 [42740]: https://github.com/rust-lang/rust/pull/42740
1752 [42844]: https://github.com/rust-lang/rust/issues/42844
1753 [42948]: https://github.com/rust-lang/rust/pull/42948
1754 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1755 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1756 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1757 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1758 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1759 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1760 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1761 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1762 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1763 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1764 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1765 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1766 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1767 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1768 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1769 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1770 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1771 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1772 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1773 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1774 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1775 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1776
1777
1778 Version 1.18.0 (2017-06-08)
1779 ===========================
1780
1781 Language
1782 --------
1783
1784 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1785   make the item visible to just that module tree. Also accepts the keyword
1786   `crate` to make something public to the whole crate but not users of the
1787   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1788 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1789   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1790 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1791   types like `Write + Send`, trailing `+` are now supported in trait objects,
1792   and better error reporting for trait objects starting with `?Sized`.
1793 - [0e+10 is now a valid floating point literal][40589]
1794 - [Now warns if you bind a lifetime parameter to 'static][40734]
1795 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1796   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1797   representation in some cases.][40377]
1798
1799 Compiler
1800 --------
1801
1802 - [rustc can now emit mir with `--emit mir`][39891]
1803 - [Improved LLVM IR for trivial functions][40367]
1804 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1805 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1806   opportunities found through profiling
1807 - [Improved backtrace formatting when panicking][38165]
1808
1809 Libraries
1810 ---------
1811
1812 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1813   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1814   iteration or reallocation.
1815 - [Simplified HashMap Bucket interface][40561] provides performance
1816   improvements for iterating and cloning.
1817 - [Specialize Vec::from_elem to use calloc][40409]
1818 - [Fixed Race condition in fs::create_dir_all][39799]
1819 - [No longer caching stdio on Windows][40516]
1820 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1821   2.50%~ faster and in one case now 12.50% faster.
1822 - [Optimized `AtomicBool::fetch_nand`][41143]
1823
1824 Stabilized APIs
1825 ---------------
1826
1827 - [`Child::try_wait`]
1828 - [`HashMap::retain`]
1829 - [`HashSet::retain`]
1830 - [`PeekMut::pop`]
1831 - [`TcpStream::peek`]
1832 - [`UdpSocket::peek`]
1833 - [`UdpSocket::peek_from`]
1834
1835 Cargo
1836 -----
1837
1838 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1839   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1840 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1841 - [Added Android build support][cargo/3885]
1842 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1843   of a certain type, for example `cargo build --bins` will build all
1844   binaries.
1845 - [Added support for haiku][cargo/3952]
1846
1847 Misc
1848 ----
1849
1850 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1851 - [Added rust-windbg script for better debugging on Windows][39983]
1852 - [Rust now uses the official cross compiler for NetBSD][40612]
1853 - [rustdoc now accepts `#` at the start of files][40828]
1854 - [Fixed jemalloc support for musl][41168]
1855
1856 Compatibility Notes
1857 -------------------
1858
1859 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1860   always placed after the sign if it exists and before the digits. With the `#`
1861   flag the zeroes are placed after the prefix and before the digits.
1862 - [Due to the struct field optimisation][40377], using `transmute` on structs
1863   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1864   always been undefined behavior, but is now more likely to break in practice.
1865 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1866   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1867   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1868 - [Overlapping inherent `impl`s are now a hard error][40728]
1869 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1870 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1871   `out.asm` and `out.ll` instead of only one of the filetypes.
1872 - [ calling a function that returns `Self` will no longer work][41805] when
1873   the size of `Self` cannot be statically determined.
1874 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1875   this has caused a few regressions namely:
1876
1877   - Changed the link order of local static/dynamic libraries (respecting the
1878     order on given rather than having the compiler reorder).
1879   - Changed how MinGW is linked, native code linked to dynamic libraries
1880     may require manually linking to the gcc support library (for the native
1881     code itself)
1882
1883 [38165]: https://github.com/rust-lang/rust/pull/38165
1884 [39799]: https://github.com/rust-lang/rust/pull/39799
1885 [39891]: https://github.com/rust-lang/rust/pull/39891
1886 [39983]: https://github.com/rust-lang/rust/pull/39983
1887 [40043]: https://github.com/rust-lang/rust/pull/40043
1888 [40241]: https://github.com/rust-lang/rust/pull/40241
1889 [40338]: https://github.com/rust-lang/rust/pull/40338
1890 [40367]: https://github.com/rust-lang/rust/pull/40367
1891 [40377]: https://github.com/rust-lang/rust/pull/40377
1892 [40409]: https://github.com/rust-lang/rust/pull/40409
1893 [40516]: https://github.com/rust-lang/rust/pull/40516
1894 [40556]: https://github.com/rust-lang/rust/pull/40556
1895 [40561]: https://github.com/rust-lang/rust/pull/40561
1896 [40589]: https://github.com/rust-lang/rust/pull/40589
1897 [40612]: https://github.com/rust-lang/rust/pull/40612
1898 [40723]: https://github.com/rust-lang/rust/pull/40723
1899 [40728]: https://github.com/rust-lang/rust/pull/40728
1900 [40731]: https://github.com/rust-lang/rust/pull/40731
1901 [40734]: https://github.com/rust-lang/rust/pull/40734
1902 [40805]: https://github.com/rust-lang/rust/pull/40805
1903 [40807]: https://github.com/rust-lang/rust/pull/40807
1904 [40828]: https://github.com/rust-lang/rust/pull/40828
1905 [40870]: https://github.com/rust-lang/rust/pull/40870
1906 [41085]: https://github.com/rust-lang/rust/pull/41085
1907 [41143]: https://github.com/rust-lang/rust/pull/41143
1908 [41168]: https://github.com/rust-lang/rust/pull/41168
1909 [41270]: https://github.com/rust-lang/rust/issues/41270
1910 [41469]: https://github.com/rust-lang/rust/pull/41469
1911 [41805]: https://github.com/rust-lang/rust/issues/41805
1912 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1913 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1914 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1915 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1916 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1917 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1918 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1919 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1920 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1921 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1922 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1923 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1924 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1925 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1926
1927
1928 Version 1.17.0 (2017-04-27)
1929 ===========================
1930
1931 Language
1932 --------
1933
1934 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1935 * [Fields of structs may be initialized without duplicating the field/variable
1936   names][39761]. [RFC 1682]
1937 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1938 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1939   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1940   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1941   `'b`. Soundness fix.
1942 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1943 * [Static variables may contain references to other statics][40027]
1944
1945 Compiler
1946 --------
1947
1948 * [Exit quickly on only `--emit dep-info`][40336]
1949 * [Make `-C relocation-model` more correctly determine whether the linker
1950   creates a position-independent executable][40245]
1951 * [Add `-C overflow-checks` to directly control whether integer overflow
1952   panics][40037]
1953 * [The rustc type checker now checks items on demand instead of in a single
1954   in-order pass][40008]. This is mostly an internal refactoring in support of
1955   future work, including incremental type checking, but also resolves [RFC
1956   1647], allowing `Self` to appear in `impl` `where` clauses.
1957 * [Optimize vtable loads][39995]
1958 * [Turn off vectorization for Emscripten targets][39990]
1959 * [Provide suggestions for unknown macros imported with `use`][39953]
1960 * [Fix ICEs in path resolution][39939]
1961 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1962 * [Add clearer error message using `&str + &str`][39116]
1963
1964 Stabilized APIs
1965 ---------------
1966
1967 * [`Arc::into_raw`]
1968 * [`Arc::from_raw`]
1969 * [`Arc::ptr_eq`]
1970 * [`Rc::into_raw`]
1971 * [`Rc::from_raw`]
1972 * [`Rc::ptr_eq`]
1973 * [`Ordering::then`]
1974 * [`Ordering::then_with`]
1975 * [`BTreeMap::range`]
1976 * [`BTreeMap::range_mut`]
1977 * [`collections::Bound`]
1978 * [`process::abort`]
1979 * [`ptr::read_unaligned`]
1980 * [`ptr::write_unaligned`]
1981 * [`Result::expect_err`]
1982 * [`Cell::swap`]
1983 * [`Cell::replace`]
1984 * [`Cell::into_inner`]
1985 * [`Cell::take`]
1986
1987 Libraries
1988 ---------
1989
1990 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1991 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1992 * [`String` implements `FromIterator<&char>`][40028]
1993 * `Box` [implements][40009] a number of new conversions:
1994   `From<Box<str>> for String`,
1995   `From<Box<[T]>> for Vec<T>`,
1996   `From<Box<CStr>> for CString`,
1997   `From<Box<OsStr>> for OsString`,
1998   `From<Box<Path>> for PathBuf`,
1999   `Into<Box<str>> for String`,
2000   `Into<Box<[T]>> for Vec<T>`,
2001   `Into<Box<CStr>> for CString`,
2002   `Into<Box<OsStr>> for OsString`,
2003   `Into<Box<Path>> for PathBuf`,
2004   `Default for Box<str>`,
2005   `Default for Box<CStr>`,
2006   `Default for Box<OsStr>`,
2007   `From<&CStr> for Box<CStr>`,
2008   `From<&OsStr> for Box<OsStr>`,
2009   `From<&Path> for Box<Path>`
2010 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
2011 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
2012 * [Slightly optimize `slice::sort`][39538]
2013 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
2014 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
2015   `Box<str>` implements `From<&str>`][39438]
2016 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
2017   `From<(I, u16)> where I: Into<IpAddr>`][39372]
2018 * [`format!` estimates the needed capacity before writing a string][39356]
2019 * [Support unprivileged symlink creation in Windows][38921]
2020 * [`PathBuf` implements `Default`][38764]
2021 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2022 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2023   and poor hash functions.
2024
2025 Cargo
2026 -----
2027
2028 * [Add `cargo check --all`][cargo/3731]
2029 * [Add an option to ignore SSL revocation checking][cargo/3699]
2030 * [Add `cargo run --package`][cargo/3691]
2031 * [Add `required_features`][cargo/3667]
2032 * [Assume `build.rs` is a build script][cargo/3664]
2033 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2034
2035 Misc
2036 ----
2037
2038 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2039   `rustbook`][39633]
2040 * [The "Unstable Book" documents nightly-only features][ubook]
2041 * [Improve the style of the sidebar in rustdoc output][40265]
2042 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2043 * [Fix MSP430 breakage due to `i128`][40257]
2044 * [Preliminary Solaris/SPARCv9 support][39903]
2045 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2046   run without installing the MSVC runtime.
2047 * [`rustdoc --test` includes file names in test names][39788]
2048 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2049   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2050 * [Initial support for `aarch64-unknown-freebsd`][39491]
2051 * [Initial support for `i686-unknown-netbsd`][39426]
2052 * [This release no longer includes the old makefile build system][39431]. Rust
2053   is built with a custom build system, written in Rust, and with Cargo.
2054 * [Add Debug implementations for libcollection structs][39002]
2055 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2056 * [`--test-threads=0` produces an error][38945]
2057 * [`rustup` installs documentation by default][40526]
2058 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2059   WinDbg and Visual Studio to improve the debugging experience.
2060
2061 Compatibility Notes
2062 -------------------
2063
2064 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2065   workaround, either use MSVC 2015 or run vcvars.bat.
2066 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2067   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2068   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2069   fix.
2070 * [`format!` and `Display::to_string` panic if an underlying formatting
2071   implementation returns an error][40117]. Previously the error was silently
2072   ignored. It is incorrect for `write_fmt` to return an error when writing
2073   to a string.
2074 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2075   crates were marked stable and could be accessed from the stable toolchain.
2076 * [Rust git source no longer includes vendored crates][39728]. Those that need
2077   to build with vendored crates should build from release tarballs.
2078 * [Fix inert attributes from `proc_macro_derives`][39572]
2079 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2080   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2081   build system.
2082 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2083   existing code generally ignores the type of dead-code unless a type-hint is
2084   provided; this can cause surprising inference interactions particularly around
2085   defaulting. The new code uniformly ignores the result type of dead-code.
2086 * [Tuple-struct constructors with private fields are no longer visible][38932]
2087 * [Lifetime parameters that do not appear in the arguments are now considered
2088   early-bound][38897], resolving a soundness bug (#[32330]). The
2089   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2090   April of 2016.
2091 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2092 * [Make transmuting from fn item types to pointer-sized types a hard
2093   error][34198]
2094
2095 [27787]: https://github.com/rust-lang/rust/issues/27787
2096 [32330]: https://github.com/rust-lang/rust/issues/32330
2097 [34198]: https://github.com/rust-lang/rust/pull/34198
2098 [38161]: https://github.com/rust-lang/rust/pull/38161
2099 [38368]: https://github.com/rust-lang/rust/pull/38368
2100 [38584]: https://github.com/rust-lang/rust/issues/38584
2101 [38661]: https://github.com/rust-lang/rust/pull/38661
2102 [38764]: https://github.com/rust-lang/rust/pull/38764
2103 [38864]: https://github.com/rust-lang/rust/issues/38864
2104 [38897]: https://github.com/rust-lang/rust/pull/38897
2105 [38921]: https://github.com/rust-lang/rust/pull/38921
2106 [38932]: https://github.com/rust-lang/rust/pull/38932
2107 [38945]: https://github.com/rust-lang/rust/pull/38945
2108 [38981]: https://github.com/rust-lang/rust/pull/38981
2109 [39002]: https://github.com/rust-lang/rust/pull/39002
2110 [39116]: https://github.com/rust-lang/rust/pull/39116
2111 [39193]: https://github.com/rust-lang/rust/pull/39193
2112 [39265]: https://github.com/rust-lang/rust/pull/39265
2113 [39356]: https://github.com/rust-lang/rust/pull/39356
2114 [39372]: https://github.com/rust-lang/rust/pull/39372
2115 [39426]: https://github.com/rust-lang/rust/pull/39426
2116 [39431]: https://github.com/rust-lang/rust/pull/39431
2117 [39438]: https://github.com/rust-lang/rust/pull/39438
2118 [39440]: https://github.com/rust-lang/rust/pull/39440
2119 [39485]: https://github.com/rust-lang/rust/pull/39485
2120 [39491]: https://github.com/rust-lang/rust/pull/39491
2121 [39518]: https://github.com/rust-lang/rust/pull/39518
2122 [39538]: https://github.com/rust-lang/rust/pull/39538
2123 [39572]: https://github.com/rust-lang/rust/pull/39572
2124 [39633]: https://github.com/rust-lang/rust/pull/39633
2125 [39642]: https://github.com/rust-lang/rust/pull/39642
2126 [39728]: https://github.com/rust-lang/rust/pull/39728
2127 [39761]: https://github.com/rust-lang/rust/pull/39761
2128 [39788]: https://github.com/rust-lang/rust/pull/39788
2129 [39793]: https://github.com/rust-lang/rust/pull/39793
2130 [39837]: https://github.com/rust-lang/rust/pull/39837
2131 [39843]: https://github.com/rust-lang/rust/pull/39843
2132 [39851]: https://github.com/rust-lang/rust/pull/39851
2133 [39903]: https://github.com/rust-lang/rust/pull/39903
2134 [39939]: https://github.com/rust-lang/rust/pull/39939
2135 [39953]: https://github.com/rust-lang/rust/pull/39953
2136 [39960]: https://github.com/rust-lang/rust/pull/39960
2137 [39990]: https://github.com/rust-lang/rust/pull/39990
2138 [39995]: https://github.com/rust-lang/rust/pull/39995
2139 [40008]: https://github.com/rust-lang/rust/pull/40008
2140 [40009]: https://github.com/rust-lang/rust/pull/40009
2141 [40027]: https://github.com/rust-lang/rust/pull/40027
2142 [40028]: https://github.com/rust-lang/rust/pull/40028
2143 [40037]: https://github.com/rust-lang/rust/pull/40037
2144 [40117]: https://github.com/rust-lang/rust/pull/40117
2145 [40166]: https://github.com/rust-lang/rust/pull/40166
2146 [40245]: https://github.com/rust-lang/rust/pull/40245
2147 [40257]: https://github.com/rust-lang/rust/pull/40257
2148 [40261]: https://github.com/rust-lang/rust/pull/40261
2149 [40265]: https://github.com/rust-lang/rust/pull/40265
2150 [40319]: https://github.com/rust-lang/rust/pull/40319
2151 [40336]: https://github.com/rust-lang/rust/pull/40336
2152 [40526]: https://github.com/rust-lang/rust/pull/40526
2153 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2154 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2155 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2156 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2157 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2158 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2159 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2160 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2161 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2162 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2163 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2164 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2165 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2166 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2167 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2168 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2169 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2170 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2171 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2172 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2173 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2174 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2175 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2176 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2177 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2178 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2179 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2180 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2181 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2182 [mdbook]: https://crates.io/crates/mdbook
2183 [ubook]: https://doc.rust-lang.org/unstable-book/
2184
2185
2186 Version 1.16.0 (2017-03-16)
2187 ===========================
2188
2189 Language
2190 --------
2191
2192 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2193 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2194   match patterns][38069]
2195 * [Clean up semantics of `self` in an import list][38313]
2196 * [`Self` may appear in `impl` headers][38920]
2197 * [`Self` may appear in struct expressions][39282]
2198
2199 Compiler
2200 --------
2201
2202 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2203   a `.rmeta` file containing only crate metadata][38571]. This can be
2204   used by tools like the Rust Language Service to perform
2205   metadata-only builds.
2206 * [Levenshtein based typo suggestions now work in most places, while
2207   previously they worked only for fields and sometimes for local
2208   variables][38927]. Together with the overhaul of "no
2209   resolution"/"unexpected resolution" errors (#[38154]) they result in
2210   large and systematic improvement in resolution diagnostics.
2211 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2212   `U`][38670]
2213 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2214 * [`rustc` no longer attempts to provide "consider using an explicit
2215   lifetime" suggestions][37057]. They were inaccurate.
2216
2217 Stabilized APIs
2218 ---------------
2219
2220 * [`VecDeque::truncate`]
2221 * [`VecDeque::resize`]
2222 * [`String::insert_str`]
2223 * [`Duration::checked_add`]
2224 * [`Duration::checked_sub`]
2225 * [`Duration::checked_div`]
2226 * [`Duration::checked_mul`]
2227 * [`str::replacen`]
2228 * [`str::repeat`]
2229 * [`SocketAddr::is_ipv4`]
2230 * [`SocketAddr::is_ipv6`]
2231 * [`IpAddr::is_ipv4`]
2232 * [`IpAddr::is_ipv6`]
2233 * [`Vec::dedup_by`]
2234 * [`Vec::dedup_by_key`]
2235 * [`Result::unwrap_or_default`]
2236 * [`<*const T>::wrapping_offset`]
2237 * [`<*mut T>::wrapping_offset`]
2238 * `CommandExt::creation_flags`
2239 * [`File::set_permissions`]
2240 * [`String::split_off`]
2241
2242 Libraries
2243 ---------
2244
2245 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2246   their argument by `Borrow` parameter][37761]
2247 * [All public types in std implement `Debug`][38006]
2248 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2249 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2250 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2251   Windows][38274]
2252 * [std: Fix partial writes in `LineWriter`][38062]
2253 * [std: Clamp max read/write sizes on Unix][38062]
2254 * [Use more specific panic message for `&str` slicing errors][38066]
2255 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2256   functionality cannot be achieved in std currently.
2257 * [`writeln!`, like `println!`, now accepts a form with no string
2258   or formatting arguments, to just print a newline][38469]
2259 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2260 * [Reduce the size of static data in `std_unicode::tables`][38781]
2261 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2262   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2263   `Display`][38909]
2264 * [`Duration` implements `Sum`][38712]
2265 * [`String` implements `ToSocketAddrs`][39048]
2266
2267 Cargo
2268 -----
2269
2270 * [The `cargo check` command does a type check of a project without
2271   building it][cargo/3296]
2272 * [crates.io will display CI badges from Travis and AppVeyor, if
2273   specified in Cargo.toml][cargo/3546]
2274 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2275 * [Compilation profiles accept integer values for `debug`, in addition
2276   to `true` and `false`. These are passed to `rustc` as the value to
2277   `-C debuginfo`][cargo/3534]
2278 * [Implement `cargo --version --verbose`][cargo/3604]
2279 * [All builds now output 'dep-info' build dependencies compatible with
2280   make and ninja][cargo/3557]
2281 * [Build all workspace members with `build --all`][cargo/3511]
2282 * [Document all workspace members with `doc --all`][cargo/3515]
2283 * [Path deps outside workspace are not members][cargo/3443]
2284
2285 Misc
2286 ----
2287
2288 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2289   the path to the Rust implementation][38589]
2290 * [The `armv7-linux-androideabi` target no longer enables NEON
2291   extensions, per Google's ABI guide][38413]
2292 * [The stock standard library can be compiled for Redox OS][38401]
2293 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2294   available.
2295 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2296   builds available.
2297 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2298
2299 Compatibility Notes
2300 -------------------
2301
2302 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2303   match patterns][38069]
2304 * In this release, references to uninhabited types can not be
2305   pattern-matched. This was accidentally allowed in 1.15.
2306 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2307 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2308   Windows][38274]
2309 * [Clean up semantics of `self` in an import list][38313]
2310 * Reimplemented lifetime elision. This change was almost entirely compatible
2311   with existing code, but it did close a number of small bugs and loopholes,
2312   as well as being more accepting in some other [cases][41105].
2313
2314 [37057]: https://github.com/rust-lang/rust/pull/37057
2315 [37761]: https://github.com/rust-lang/rust/pull/37761
2316 [38006]: https://github.com/rust-lang/rust/pull/38006
2317 [38051]: https://github.com/rust-lang/rust/pull/38051
2318 [38062]: https://github.com/rust-lang/rust/pull/38062
2319 [38062]: https://github.com/rust-lang/rust/pull/38622
2320 [38066]: https://github.com/rust-lang/rust/pull/38066
2321 [38069]: https://github.com/rust-lang/rust/pull/38069
2322 [38131]: https://github.com/rust-lang/rust/pull/38131
2323 [38154]: https://github.com/rust-lang/rust/pull/38154
2324 [38274]: https://github.com/rust-lang/rust/pull/38274
2325 [38304]: https://github.com/rust-lang/rust/pull/38304
2326 [38313]: https://github.com/rust-lang/rust/pull/38313
2327 [38314]: https://github.com/rust-lang/rust/pull/38314
2328 [38327]: https://github.com/rust-lang/rust/pull/38327
2329 [38401]: https://github.com/rust-lang/rust/pull/38401
2330 [38413]: https://github.com/rust-lang/rust/pull/38413
2331 [38469]: https://github.com/rust-lang/rust/pull/38469
2332 [38559]: https://github.com/rust-lang/rust/pull/38559
2333 [38571]: https://github.com/rust-lang/rust/pull/38571
2334 [38580]: https://github.com/rust-lang/rust/pull/38580
2335 [38589]: https://github.com/rust-lang/rust/pull/38589
2336 [38670]: https://github.com/rust-lang/rust/pull/38670
2337 [38712]: https://github.com/rust-lang/rust/pull/38712
2338 [38726]: https://github.com/rust-lang/rust/pull/38726
2339 [38781]: https://github.com/rust-lang/rust/pull/38781
2340 [38798]: https://github.com/rust-lang/rust/pull/38798
2341 [38909]: https://github.com/rust-lang/rust/pull/38909
2342 [38920]: https://github.com/rust-lang/rust/pull/38920
2343 [38927]: https://github.com/rust-lang/rust/pull/38927
2344 [39048]: https://github.com/rust-lang/rust/pull/39048
2345 [39282]: https://github.com/rust-lang/rust/pull/39282
2346 [39379]: https://github.com/rust-lang/rust/pull/39379
2347 [41105]: https://github.com/rust-lang/rust/issues/41105
2348 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2349 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2350 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2351 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2352 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2353 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2354 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2355 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2356 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2357 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2358 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2359 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2360 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2361 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2362 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2363 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2364 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2365 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2366 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2367 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2368 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2369 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2370 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2371 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2372 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2373 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2374 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2375 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2376 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2377 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2378
2379
2380 Version 1.15.1 (2017-02-09)
2381 ===========================
2382
2383 * [Fix IntoIter::as_mut_slice's signature][39466]
2384 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2385
2386 [39466]: https://github.com/rust-lang/rust/pull/39466
2387 [39523]: https://github.com/rust-lang/rust/pull/39523
2388
2389
2390 Version 1.15.0 (2017-02-02)
2391 ===========================
2392
2393 Language
2394 --------
2395
2396 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2397   stable. This allows popular code-generating crates like Serde and Diesel to
2398   work ergonomically. [RFC 1681].
2399 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2400   with curly braces][36868]. Part of [RFC 1506].
2401 * [A number of minor changes to name resolution have been activated][37127].
2402   They add up to more consistent semantics, allowing for future evolution of
2403   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2404   details of what is different. The breaking changes here have been transitioned
2405   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2406 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2407   bounds][38279]
2408 * [`?Sized` can be used in `where` clauses][37791]
2409 * [There is now a limit on the size of monomorphized types and it can be
2410   modified with the `#![type_size_limit]` crate attribute, similarly to
2411   the `#![recursion_limit]` attribute][37789]
2412
2413 Compiler
2414 --------
2415
2416 * [On Windows, the compiler will apply dllimport attributes when linking to
2417   extern functions][37973]. Additional attributes and flags can control which
2418   library kind is linked and its name. [RFC 1717].
2419 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2420 * [The `--test` flag works with procedural macro crates][38107]
2421 * [Fix `extern "aapcs" fn` ABI][37814]
2422 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2423 * [The `format!` expander recognizes incorrect `printf` and shell-style
2424   formatting directives and suggests the correct format][37613].
2425 * [Only report one error for all unused imports in an import list][37456]
2426
2427 Compiler Performance
2428 --------------------
2429
2430 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2431 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2432 * [Don't clone in `UnificationTable::probe`][37848]
2433 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2434 * [Use small vectors in type walker][37760]
2435 * [Macro expansion performance was improved][37701]
2436 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2437 * [Replace FNV with a faster hash function][37229]
2438
2439 Stabilized APIs
2440 ---------------
2441
2442 * [`std::iter::Iterator::min_by`]
2443 * [`std::iter::Iterator::max_by`]
2444 * [`std::os::*::fs::FileExt`]
2445 * [`std::sync::atomic::Atomic*::get_mut`]
2446 * [`std::sync::atomic::Atomic*::into_inner`]
2447 * [`std::vec::IntoIter::as_slice`]
2448 * [`std::vec::IntoIter::as_mut_slice`]
2449 * [`std::sync::mpsc::Receiver::try_iter`]
2450 * [`std::os::unix::process::CommandExt::before_exec`]
2451 * [`std::rc::Rc::strong_count`]
2452 * [`std::rc::Rc::weak_count`]
2453 * [`std::sync::Arc::strong_count`]
2454 * [`std::sync::Arc::weak_count`]
2455 * [`std::char::encode_utf8`]
2456 * [`std::char::encode_utf16`]
2457 * [`std::cell::Ref::clone`]
2458 * [`std::io::Take::into_inner`]
2459
2460 Libraries
2461 ---------
2462
2463 * [The standard sorting algorithm has been rewritten for dramatic performance
2464   improvements][38192]. It is a hybrid merge sort, drawing influences from
2465   Timsort. Previously it was a naive merge sort.
2466 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2467 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2468   performance.
2469 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2470   and `char_indices().last()`][37882]
2471 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2472 * [Chinese characters display correctly in `fmt::Debug`][37855]
2473 * [Derive `Default` for `Duration`][37699]
2474 * [Support creation of anonymous pipes on WinXP/2k][37677]
2475 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2476 * [Don't pass overlapped handles to processes][38835]
2477
2478 Cargo
2479 -----
2480
2481 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2482   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2483   should instead check the variable at runtime with `std::env`. That the value
2484   was set at build time was a bug, and incorrect when cross-compiling. This
2485   change is known to cause breakage.
2486 * [Add `--all` flag to `cargo test`][cargo/3221]
2487 * [Compile statically against the MSVC CRT][cargo/3363]
2488 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2489 * [Link OpenSSL statically on OSX][cargo/3311]
2490 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2491 * [Test for bad path overrides with summaries][cargo/3336]
2492 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2493 * [Fix retrying crate downloads for network errors][cargo/3348]
2494 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2495 * [Emit more info on --message-format=json][cargo/3319]
2496 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2497 * [Don't ignore errors in workspace manifest][cargo/3409]
2498 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2499
2500 Tooling
2501 -------
2502
2503 * [Test runners (binaries built with `--test`) now support a `--list` argument
2504   that lists the tests it contains][38185]
2505 * [Test runners now support a `--exact` argument that makes the test filter
2506   match exactly, instead of matching only a substring of the test name][38181]
2507 * [rustdoc supports a `--playground-url` flag][37763]
2508 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2509
2510 Misc
2511 ----
2512
2513 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2514   continue to be used in this release by passing `--disable-rustbuild` to the
2515   configure script, but they will be deleted soon. Note that the new build
2516   system uses a different on-disk layout that will likely affect any scripts
2517   building Rust.
2518 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2519   releases.
2520 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2521 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2522   releases.
2523
2524 Compatibility Notes
2525 -------------------
2526
2527 * [A number of minor changes to name resolution have been activated][37127].
2528   They add up to more consistent semantics, allowing for future evolution of
2529   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2530   details of what is different. The breaking changes here have been transitioned
2531   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2532 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2533   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2534   should instead check the variable at runtime with `std::env`. That the value
2535   was set at build time was a bug, and incorrect when cross-compiling. This
2536   change is known to cause breakage.
2537 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2538   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2539   1.10 and is now an error by default. It will become a hard error in the near
2540   future.
2541 * [The semantics relating modules to file system directories are changing in
2542   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2543   lint, which is a warning in this release, and will become a hard error in the
2544   future.
2545 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2546 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2547   the underlying iterator][37834]
2548
2549 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2550 [33685]: https://github.com/rust-lang/rust/issues/33685
2551 [36868]: https://github.com/rust-lang/rust/pull/36868
2552 [37127]: https://github.com/rust-lang/rust/pull/37127
2553 [37229]: https://github.com/rust-lang/rust/pull/37229
2554 [37456]: https://github.com/rust-lang/rust/pull/37456
2555 [37527]: https://github.com/rust-lang/rust/pull/37527
2556 [37602]: https://github.com/rust-lang/rust/pull/37602
2557 [37613]: https://github.com/rust-lang/rust/pull/37613
2558 [37615]: https://github.com/rust-lang/rust/pull/37615
2559 [37636]: https://github.com/rust-lang/rust/pull/37636
2560 [37627]: https://github.com/rust-lang/rust/pull/37627
2561 [37642]: https://github.com/rust-lang/rust/pull/37642
2562 [37677]: https://github.com/rust-lang/rust/pull/37677
2563 [37699]: https://github.com/rust-lang/rust/pull/37699
2564 [37701]: https://github.com/rust-lang/rust/pull/37701
2565 [37705]: https://github.com/rust-lang/rust/pull/37705
2566 [37749]: https://github.com/rust-lang/rust/pull/37749
2567 [37760]: https://github.com/rust-lang/rust/pull/37760
2568 [37763]: https://github.com/rust-lang/rust/pull/37763
2569 [37764]: https://github.com/rust-lang/rust/pull/37764
2570 [37789]: https://github.com/rust-lang/rust/pull/37789
2571 [37791]: https://github.com/rust-lang/rust/pull/37791
2572 [37814]: https://github.com/rust-lang/rust/pull/37814
2573 [37817]: https://github.com/rust-lang/rust/pull/37817
2574 [37834]: https://github.com/rust-lang/rust/pull/37834
2575 [37848]: https://github.com/rust-lang/rust/pull/37848
2576 [37855]: https://github.com/rust-lang/rust/pull/37855
2577 [37882]: https://github.com/rust-lang/rust/pull/37882
2578 [37888]: https://github.com/rust-lang/rust/pull/37888
2579 [37973]: https://github.com/rust-lang/rust/pull/37973
2580 [37979]: https://github.com/rust-lang/rust/pull/37979
2581 [38086]: https://github.com/rust-lang/rust/pull/38086
2582 [38107]: https://github.com/rust-lang/rust/pull/38107
2583 [38117]: https://github.com/rust-lang/rust/pull/38117
2584 [38134]: https://github.com/rust-lang/rust/pull/38134
2585 [38146]: https://github.com/rust-lang/rust/pull/38146
2586 [38181]: https://github.com/rust-lang/rust/pull/38181
2587 [38182]: https://github.com/rust-lang/rust/pull/38182
2588 [38185]: https://github.com/rust-lang/rust/pull/38185
2589 [38192]: https://github.com/rust-lang/rust/pull/38192
2590 [38279]: https://github.com/rust-lang/rust/pull/38279
2591 [38835]: https://github.com/rust-lang/rust/pull/38835
2592 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2593 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2594 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2595 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2596 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2597 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2598 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2599 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2600 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2601 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2602 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2603 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2604 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2605 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2606 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2607 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2608 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2609 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2610 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2611 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2612 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2613 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2614 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2615 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2616 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2617 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2618 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2619 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2620 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2621 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2622 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2623 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2624 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2625 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2626 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2627 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2628 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2629 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2630
2631
2632 Version 1.14.0 (2016-12-22)
2633 ===========================
2634
2635 Language
2636 --------
2637
2638 * [`..` matches multiple tuple fields in enum variants, structs
2639   and tuples][36843]. [RFC 1492].
2640 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2641 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2642 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2643   dereferencing][36822]
2644
2645 Compiler
2646 --------
2647
2648 * [Mark enums with non-zero discriminant as non-zero][37224]
2649 * [Lower-case `static mut` names are linted like other
2650   statics and consts][37162]
2651 * [Fix ICE on some macros in const integer positions
2652    (e.g. `[u8; m!()]`)][36819]
2653 * [Improve error message and snippet for "did you mean `x`"][36798]
2654 * [Add a panic-strategy field to the target specification][36794]
2655 * [Include LLVM version in `--version --verbose`][37200]
2656
2657 Compile-time Optimizations
2658 --------------------------
2659
2660 * [Improve macro expansion performance][37569]
2661 * [Shrink `Expr_::ExprInlineAsm`][37445]
2662 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2663 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2664 * [Avoid more allocations when compiling html5ever][37373]
2665 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2666 * [Avoid some allocations in the macro parser][37318]
2667 * [Use a faster deflate setting][37298]
2668 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2669   during interning of slices][37270]
2670 * [Optimize `write_metadata`][37267]
2671 * [Don't process obligation forest cycles when stalled][37231]
2672 * [Avoid many `CrateConfig` clones][37161]
2673 * [Optimize `Substs::super_fold_with`][37108]
2674 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2675 * [Speed up `plug_leaks`][36917]
2676
2677 Libraries
2678 ---------
2679
2680 * [`println!()`, with no arguments, prints newline][36825].
2681   Previously, an empty string was required to achieve the same.
2682 * [`Wrapping` impls standard binary and unary operators, as well as
2683    the `Sum` and `Product` iterators][37356]
2684 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2685   Vec<T>`][37326]
2686 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2687   `VecDeque` iterators][37315]
2688 * [Improve `SipHasher` performance on small values][37312]
2689 * [Add Iterator trait TrustedLen to enable better FromIterator /
2690   Extend][37306]
2691 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2692 * [`ReadDir` implements `Debug`][37221]
2693 * [Implement `RefUnwindSafe` for atomic types][37178]
2694 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2695 * [Avoid allocations in `Decoder::read_str`][37064]
2696 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2697 * [Impl `Debug` for raw pointers to unsized data][36880]
2698 * [Don't reuse `HashMap` random seeds][37470]
2699 * [The internal memory layout of `HashMap` is more cache-friendly, for
2700   significant improvements in some operations][36692]
2701 * [`HashMap` uses less memory on 32-bit architectures][36595]
2702 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2703
2704 Cargo
2705 -----
2706
2707 * [Expose rustc cfg values to build scripts][cargo/3243]
2708 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2709 * [Fix passing --features when testing multiple packages][cargo/3280]
2710 * [Use a single profile set per workspace][cargo/3249]
2711 * [Load `replace` sections from lock files][cargo/3220]
2712 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2713
2714 Tooling
2715 -------
2716
2717 * [rustup is the recommended Rust installation method][1.14rustup]
2718 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2719   S390x. These are [tier 2] platforms and may have major defects. Follow the
2720   instructions on the website to install, or add the targets to an existing
2721   installation with `rustup target add`. The new target triples are:
2722   - `mips-unknown-linux-gnu`
2723   - `mipsel-unknown-linux-gnu`
2724   - `mips64-unknown-linux-gnuabi64`
2725   - `mips64el-unknown-linux-gnuabi64 `
2726   - `powerpc-unknown-linux-gnu`
2727   - `powerpc64-unknown-linux-gnu`
2728   - `powerpc64le-unknown-linux-gnu`
2729   - `s390x-unknown-linux-gnu `
2730 * This release includes target (std) builds for ARM Linux running MUSL
2731   libc. These are [tier 2] platforms and may have major defects. Add the
2732   following triples to an existing rustup installation with `rustup target add`:
2733   - `arm-unknown-linux-musleabi`
2734   - `arm-unknown-linux-musleabihf`
2735   - `armv7-unknown-linux-musleabihf`
2736 * This release includes [experimental support for WebAssembly][1.14wasm], via
2737   the `wasm32-unknown-emscripten` target. This target is known to have major
2738   defects. Please test, report, and fix.
2739 * rustup no longer installs documentation by default. Run `rustup
2740   component add rust-docs` to install.
2741 * [Fix line stepping in debugger][37310]
2742 * [Enable line number debuginfo in releases][37280]
2743
2744 Misc
2745 ----
2746
2747 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2748 * [Add support for Fuchsia OS][37313]
2749 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2750
2751 Compatibility Notes
2752 -------------------
2753
2754 * [A number of forward-compatibility lints used by the compiler
2755   to gradually introduce language changes have been converted
2756   to deny by default][36894]:
2757   - ["use of inaccessible extern crate erroneously allowed"][36886]
2758   - ["type parameter default erroneously allowed in invalid location"][36887]
2759   - ["detects super or self keywords at the beginning of global path"][36888]
2760   - ["two overlapping inherent impls define an item with the same name
2761     were erroneously allowed"][36889]
2762   - ["floating-point constants cannot be used in patterns"][36890]
2763   - ["constants of struct or enum type can only be used in a pattern if
2764      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2765   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2766 * [Prohibit patterns in trait methods without bodies][37378]
2767 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2768 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2769 * [The `$crate` macro variable is accepted in fewer locations][37213]
2770 * [Impls specifying extra region requirements beyond the trait
2771   they implement are rejected][37167]
2772 * [Enums may not be unsized][37111]. Unsized enums are intended to
2773   work but never have. For now they are forbidden.
2774 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2775
2776 [tier 2]: https://forge.rust-lang.org/platform-support.html
2777 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2778 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2779 [36430]: https://github.com/rust-lang/rust/pull/36430
2780 [36595]: https://github.com/rust-lang/rust/pull/36595
2781 [36595]: https://github.com/rust-lang/rust/pull/36595
2782 [36692]: https://github.com/rust-lang/rust/pull/36692
2783 [36767]: https://github.com/rust-lang/rust/pull/36767
2784 [36794]: https://github.com/rust-lang/rust/pull/36794
2785 [36798]: https://github.com/rust-lang/rust/pull/36798
2786 [36819]: https://github.com/rust-lang/rust/pull/36819
2787 [36822]: https://github.com/rust-lang/rust/pull/36822
2788 [36825]: https://github.com/rust-lang/rust/pull/36825
2789 [36843]: https://github.com/rust-lang/rust/pull/36843
2790 [36880]: https://github.com/rust-lang/rust/pull/36880
2791 [36886]: https://github.com/rust-lang/rust/issues/36886
2792 [36887]: https://github.com/rust-lang/rust/issues/36887
2793 [36888]: https://github.com/rust-lang/rust/issues/36888
2794 [36889]: https://github.com/rust-lang/rust/issues/36889
2795 [36890]: https://github.com/rust-lang/rust/issues/36890
2796 [36891]: https://github.com/rust-lang/rust/issues/36891
2797 [36892]: https://github.com/rust-lang/rust/issues/36892
2798 [36894]: https://github.com/rust-lang/rust/pull/36894
2799 [36917]: https://github.com/rust-lang/rust/pull/36917
2800 [36993]: https://github.com/rust-lang/rust/pull/36993
2801 [37037]: https://github.com/rust-lang/rust/pull/37037
2802 [37064]: https://github.com/rust-lang/rust/pull/37064
2803 [37094]: https://github.com/rust-lang/rust/pull/37094
2804 [37108]: https://github.com/rust-lang/rust/pull/37108
2805 [37111]: https://github.com/rust-lang/rust/pull/37111
2806 [37161]: https://github.com/rust-lang/rust/pull/37161
2807 [37162]: https://github.com/rust-lang/rust/pull/37162
2808 [37167]: https://github.com/rust-lang/rust/pull/37167
2809 [37178]: https://github.com/rust-lang/rust/pull/37178
2810 [37200]: https://github.com/rust-lang/rust/pull/37200
2811 [37213]: https://github.com/rust-lang/rust/pull/37213
2812 [37221]: https://github.com/rust-lang/rust/pull/37221
2813 [37224]: https://github.com/rust-lang/rust/pull/37224
2814 [37230]: https://github.com/rust-lang/rust/pull/37230
2815 [37231]: https://github.com/rust-lang/rust/pull/37231
2816 [37247]: https://github.com/rust-lang/rust/pull/37247
2817 [37267]: https://github.com/rust-lang/rust/pull/37267
2818 [37270]: https://github.com/rust-lang/rust/pull/37270
2819 [37273]: https://github.com/rust-lang/rust/pull/37273
2820 [37280]: https://github.com/rust-lang/rust/pull/37280
2821 [37298]: https://github.com/rust-lang/rust/pull/37298
2822 [37306]: https://github.com/rust-lang/rust/pull/37306
2823 [37310]: https://github.com/rust-lang/rust/pull/37310
2824 [37312]: https://github.com/rust-lang/rust/pull/37312
2825 [37313]: https://github.com/rust-lang/rust/pull/37313
2826 [37315]: https://github.com/rust-lang/rust/pull/37315
2827 [37318]: https://github.com/rust-lang/rust/pull/37318
2828 [37322]: https://github.com/rust-lang/rust/pull/37322
2829 [37326]: https://github.com/rust-lang/rust/pull/37326
2830 [37351]: https://github.com/rust-lang/rust/pull/37351
2831 [37356]: https://github.com/rust-lang/rust/pull/37356
2832 [37367]: https://github.com/rust-lang/rust/pull/37367
2833 [37373]: https://github.com/rust-lang/rust/pull/37373
2834 [37378]: https://github.com/rust-lang/rust/pull/37378
2835 [37389]: https://github.com/rust-lang/rust/pull/37389
2836 [37392]: https://github.com/rust-lang/rust/pull/37392
2837 [37427]: https://github.com/rust-lang/rust/pull/37427
2838 [37439]: https://github.com/rust-lang/rust/pull/37439
2839 [37445]: https://github.com/rust-lang/rust/pull/37445
2840 [37470]: https://github.com/rust-lang/rust/pull/37470
2841 [37569]: https://github.com/rust-lang/rust/pull/37569
2842 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2843 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2844 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2845 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2846 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2847 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2848 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2849
2850
2851 Version 1.13.0 (2016-11-10)
2852 ===========================
2853
2854 Language
2855 --------
2856
2857 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2858   errors, like the `try!` macro, described in [RFC 0243].
2859 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2860 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2861 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2862 * [Fix lifetime rules for 'if' conditions][36029]
2863 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2864
2865 Compiler
2866 --------
2867
2868 * [Add the `-C link-arg` argument][36574]
2869 * [Remove the old AST-based backend from rustc_trans][35764]
2870 * [Don't enable NEON by default on armv7 Linux][35814]
2871 * [Fix debug line number info for macro expansions][35238]
2872 * [Do not emit "class method" debuginfo for types that are not
2873   DICompositeType][36008]
2874 * [Warn about multiple conflicting #[repr] hints][34623]
2875 * [When sizing DST, don't double-count nested struct prefixes][36351]
2876 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2877 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2878 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2879 * [Expand macros without recursing to avoid stack overflows][36214]
2880
2881 Diagnostics
2882 -----------
2883
2884 * [Replace macro backtraces with labeled local uses][35702]
2885 * [Improve error message for misplaced doc comments][33922]
2886 * [Buffer unix and lock windows to prevent message interleaving][35975]
2887 * [Update lifetime errors to specifically note temporaries][36171]
2888 * [Special case a few colors for Windows][36178]
2889 * [Suggest `use self` when such an import resolves][36289]
2890 * [Be more specific when type parameter shadows primitive type][36338]
2891 * Many minor improvements
2892
2893 Compile-time Optimizations
2894 --------------------------
2895
2896 * [Compute and cache HIR hashes at beginning][35854]
2897 * [Don't hash types in loan paths][36004]
2898 * [Cache projections in trans][35761]
2899 * [Optimize the parser's last token handling][36527]
2900 * [Only instantiate #[inline] functions in codegen units referencing
2901   them][36524]. This leads to big improvements in cases where crates export
2902   define many inline functions without using them directly.
2903 * [Lazily allocate TypedArena's first chunk][36592]
2904 * [Don't allocate during default HashSet creation][36734]
2905
2906 Stabilized APIs
2907 ---------------
2908
2909 * [`checked_abs`]
2910 * [`wrapping_abs`]
2911 * [`overflowing_abs`]
2912 * [`RefCell::try_borrow`]
2913 * [`RefCell::try_borrow_mut`]
2914
2915 Libraries
2916 ---------
2917
2918 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2919 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2920   covariant][35354]
2921 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2922 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2923 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2924 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2925 * [Use arc4rand on FreeBSD][35884]
2926 * [memrchr: Correct aligned offset computation][35969]
2927 * [Improve Demangling of Rust Symbols][36059]
2928 * [Use monotonic time in condition variables][35048]
2929 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2930 * [Implement conversion traits for `char`][35755]
2931 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2932 * [Zero first byte of CString on drop][36264]
2933 * [Inherit overflow checks for sum and product][36372]
2934 * [Add missing Eq implementations][36423]
2935 * [Implement `Debug` for `DirEntry`][36631]
2936 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2937   `errno`][36754]
2938 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2939 * [Implement more traits for `std::io::ErrorKind`][35911]
2940 * [Optimize BinaryHeap bounds checking][36072]
2941 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2942   `extend_with_element`][36355]
2943 * [Fix overflow checking in unsigned pow()][34942]
2944
2945 Cargo
2946 -----
2947
2948 * This release includes security fixes to both curl and OpenSSL.
2949 * [Fix transitive doctests when panic=abort][cargo/3021]
2950 * [Add --all-features flag to cargo][cargo/3038]
2951 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2952 * [Don't parse the home directory more than once][cargo/3078]
2953 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2954 * [Update OpenSSL to 1.0.2j][cargo/3121]
2955 * [Add license and license_file to cargo metadata output][cargo/3110]
2956 * [Make crates-io registry URL optional in config; ignore all changes to
2957   source.crates-io][cargo/3089]
2958 * [Don't download dependencies from other platforms][cargo/3123]
2959 * [Build transitive dev-dependencies when needed][cargo/3125]
2960 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2961 * [Avoid updating registry when adding existing deps][cargo/3144]
2962 * [Warn about path overrides that won't work][cargo/3136]
2963 * [Use workspaces during `cargo install`][cargo/3146]
2964 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2965 * [Add --message-format flag][cargo/3000]
2966 * [Pass target environment for rustdoc][cargo/3205]
2967 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2968 * [Update curl and curl-sys][cargo/3241]
2969 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2970
2971 Tooling
2972 -------
2973
2974 * [rustdoc: Add the `--sysroot` argument][36586]
2975 * [rustdoc: Fix a couple of issues with the search results][35655]
2976 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2977 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2978 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2979
2980 Misc
2981 ----
2982
2983 * [Remove unmaintained style guide][35124]
2984 * [Add s390x support][36369]
2985 * [Initial work at Haiku OS support][36727]
2986 * [Add mips-uclibc targets][35734]
2987 * [Crate-ify compiler-rt into compiler-builtins][35021]
2988 * [Add rustc version info (git hash + date) to dist tarball][36213]
2989 * Many documentation improvements
2990
2991 Compatibility Notes
2992 -------------------
2993
2994 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2995 * [Deny (by default) transmuting from fn item types to pointer-sized
2996   types][34923]. Continuing the long transition to zero-sized fn items,
2997   per [RFC 401].
2998 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2999   Part of [RFC 1506].
3000 * [Issue deprecation warnings for safe accesses to extern statics][36173]
3001 * [Fix lifetime rules for 'if' conditions][36029].
3002 * [Inherit overflow checks for sum and product][36372].
3003 * [Forbid user-defined macros named "macro_rules"][36730].
3004
3005 [33922]: https://github.com/rust-lang/rust/pull/33922
3006 [34623]: https://github.com/rust-lang/rust/pull/34623
3007 [34923]: https://github.com/rust-lang/rust/pull/34923
3008 [34942]: https://github.com/rust-lang/rust/pull/34942
3009 [34982]: https://github.com/rust-lang/rust/pull/34982
3010 [35021]: https://github.com/rust-lang/rust/pull/35021
3011 [35048]: https://github.com/rust-lang/rust/pull/35048
3012 [35074]: https://github.com/rust-lang/rust/pull/35074
3013 [35124]: https://github.com/rust-lang/rust/pull/35124
3014 [35234]: https://github.com/rust-lang/rust/pull/35234
3015 [35238]: https://github.com/rust-lang/rust/pull/35238
3016 [35354]: https://github.com/rust-lang/rust/pull/35354
3017 [35559]: https://github.com/rust-lang/rust/pull/35559
3018 [35585]: https://github.com/rust-lang/rust/pull/35585
3019 [35627]: https://github.com/rust-lang/rust/pull/35627
3020 [35655]: https://github.com/rust-lang/rust/pull/35655
3021 [35702]: https://github.com/rust-lang/rust/pull/35702
3022 [35707]: https://github.com/rust-lang/rust/pull/35707
3023 [35728]: https://github.com/rust-lang/rust/pull/35728
3024 [35734]: https://github.com/rust-lang/rust/pull/35734
3025 [35755]: https://github.com/rust-lang/rust/pull/35755
3026 [35761]: https://github.com/rust-lang/rust/pull/35761
3027 [35764]: https://github.com/rust-lang/rust/pull/35764
3028 [35814]: https://github.com/rust-lang/rust/pull/35814
3029 [35854]: https://github.com/rust-lang/rust/pull/35854
3030 [35871]: https://github.com/rust-lang/rust/pull/35871
3031 [35884]: https://github.com/rust-lang/rust/pull/35884
3032 [35911]: https://github.com/rust-lang/rust/pull/35911
3033 [35969]: https://github.com/rust-lang/rust/pull/35969
3034 [35975]: https://github.com/rust-lang/rust/pull/35975
3035 [36004]: https://github.com/rust-lang/rust/pull/36004
3036 [36008]: https://github.com/rust-lang/rust/pull/36008
3037 [36014]: https://github.com/rust-lang/rust/pull/36014
3038 [36029]: https://github.com/rust-lang/rust/pull/36029
3039 [36059]: https://github.com/rust-lang/rust/pull/36059
3040 [36072]: https://github.com/rust-lang/rust/pull/36072
3041 [36101]: https://github.com/rust-lang/rust/pull/36101
3042 [36104]: https://github.com/rust-lang/rust/pull/36104
3043 [36171]: https://github.com/rust-lang/rust/pull/36171
3044 [36173]: https://github.com/rust-lang/rust/pull/36173
3045 [36178]: https://github.com/rust-lang/rust/pull/36178
3046 [36213]: https://github.com/rust-lang/rust/pull/36213
3047 [36214]: https://github.com/rust-lang/rust/pull/36214
3048 [36264]: https://github.com/rust-lang/rust/pull/36264
3049 [36266]: https://github.com/rust-lang/rust/pull/36266
3050 [36289]: https://github.com/rust-lang/rust/pull/36289
3051 [36338]: https://github.com/rust-lang/rust/pull/36338
3052 [36351]: https://github.com/rust-lang/rust/pull/36351
3053 [36355]: https://github.com/rust-lang/rust/pull/36355
3054 [36369]: https://github.com/rust-lang/rust/pull/36369
3055 [36372]: https://github.com/rust-lang/rust/pull/36372
3056 [36423]: https://github.com/rust-lang/rust/pull/36423
3057 [36482]: https://github.com/rust-lang/rust/pull/36482
3058 [36505]: https://github.com/rust-lang/rust/pull/36505
3059 [36524]: https://github.com/rust-lang/rust/pull/36524
3060 [36527]: https://github.com/rust-lang/rust/pull/36527
3061 [36551]: https://github.com/rust-lang/rust/pull/36551
3062 [36574]: https://github.com/rust-lang/rust/pull/36574
3063 [36586]: https://github.com/rust-lang/rust/pull/36586
3064 [36592]: https://github.com/rust-lang/rust/pull/36592
3065 [36631]: https://github.com/rust-lang/rust/pull/36631
3066 [36639]: https://github.com/rust-lang/rust/pull/36639
3067 [36721]: https://github.com/rust-lang/rust/pull/36721
3068 [36727]: https://github.com/rust-lang/rust/pull/36727
3069 [36730]: https://github.com/rust-lang/rust/pull/36730
3070 [36734]: https://github.com/rust-lang/rust/pull/36734
3071 [36754]: https://github.com/rust-lang/rust/pull/36754
3072 [36995]: https://github.com/rust-lang/rust/pull/36995
3073 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3074 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3075 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3076 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3077 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3078 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3079 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3080 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3081 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3082 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3083 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3084 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3085 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3086 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3087 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3088 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3089 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3090 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3091 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3092 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3093 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3094 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3095 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3096 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3097 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3098 [rustup]: https://www.rustup.rs
3099 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3100 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3101 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3102 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3103 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3104 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3105 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3106
3107
3108 Version 1.12.1 (2016-10-20)
3109 ===========================
3110
3111 Regression Fixes
3112 ----------------
3113
3114 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3115 * [Confusion with double negation and booleans][36856]
3116 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3117 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3118 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3119 * [Corrupted memory after updated to 1.12][36936]
3120 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3121 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3122 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3123
3124 [36381]: https://github.com/rust-lang/rust/issues/36381
3125 [36856]: https://github.com/rust-lang/rust/issues/36856
3126 [36875]: https://github.com/rust-lang/rust/issues/36875
3127 [36924]: https://github.com/rust-lang/rust/issues/36924
3128 [36926]: https://github.com/rust-lang/rust/issues/36926
3129 [36936]: https://github.com/rust-lang/rust/issues/36936
3130 [37026]: https://github.com/rust-lang/rust/issues/37026
3131 [37112]: https://github.com/rust-lang/rust/issues/37112
3132 [37153]: https://github.com/rust-lang/rust/issues/37153
3133
3134
3135 Version 1.12.0 (2016-09-29)
3136 ===========================
3137
3138 Highlights
3139 ----------
3140
3141 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3142   This translation pass is far simpler than the previous AST->LLVM pass, and
3143   creates opportunities to perform new optimizations directly on the MIR. It
3144   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3145 * [`rustc` presents a new, more readable error format, along with
3146   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3147   Most common editors supporting Rust have been updated to work with it. It was
3148   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3149
3150 Compiler
3151 --------
3152
3153 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3154   This translation pass is far simpler than the previous AST->LLVM pass, and
3155   creates opportunities to perform new optimizations directly on the MIR. It
3156   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3157 * [Print the Rust target name, not the LLVM target name, with
3158   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3159 * [The computation of `TypeId` is correct in some cases where it was previously
3160   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3161 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3162 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3163   `--print relocation-models`, and `--print code-models` print the available
3164   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3165   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3166 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3167   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3168   These targets produce statically-linked binaries. There are no binary release
3169   builds yet though.
3170
3171 Diagnostics
3172 -----------
3173
3174 * [`rustc` presents a new, more readable error format, along with
3175   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3176   Most common editors supporting Rust have been updated to work with it. It was
3177   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3178 * [In error descriptions, references are now described in plain English,
3179   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3180 * [In error type descriptions, unknown numeric types are named `{integer}` or
3181   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3182 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3183
3184 Language
3185 --------
3186
3187 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3188 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3189 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3190   useful](https://github.com/rust-lang/rust/pull/34908)
3191 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3192   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3193 * [Semicolons are properly required as statement delimiters inside
3194   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3195 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3196
3197 Stabilized APIs
3198 ---------------
3199
3200 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3201 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3202 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3203 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3204 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3205 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3206 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3207 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3208 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3209 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3210   Both on Unix and Windows.
3211 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3212 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3213 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3214 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3215 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3216 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3217 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3218 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3219
3220 Libraries
3221 ---------
3222
3223 * [The `format!` macro and friends now allow a single argument to be formatted
3224   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3225 * [The lifetime bounds on `[T]::binary_search_by` and
3226   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3227 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3228 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3229 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3230 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3231 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3232 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3233 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3234 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3235   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3236 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3237   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3238 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3239 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3240   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3241 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3242 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3243 * [`mpsc::sync_channel` `Receiver`s return any available message before
3244   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3245 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3246 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3247
3248 Cargo
3249 -----
3250
3251 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3252 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3253 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3254 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3255 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3256 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3257 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3258 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3259 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3260 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3261 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3262 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3263 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3264 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3265 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3266 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3267
3268 Performance
3269 -----------
3270
3271 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3272 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3273
3274 Tooling
3275 -------
3276
3277 * [Test binaries now support a `--test-threads` argument to specify the number
3278   of threads used to run tests, and which acts the same as the
3279   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3280 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3281 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3282 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3283 * [Rust releases now come with source packages that can be installed by rustup
3284   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3285   The resulting source code can be used by tools and IDES, located in the
3286   sysroot under `lib/rustlib/src`.
3287
3288 Misc
3289 ----
3290
3291 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3292 * Many minor improvements to the documentation.
3293 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3294
3295 Compatibility Notes
3296 -------------------
3297
3298 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3299   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3300 * [When formatting strings, if "precision" is specified, the "fill",
3301   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3302 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3303
3304
3305 Version 1.11.0 (2016-08-18)
3306 ===========================
3307
3308 Language
3309 --------
3310
3311 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3312 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3313 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3314 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3315 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3316
3317 Stabilized APIs
3318 ---------------
3319
3320 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3321 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3322 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3323 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3324 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3325 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3326   (in libcore - previously stabilized in libstd)
3327 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3328   (in libcore - previously stabilized in libstd)
3329 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3330   (in libcore - previously stabilized in libstd)
3331 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3332   (in libcore - previously stabilized in libstd)
3333 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3334 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3335 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3336 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3337
3338 Libraries
3339 ---------
3340
3341 * [The `thread_local!` macro supports multiple definitions in a single
3342    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3343 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3344 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3345   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3346 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3347 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3348 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3349 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3350
3351 Cargo
3352 -----
3353
3354 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3355 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3356 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3357 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3358 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3359   and `-vv` prints warnings for all crates.
3360 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3361 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3362   This provides room for expansion by arbitrary tools.
3363 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3364 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3365 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3366 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3367 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3368 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3369 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3370
3371 Performance
3372 -----------
3373
3374 * [Caching projections speeds up type check dramatically for some
3375   workloads](https://github.com/rust-lang/rust/pull/33816)
3376 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3377   This hasher is faster, but is believed to provide sufficient
3378   protection from collision attacks.
3379 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3380
3381 Rustdoc
3382 -------
3383
3384 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3385 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3386 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3387 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3388 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3389
3390 Tooling
3391 -------
3392
3393 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3394 * [When emitting debug info, rustc emits frame pointers for closures,
3395   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3396 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3397 * Many more errors have been given error codes and extended
3398   explanations
3399 * API documentation continues to be improved, with many new examples
3400
3401 Misc
3402 ----
3403
3404 * [rustc no longer hangs when dependencies recursively re-export
3405   submodules](https://github.com/rust-lang/rust/pull/34542)
3406 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3407 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3408   rewritten](https://github.com/rust-lang/rust/pull/33895)
3409 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3410   No targets use this yet, but it works toward AVR support.
3411
3412 Compatibility Notes
3413 -------------------
3414
3415 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3416 * [The new follow-set rules that place restrictions on `macro_rules!`
3417   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3418   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3419   and has been a warning since 1.10.
3420 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3421   This causes breakage in some corner cases.
3422
3423
3424 Version 1.10.0 (2016-07-07)
3425 ===========================
3426
3427 Language
3428 --------
3429
3430 * [Allow `concat_idents!` in type positions as well as in expression
3431   positions](https://github.com/rust-lang/rust/pull/33735).
3432 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3433   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3434 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3435 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3436 * [`panic!` can be converted to a runtime abort with the
3437   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3438   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3439 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3440   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3441   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3442   Note that Cargo does not yet directly support cdylibs.
3443
3444 Stabilized APIs
3445 ---------------
3446
3447 * `os::windows::fs::OpenOptionsExt::access_mode`
3448 * `os::windows::fs::OpenOptionsExt::share_mode`
3449 * `os::windows::fs::OpenOptionsExt::custom_flags`
3450 * `os::windows::fs::OpenOptionsExt::attributes`
3451 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3452 * `os::unix::fs::OpenOptionsExt::custom_flags`
3453 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3454 * `Default for sync::Weak`
3455 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3456 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3457 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3458 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3459 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3460 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3461 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3462 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3463 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3464 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3465 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3466 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3467 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3468 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3469 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3470 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3471 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3472 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3473 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3474 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3475 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3476 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3477 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3478 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3479 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3480 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3481 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3482 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3483 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3484 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3485 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3486 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3487 * Read/Write/RawFd impls for `UnixStream`
3488 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3489 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3490 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3491 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3492 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3493 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3494 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3495 * RawFd impls for `UnixListener`
3496 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3497 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3498 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3499 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3500 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3501 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3502 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3503 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3504 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3505 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3506 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3507 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3508 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3509 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3510 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3511 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3512 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3513 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3514 * RawFd impls for `UnixDatagram`
3515 * `{BTree,Hash}Map::values_mut`
3516 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3517
3518 Libraries
3519 ---------
3520
3521 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3522   The semantics of this minor method are subtle and probably not what
3523   most people want.
3524 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3525 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3526   will fall back to `/dev/urandom` temporarily to avoid blocking
3527   during early boot](https://github.com/rust-lang/rust/pull/33086).
3528 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3529 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3530 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3531 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3532 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3533 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3534   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3535
3536 Cargo
3537 -----
3538 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3539   This controls the runtime behavior of the `panic!` macro
3540   and can be either "unwind" (the default), or "abort".
3541   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3542 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3543 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3544 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3545   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3546 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3547 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3548 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3549   By default they are retried twice, which can be customized with the
3550   `net.retry` value in `.cargo/config`.
3551 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3552 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3553 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3554 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3555   Makes it possible to install multiple crates in parallel.
3556 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3557 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3558 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3559 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3560 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3561 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3562
3563 Performance
3564 -----------
3565
3566 * [rustc memory usage was reduced by refactoring the context used for
3567   type checking](https://github.com/rust-lang/rust/pull/33425).
3568 * [Speed up creation of `HashMap`s by caching the random keys used
3569   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3570 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3571 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3572 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3573   10x faster than the previous lookup tables.
3574 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3575
3576 Usability
3577 ---------
3578
3579 * Many incremental improvements to documentation and rustdoc.
3580 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3581 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3582 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3583 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3584 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3585 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3586 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3587
3588 Misc
3589 ----
3590
3591 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3592 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3593 * [`std` no longer prints backtraces on platforms where the running
3594   module must be loaded with `env::current_exe`, which can't be relied
3595   on](https://github.com/rust-lang/rust/pull/33554).
3596 * This release includes std binaries for the i586-unknown-linux-gnu,
3597   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3598   i586 target is for old x86 hardware without SSE2, and the armv7
3599   target is for Android running on modern ARM architectures.
3600 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3601   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3602 * [On Unix the runtime aborts by calling `libc::abort` instead of
3603   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3604 * [Rust is now bootstrapped from the previous release of Rust,
3605   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3606
3607 Compatibility Notes
3608 -------------------
3609
3610 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3611 * [`target_env` for Linux ARM targets is just `gnu`, not
3612   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3613 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3614 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3615 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3616   Affects how macros are parsed.
3617 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3618 * [Feature-gated attributes on macro-generated macro invocations are
3619   now rejected](https://github.com/rust-lang/rust/pull/32791).
3620 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3621   This caused some minor changes to type inference.
3622
3623
3624 Version 1.9.0 (2016-05-26)
3625 ==========================
3626
3627 Language
3628 --------
3629
3630 * The `#[deprecated]` attribute when applied to an API will generate
3631   warnings when used. The warnings may be suppressed with
3632   `#[allow(deprecated)]`. [RFC 1270].
3633 * [`fn` item types are zero sized, and each `fn` names a unique
3634   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3635   `transmute` on a `fn` type will generate a warning for a few cycles,
3636   then will be converted to an error.
3637 * [Field and method resolution understand visibility, so private
3638   fields and methods cannot prevent the proper use of public fields
3639   and methods][1.9fv].
3640 * [The parser considers unicode codepoints in the
3641   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3642
3643 Stabilized APIs
3644 ---------------
3645
3646 * [`std::panic`]
3647 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3648 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3649 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3650 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3651 * [`str::is_char_boundary`]
3652 * [`<*const T>::as_ref`]
3653 * [`<*mut T>::as_ref`]
3654 * [`<*mut T>::as_mut`]
3655 * [`AsciiExt::make_ascii_uppercase`]
3656 * [`AsciiExt::make_ascii_lowercase`]
3657 * [`char::decode_utf16`]
3658 * [`char::DecodeUtf16`]
3659 * [`char::DecodeUtf16Error`]
3660 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3661 * [`BTreeSet::take`]
3662 * [`BTreeSet::replace`]
3663 * [`BTreeSet::get`]
3664 * [`HashSet::take`]
3665 * [`HashSet::replace`]
3666 * [`HashSet::get`]
3667 * [`OsString::with_capacity`]
3668 * [`OsString::clear`]
3669 * [`OsString::capacity`]
3670 * [`OsString::reserve`]
3671 * [`OsString::reserve_exact`]
3672 * [`OsStr::is_empty`]
3673 * [`OsStr::len`]
3674 * [`std::os::unix::thread`]
3675 * [`RawPthread`]
3676 * [`JoinHandleExt`]
3677 * [`JoinHandleExt::as_pthread_t`]
3678 * [`JoinHandleExt::into_pthread_t`]
3679 * [`HashSet::hasher`]
3680 * [`HashMap::hasher`]
3681 * [`CommandExt::exec`]
3682 * [`File::try_clone`]
3683 * [`SocketAddr::set_ip`]
3684 * [`SocketAddr::set_port`]
3685 * [`SocketAddrV4::set_ip`]
3686 * [`SocketAddrV4::set_port`]
3687 * [`SocketAddrV6::set_ip`]
3688 * [`SocketAddrV6::set_port`]
3689 * [`SocketAddrV6::set_flowinfo`]
3690 * [`SocketAddrV6::set_scope_id`]
3691 * [`slice::copy_from_slice`]
3692 * [`ptr::read_volatile`]
3693 * [`ptr::write_volatile`]
3694 * [`OpenOptions::create_new`]
3695 * [`TcpStream::set_nodelay`]
3696 * [`TcpStream::nodelay`]
3697 * [`TcpStream::set_ttl`]
3698 * [`TcpStream::ttl`]
3699 * [`TcpStream::set_only_v6`]
3700 * [`TcpStream::only_v6`]
3701 * [`TcpStream::take_error`]
3702 * [`TcpStream::set_nonblocking`]
3703 * [`TcpListener::set_ttl`]
3704 * [`TcpListener::ttl`]
3705 * [`TcpListener::set_only_v6`]
3706 * [`TcpListener::only_v6`]
3707 * [`TcpListener::take_error`]
3708 * [`TcpListener::set_nonblocking`]
3709 * [`UdpSocket::set_broadcast`]
3710 * [`UdpSocket::broadcast`]
3711 * [`UdpSocket::set_multicast_loop_v4`]
3712 * [`UdpSocket::multicast_loop_v4`]
3713 * [`UdpSocket::set_multicast_ttl_v4`]
3714 * [`UdpSocket::multicast_ttl_v4`]
3715 * [`UdpSocket::set_multicast_loop_v6`]
3716 * [`UdpSocket::multicast_loop_v6`]
3717 * [`UdpSocket::set_multicast_ttl_v6`]
3718 * [`UdpSocket::multicast_ttl_v6`]
3719 * [`UdpSocket::set_ttl`]
3720 * [`UdpSocket::ttl`]
3721 * [`UdpSocket::set_only_v6`]
3722 * [`UdpSocket::only_v6`]
3723 * [`UdpSocket::join_multicast_v4`]
3724 * [`UdpSocket::join_multicast_v6`]
3725 * [`UdpSocket::leave_multicast_v4`]
3726 * [`UdpSocket::leave_multicast_v6`]
3727 * [`UdpSocket::take_error`]
3728 * [`UdpSocket::connect`]
3729 * [`UdpSocket::send`]
3730 * [`UdpSocket::recv`]
3731 * [`UdpSocket::set_nonblocking`]
3732
3733 Libraries
3734 ---------
3735
3736 * [`std::sync::Once` is poisoned if its initialization function
3737   fails][1.9o].
3738 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3739 * [Most types implement `fmt::Debug`][1.9db].
3740 * [The default buffer size used by `BufReader` and `BufWriter` was
3741   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3742   used by other languages.
3743 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3744   `Duration` additionally implements `*=` and `/=`][1.9ta].
3745 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3746 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3747 * [`Chain` implements `BufRead`][1.9ch].
3748 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3749
3750 Cargo
3751 -----
3752
3753 * [Cargo can now run concurrently][1.9cc].
3754 * [Top-level overrides allow specific revisions of crates to be
3755   overridden through the entire crate graph][1.9ct].  This is intended
3756   to make upgrades easier for large projects, by allowing crates to be
3757   forked temporarily until they've been upgraded and republished.
3758 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3759 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3760   on the commandline][1.9cf]. `rustc` arguments can also be specified
3761   in the `build.rustflags` configuration key.
3762
3763 Performance
3764 -----------
3765
3766 * [The time complexity of comparing variables for equivalence during type
3767   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3768   to major compilation time improvement in some scenarios.
3769 * [`ToString` is specialized for `str`, giving it the same performance
3770   as `to_owned`][1.9ts].
3771 * [Spawning processes with `Command::output` no longer creates extra
3772   threads][1.9sp].
3773 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3774   for C-like enums][1.9cl].
3775
3776 Misc
3777 ----
3778
3779 * [Passing the `--quiet` flag to a test runner will produce
3780   much-abbreviated output][1.9q].
3781 * The Rust Project now publishes std binaries for the
3782   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3783   `i586-pc-windows-msvc` targets.
3784
3785 Compatibility Notes
3786 -------------------
3787
3788 * [`std::sync::Once` is poisoned if its initialization function
3789   fails][1.9o].
3790 * [It is illegal to define methods with the same name in overlapping
3791   inherent `impl` blocks][1.9sn].
3792 * [`fn` item types are zero sized, and each `fn` names a unique
3793   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3794   `transmute` on a `fn` type will generate a warning for a few cycles,
3795   then will be converted to an error.
3796 * [Improvements to const evaluation may trigger new errors when integer
3797   literals are out of range][1.9ce].
3798
3799
3800 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3801 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3802 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3803 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3804 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3805 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3806 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3807 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3808 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3809 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3810 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3811 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3812 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3813 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3814 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3815 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3816 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3817 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3818 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3819 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3820 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3821 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3822 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3823 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3824 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3825 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3826 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3827 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3828 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3829 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3830 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3831 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3832 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3833 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3834 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3835 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3836 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3837 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3838 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3839 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3840 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3841 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3842 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3843 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3844 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3845 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3846 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3847 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3848 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3849 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3850 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3851 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3852 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3853 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3854 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3855 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3856 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3857 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3858 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3859 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3860 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3861 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3862 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3863 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3864 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3865 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3866 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3867 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3868 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3869 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3870 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3871 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3872 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3873 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3874 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3875 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3876 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3877 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3878 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3879 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3880 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3881 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3882 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3883 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3884 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3885 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3886 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3887 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3888 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3889 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3890 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3891 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3892 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3893 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3894 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3895 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3896 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3897 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3898 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3899 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3900 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3901 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3902 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3903 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3904 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3905 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3906 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3907 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3908 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3909 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3910
3911
3912 Version 1.8.0 (2016-04-14)
3913 ==========================
3914
3915 Language
3916 --------
3917
3918 * Rust supports overloading of compound assignment statements like
3919   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3920   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3921   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3922   traits. [RFC 953].
3923 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3924   addition to the non-braced form, `struct Foo;`. [RFC 218].
3925
3926 Libraries
3927 ---------
3928
3929 * Stabilized APIs:
3930   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3931   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3932   * [`Ref::map`]
3933   * [`RefMut::map`]
3934   * [`ptr::drop_in_place`]
3935   * [`time::Instant`]
3936   * [`time::SystemTime`]
3937   * [`Instant::now`]
3938   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3939   * [`Instant::elapsed`]
3940   * [`SystemTime::now`]
3941   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3942   * [`SystemTime::elapsed`]
3943   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3944   * [`SystemTimeError`]
3945   * [`SystemTimeError::duration`]
3946   * Various impls for `SystemTimeError`
3947   * [`UNIX_EPOCH`]
3948   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3949     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3950     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3951 * [The `write!` and `writeln!` macros correctly emit errors if any of
3952   their arguments can't be formatted][1.8w].
3953 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3954 * [The Unix-specific `raw` modules, which contain a number of
3955   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3956   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3957   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3958   across platforms was making it difficult to implement `std`
3959   correctly. Those that need these definitions should use the `libc`
3960   crate. [RFC 1415].
3961 * The Unix-specific `MetadataExt` traits, including
3962   `os::unix::fs::MetadataExt`, which expose values such as inode
3963   numbers [no longer return platform-specific types][1.8r], but
3964   instead return widened integers. [RFC 1415].
3965 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3966 * [Atomic loads and stores are not volatile][1.8a].
3967 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3968
3969 Performance
3970 -----------
3971
3972 * [Inlining hash functions lead to a 3% compile-time improvement in
3973   some workloads][1.8h].
3974 * When using jemalloc, its symbols are [unprefixed so that it
3975   overrides the libc malloc implementation][1.8h]. This means that for
3976   rustc, LLVM is now using jemalloc, which results in a 6%
3977   compile-time improvement on a specific workload.
3978 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3979
3980 Misc
3981 ----
3982
3983 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3984   i686-pc-windows-msvc is now considered a tier-1 platform.
3985 * [The `--print targets` flag prints a list of supported targets][1.8t].
3986 * [The `--print cfg` flag prints the `cfg`s defined for the current
3987   target][1.8cf].
3988 * [`rustc` can be built with an new Cargo-based build system, written
3989   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3990   build system. To enable it configure with `configure --rustbuild`.
3991 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3992   variants while also indicating the total number of missing variants
3993   if more than 3][1.8m].
3994 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3995 * The Rust Project now publishes binary releases of the standard
3996   library for a number of tier-2 targets:
3997   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3998   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3999   `x86_64-rumprun-netbsd`. These can be installed with
4000   tools such as [multirust][1.8mr].
4001
4002 Cargo
4003 -----
4004
4005 * [`cargo init` creates a new Cargo project in the current
4006   directory][1.8ci].  It is otherwise like `cargo new`.
4007 * [Cargo has configuration keys for `-v` and
4008   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
4009   `[term]` section of `.cargo/config`.
4010 * [Configuration keys that evaluate to strings or integers can be set
4011   via environment variables][1.8ce]. For example the `build.jobs` key
4012   can be set via `CARGO_BUILD_JOBS`. Environment variables take
4013   precedence over config files.
4014 * [Target-specific dependencies support Rust `cfg` syntax for
4015   describing targets][1.8cfg] so that dependencies for multiple
4016   targets can be specified together. [RFC 1361].
4017 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
4018   `RUSTDOC` take precedence over the `build.target-dir`,
4019   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4020 * [The child process tree is killed on Windows when Cargo is
4021   killed][1.8ck].
4022 * [The `build.target` configuration value sets the target platform,
4023   like `--target`][1.8ct].
4024
4025 Compatibility Notes
4026 -------------------
4027
4028 * [Unstable compiler flags have been further restricted][1.8u]. Since
4029   1.0 `-Z` flags have been considered unstable, and other flags that
4030   were considered unstable additionally required passing `-Z
4031   unstable-options` to access. Unlike unstable language and library
4032   features though, these options have been accessible on the stable
4033   release channel. Going forward, *new unstable flags will not be
4034   available on the stable release channel*, and old unstable flags
4035   will warn about their usage. In the future, all unstable flags will
4036   be unavailable on the stable release channel.
4037 * [It is no longer possible to `match` on empty enum variants using
4038   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4039 * The Unix-specific `MetadataExt` traits, including
4040   `os::unix::fs::MetadataExt`, which expose values such as inode
4041   numbers [no longer return platform-specific types][1.8r], but
4042   instead return widened integers. [RFC 1415].
4043 * [Modules sourced from the filesystem cannot appear within arbitrary
4044   blocks, but only within other modules][1.8mf].
4045 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4046 * On Unix, [stack overflow triggers a runtime abort instead of a
4047   SIGSEGV][1.8so].
4048 * [`Command::spawn` and its equivalents return an error if any of
4049   its command-line arguments contain interior `NUL`s][1.8n].
4050 * [Tuple and unit enum variants from other crates are in the type
4051   namespace][1.8tn].
4052 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4053   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4054   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4055   instead of `foo.lib`.
4056
4057
4058 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4059 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4060 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4061 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4062 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4063 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4064 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4065 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4066 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4067 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4068 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4069 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4070 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4071 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4072 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4073 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4074 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4075 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4076 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4077 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4078 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4079 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4080 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4081 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4082 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4083 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4084 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4085 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4086 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4087 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4088 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4089 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4090 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4091 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4092 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4093 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4094 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4095 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4096 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4097 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4098 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4099 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4100 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4101 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4102 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4103 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4104 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4105 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4106 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4107 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4108 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4109 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4110 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4111 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4112 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4113 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4114 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4115 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4116 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4117 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4118
4119
4120 Version 1.7.0 (2016-03-03)
4121 ==========================
4122
4123 Libraries
4124 ---------
4125
4126 * Stabilized APIs
4127   * `Path`
4128     * [`Path::strip_prefix`][] (renamed from relative_from)
4129     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4130   * `Ipv4Addr`
4131     * [`Ipv4Addr::is_loopback`]
4132     * [`Ipv4Addr::is_private`]
4133     * [`Ipv4Addr::is_link_local`]
4134     * [`Ipv4Addr::is_multicast`]
4135     * [`Ipv4Addr::is_broadcast`]
4136     * [`Ipv4Addr::is_documentation`]
4137   * `Ipv6Addr`
4138     * [`Ipv6Addr::is_unspecified`]
4139     * [`Ipv6Addr::is_loopback`]
4140     * [`Ipv6Addr::is_multicast`]
4141   * `Vec`
4142     * [`Vec::as_slice`]
4143     * [`Vec::as_mut_slice`]
4144   * `String`
4145     * [`String::as_str`]
4146     * [`String::as_mut_str`]
4147   * Slices
4148     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4149     be the same length
4150     * `<[T]>::`[`sort_by_key`]
4151   * checked, saturated, and overflowing operations
4152     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4153     * [`i32::saturating_mul`]
4154     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4155     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4156     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4157     * [`u32::saturating_mul`]
4158     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4159     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4160     * and checked, saturated, and overflowing operations for other primitive types
4161   * FFI
4162     * [`ffi::IntoStringError`]
4163     * [`CString::into_string`]
4164     * [`CString::into_bytes`]
4165     * [`CString::into_bytes_with_nul`]
4166     * `From<CString> for Vec<u8>`
4167   * `IntoStringError`
4168     * [`IntoStringError::into_cstring`]
4169     * [`IntoStringError::utf8_error`]
4170     * `Error for IntoStringError`
4171   * Hashing
4172     * [`std::hash::BuildHasher`]
4173     * [`BuildHasher::Hasher`]
4174     * [`BuildHasher::build_hasher`]
4175     * [`std::hash::BuildHasherDefault`]
4176     * [`HashMap::with_hasher`]
4177     * [`HashMap::with_capacity_and_hasher`]
4178     * [`HashSet::with_hasher`]
4179     * [`HashSet::with_capacity_and_hasher`]
4180     * [`std::collections::hash_map::RandomState`]
4181     * [`RandomState::new`]
4182 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4183   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4184   from bytes is faster.
4185 * [The performance of `LineWriter` (and thus `io::stdout`) was
4186   improved by using `memchr` to search for newlines][1.7m].
4187 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4188   `f64` variants were stabilized previously.
4189 * [`BTreeMap` was rewritten to use less memory and improve the performance
4190   of insertion and iteration, the latter by as much as 5x][1.7bm].
4191 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4192   covariant over their contained type][1.7bt].
4193 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4194   over their contained type][1.7ll].
4195 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4196   searching methods.
4197 * [`Any` is implemented for unsized types][1.7a].
4198 * [`Hash` is implemented for `Duration`][1.7h].
4199
4200 Misc
4201 ----
4202
4203 * [When running tests with `--test`, rustdoc will pass `--cfg`
4204   arguments to the compiler][1.7dt].
4205 * [The compiler is built with RPATH information by default][1.7rpa].
4206   This means that it will be possible to run `rustc` when installed in
4207   unusual configurations without configuring the dynamic linker search
4208   path explicitly.
4209 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4210   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4211   over `LD_LIBRARY_PATH`.
4212
4213 Cargo
4214 -----
4215
4216 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4217   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4218 * [The `rerun-if-changed` build script directive no longer causes the
4219   build script to incorrectly run twice in certain scenarios][1.7rr].
4220
4221 Compatibility Notes
4222 -------------------
4223
4224 * Soundness fixes to the interactions between associated types and
4225   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4226   code that violates the new rules. This is a significant change that
4227   is known to break existing code, so it has emitted warnings for the
4228   new error cases since 1.4 to give crate authors time to adapt. The
4229   details of what is changing are subtle; read the RFC for more.
4230 * [Several bugs in the compiler's visibility calculations were
4231   fixed][1.7v]. Since this was found to break significant amounts of
4232   code, the new errors will be emitted as warnings for several release
4233   cycles, under the `private_in_public` lint.
4234 * Defaulted type parameters were accidentally accepted in positions
4235   that were not intended. In this release, [defaulted type parameters
4236   appearing outside of type definitions will generate a
4237   warning][1.7d], which will become an error in future releases.
4238 * [Parsing "." as a float results in an error instead of 0][1.7p].
4239   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4240 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4241
4242 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4243 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4244 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4245 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4246 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4247 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4248 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4249 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4250 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4251 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4252 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4253 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4254 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4255 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4256 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4257 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4258 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4259 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4260 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4261 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4262 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4263 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4264 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4265 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4266 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4267 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4268 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4269 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4270 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4271 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4272 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4273 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4274 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4275 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4276 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4277 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4278 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4279 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4280 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4281 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4282 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4283 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4284 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4285 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4286 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4287 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4288 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4289 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4290 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4291 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4292 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4293 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4294 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4295 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4296 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4297 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4298 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4299 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4300 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4301 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4302 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4303 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4304 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4305 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4306 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4307 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4308 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4309 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4310 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4311 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4312 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4313 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4314 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4315 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4316 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4317 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4318 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4319 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4320 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4321
4322
4323 Version 1.6.0 (2016-01-21)
4324 ==========================
4325
4326 Language
4327 --------
4328
4329 * The `#![no_std]` attribute causes a crate to not be linked to the
4330   standard library, but only the [core library][1.6co], as described
4331   in [RFC 1184]. The core library defines common types and traits but
4332   has no platform dependencies whatsoever, and is the basis for Rust
4333   software in environments that cannot support a full port of the
4334   standard library, such as operating systems. Most of the core
4335   library is now stable.
4336
4337 Libraries
4338 ---------
4339
4340 * Stabilized APIs:
4341   [`Read::read_exact`],
4342   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4343   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4344   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4345   [`os::unix::fs::DirBuilderExt`],
4346   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4347   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4348   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4349   [`collections::hash_map::Drain`],
4350   [`collections::hash_map::HashMap::drain`],
4351   [`collections::hash_set::Drain`],
4352   [`collections::hash_set::HashSet::drain`],
4353   [`collections::binary_heap::Drain`],
4354   [`collections::binary_heap::BinaryHeap::drain`],
4355   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4356   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4357   [`RwLock::into_inner`],
4358   [`Iterator::min_by_key`][] (renamed from `min_by`),
4359   [`Iterator::max_by_key`][] (renamed from `max_by`).
4360 * The [core library][1.6co] is stable, as are most of its APIs.
4361 * [The `assert_eq!` macro supports arguments that don't implement
4362   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4363   `assert!`.
4364 * Several timer functions that take duration in milliseconds [are
4365   deprecated in favor of those that take `Duration`][1.6ms]. These
4366   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4367   `thread::park_timeout_ms`.
4368 * The algorithm by which `Vec` reserves additional elements was
4369   [tweaked to not allocate excessive space][1.6a] while still growing
4370   exponentially.
4371 * `From` conversions are [implemented from integers to floats][1.6f]
4372   in cases where the conversion is lossless. Thus they are not
4373   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4374   or `f64`. They are also not implemented for `isize` and `usize`
4375   because the implementations would be platform-specific. `From` is
4376   also implemented from `f32` to `f64`.
4377 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4378 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4379 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4380 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4381   improvements.
4382 * Sorting slices that are already sorted [is 50% faster in some
4383   cases][1.6s].
4384
4385 Cargo
4386 -----
4387
4388 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4389 * Cargo build scripts can specify their dependencies by emitting the
4390   [`rerun-if-changed`][1.6rr] key.
4391 * crates.io will reject publication of crates with dependencies that
4392   have a wildcard version constraint. Crates with wildcard
4393   dependencies were seen to cause a variety of problems, as described
4394   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4395   warning.
4396 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4397   release folder.  A variety of artifacts that Cargo failed to clean
4398   are now correctly deleted.
4399
4400 Misc
4401 ----
4402
4403 * The `unreachable_code` lint [warns when a function call's argument
4404   diverges][1.6dv].
4405 * The parser indicates [failures that may be caused by
4406   confusingly-similar Unicode characters][1.6uc]
4407 * Certain macro errors [are reported at definition time][1.6m], not
4408   expansion.
4409
4410 Compatibility Notes
4411 -------------------
4412
4413 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4414   environment variable when locating crates. This was a pre-cargo
4415   feature for integrating with the package manager that was
4416   accidentally never removed.
4417 * [A number of bugs were fixed in the privacy checker][1.6p] that
4418   could cause previously-accepted code to break.
4419 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4420 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4421   struct pattern syntax (`Foo(..)`) can no longer be used to match
4422   unit structs. This is a warning now, but will become an error in
4423   future releases. Patterns that share the same name as a const are
4424   now an error.
4425 * A bug was fixed that causes [rustc not to apply default type
4426   parameters][1.6xc] when resolving certain method implementations of
4427   traits defined in other crates.
4428
4429 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4430 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4431 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4432 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4433 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4434 [1.6co]: http://doc.rust-lang.org/core/index.html
4435 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4436 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4437 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4438 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4439 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4440 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4441 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4442 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4443 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4444 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4445 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4446 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4447 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4448 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4449 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4450 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4451 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4452 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4453 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4454 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4455 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4456 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4457 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4458 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4459 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4460 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4461 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4462 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4463 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4464 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4465 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4466 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4467 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4468 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4469 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4470 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4471 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4472 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4473 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4474 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4475 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4476
4477
4478 Version 1.5.0 (2015-12-10)
4479 ==========================
4480
4481 * ~700 changes, numerous bugfixes
4482
4483 Highlights
4484 ----------
4485
4486 * Stabilized APIs:
4487   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4488   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4489   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4490   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4491   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4492   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4493   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4494   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4495   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4496   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4497   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4498   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4499   [`Path::read_link`], [`Path::symlink_metadata`],
4500   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4501   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4502   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4503   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4504   [`slice::split_first_mut`], [`slice::split_first`],
4505   [`slice::split_last_mut`], [`slice::split_last`],
4506   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4507   [`str::MatchIndices`], [`str::RMatchIndices`],
4508   [`str::match_indices`], [`str::rmatch_indices`],
4509   [`str::slice_mut_unchecked`], [`string::ParseError`].
4510 * Rust applications hosted on crates.io can be installed locally to
4511   `~/.cargo/bin` with the [`cargo install`] command. Among other
4512   things this makes it easier to augment Cargo with new subcommands:
4513   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4514   invoked as `cargo foo`.
4515 * Crates with wildcard (`*`) dependencies will [emit warnings when
4516   published][1.5w]. In 1.6 it will no longer be possible to publish
4517   crates with wildcard dependencies.
4518
4519 Breaking Changes
4520 ----------------
4521
4522 * The rules determining when a particular lifetime must outlive
4523   a particular value (known as '[dropck]') have been [modified
4524   to not rely on parametricity][1.5p].
4525 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4526   and `Arc`][1.5a]. Because these smart pointer types implement
4527   `Deref`, this causes breakage in cases where the interior type
4528   contains methods of the same name.
4529 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4530   that they could drop their content. Soundness fix.
4531 * All method invocations are [properly checked][1.5wf1] for
4532   [well-formedness][1.5wf2]. Soundness fix.
4533 * Traits whose supertraits contain `Self` are [not object
4534   safe][1.5o]. Soundness fix.
4535 * Target specifications support a [`no_default_libraries`][1.5nd]
4536   setting that controls whether `-nodefaultlibs` is passed to the
4537   linker, and in turn the `is_like_windows` setting no longer affects
4538   the `-nodefaultlibs` flag.
4539 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4540 * The `#[inline]` and `#[repr]` attributes [can only appear
4541   in valid locations][1.5at].
4542 * Native libraries linked from the local crate are [passed to
4543   the linker before native libraries from upstream crates][1.5nl].
4544 * Two rarely-used attributes, `#[no_debug]` and
4545   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4546 * Negation of unsigned integers, which has been a warning for
4547   several releases, [is now behind a feature gate and will
4548   generate errors][1.5nu].
4549 * The parser accidentally accepted visibility modifiers on
4550   enum variants, a bug [which has been fixed][1.5ev].
4551 * [A bug was fixed that allowed `use` statements to import unstable
4552   features][1.5use].
4553
4554 Language
4555 --------
4556
4557 * When evaluating expressions at compile-time that are not
4558   compile-time constants (const-evaluating expressions in non-const
4559   contexts), incorrect code such as overlong bitshifts and arithmetic
4560   overflow will [generate a warning instead of an error][1.5ce],
4561   delaying the error until runtime. This will allow the
4562   const-evaluator to be expanded in the future backwards-compatibly.
4563 * The `improper_ctypes` lint [no longer warns about using `isize` and
4564   `usize` in FFI][1.5ict].
4565
4566 Libraries
4567 ---------
4568
4569 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4570   invariant][1.5c].
4571 * `Default` is [implemented for mutable slices][1.5d].
4572 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4573 * There are now `From` conversions [between floating point
4574   types][1.5f] where the conversions are lossless.
4575 * There are now `From` conversions [between integer types][1.5i] where
4576   the conversions are lossless.
4577 * [`fs::Metadata` implements `Clone`][1.5fs].
4578 * The `parse` method [accepts a leading "+" when parsing
4579   integers][1.5pi].
4580 * [`AsMut` is implemented for `Vec`][1.5am].
4581 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4582   been optimized][1.5cf] and no longer rely on the default impl.
4583 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4584   `unsafe extern "C"` function types now [implement `Clone`,
4585   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4586   `fmt::Debug` for up to 12 arguments][1.5fp].
4587 * [Dropping `Vec`s is much faster in unoptimized builds when the
4588   element types don't implement `Drop`][1.5dv].
4589 * A bug that caused in incorrect behavior when [combining `VecDeque`
4590   with zero-sized types][1.5vdz] was resolved.
4591 * [`PartialOrd` for slices is faster][1.5po].
4592
4593 Miscellaneous
4594 -------------
4595
4596 * [Crate metadata size was reduced by 20%][1.5md].
4597 * [Improvements to code generation reduced the size of libcore by 3.3
4598   MB and rustc's memory usage by 18MB][1.5m].
4599 * [Improvements to deref translation increased performance in
4600   unoptimized builds][1.5dr].
4601 * Various errors in trait resolution [are deduplicated to only be
4602   reported once][1.5te].
4603 * Rust has preliminary [support for rumprun kernels][1.5rr].
4604 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4605
4606 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4607 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4608 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4609 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4610 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4611 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4612 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4613 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4614 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4615 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4616 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4617 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4618 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4619 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4620 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4621 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4622 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4623 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4624 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4625 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4626 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4627 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4628 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4629 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4630 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4631 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4632 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4633 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4634 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4635 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4636 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4637 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4638 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4639 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4640 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4641 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4642 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4643 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4644 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4645 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4646 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4647 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4648 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4649 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4650 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4651 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4652 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4653 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4654 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4655 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4656 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4657 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4658 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4659 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4660 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4661 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4662 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4663 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4664 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4665 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4666 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4667 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4668 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4669 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4670 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4671 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4672 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4673 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4674 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4675 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4676 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4677 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4678 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4679 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4680 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4681 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4682 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4683 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4684 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4685 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4686 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4687 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4688 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4689 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4690 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4691 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4692 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4693 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4694 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4695
4696 Version 1.4.0 (2015-10-29)
4697 ==========================
4698
4699 * ~1200 changes, numerous bugfixes
4700
4701 Highlights
4702 ----------
4703
4704 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4705   GNU) are now supported and recommended for use.
4706
4707 Breaking Changes
4708 ----------------
4709
4710 * [Several changes have been made to fix type soundness and improve
4711   the behavior of associated types][sound]. See [RFC 1214]. Although
4712   we have mostly introduced these changes as warnings this release, to
4713   become errors next release, there are still some scenarios that will
4714   see immediate breakage.
4715 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4716   line breaks in addition to `\n`][crlf].
4717 * [Loans of `'static` lifetime extend to the end of a function][stat].
4718 * [`str::parse` no longer introduces avoidable rounding error when
4719   parsing floating point numbers. Together with earlier changes to
4720   float formatting/output, "round trips" like f.to_string().parse()
4721   now preserve the value of f exactly. Additionally, leading plus
4722   signs are now accepted][fp3].
4723
4724
4725 Language
4726 --------
4727
4728 * `use` statements that import multiple items [can now rename
4729   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4730 * [Binops work correctly on fat pointers][binfat].
4731 * `pub extern crate`, which does not behave as expected, [issues a
4732   warning][pec] until a better solution is found.
4733
4734 Libraries
4735 ---------
4736
4737 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4738   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4739   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4740   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4741   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4742   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4743   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4744   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4745   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4746   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4747   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4748   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4749   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4750   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4751   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4752   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4753   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4754   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4755   [`thread::sleep`].
4756 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4757   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4758   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4759   `f64::from_str_radix`.
4760 * [Reverse-searching strings is faster with the 'two-way'
4761   algorithm][s].
4762 * [`std::io::copy` allows `?Sized` arguments][cc].
4763 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4764   [override `count`, `nth` and `last` with an O(1)
4765   implementation][it].
4766 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4767 * [`IntoRawFd` has been added to the Unix-specific prelude,
4768   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4769   prelude][pr].
4770 * [`Extend<String>` and `FromIterator<String` are both implemented for
4771   `String`][es].
4772 * [`IntoIterator` is implemented for references to `Option` and
4773   `Result`][into2].
4774 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4775   Copy`][ext] as part of [RFC 839]. This will cause type inference
4776   breakage in rare situations.
4777 * [`BinaryHeap` implements `Debug`][bh2].
4778 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4779   arrays][bm].
4780 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4781   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4782 * [String comparison is faster][faststr].
4783 * `&mut T` where `T: std::fmt::Write` [also implements
4784   `std::fmt::Write`][mutw].
4785 * [A stable regression in `VecDeque::push_back` and other
4786   capacity-altering methods that caused panics for zero-sized types
4787   was fixed][vd].
4788 * [Function pointers implement traits for up to 12 parameters][fp2].
4789
4790 Miscellaneous
4791 -------------
4792
4793 * The compiler [no longer uses the 'morestack' feature to prevent
4794   stack overflow][mm]. Instead it uses guard pages and stack
4795   probes (though stack probes are not yet implemented on any platform
4796   but Windows).
4797 * [The compiler matches traits faster when projections are involved][p].
4798 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4799   `usize`][ffi].
4800 * [Cargo now displays useful information about what its doing during
4801   `cargo update`][cu].
4802
4803 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4804 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4805 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4806 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4807 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4808 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4809 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4810 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4811 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4812 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4813 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4814 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4815 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4816 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4817 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4818 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4819 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4820 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4821 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4822 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4823 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4824 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4825 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4826 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4827 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4828 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4829 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4830 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4831 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4832 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4833 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4834 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4835 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4836 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4837 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4838 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4839 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4840 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4841 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4842 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4843 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4844 [bh2]: https://github.com/rust-lang/rust/pull/28156
4845 [binfat]: https://github.com/rust-lang/rust/pull/28270
4846 [bm]: https://github.com/rust-lang/rust/pull/28197
4847 [cc]: https://github.com/rust-lang/rust/pull/27531
4848 [crlf]: https://github.com/rust-lang/rust/pull/28034
4849 [cu]: https://github.com/rust-lang/cargo/pull/1931
4850 [d]: https://github.com/rust-lang/rust/pull/27825
4851 [dep]: https://github.com/rust-lang/rust/pull/28339
4852 [es]: https://github.com/rust-lang/rust/pull/27956
4853 [ext]: https://github.com/rust-lang/rust/pull/28094
4854 [faststr]: https://github.com/rust-lang/rust/pull/28338
4855 [ffi]: https://github.com/rust-lang/rust/pull/28779
4856 [fp]: https://github.com/rust-lang/rust/pull/28268
4857 [fp2]: https://github.com/rust-lang/rust/pull/28560
4858 [fp3]: https://github.com/rust-lang/rust/pull/27307
4859 [i]: https://github.com/rust-lang/rust/pull/27451
4860 [into2]: https://github.com/rust-lang/rust/pull/28039
4861 [it]: https://github.com/rust-lang/rust/pull/27652
4862 [mm]: https://github.com/rust-lang/rust/pull/27338
4863 [mutw]: https://github.com/rust-lang/rust/pull/28368
4864 [sound]: https://github.com/rust-lang/rust/pull/27641
4865 [p]: https://github.com/rust-lang/rust/pull/27866
4866 [pec]: https://github.com/rust-lang/rust/pull/28486
4867 [pr]: https://github.com/rust-lang/rust/pull/27896
4868 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4869 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4870 [s]: https://github.com/rust-lang/rust/pull/27474
4871 [stab]: https://github.com/rust-lang/rust/pull/28339
4872 [stat]: https://github.com/rust-lang/rust/pull/28321
4873 [vd]: https://github.com/rust-lang/rust/pull/28494
4874
4875 Version 1.3.0 (2015-09-17)
4876 ==============================
4877
4878 * ~900 changes, numerous bugfixes
4879
4880 Highlights
4881 ----------
4882
4883 * The [new object lifetime defaults][nold] have been [turned
4884   on][nold2] after a cycle of warnings about the change. Now types
4885   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4886   being interpreted as `&'a Box<Trait+'a>` to `&'a
4887   Box<Trait+'static>`.
4888 * [The Rustonomicon][nom] is a new book in the official documentation
4889   that dives into writing unsafe Rust.
4890 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4891   timekeeping is employed by other std APIs, as well as out-of-tree
4892   time crates.
4893
4894 Breaking Changes
4895 ----------------
4896
4897 * The [new object lifetime defaults][nold] have been [turned
4898   on][nold2] after a cycle of warnings about the change.
4899 * There is a known [regression][lr] in how object lifetime elision is
4900   interpreted, the proper solution for which is undetermined.
4901 * The `#[prelude_import]` attribute, an internal implementation
4902   detail, was accidentally stabilized previously. [It has been put
4903   behind the `prelude_import` feature gate][pi]. This change is
4904   believed to break no existing code.
4905 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4906   [more sane for dynamically sized types][dst3]. Code that relied on
4907   the previous behavior is thought to be broken.
4908 * The `dropck` rules, which checks that destructors can't access
4909   destroyed values, [have been updated][dropck] to match the
4910   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4911   cause some previously-compiling code to no longer build.
4912
4913 Language
4914 --------
4915
4916 * The [new object lifetime defaults][nold] have been [turned
4917   on][nold2] after a cycle of warnings about the change.
4918 * Semicolons may [now follow types and paths in
4919   macros](https://github.com/rust-lang/rust/pull/27000).
4920 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4921   [more sane for dynamically sized types][dst3]. Code that relied on
4922   the previous behavior is not known to exist, and suspected to be
4923   broken.
4924 * `'static` variables [may now be recursive][st].
4925 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4926   implementations correctly.
4927 * The `dropck` rules, which checks that destructors can't access
4928   destroyed values, [have been updated][dropck] to match the
4929   [RFC][dropckrfc].
4930
4931 Libraries
4932 ---------
4933
4934 * The [`Duration`] API, [has been stabilized][ds], as well as the
4935   `std::time` module, which presently contains only `Duration`.
4936 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4937 * The owned C string, [`CString`], implements [`Borrow`] and the
4938   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4939   these allow C strings to be borrowed and cloned in generic code.
4940 * [`CStr`] implements [`Debug`].
4941 * [`AtomicPtr`] implements [`Debug`].
4942 * [`Error`] trait objects [can be downcast to their concrete types][e]
4943   in many common configurations, using the [`is`], [`downcast`],
4944   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4945   [`Any`] trait.
4946 * Searching for substrings now [employs the two-way algorithm][search]
4947   instead of doing a naive search. This gives major speedups to a
4948   number of methods, including [`contains`][sc], [`find`][sf],
4949   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4950   [`ends_with`][sew] are also faster.
4951 * The performance of `PartialEq` for slices is [much faster][ps].
4952 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4953   is overridden and optimized by the implementations for scalars.
4954 * The [`Hasher`] trait now has a number of specialized `write_*`
4955   methods for primitive types, for efficiency.
4956 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4957   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4958   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4959   of [`std::error::Error::cause`][iec] also delegates to the inner
4960   error.
4961 * [`process::Child`][pc] gained the [`id`] method, which returns a
4962   `u32` representing the platform-specific process identifier.
4963 * The [`connect`] method on slices is deprecated, replaced by the new
4964   [`join`] method (note that both of these are on the *unstable*
4965   [`SliceConcatExt`] trait, but through the magic of the prelude are
4966   available to stable code anyway).
4967 * The [`Div`] operator is implemented for [`Wrapping`] types.
4968 * [`DerefMut` is implemented for `String`][dms].
4969 * Performance of SipHash (the default hasher for `HashMap`) is
4970   [better for long data][sh].
4971 * [`AtomicPtr`] implements [`Send`].
4972 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4973   are now [specialized to use uninitialized buffers for increased
4974   performance][rte].
4975 * Lifetime parameters of foreign functions [are now resolved
4976   properly][f].
4977
4978 Misc
4979 ----
4980
4981 * Rust can now, with some coercion, [produce programs that run on
4982   Windows XP][xp], though XP is not considered a supported platform.
4983 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4984   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4985   recommended for use in 1.3, though should be fully-functional
4986   in the [64-bit 1.4 beta][b14].
4987 * On Fedora-based systems installation will [properly configure the
4988   dynamic linker][fl].
4989 * The compiler gained many new extended error descriptions, which can
4990   be accessed with the `--explain` flag.
4991 * The `dropck` pass, which checks that destructors can't access
4992   destroyed values, [has been rewritten][dropck]. This fixes some
4993   soundness holes, and as such will cause some previously-compiling
4994   code to no longer build.
4995 * `rustc` now uses [LLVM to write archive files where possible][ar].
4996   Eventually this will eliminate the compiler's dependency on the ar
4997   utility.
4998 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4999   supported FreeBSD on x86_64).
5000 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
5001   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
5002   more strict.
5003 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
5004   will kill the process instead of leaking][nlp].
5005
5006 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
5007 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
5008 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
5009 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
5010 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
5011 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5012 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5013 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
5014 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
5015 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
5016 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
5017 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
5018 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5019 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5020 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5021 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5022 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5023 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5024 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5025 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5026 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5027 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5028 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5029 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5030 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5031 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5032 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5033 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5034 [ar]: https://github.com/rust-lang/rust/pull/26926
5035 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5036 [dms]: https://github.com/rust-lang/rust/pull/26241
5037 [dropck]: https://github.com/rust-lang/rust/pull/27261
5038 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5039 [ds]: https://github.com/rust-lang/rust/pull/26818
5040 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5041 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5042 [dst3]: https://github.com/rust-lang/rust/pull/27351
5043 [e]: https://github.com/rust-lang/rust/pull/24793
5044 [f]: https://github.com/rust-lang/rust/pull/26588
5045 [fb]: https://github.com/rust-lang/rust/pull/26959
5046 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5047 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5048 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5049 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5050 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5051 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5052 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5053 [lic]: https://github.com/rust-lang/rust/pull/26583
5054 [lnu]: https://github.com/rust-lang/rust/pull/27026
5055 [lr]: https://github.com/rust-lang/rust/issues/27248
5056 [lum]: https://github.com/rust-lang/rust/pull/26378
5057 [lur]: https://github.com/rust-lang/rust/pull/26783
5058 [nlp]: https://github.com/rust-lang/rust/pull/27176
5059 [nold2]: https://github.com/rust-lang/rust/pull/27045
5060 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5061 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5062 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5063 [pi]: https://github.com/rust-lang/rust/pull/26699
5064 [ps]: https://github.com/rust-lang/rust/pull/26884
5065 [rte]: https://github.com/rust-lang/rust/pull/26950
5066 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5067 [search]: https://github.com/rust-lang/rust/pull/26327
5068 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5069 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5070 [sh]: https://github.com/rust-lang/rust/pull/27280
5071 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5072 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5073 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5074 [st]: https://github.com/rust-lang/rust/pull/26630
5075 [win1]: https://github.com/rust-lang/rust/pull/26569
5076 [win2]: https://github.com/rust-lang/rust/pull/26741
5077 [win3]: https://github.com/rust-lang/rust/pull/26741
5078 [win4]: https://github.com/rust-lang/rust/pull/27210
5079 [xp]: https://github.com/rust-lang/rust/pull/26569
5080
5081 Version 1.2.0 (2015-08-07)
5082 ==========================
5083
5084 * ~1200 changes, numerous bugfixes
5085
5086 Highlights
5087 ----------
5088
5089 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5090   like `Rc` to contain types without a fixed size, arrays and trait
5091   objects, finally enabling use of `Rc<[T]>` and completing the
5092   implementation of DST.
5093 * [Parallel codegen][parcodegen] is now working again, which can
5094   substantially speed up large builds in debug mode; It also gets
5095   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5096   jobs). It's not enabled by default, but will be "in the near
5097   future". It can be activated with the `-C codegen-units=N` flag to
5098   `rustc`.
5099 * This is the first release with [experimental support for linking
5100   with the MSVC linker and lib C on Windows (instead of using the GNU
5101   variants via MinGW)][win]. It is yet recommended only for the most
5102   intrepid Rustaceans.
5103 * Benchmark compilations are showing a 30% improvement in
5104   bootstrapping over 1.1.
5105
5106 Breaking Changes
5107 ----------------
5108
5109 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5110   unicode case mapping, which is a previously-planned change in
5111   behavior and considered a bugfix.
5112 * [`mem::align_of`] now specifies [the *minimum alignment* for
5113   T][align], which is usually the alignment programs are interested
5114   in, and the same value reported by clang's
5115   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5116   break real code.
5117 * [The `#[packed]` attribute is no longer silently accepted by the
5118   compiler][packed]. This attribute did nothing and code that
5119   mentioned it likely did not work as intended.
5120 * Associated type defaults are [now behind the
5121   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5122   defaults *did not work*, but could be mentioned syntactically. As
5123   such this breakage has minimal impact.
5124
5125 Language
5126 --------
5127
5128 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5129   matching against dereferenceable values.
5130
5131 Libraries
5132 ---------
5133
5134 * The [`Extend`] trait, which grows a collection from an iterator, is
5135   implemented over iterators of references, for `String`, `Vec`,
5136   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5137   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5138 * The [`iter::once`] function returns an iterator that yields a single
5139   element, and [`iter::empty`] returns an iterator that yields no
5140   elements.
5141 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5142   over substring matches.
5143 * [`Cell`] and [`RefCell`] both implement `Eq`.
5144 * A number of methods for wrapping arithmetic are added to the
5145   integral types, [`wrapping_div`], [`wrapping_rem`],
5146   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5147   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5148   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5149   type.. It is illegal for the default arithmetic operations in Rust
5150   to overflow; the desire to wrap must be explicit.
5151 * The `{:#?}` formatting specifier [displays the alternate,
5152   pretty-printed][debugfmt] form of the `Debug` formatter. This
5153   feature was actually introduced prior to 1.0 with little
5154   fanfare.
5155 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5156   for writing data to formatted strings, similar to [`io::Write`].
5157 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5158   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5159   are used by code generators to emit implementations of [`Debug`].
5160 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5161   methods that convert case, following Unicode case mapping.
5162 * It is now easier to handle poisoned locks. The [`PoisonError`]
5163   type, returned by failing lock operations, exposes `into_inner`,
5164   `get_ref`, and `get_mut`, which all give access to the inner lock
5165   guard, and allow the poisoned lock to continue to operate. The
5166   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5167   poisoned lock without attempting to take the lock.
5168 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5169   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5170   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5171   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5172   `ChildStderr`.
5173 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5174   malformed input.
5175
5176 Misc
5177 ----
5178
5179 * `rustc` employs smarter heuristics for guessing at [typos].
5180 * `rustc` emits more efficient code for [no-op conversions between
5181   unsafe pointers][nop].
5182 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5183   resulting in faster compile times and smaller code.
5184
5185 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5186 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5187 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5188 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5189 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5190 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5191 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5192 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5193 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5194 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5195 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5196 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5197 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5198 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5199 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5200 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5201 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5202 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5203 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5204 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5205 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5206 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5207 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5208 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5209 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5210 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5211 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5212 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5213 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5214 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5215 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5216 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5217 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5218 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5219 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5220 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5221 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5222 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5223 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5224 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5225 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5226 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5227 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5228 [align]: https://github.com/rust-lang/rust/pull/25646
5229 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5230 [typos]: https://github.com/rust-lang/rust/pull/26087
5231 [nop]: https://github.com/rust-lang/rust/pull/26336
5232 [fat]: https://github.com/rust-lang/rust/pull/26411
5233 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5234 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5235 [packed]: https://github.com/rust-lang/rust/pull/25541
5236 [ad]: https://github.com/rust-lang/rust/pull/27382
5237 [win]: https://github.com/rust-lang/rust/pull/25350
5238
5239 Version 1.1.0 (2015-06-25)
5240 =========================
5241
5242 * ~850 changes, numerous bugfixes
5243
5244 Highlights
5245 ----------
5246
5247 * The [`std::fs` module has been expanded][fs] to expand the set of
5248   functionality exposed:
5249   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5250     don't incur a syscall on some platforms.
5251   * A `symlink_metadata` function has been added.
5252   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5253     access to all underlying information.
5254 * The compiler now contains extended explanations of many errors. When an error
5255   with an explanation occurs the compiler suggests using the `--explain` flag
5256   to read the explanation. Error explanations are also [available online][err-index].
5257 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5258   well as other work, the time to bootstrap the compiler decreased by
5259   32%.
5260
5261 Libraries
5262 ---------
5263
5264 * The [`str::split_whitespace`] method splits a string on unicode
5265   whitespace boundaries.
5266 * On both Windows and Unix, new extension traits provide conversion of
5267   I/O types to and from the underlying system handles. On Unix, these
5268   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5269   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5270   `TcpListener`, and `UpdSocket`. Further implementations for
5271   `std::process` will be stabilized later.
5272 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5273   Windows, symlinks can be created with
5274   `std::os::windows::symlink_dir` and
5275   `std::os::windows::symlink_file`.
5276 * The `mpsc::Receiver` type can now be converted into an iterator with
5277   `into_iter` on the [`IntoIterator`] trait.
5278 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5279   implementation of the [`From`] trait.
5280 * The `Debug` implementation for `RangeFull` [creates output that is
5281   more consistent with other implementations][rf].
5282 * [`Debug` is implemented for `File`][file].
5283 * The `Default` implementation for `Arc` [no longer requires `Sync +
5284   Send`][arc].
5285 * [The `Iterator` methods `count`, `nth`, and `last` have been
5286   overridden for slices to have O(1) performance instead of O(n)][si].
5287 * Incorrect handling of paths on Windows has been improved in both the
5288   compiler and the standard library.
5289 * [`AtomicPtr` gained a `Default` implementation][ap].
5290 * In accordance with Rust's policy on arithmetic overflow `abs` now
5291   [panics on overflow when debug assertions are enabled][abs].
5292 * The [`Cloned`] iterator, which was accidentally left unstable for
5293   1.0 [has been stabilized][c].
5294 * The [`Incoming`] iterator, which iterates over incoming TCP
5295   connections, and which was accidentally unnamable in 1.0, [is now
5296   properly exported][inc].
5297 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5298   `sift_up` or `sift_down` panic][bh].
5299 * The [`split_off`] method of `LinkedList` [no longer corrupts
5300   the list in certain scenarios][ll].
5301
5302 Misc
5303 ----
5304
5305 * Type checking performance [has improved notably][sk] with
5306   [multiple improvements][pre].
5307 * The compiler [suggests code changes][ch] for more errors.
5308 * rustc and it's build system have experimental support for [building
5309   toolchains against MUSL][m] instead of glibc on Linux.
5310 * The compiler defines the `target_env` cfg value, which is used for
5311   distinguishing toolchains that are otherwise for the same
5312   platform. Presently this is set to `gnu` for common GNU Linux
5313   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5314 * The [`cargo rustc`][crc] command invokes a build with custom flags
5315   to rustc.
5316 * [Android executables are always position independent][pie].
5317 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5318   with `Drop`][drop].
5319
5320 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5321 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5322 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5323 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5324 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5325 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5326 [rf]: https://github.com/rust-lang/rust/pull/24491
5327 [err-index]: https://doc.rust-lang.org/error-index.html
5328 [sk]: https://github.com/rust-lang/rust/pull/24615
5329 [pre]: https://github.com/rust-lang/rust/pull/25323
5330 [file]: https://github.com/rust-lang/rust/pull/24598
5331 [ch]: https://github.com/rust-lang/rust/pull/24683
5332 [arc]: https://github.com/rust-lang/rust/pull/24695
5333 [si]: https://github.com/rust-lang/rust/pull/24701
5334 [ap]: https://github.com/rust-lang/rust/pull/24834
5335 [m]: https://github.com/rust-lang/rust/pull/24777
5336 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5337 [crc]: https://github.com/rust-lang/cargo/pull/1568
5338 [pie]: https://github.com/rust-lang/rust/pull/24953
5339 [abs]: https://github.com/rust-lang/rust/pull/25441
5340 [c]: https://github.com/rust-lang/rust/pull/25496
5341 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5342 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5343 [inc]: https://github.com/rust-lang/rust/pull/25522
5344 [bh]: https://github.com/rust-lang/rust/pull/25856
5345 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5346 [ll]: https://github.com/rust-lang/rust/pull/26022
5347 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5348 [drop]: https://github.com/rust-lang/rust/pull/24935
5349
5350 Version 1.0.0 (2015-05-15)
5351 ========================
5352
5353 * ~1500 changes, numerous bugfixes
5354
5355 Highlights
5356 ----------
5357
5358 * The vast majority of the standard library is now `#[stable]`. It is
5359   no longer possible to use unstable features with a stable build of
5360   the compiler.
5361 * Many popular crates on [crates.io] now work on the stable release
5362   channel.
5363 * Arithmetic on basic integer types now [checks for overflow in debug
5364   builds][overflow].
5365
5366 Language
5367 --------
5368
5369 * Several [restrictions have been added to trait coherence][coh] in
5370   order to make it easier for upstream authors to change traits
5371   without breaking downstream code.
5372 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5373   improve error messages and macro behavior. For example, `0b1234` is
5374   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5375 * Trait bounds [are always invariant][inv], eliminating the need for
5376   the `PhantomFn` and `MarkerTrait` lang items, which have been
5377   removed.
5378 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5379   "foo" as bar` syntax has been replaced with `extern crate foo as
5380   bar`, and Cargo now automatically translates "-" in *package* names
5381   to underscore for the crate name.
5382 * [Lifetime shadowing is an error][lt].
5383 * [`Send` no longer implies `'static`][send-rfc].
5384 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5385   `MyType::default()`.
5386 * Primitive types [now have inherent methods][prim-inherent],
5387   obviating the need for extension traits like `SliceExt`.
5388 * Methods with `Self: Sized` in their `where` clause are [considered
5389   object-safe][self-sized], allowing many extension traits like
5390   `IteratorExt` to be merged into the traits they extended.
5391 * You can now [refer to associated types][assoc-where] whose
5392   corresponding trait bounds appear only in a `where` clause.
5393 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5394   like `Send` and `Sync` are now library-defined.
5395 * A [Reflect trait][reflect] was introduced, which means that
5396   downcasting via the `Any` trait is effectively limited to concrete
5397   types. This helps retain the potentially-important "parametricity"
5398   property: generic code cannot behave differently for different type
5399   arguments except in minor ways.
5400 * The `unsafe_destructor` feature is now deprecated in favor of the
5401   [new `dropck`][dropck]. This change is a major reduction in unsafe
5402   code.
5403
5404 Libraries
5405 ---------
5406
5407 * The `thread_local` module [has been renamed to `std::thread`][th].
5408 * The methods of `IteratorExt` [have been moved to the `Iterator`
5409   trait itself][ie].
5410 * Several traits that implement Rust's conventions for type
5411   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5412   [centralized in the `std::convert` module][con].
5413 * The `FromError` trait [was removed in favor of `From`][fe].
5414 * The basic sleep function [has moved to
5415   `std::thread::sleep_ms`][slp].
5416 * The `splitn` function now takes an `n` parameter that represents the
5417   number of items yielded by the returned iterator [instead of the
5418   number of 'splits'][spl].
5419 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5420 * [Derived implementations of `PartialOrd` now order enums according
5421   to their explicitly-assigned discriminants][po].
5422 * [Methods for searching strings are generic over `Pattern`s][pat],
5423   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5424   some others.
5425 * [In method resolution, object methods are resolved before inherent
5426   methods][meth].
5427 * [`String::from_str` has been deprecated in favor of the `From` impl,
5428   `String::from`][sf].
5429 * [`io::Error` implements `Sync`][ios].
5430 * [The `words` method on `&str` has been replaced with
5431   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5432   a word?'
5433 * The new path and IO modules are complete and `#[stable]`. This
5434   was the major library focus for this cycle.
5435 * The path API was [revised][path-normalize] to normalize `.`,
5436   adjusting the tradeoffs in favor of the most common usage.
5437 * A large number of remaining APIs in `std` were also stabilized
5438   during this cycle; about 75% of the non-deprecated API surface
5439   is now stable.
5440 * The new [string pattern API][string-pattern] landed, which makes
5441   the string slice API much more internally consistent and flexible.
5442 * A new set of [generic conversion traits][conversion] replaced
5443   many existing ad hoc traits.
5444 * Generic numeric traits were [completely removed][num-traits]. This
5445   was made possible thanks to inherent methods for primitive types,
5446   and the removal gives maximal flexibility for designing a numeric
5447   hierarchy in the future.
5448 * The `Fn` traits are now related via [inheritance][fn-inherit]
5449   and provide ergonomic [blanket implementations][fn-blanket].
5450 * The `Index` and `IndexMut` traits were changed to
5451   [take the index by value][index-value], enabling code like
5452   `hash_map["string"]` to work.
5453 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5454   `Copy` data is known to be `Clone` as well.
5455
5456 Misc
5457 ----
5458
5459 * Many errors now have extended explanations that can be accessed with
5460   the `--explain` flag to `rustc`.
5461 * Many new examples have been added to the standard library
5462   documentation.
5463 * rustdoc has received a number of improvements focused on completion
5464   and polish.
5465 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5466 * Much headway was made on ecosystem-wide CI, making it possible
5467   to [compare builds for breakage][ci-compare].
5468
5469
5470 [crates.io]: http://crates.io
5471 [clo]: https://github.com/rust-lang/rust/pull/24034
5472 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5473 [con]: https://github.com/rust-lang/rust/pull/23875
5474 [cr]: https://github.com/rust-lang/rust/pull/23419
5475 [fe]: https://github.com/rust-lang/rust/pull/23879
5476 [ie]: https://github.com/rust-lang/rust/pull/23300
5477 [inv]: https://github.com/rust-lang/rust/pull/23938
5478 [ios]: https://github.com/rust-lang/rust/pull/24133
5479 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5480 [lt]: https://github.com/rust-lang/rust/pull/24057
5481 [meth]: https://github.com/rust-lang/rust/pull/24056
5482 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5483 [po]: https://github.com/rust-lang/rust/pull/24270
5484 [sf]: https://github.com/rust-lang/rust/pull/24517
5485 [slp]: https://github.com/rust-lang/rust/pull/23949
5486 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5487 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5488 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5489 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5490 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5491 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5492 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5493 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5494 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5495 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5496 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5497 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5498 [reflect]: https://github.com/rust-lang/rust/pull/23712
5499 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5500 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5501 [index-value]: https://github.com/rust-lang/rust/pull/23601
5502 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5503 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5504 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5505 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5506 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5507 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5508
5509
5510 Version 1.0.0-alpha.2 (2015-02-20)
5511 =====================================
5512
5513 * ~1300 changes, numerous bugfixes
5514
5515 * Highlights
5516
5517     * The various I/O modules were [overhauled][io-rfc] to reduce
5518       unnecessary abstractions and provide better interoperation with
5519       the underlying platform. The old `io` module remains temporarily
5520       at `std::old_io`.
5521     * The standard library now [participates in feature gating][feat],
5522       so use of unstable libraries now requires a `#![feature(...)]`
5523       attribute. The impact of this change is [described on the
5524       forum][feat-forum]. [RFC][feat-rfc].
5525
5526 * Language
5527
5528     * `for` loops [now operate on the `IntoIterator` trait][into],
5529       which eliminates the need to call `.iter()`, etc. to iterate
5530       over collections. There are some new subtleties to remember
5531       though regarding what sort of iterators various types yield, in
5532       particular that `for foo in bar { }` yields values from a move
5533       iterator, destroying the original collection. [RFC][into-rfc].
5534     * Objects now have [default lifetime bounds][obj], so you don't
5535       have to write `Box<Trait+'static>` when you don't care about
5536       storing references. [RFC][obj-rfc].
5537     * In types that implement `Drop`, [lifetimes must outlive the
5538       value][drop]. This will soon make it possible to safely
5539       implement `Drop` for types where `#[unsafe_destructor]` is now
5540       required. Read the [gorgeous RFC][drop-rfc] for details.
5541     * The fully qualified <T as Trait>::X syntax lets you set the Self
5542       type for a trait method or associated type. [RFC][ufcs-rfc].
5543     * References to types that implement `Deref<U>` now [automatically
5544       coerce to references][deref] to the dereferenced type `U`,
5545       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5546       should eliminate many unsightly uses of `&*`, as when converting
5547       from references to vectors into references to
5548       slices. [RFC][deref-rfc].
5549     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5550       `|:|`) is obsolete and closure kind is inferred from context.
5551     * [`Self` is a keyword][Self].
5552
5553 * Libraries
5554
5555     * The `Show` and `String` formatting traits [have been
5556       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5557       their related purposes. Automatically getting a string
5558       conversion to use with `format!("{:?}", something_to_debug)` is
5559       now written `#[derive(Debug)]`.
5560     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5561       OsStr}`, provide strings in platform-specific encodings for easier
5562       interop with system APIs. [RFC][osstr-rfc].
5563     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5564       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5565       creating raw pointers.
5566
5567 * Tooling
5568
5569     * Certain long error messages of the form 'expected foo found bar'
5570       are now [split neatly across multiple
5571       lines][multiline]. Examples in the PR.
5572     * On Unix Rust can be [uninstalled][un] by running
5573       `/usr/local/lib/rustlib/uninstall.sh`.
5574     * The `#[rustc_on_unimplemented]` attribute, requiring the
5575       'on_unimplemented' feature, lets rustc [display custom error
5576       messages when a trait is expected to be implemented for a type
5577       but is not][onun].
5578
5579 * Misc
5580
5581     * Rust is tested against a [LALR grammar][lalr], which parses
5582       almost all the Rust files that rustc does.
5583
5584 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5585 [close]: https://github.com/rust-lang/rust/pull/21843
5586 [deref]: https://github.com/rust-lang/rust/pull/21351
5587 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5588 [drop]: https://github.com/rust-lang/rust/pull/21972
5589 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5590 [feat]: https://github.com/rust-lang/rust/pull/21248
5591 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5592 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5593 [fmt]: https://github.com/rust-lang/rust/pull/21457
5594 [into]: https://github.com/rust-lang/rust/pull/20790
5595 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5596 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5597 [lalr]: https://github.com/rust-lang/rust/pull/21452
5598 [multiline]: https://github.com/rust-lang/rust/pull/19870
5599 [obj]: https://github.com/rust-lang/rust/pull/22230
5600 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5601 [onun]: https://github.com/rust-lang/rust/pull/20889
5602 [osstr]: https://github.com/rust-lang/rust/pull/21488
5603 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5604 [Self]: https://github.com/rust-lang/rust/pull/22158
5605 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5606 [un]: https://github.com/rust-lang/rust/pull/22256
5607
5608
5609 Version 1.0.0-alpha (2015-01-09)
5610 ==================================
5611
5612   * ~2400 changes, numerous bugfixes
5613
5614   * Highlights
5615
5616     * The language itself is considered feature complete for 1.0,
5617       though there will be many usability improvements and bugfixes
5618       before the final release.
5619     * Nearly 50% of the public API surface of the standard library has
5620       been declared 'stable'. Those interfaces are unlikely to change
5621       before 1.0.
5622     * The long-running debate over integer types has been
5623       [settled][ints]: Rust will ship with types named `isize` and
5624       `usize`, rather than `int` and `uint`, for pointer-sized
5625       integers. Guidelines will be rolled out during the alpha cycle.
5626     * Most crates that are not `std` have been moved out of the Rust
5627       distribution into the Cargo ecosystem so they can evolve
5628       separately and don't need to be stabilized as quickly, including
5629       'time', 'getopts', 'num', 'regex', and 'term'.
5630     * Documentation continues to be expanded with more API coverage, more
5631       examples, and more in-depth explanations. The guides have been
5632       consolidated into [The Rust Programming Language][trpl].
5633     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5634     * All official Rust binary installers now come with [Cargo], the
5635       Rust package manager.
5636
5637 * Language
5638
5639     * Closures have been [completely redesigned][unboxed] to be
5640       implemented in terms of traits, can now be used as generic type
5641       bounds and thus monomorphized and inlined, or via an opaque
5642       pointer (boxed) as in the old system. The new system is often
5643       referred to as 'unboxed' closures.
5644     * Traits now support [associated types][assoc], allowing families
5645       of related types to be defined together and used generically in
5646       powerful ways.
5647     * Enum variants are [namespaced by their type names][enum].
5648     * [`where` clauses][where] provide a more versatile and attractive
5649       syntax for specifying generic bounds, though the previous syntax
5650       remains valid.
5651     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5652       numeric types.
5653     * Rust [no longer has a runtime][rt] of any description, and only
5654       supports OS threads, not green threads.
5655     * At long last, Rust has been overhauled for 'dynamically-sized
5656       types' ([DST]), which integrates 'fat pointers' (object types,
5657       arrays, and `str`) more deeply into the type system, making it
5658       more consistent.
5659     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5660       `..j` that produce range types and which, when combined with the
5661       `Index` operator and multidispatch, leads to a convenient slice
5662       notation, `[i..j]`.
5663     * The new range syntax revealed an ambiguity in the fixed-length
5664       array syntax, so now fixed length arrays [are written `[T;
5665       N]`][arrays].
5666     * The `Copy` trait is no longer implemented automatically. Unsafe
5667       pointers no longer implement `Sync` and `Send` so types
5668       containing them don't automatically either. `Sync` and `Send`
5669       are now 'unsafe traits' so one can "forcibly" implement them via
5670       `unsafe impl` if a type confirms to the requirements for them
5671       even though the internals do not (e.g. structs containing unsafe
5672       pointers like `Arc`). These changes are intended to prevent some
5673       footguns and are collectively known as [opt-in built-in
5674       traits][oibit] (though `Sync` and `Send` will soon become pure
5675       library types unknown to the compiler).
5676     * Operator traits now take their operands [by value][ops], and
5677       comparison traits can use multidispatch to compare one type
5678       against multiple other types, allowing e.g. `String` to be
5679       compared with `&str`.
5680     * `if let` and `while let` are no longer feature-gated.
5681     * Rust has adopted a more [uniform syntax for escaping unicode
5682       characters][unicode].
5683     * `macro_rules!` [has been declared stable][mac]. Though it is a
5684       flawed system it is sufficiently popular that it must be usable
5685       for 1.0. Effort has gone into [future-proofing][mac-future] it
5686       in ways that will allow other macro systems to be developed in
5687       parallel, and won't otherwise impact the evolution of the
5688       language.
5689     * The prelude has been [pared back significantly][prelude] such
5690       that it is the minimum necessary to support the most pervasive
5691       code patterns, and through [generalized where clauses][where]
5692       many of the prelude extension traits have been consolidated.
5693     * Rust's rudimentary reflection [has been removed][refl], as it
5694       incurred too much code generation for little benefit.
5695     * [Struct variants][structvars] are no longer feature-gated.
5696     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5697       known as 'higher-ranked trait bounds', this crucially allows
5698       unboxed closures to work.
5699     * Macros invocations surrounded by parens or square brackets and
5700       not terminated by a semicolon are [parsed as
5701       expressions][macros], which makes expressions like `vec![1i32,
5702       2, 3].len()` work as expected.
5703     * Trait objects now implement their traits automatically, and
5704       traits that can be coerced to objects now must be [object
5705       safe][objsafe].
5706     * Automatically deriving traits is now done with `#[derive(...)]`
5707       not `#[deriving(...)]` for [consistency with other naming
5708       conventions][derive].
5709     * Importing the containing module or enum at the same time as
5710       items or variants they contain is [now done with `self` instead
5711       of `mod`][self], as in use `foo::{self, bar}`
5712     * Glob imports are no longer feature-gated.
5713     * The `box` operator and `box` patterns have been feature-gated
5714       pending a redesign. For now unique boxes should be allocated
5715       like other containers, with `Box::new`.
5716
5717 * Libraries
5718
5719     * A [series][coll1] of [efforts][coll2] to establish
5720       [conventions][coll3] for collections types has resulted in API
5721       improvements throughout the standard library.
5722     * New [APIs for error handling][err] provide ergonomic interop
5723       between error types, and [new conventions][err-conv] describe
5724       more clearly the recommended error handling strategies in Rust.
5725     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5726       it is easier to discuss failure in the context of error handling
5727       without making clarifications as to whether you are referring to
5728       the 'fail' macro or failure more generally.
5729     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5730       syscall when available.
5731     * The 'serialize' crate has been renamed 'rustc-serialize' and
5732       moved out of the distribution to Cargo. Although it is widely
5733       used now, it is expected to be superseded in the near future.
5734     * The `Show` formatter, typically implemented with
5735       `#[derive(Show)]` is [now requested with the `{:?}`
5736       specifier][show] and is intended for use by all types, for uses
5737       such as `println!` debugging. The new `String` formatter must be
5738       implemented by hand, uses the `{}` specifier, and is intended
5739       for full-fidelity conversions of things that can logically be
5740       represented as strings.
5741
5742 * Tooling
5743
5744     * [Flexible target specification][flex] allows rustc's code
5745       generation to be configured to support otherwise-unsupported
5746       platforms.
5747     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5748       respective debuggers with Rust-appropriate pretty-printing.
5749     * The Windows installation of Rust is distributed with the
5750       MinGW components currently required to link binaries on that
5751       platform.
5752
5753 * Misc
5754
5755     * Nullable enum optimizations have been extended to more types so
5756       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5757       space than the inner types themselves.
5758     * Work has begun on supporting AArch64.
5759
5760 [Cargo]: https://crates.io
5761 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5762 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5763 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5764 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5765 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5766 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5767 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5768 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5769 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5770 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5771 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5772 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5773 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5774 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5775 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5776 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5777 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5778 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5779 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5780 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5781 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5782 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5783 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5784 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5785 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5786 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5787 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5788 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5789 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5790 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5791 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5792 [trpl]: https://doc.rust-lang.org/book/index.html
5793 [rbe]: http://rustbyexample.com/
5794
5795
5796 Version 0.12.0 (2014-10-09)
5797 =============================
5798
5799   * ~1900 changes, numerous bugfixes
5800
5801   * Highlights
5802
5803     * The introductory documentation (now called The Rust Guide) has
5804       been completely rewritten, as have a number of supplementary
5805       guides.
5806     * Rust's package manager, Cargo, continues to improve and is
5807       sometimes considered to be quite awesome.
5808     * Many API's in `std` have been reviewed and updated for
5809       consistency with the in-development Rust coding
5810       guidelines. The standard library documentation tracks
5811       stabilization progress.
5812     * Minor libraries have been moved out-of-tree to the rust-lang org
5813       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5814       be installed with Cargo.
5815     * Lifetime elision allows lifetime annotations to be left off of
5816       function declarations in many common scenarios.
5817     * Rust now works on 64-bit Windows.
5818
5819   * Language
5820     * Indexing can be overloaded with the `Index` and `IndexMut`
5821       traits.
5822     * The `if let` construct takes a branch only if the `let` pattern
5823       matches, currently behind the 'if_let' feature gate.
5824     * 'where clauses', a more flexible syntax for specifying trait
5825       bounds that is more aesthetic, have been added for traits and
5826       free functions. Where clauses will in the future make it
5827       possible to constrain associated types, which would be
5828       impossible with the existing syntax.
5829     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5830       the 'slicing_syntax' feature gate, and can be overloaded with
5831       the `Slice` or `SliceMut` traits.
5832     * The syntax for matching of sub-slices has been changed to use a
5833       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5834       consistency with other uses of `..` and to future-proof
5835       potential additional uses of the syntax.
5836     * The syntax for matching inclusive ranges in patterns has changed
5837       from `0..3` to `0...4` to be consistent with the exclusive range
5838       syntax for slicing.
5839     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5840       c]`) has been put behind the 'advanced_slice_patterns' feature
5841       gate and may be removed in the future.
5842     * Components of tuples and tuple structs can be extracted using
5843       the `value.0` syntax, currently behind the `tuple_indexing`
5844       feature gate.
5845     * The `#[crate_id]` attribute is no longer supported; versioning
5846       is handled by the package manager.
5847     * Renaming crate imports are now written `extern crate foo as bar`
5848       instead of `extern crate bar = foo`.
5849     * Renaming use statements are now written `use foo as bar` instead
5850       of `use bar = foo`.
5851     * `let` and `match` bindings and argument names in macros are now
5852       hygienic.
5853     * The new, more efficient, closure types ('unboxed closures') have
5854       been added under a feature gate, 'unboxed_closures'. These will
5855       soon replace the existing closure types, once higher-ranked
5856       trait lifetimes are added to the language.
5857     * `move` has been added as a keyword, for indicating closures
5858       that capture by value.
5859     * Mutation and assignment is no longer allowed in pattern guards.
5860     * Generic structs and enums can now have trait bounds.
5861     * The `Share` trait is now called `Sync` to free up the term
5862       'shared' to refer to 'shared reference' (the default reference
5863       type.
5864     * Dynamically-sized types have been mostly implemented,
5865       unifying the behavior of fat-pointer types with the rest of the
5866       type system.
5867     * As part of dynamically-sized types, the `Sized` trait has been
5868       introduced, which qualifying types implement by default, and
5869       which type parameters expect by default. To specify that a type
5870       parameter does not need to be sized, write `<Sized? T>`. Most
5871       types are `Sized`, notable exceptions being unsized arrays
5872       (`[T]`) and trait types.
5873     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5874     * Lifetime bounds can now be applied to type parameters and object
5875       types.
5876     * The old, reference counted GC type, `Gc<T>` which was once
5877       denoted by the `@` sigil, has finally been removed. GC will be
5878       revisited in the future.
5879
5880   * Libraries
5881     * Library documentation has been improved for a number of modules.
5882     * Bit-vectors, collections::bitv has been modernized.
5883     * The url crate is deprecated in favor of
5884       http://github.com/servo/rust-url, which can be installed with
5885       Cargo.
5886     * Most I/O stream types can be cloned and subsequently closed from
5887       a different thread.
5888     * A `std::time::Duration` type has been added for use in I/O
5889       methods that rely on timers, as well as in the 'time' crate's
5890       `Timespec` arithmetic.
5891     * The runtime I/O abstraction layer that enabled the green thread
5892       scheduler to do non-thread-blocking I/O has been removed, along
5893       with the libuv-based implementation employed by the green thread
5894       scheduler. This will greatly simplify the future I/O work.
5895     * `collections::btree` has been rewritten to have a more
5896       idiomatic and efficient design.
5897
5898   * Tooling
5899     * rustdoc output now indicates the stability levels of API's.
5900     * The `--crate-name` flag can specify the name of the crate
5901       being compiled, like `#[crate_name]`.
5902     * The `-C metadata` specifies additional metadata to hash into
5903       symbol names, and `-C extra-filename` specifies additional
5904       information to put into the output filename, for use by the
5905       package manager for versioning.
5906     * debug info generation has continued to improve and should be
5907       more reliable under both gdb and lldb.
5908     * rustc has experimental support for compiling in parallel
5909       using the `-C codegen-units` flag.
5910     * rustc no longer encodes rpath information into binaries by
5911       default.
5912
5913   * Misc
5914     * Stack usage has been optimized with LLVM lifetime annotations.
5915     * Official Rust binaries on Linux are more compatible with older
5916       kernels and distributions, built on CentOS 5.10.
5917
5918
5919 Version 0.11.0 (2014-07-02)
5920 ==========================
5921
5922   * ~1700 changes, numerous bugfixes
5923
5924   * Language
5925     * ~[T] has been removed from the language. This type is superseded by
5926       the Vec<T> type.
5927     * ~str has been removed from the language. This type is superseded by
5928       the String type.
5929     * ~T has been removed from the language. This type is superseded by the
5930       Box<T> type.
5931     * @T has been removed from the language. This type is superseded by the
5932       standard library's std::gc::Gc<T> type.
5933     * Struct fields are now all private by default.
5934     * Vector indices and shift amounts are both required to be a `uint`
5935       instead of any integral type.
5936     * Byte character, byte string, and raw byte string literals are now all
5937       supported by prefixing the normal literal with a `b`.
5938     * Multiple ABIs are no longer allowed in an ABI string
5939     * The syntax for lifetimes on closures/procedures has been tweaked
5940       slightly: `<'a>|A, B|: 'b + K -> T`
5941     * Floating point modulus has been removed from the language; however it
5942       is still provided by a library implementation.
5943     * Private enum variants are now disallowed.
5944     * The `priv` keyword has been removed from the language.
5945     * A closure can no longer be invoked through a &-pointer.
5946     * The `use foo, bar, baz;` syntax has been removed from the language.
5947     * The transmute intrinsic no longer works on type parameters.
5948     * Statics now allow blocks/items in their definition.
5949     * Trait bounds are separated from objects with + instead of : now.
5950     * Objects can no longer be read while they are mutably borrowed.
5951     * The address of a static is now marked as insignificant unless the
5952       #[inline(never)] attribute is placed it.
5953     * The #[unsafe_destructor] attribute is now behind a feature gate.
5954     * Struct literals are no longer allowed in ambiguous positions such as
5955       if, while, match, and for..in.
5956     * Declaration of lang items and intrinsics are now feature-gated by
5957       default.
5958     * Integral literals no longer default to `int`, and floating point
5959       literals no longer default to `f64`. Literals must be suffixed with an
5960       appropriate type if inference cannot determine the type of the
5961       literal.
5962     * The Box<T> type is no longer implicitly borrowed to &mut T.
5963     * Procedures are now required to not capture borrowed references.
5964
5965   * Libraries
5966     * The standard library is now a "facade" over a number of underlying
5967       libraries. This means that development on the standard library should
5968       be speedier due to smaller crates, as well as a clearer line between
5969       all dependencies.
5970     * A new library, libcore, lives under the standard library's facade
5971       which is Rust's "0-assumption" library, suitable for embedded and
5972       kernel development for example.
5973     * A regex crate has been added to the standard distribution. This crate
5974       includes statically compiled regular expressions.
5975     * The unwrap/unwrap_err methods on Result require a Show bound for
5976       better error messages.
5977     * The return types of the std::comm primitives have been centralized
5978       around the Result type.
5979     * A number of I/O primitives have gained the ability to time out their
5980       operations.
5981     * A number of I/O primitives have gained the ability to close their
5982       reading/writing halves to cancel pending operations.
5983     * Reverse iterator methods have been removed in favor of `rev()` on
5984       their forward-iteration counterparts.
5985     * A bitflags! macro has been added to enable easy interop with C and
5986       management of bit flags.
5987     * A debug_assert! macro is now provided which is disabled when
5988       `--cfg ndebug` is passed to the compiler.
5989     * A graphviz crate has been added for creating .dot files.
5990     * The std::cast module has been migrated into std::mem.
5991     * The std::local_data api has been migrated from freestanding functions
5992       to being based on methods.
5993     * The Pod trait has been renamed to Copy.
5994     * jemalloc has been added as the default allocator for types.
5995     * The API for allocating memory has been changed to use proper alignment
5996       and sized deallocation
5997     * Connecting a TcpStream or binding a TcpListener is now based on a
5998       string address and a u16 port. This allows connecting to a hostname as
5999       opposed to an IP.
6000     * The Reader trait now contains a core method, read_at_least(), which
6001       correctly handles many repeated 0-length reads.
6002     * The process-spawning API is now centered around a builder-style
6003       Command struct.
6004     * The :? printing qualifier has been moved from the standard library to
6005       an external libdebug crate.
6006     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
6007       have been renamed to Eq/Ord.
6008     * The select/plural methods have been removed from format!. The escapes
6009       for { and } have also changed from \{ and \} to {{ and }},
6010       respectively.
6011     * The TaskBuilder API has been re-worked to be a true builder, and
6012       extension traits for spawning native/green tasks have been added.
6013
6014   * Tooling
6015     * All breaking changes to the language or libraries now have their
6016       commit message annotated with `[breaking-change]` to allow for easy
6017       discovery of breaking changes.
6018     * The compiler will now try to suggest how to annotate lifetimes if a
6019       lifetime-related error occurs.
6020     * Debug info continues to be improved greatly with general bug fixes and
6021       better support for situations like link time optimization (LTO).
6022     * Usage of syntax extensions when cross-compiling has been fixed.
6023     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6024       -fdata-sections and --gc-sections has been enabled by default
6025     * The compiler is now stricter about where it will load module files
6026       from when a module is declared via `mod foo;`.
6027     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6028       Syntax extensions are now discovered via a "plugin registrar" type
6029       which will be extended in the future to other various plugins.
6030     * Lints have been restructured to allow for dynamically loadable lints.
6031     * A number of rustdoc improvements:
6032       * The HTML output has been visually redesigned.
6033       * Markdown is now powered by hoedown instead of sundown.
6034       * Searching heuristics have been greatly improved.
6035       * The search index has been reduced in size by a great amount.
6036       * Cross-crate documentation via `pub use` has been greatly improved.
6037       * Primitive types are now hyperlinked and documented.
6038     * Documentation has been moved from static.rust-lang.org/doc to
6039       doc.rust-lang.org
6040     * A new sandbox, play.rust-lang.org, is available for running and
6041       sharing rust code examples on-line.
6042     * Unused attributes are now more robustly warned about.
6043     * The dead_code lint now warns about unused struct fields.
6044     * Cross-compiling to iOS is now supported.
6045     * Cross-compiling to mipsel is now supported.
6046     * Stability attributes are now inherited by default and no longer apply
6047       to intra-crate usage, only inter-crate usage.
6048     * Error message related to non-exhaustive match expressions have been
6049       greatly improved.
6050
6051
6052 Version 0.10 (2014-04-03)
6053 =========================
6054
6055   * ~1500 changes, numerous bugfixes
6056
6057   * Language
6058     * A new RFC process is now in place for modifying the language.
6059     * Patterns with `@`-pointers have been removed from the language.
6060     * Patterns with unique vectors (`~[T]`) have been removed from the
6061       language.
6062     * Patterns with unique strings (`~str`) have been removed from the
6063       language.
6064     * `@str` has been removed from the language.
6065     * `@[T]` has been removed from the language.
6066     * `@self` has been removed from the language.
6067     * `@Trait` has been removed from the language.
6068     * Headers on `~` allocations which contain `@` boxes inside the type for
6069       reference counting have been removed.
6070     * The semantics around the lifetimes of temporary expressions have changed,
6071       see #3511 and #11585 for more information.
6072     * Cross-crate syntax extensions are now possible, but feature gated. See
6073       #11151 for more information. This includes both `macro_rules!` macros as
6074       well as syntax extensions such as `format!`.
6075     * New lint modes have been added, and older ones have been turned on to be
6076       warn-by-default.
6077       * Unnecessary parentheses
6078       * Uppercase statics
6079       * Camel Case types
6080       * Uppercase variables
6081       * Publicly visible private types
6082       * `#[deriving]` with raw pointers
6083     * Unsafe functions can no longer be coerced to closures.
6084     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6085     * The `#[simd]` attribute is now behind a feature gate.
6086     * Visibility is no longer allowed on `extern crate` statements, and
6087       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6088     * Trailing commas are now allowed in argument lists and tuple patterns.
6089     * The `do` keyword has been removed, it is now a reserved keyword.
6090     * Default type parameters have been implemented, but are feature gated.
6091     * Borrowed variables through captures in closures are now considered soundly.
6092     * `extern mod` is now `extern crate`
6093     * The `Freeze` trait has been removed.
6094     * The `Share` trait has been added for types that can be shared among
6095       threads.
6096     * Labels in macros are now hygienic.
6097     * Expression/statement macro invocations can be delimited with `{}` now.
6098     * Treatment of types allowed in `static mut` locations has been tweaked.
6099     * The `*` and `.` operators are now overloadable through the `Deref` and
6100       `DerefMut` traits.
6101     * `~Trait` and `proc` no longer have `Send` bounds by default.
6102     * Partial type hints are now supported with the `_` type marker.
6103     * An `Unsafe` type was introduced for interior mutability. It is now
6104       considered undefined to transmute from `&T` to `&mut T` without using the
6105       `Unsafe` type.
6106     * The #[linkage] attribute was implemented for extern statics/functions.
6107     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6108     * `Pod` was renamed to `Copy`.
6109
6110   * Libraries
6111     * The `libextra` library has been removed. It has now been decomposed into
6112       component libraries with smaller and more focused nuggets of
6113       functionality. The full list of libraries can be found on the
6114       documentation index page.
6115     * std: `std::condition` has been removed. All I/O errors are now propagated
6116       through the `Result` type. In order to assist with error handling, a
6117       `try!` macro for unwrapping errors with an early return and a lint for
6118       unused results has been added. See #12039 for more information.
6119     * std: The `vec` module has been renamed to `slice`.
6120     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6121       This will become the only growable vector in the future.
6122     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6123       are now found at `std::io::BufferedReader` instead of
6124       `std::io::buffered::BufferedReader`.
6125     * std: `print` and `println` are no longer in the prelude, the `print!` and
6126       `println!` macros are intended to be used instead.
6127     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6128       attempts to statically prevent cycles.
6129     * std: The standard distribution is adopting the policy of pushing failure
6130       to the user rather than failing in libraries. Many functions (such as
6131       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6132     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6133       deriving mode: `#[deriving(Show)]`.
6134     * std: `ToStr` is now implemented for all types implementing `Show`.
6135     * std: The formatting trait methods now take `&self` instead of `&T`
6136     * std: The `invert()` method on iterators has been renamed to `rev()`
6137     * std: `std::num` has seen a reduction in the genericity of its traits,
6138       consolidating functionality into a few core traits.
6139     * std: Backtraces are now printed on task failure if the environment
6140       variable `RUST_BACKTRACE` is present.
6141     * std: Naming conventions for iterators have been standardized. More details
6142       can be found on the wiki's style guide.
6143     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6144       still implement the function.
6145     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6146     * std: `assert_approx_eq!` has been removed
6147     * std: The `e` and `E` formatting specifiers for floats have been added to
6148       print them in exponential notation.
6149     * std: The `Times` trait has been removed
6150     * std: Indications of variance and opting out of builtin bounds is done
6151       through marker types in `std::kinds::marker` now
6152     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6153       `#[deriving(Hash)]` is now possible.
6154     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6155     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6156     * std: `Chan::new` is now `channel()`.
6157     * std: A new synchronous channel type has been implemented.
6158     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6159     * std: `hashmap` and `trie` have been moved to `libcollections`
6160     * std: `run` has been rolled into `io::process`
6161     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6162     * std: The equality and comparison traits have seen some reorganization.
6163     * std: `rand` has moved to `librand`.
6164     * std: `to_{lower,upper}case` has been implemented for `char`.
6165     * std: Logging has been moved to `liblog`.
6166     * collections: `HashMap` has been rewritten for higher performance and less
6167       memory usage.
6168     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6169       it can be booted manually. The runtime guide has more information and
6170       examples.
6171     * native: All I/O functionality except signals has been implemented.
6172     * green: Task spawning with `libgreen` has been optimized with stack caching
6173       and various trimming of code.
6174     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6175     * sync: The `extra::sync` module has been updated to modern rust (and moved
6176       to the `sync` library), tweaking and improving various interfaces while
6177       dropping redundant functionality.
6178     * sync: A new `Barrier` type has been added to the `sync` library.
6179     * sync: An efficient mutex for native and green tasks has been implemented.
6180     * serialize: The `base64` module has seen some improvement. It treats
6181       newlines better, has non-string error values, and has seen general
6182       cleanup.
6183     * fourcc: A `fourcc!` macro was introduced
6184     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6185       hexadecimal literal.
6186
6187   * Tooling
6188     * `rustpkg` has been deprecated and removed from the main repository. Its
6189       replacement, `cargo`, is under development.
6190     * Nightly builds of rust are now available
6191     * The memory usage of rustc has been improved many times throughout this
6192       release cycle.
6193     * The build process supports disabling rpath support for the rustc binary
6194       itself.
6195     * Code generation has improved in some cases, giving more information to the
6196       LLVM optimization passes to enable more extensive optimizations.
6197     * Debuginfo compatibility with lldb on OSX has been restored.
6198     * The master branch is now gated on an android bot, making building for
6199       android much more reliable.
6200     * Output flags have been centralized into one `--emit` flag.
6201     * Crate type flags have been centralized into one `--crate-type` flag.
6202     * Codegen flags have been consolidated behind a `-C` flag.
6203     * Linking against outdated crates now has improved error messages.
6204     * Error messages with lifetimes will often suggest how to annotate the
6205       function to fix the error.
6206     * Many more types are documented in the standard library, and new guides
6207       were written.
6208     * Many `rustdoc` improvements:
6209       * code blocks are syntax highlighted.
6210       * render standalone markdown files.
6211       * the --test flag tests all code blocks by default.
6212       * exported macros are displayed.
6213       * re-exported types have their documentation inlined at the location of the
6214         first re-export.
6215       * search works across crates that have been rendered to the same output
6216         directory.
6217
6218
6219 Version 0.9 (2014-01-09)
6220 ==========================
6221
6222    * ~1800 changes, numerous bugfixes
6223
6224    * Language
6225       * The `float` type has been removed. Use `f32` or `f64` instead.
6226       * A new facility for enabling experimental features (feature gating) has
6227         been added, using the crate-level `#[feature(foo)]` attribute.
6228       * Managed boxes (@) are now behind a feature gate
6229         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6230         standard library's `Gc` or `Rc` types instead.
6231       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6232       * Jumping back to the top of a loop is now done with `continue` instead of
6233         `loop`.
6234       * Strings can no longer be mutated through index assignment.
6235       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6236         hash delimiters, as in `r###"foo"###`.
6237       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6238         called once.
6239       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6240       * `@fn`s have been removed.
6241       * `do` only works with procs in order to make it obvious what the cost
6242         of `do` is.
6243       * Single-element tuple-like structs can no longer be dereferenced to
6244         obtain the inner value. A more comprehensive solution for overloading
6245         the dereference operator will be provided in the future.
6246       * The `#[link(...)]` attribute has been replaced with
6247         `#[crate_id = "name#vers"]`.
6248       * Empty `impl`s must be terminated with empty braces and may not be
6249         terminated with a semicolon.
6250       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6251         no longer has any special meaning.
6252       * The old `fmt!` string formatting macro has been removed.
6253       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6254         `print!` and `println!`.
6255       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6256       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6257         `extern mod foo = "bar"` instead.
6258       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6259       * Macros can have attributes.
6260       * Macros can expand to items with attributes.
6261       * Macros can expand to multiple items.
6262       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6263       * Comments may be nested.
6264       * Values automatically coerce to trait objects they implement, without
6265         an explicit `as`.
6266       * Enum discriminants are no longer an entire word but as small as needed to
6267         contain all the variants. The `repr` attribute can be used to override
6268         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6269         `#[repr(C)]` to match C enums.
6270       * Non-string literals are not allowed in attributes (they never worked).
6271       * The FFI now supports variadic functions.
6272       * Octal numeric literals, as in `0o7777`.
6273       * The `concat!` syntax extension performs compile-time string concatenation.
6274       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6275         removed as Rust no longer uses segmented stacks.
6276       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6277       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6278         not `*`; ignoring remaining fields of a struct is also done with `..`,
6279         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6280       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6281       * `rustc` supports the "system" calling convention, which defaults to the
6282         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6283         "C" elsewhere.
6284       * The `type_overflow` lint (default: warn) checks literals for overflow.
6285       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6286       * The `attribute_usage` lint (default: warn) warns about unknown
6287         attributes.
6288       * The `unknown_features` lint (default: warn) warns about unknown
6289         feature gates.
6290       * The `dead_code` lint (default: warn) checks for dead code.
6291       * Rust libraries can be linked statically to one another
6292       * `#[link_args]` is behind the `link_args` feature gate.
6293       * Native libraries are now linked with `#[link(name = "foo")]`
6294       * Native libraries can be statically linked to a rust crate
6295         (`#[link(name = "foo", kind = "static")]`).
6296       * Native OS X frameworks are now officially supported
6297         (`#[link(name = "foo", kind = "framework")]`).
6298       * The `#[thread_local]` attribute creates thread-local (not task-local)
6299         variables. Currently behind the `thread_local` feature gate.
6300       * The `return` keyword may be used in closures.
6301       * Types that can be copied via a memcpy implement the `Pod` kind.
6302       * The `cfg` attribute can now be used on struct fields and enum variants.
6303
6304    * Libraries
6305       * std: The `option` and `result` API's have been overhauled to make them
6306         simpler, more consistent, and more composable.
6307       * std: The entire `std::io` module has been replaced with one that is
6308         more comprehensive and that properly interfaces with the underlying
6309         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6310         implemented.
6311       * std: `io::util` contains a number of useful implementations of
6312         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6313         `ZeroReader`, `TeeReader`.
6314       * std: The reference counted pointer type `extra::rc` moved into std.
6315       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6316         just a wrapper around it).
6317       * std: The `Either` type has been removed.
6318       * std: `fmt::Default` can be implemented for any type to provide default
6319         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6320       * std: The `rand` API continues to be tweaked.
6321       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6322         on failure in gdb, is now named `rust_fail`.
6323       * std: The `each_key` and `each_value` methods on `HashMap` have been
6324         replaced by the `keys` and `values` iterators.
6325       * std: Functions dealing with type size and alignment have moved from the
6326         `sys` module to the `mem` module.
6327       * std: The `path` module was written and API changed.
6328       * std: `str::from_utf8` has been changed to cast instead of allocate.
6329       * std: `starts_with` and `ends_with` methods added to vectors via the
6330         `ImmutableEqVector` trait, which is in the prelude.
6331       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6332         if the index is out of bounds.
6333       * std: Task failure no longer propagates between tasks, as the model was
6334         complex, expensive, and incompatible with thread-based tasks.
6335       * std: The `Any` type can be used for dynamic typing.
6336       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6337         `task::try`.
6338       * std: Methods that produce iterators generally do not have an `_iter`
6339         suffix now.
6340       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6341         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6342       * std: `util::ignore` renamed to `prelude::drop`.
6343       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6344         trait.
6345       * std: `vec::raw` has seen a lot of cleanup and API changes.
6346       * std: The standard library no longer includes any C++ code, and very
6347         minimal C, eliminating the dependency on libstdc++.
6348       * std: Runtime scheduling and I/O functionality has been factored out into
6349         extensible interfaces and is now implemented by two different crates:
6350         libnative, for native threading and I/O; and libgreen, for green threading
6351         and I/O. This paves the way for using the standard library in more limited
6352         embedded environments.
6353       * std: The `comm` module has been rewritten to be much faster, have a
6354         simpler, more consistent API, and to work for both native and green
6355         threading.
6356       * std: All libuv dependencies have been moved into the rustuv crate.
6357       * native: New implementations of runtime scheduling on top of OS threads.
6358       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6359         and other I/O.
6360       * green: The green thread scheduler and message passing types are almost
6361         entirely lock-free.
6362       * extra: The `flatpipes` module had bitrotted and was removed.
6363       * extra: All crypto functions have been removed and Rust now has a policy of
6364         not reimplementing crypto in the standard library. In the future crypto
6365         will be provided by external crates with bindings to established libraries.
6366       * extra: `c_vec` has been modernized.
6367       * extra: The `sort` module has been removed. Use the `sort` method on
6368         mutable slices.
6369
6370    * Tooling
6371       * The `rust` and `rusti` commands have been removed, due to lack of
6372         maintenance.
6373       * `rustdoc` was completely rewritten.
6374       * `rustdoc` can test code examples in documentation.
6375       * `rustpkg` can test packages with the argument, 'test'.
6376       * `rustpkg` supports arbitrary dependencies, including C libraries.
6377       * `rustc`'s support for generating debug info is improved again.
6378       * `rustc` has better error reporting for unbalanced delimiters.
6379       * `rustc`'s JIT support was removed due to bitrot.
6380       * Executables and static libraries can be built with LTO (-Z lto)
6381       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6382         build tools.
6383
6384
6385 Version 0.8 (2013-09-26)
6386 ============================
6387
6388    * ~2200 changes, numerous bugfixes
6389
6390    * Language
6391       * The `for` loop syntax has changed to work with the `Iterator` trait.
6392       * At long last, unwinding works on Windows.
6393       * Default methods are ready for use.
6394       * Many trait inheritance bugs fixed.
6395       * Owned and borrowed trait objects work more reliably.
6396       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6397       * rustc can omit emission of code for the `debug!` macro if it is passed
6398         `--cfg ndebug`
6399       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6400         for foo.rs, then foo/mod.rs, and will generate an error when both are
6401         present.
6402       * Strings no longer contain trailing nulls. The new `std::c_str` module
6403         provides new mechanisms for converting to C strings.
6404       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6405       * The FFI has been overhauled such that foreign functions are called directly,
6406         instead of through a stack-switching wrapper.
6407       * Calling a foreign function must be done through a Rust function with the
6408         `#[fixed_stack_segment]` attribute.
6409       * The `externfn!` macro can be used to declare both a foreign function and
6410         a `#[fixed_stack_segment]` wrapper at once.
6411       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6412       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6413       * `priv` is disallowed everywhere except for struct fields and enum variants.
6414       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6415       * `ref` bindings in irrefutable patterns work correctly now.
6416       * `char` is now prevented from containing invalid code points.
6417       * Casting to `bool` is no longer allowed.
6418       * `\0` is now accepted as an escape in chars and strings.
6419       * `yield` is a reserved keyword.
6420       * `typeof` is a reserved keyword.
6421       * Crates may be imported by URL with `extern mod foo = "url";`.
6422       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6423       * Static vectors can be initialized with repeating elements,
6424         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6425       * Static structs can be initialized with functional record update,
6426         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6427       * `cfg!` can be used to conditionally execute code based on the crate
6428         configuration, similarly to `#[cfg(...)]`.
6429       * The `unnecessary_qualification` lint detects unneeded module
6430         prefixes (default: allow).
6431       * Arithmetic operations have been implemented on the SIMD types in
6432         `std::unstable::simd`.
6433       * Exchange allocation headers were removed, reducing memory usage.
6434       * `format!` implements a completely new, extensible, and higher-performance
6435         string formatting system. It will replace `fmt!`.
6436       * `print!` and `println!` write formatted strings (using the `format!`
6437         extension) to stdout.
6438       * `write!` and `writeln!` write formatted strings (using the `format!`
6439         extension) to the new Writers in `std::rt::io`.
6440       * The library section in which a function or static is placed may
6441         be specified with `#[link_section = "..."]`.
6442       * The `proto!` syntax extension for defining bounded message protocols
6443         was removed.
6444       * `macro_rules!` is hygienic for `let` declarations.
6445       * The `#[export_name]` attribute specifies the name of a symbol.
6446       * `unreachable!` can be used to indicate unreachable code, and fails
6447         if executed.
6448
6449    * Libraries
6450       * std: Transitioned to the new runtime, written in Rust.
6451       * std: Added an experimental I/O library, `rt::io`, based on the new
6452         runtime.
6453       * std: A new generic `range` function was added to the prelude, replacing
6454         `uint::range` and friends.
6455       * std: `range_rev` no longer exists. Since range is an iterator it can be
6456         reversed with `range(lo, hi).invert()`.
6457       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6458         renamed to `unwrap_or`.
6459       * std: The `iterator` module was renamed to `iter`.
6460       * std: Integral types now support the `checked_add`, `checked_sub`, and
6461         `checked_mul` operations for detecting overflow.
6462       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6463         consistency.
6464       * std: Methods are standardizing on conventions for casting methods:
6465         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6466         and cheap casts.
6467       * std: The `CString` type in `c_str` provides new ways to convert to and
6468         from C strings.
6469       * std: `DoubleEndedIterator` can yield elements in two directions.
6470       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6471         two splices.
6472       * std: `str::from_bytes` renamed to `str::from_utf8`.
6473       * std: `pop_opt` and `shift_opt` methods added to vectors.
6474       * std: The task-local data interface no longer uses @, and keys are
6475         no longer function pointers.
6476       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6477       * std: Added `SharedPort` to `comm`.
6478       * std: `Eq` has a default method for `ne`; only `eq` is required
6479         in implementations.
6480       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6481         is required in implementations.
6482       * std: `is_utf8` performance is improved, impacting many string functions.
6483       * std: `os::MemoryMap` provides cross-platform mmap.
6484       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6485         are not 'in-bounds' are considered undefined.
6486       * std: Many freestanding functions in `vec` removed in favor of methods.
6487       * std: Many freestanding functions on scalar types removed in favor of
6488         methods.
6489       * std: Many options to task builders were removed since they don't make
6490         sense in the new scheduler design.
6491       * std: More containers implement `FromIterator` so can be created by the
6492         `collect` method.
6493       * std: More complete atomic types in `unstable::atomics`.
6494       * std: `comm::PortSet` removed.
6495       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6496         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6497         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6498         default implementations.
6499       * std: Various `from_str` functions were removed in favor of a generic
6500         `from_str` which is available in the prelude.
6501       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6502       * extra: `dlist`, the doubly-linked list was modernized.
6503       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6504       * extra: Added `glob` module, replacing `std::os::glob`.
6505       * extra: `rope` was removed.
6506       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6507       * extra: `net`, and `timer` were removed. The experimental replacements
6508         are `std::rt::io::net` and `std::rt::io::timer`.
6509       * extra: Iterators implemented for `SmallIntMap`.
6510       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6511       * extra: `SmallIntSet` removed. Use `BitvSet`.
6512       * extra: Performance of JSON parsing greatly improved.
6513       * extra: `semver` updated to SemVer 2.0.0.
6514       * extra: `term` handles more terminals correctly.
6515       * extra: `dbg` module removed.
6516       * extra: `par` module removed.
6517       * extra: `future` was cleaned up, with some method renames.
6518       * extra: Most free functions in `getopts` were converted to methods.
6519
6520    * Other
6521       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6522       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6523         similarly to gcc's `--march` flag.
6524       * rustc's performance compiling small crates is much better.
6525       * rustpkg has received many improvements.
6526       * rustpkg supports git tags as package IDs.
6527       * rustpkg builds into target-specific directories so it can be used for
6528         cross-compiling.
6529       * The number of concurrent test tasks is controlled by the environment
6530         variable RUST_TEST_TASKS.
6531       * The test harness can now report metrics for benchmarks.
6532       * All tools have man pages.
6533       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6534       * The runtime uses jemalloc for allocations.
6535       * Segmented stacks are temporarily disabled as part of the transition to
6536         the new runtime. Stack overflows are possible!
6537       * A new documentation backend, rustdoc_ng, is available for use. It is
6538         still invoked through the normal `rustdoc` command.
6539
6540
6541 Version 0.7 (2013-07-03)
6542 =======================
6543
6544    * ~2000 changes, numerous bugfixes
6545
6546    * Language
6547       * `impl`s no longer accept a visibility qualifier. Put them on methods
6548         instead.
6549       * The borrow checker has been rewritten with flow-sensitivity, fixing
6550         many bugs and inconveniences.
6551       * The `self` parameter no longer implicitly means `&'self self`,
6552         and can be explicitly marked with a lifetime.
6553       * Overloadable compound operators (`+=`, etc.) have been temporarily
6554         removed due to bugs.
6555       * The `for` loop protocol now requires `for`-iterators to return `bool`
6556         so they compose better.
6557       * The `Durable` trait is replaced with the `'static` bounds.
6558       * Trait default methods work more often.
6559       * Structs with the `#[packed]` attribute have byte alignment and
6560         no padding between fields.
6561       * Type parameters bound by `Copy` must now be copied explicitly with
6562         the `copy` keyword.
6563       * It is now illegal to move out of a dereferenced unsafe pointer.
6564       * `Option<~T>` is now represented as a nullable pointer.
6565       * `@mut` does dynamic borrow checks correctly.
6566       * The `main` function is only detected at the topmost level of the crate.
6567         The `#[main]` attribute is still valid anywhere.
6568       * Struct fields may no longer be mutable. Use inherited mutability.
6569       * The `#[no_send]` attribute makes a type that would otherwise be
6570         `Send`, not.
6571       * The `#[no_freeze]` attribute makes a type that would otherwise be
6572         `Freeze`, not.
6573       * Unbounded recursion will abort the process after reaching the limit
6574         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6575       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6576         are never implicitly copyable.
6577       * `#[static_assert]` makes compile-time assertions about static bools.
6578       * At long last, 'argument modes' no longer exist.
6579       * The rarely used `use mod` statement no longer exists.
6580
6581    * Syntax extensions
6582       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6583         argument list.
6584       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6585         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6586         `#[deriving(...)]`.
6587       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6588         and unsuffixed integer literals.
6589
6590    * Libraries
6591       * The `core` crate was renamed to `std`.
6592       * The `std` crate was renamed to `extra`.
6593       * More and improved documentation.
6594       * std: `iterator` module for external iterator objects.
6595       * Many old-style (internal, higher-order function) iterators replaced by
6596         implementations of `Iterator`.
6597       * std: Many old internal vector and string iterators,
6598         incl. `any`, `all`. removed.
6599       * std: The `finalize` method of `Drop` renamed to `drop`.
6600       * std: The `drop` method now takes `&mut self` instead of `&self`.
6601       * std: The prelude no longer re-exports any modules, only types and traits.
6602       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6603         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6604       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6605         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6606       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6607         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6608       * std: Many types implement `Clone`.
6609       * std: `path` type renamed to `Path`.
6610       * std: `mut` module and `Mut` type removed.
6611       * std: Many standalone functions removed in favor of methods and iterators
6612         in `vec`, `str`. In the future methods will also work as functions.
6613       * std: `reinterpret_cast` removed. Use `transmute`.
6614       * std: ascii string handling in `std::ascii`.
6615       * std: `Rand` is implemented for ~/@.
6616       * std: `run` module for spawning processes overhauled.
6617       * std: Various atomic types added to `unstable::atomic`.
6618       * std: Various types implement `Zero`.
6619       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6620       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6621       * std: Added `os::mkdir_recursive`.
6622       * std: Added `os::glob` function performs filesystems globs.
6623       * std: `FuzzyEq` renamed to `ApproxEq`.
6624       * std: `Map` now defines `pop` and `swap` methods.
6625       * std: `Cell` constructors converted to static methods.
6626       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6627       * extra: `flate` module moved from `std` to `extra`.
6628       * extra: `fileinput` module for iterating over a series of files.
6629       * extra: `Complex` number type and `complex` module.
6630       * extra: `Rational` number type and `rational` module.
6631       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6632       * extra: `term` uses terminfo now, is more correct.
6633       * extra: `arc` functions converted to methods.
6634       * extra: Implementation of fixed output size variations of SHA-2.
6635
6636    * Tooling
6637       * `unused_variable`  lint mode for unused variables (default: warn).
6638       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6639         (default: warn).
6640       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6641         (default: warn).
6642       * `dead_assignment` lint mode for unread variables (default: warn).
6643       * `unnecessary_allocation` lint mode detects some heap allocations that are
6644         immediately borrowed so could be written without allocating (default: warn).
6645       * `missing_doc` lint mode (default: allow).
6646       * `unreachable_code` lint mode (default: warn).
6647       * The `rusti` command has been rewritten and a number of bugs addressed.
6648       * rustc outputs in color on more terminals.
6649       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6650       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6651       * Compiling with `-g` will make the binary record information about
6652         dynamic borrowcheck failures for debugging.
6653       * rustdoc has a nicer stylesheet.
6654       * Various improvements to rustdoc.
6655       * Improvements to rustpkg (see the detailed release notes).
6656
6657
6658 Version 0.6 (2013-04-03)
6659 ========================
6660
6661    * ~2100 changes, numerous bugfixes
6662
6663    * Syntax changes
6664       * The self type parameter in traits is now spelled `Self`
6665       * The `self` parameter in trait and impl methods must now be explicitly
6666         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6667       * Static methods no longer require the `static` keyword and instead
6668         are distinguished by the lack of a `self` parameter
6669       * Replaced the `Durable` trait with the `'static` lifetime
6670       * The old closure type syntax with the trailing sigil has been
6671         removed in favor of the more consistent leading sigil
6672       * `super` is a keyword, and may be prefixed to paths
6673       * Trait bounds are separated with `+` instead of whitespace
6674       * Traits are implemented with `impl Trait for Type`
6675         instead of `impl Type: Trait`
6676       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6677       * The `export` keyword has finally been removed
6678       * The `move` keyword has been removed (see "Semantic changes")
6679       * The interior mutability qualifier on vectors, `[mut T]`, has been
6680         removed. Use `&mut [T]`, etc.
6681       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6682       * `fail` is no longer a keyword. Use `fail!()`
6683       * `assert` is no longer a keyword. Use `assert!()`
6684       * `log` is no longer a keyword. use `debug!`, etc.
6685       * 1-tuples may be represented as `(T,)`
6686       * Struct fields may no longer be `mut`. Use inherited mutability,
6687         `@mut T`, `core::mut` or `core::cell`
6688       * `extern mod { ... }` is no longer valid syntax for foreign
6689         function modules. Use extern blocks: `extern { ... }`
6690       * Newtype enums removed. Use tuple-structs.
6691       * Trait implementations no longer support visibility modifiers
6692       * Pattern matching over vectors improved and expanded
6693       * `const` renamed to `static` to correspond to lifetime name,
6694         and make room for future `static mut` unsafe mutable globals.
6695       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6696       * `Clone` implementations can be automatically generated with
6697         `#[deriving(Clone)]`
6698       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6699         instead of `foo as Bar`.
6700       * Fixed length vector types are now written as `[int, .. 3]`
6701         instead of `[int * 3]`.
6702       * Fixed length vector types can express the length as a constant
6703         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6704
6705    * Semantic changes
6706       * Types with owned pointers or custom destructors move by default,
6707         eliminating the `move` keyword
6708       * All foreign functions are considered unsafe
6709       * &mut is now unaliasable
6710       * Writes to borrowed @mut pointers are prevented dynamically
6711       * () has size 0
6712       * The name of the main function can be customized using #[main]
6713       * The default type of an inferred closure is &fn instead of @fn
6714       * `use` statements may no longer be "chained" - they cannot import
6715         identifiers imported by previous `use` statements
6716       * `use` statements are crate relative, importing from the "top"
6717         of the crate by default. Paths may be prefixed with `super::`
6718         or `self::` to change the search behavior.
6719       * Method visibility is inherited from the implementation declaration
6720       * Structural records have been removed
6721       * Many more types can be used in static items, including enums
6722         'static-lifetime pointers and vectors
6723       * Pattern matching over vectors improved and expanded
6724       * Typechecking of closure types has been overhauled to
6725         improve inference and eliminate unsoundness
6726       * Macros leave scope at the end of modules, unless that module is
6727         tagged with #[macro_escape]
6728
6729    * Libraries
6730       * Added big integers to `std::bigint`
6731       * Removed `core::oldcomm` module
6732       * Added pipe-based `core::comm` module
6733       * Numeric traits have been reorganized under `core::num`
6734       * `vec::slice` finally returns a slice
6735       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6736       * Containers reorganized around traits in `core::container`
6737       * `core::dvec` removed, `~[T]` is a drop-in replacement
6738       * `core::send_map` renamed to `core::hashmap`
6739       * `std::map` removed; replaced with `core::hashmap`
6740       * `std::treemap` reimplemented as an owned balanced tree
6741       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6742       * `core::trie` added as a fast ordered map for integer keys
6743       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6744       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6745         overload the comparison operators, whereas `TotalOrd` is used
6746         by certain container types
6747
6748    * Other
6749       * Replaced the 'cargo' package manager with 'rustpkg'
6750       * Added all-purpose 'rust' tool
6751       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6752       * rustc now *attempts* to offer spelling suggestions
6753       * Improved support for ARM and Android
6754       * Preliminary MIPS backend
6755       * Improved foreign function ABI implementation for x86, x86_64
6756       * Various memory usage improvements
6757       * Rust code may be embedded in foreign code under limited circumstances
6758       * Inline assembler supported by new asm!() syntax extension.
6759
6760
6761 Version 0.5 (2012-12-21)
6762 ===========================
6763
6764    * ~900 changes, numerous bugfixes
6765
6766    * Syntax changes
6767       * Removed `<-` move operator
6768       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6769       * Removed old fixed length vector syntax - `[T]/N`
6770       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6771       * Macros may now expand to items and statements
6772       * `a.b()` is always parsed as a method call, never as a field projection
6773       * `Eq` and `IterBytes` implementations can be automatically generated
6774         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6775       * Removed the special crate language for `.rc` files
6776       * Function arguments may consist of any irrefutable pattern
6777
6778    * Semantic changes
6779       * `&` and `~` pointers may point to objects
6780       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6781       * Enum variants may be structs
6782       * Destructors can be added to all nominal types with the Drop trait
6783       * Structs and nullary enum variants may be constants
6784       * Values that cannot be implicitly copied are now automatically moved
6785         without writing `move` explicitly
6786       * `&T` may now be coerced to `*T`
6787       * Coercions happen in `let` statements as well as function calls
6788       * `use` statements now take crate-relative paths
6789       * The module and type namespaces have been merged so that static
6790         method names can be resolved under the trait in which they are
6791         declared
6792
6793    * Improved support for language features
6794       * Trait inheritance works in many scenarios
6795       * More support for explicit self arguments in methods - `self`, `&self`
6796         `@self`, and `~self` all generally work as expected
6797       * Static methods work in more situations
6798       * Experimental: Traits may declare default methods for the implementations
6799         to use
6800
6801    * Libraries
6802       * New condition handling system in `core::condition`
6803       * Timsort added to `std::sort`
6804       * New priority queue, `std::priority_queue`
6805       * Pipes for serializable types, `std::flatpipes'
6806       * Serialization overhauled to be trait-based
6807       * Expanded `getopts` definitions
6808       * Moved futures to `std`
6809       * More functions are pure now
6810       * `core::comm` renamed to `oldcomm`. Still deprecated
6811       * `rustdoc` and `cargo` are libraries now
6812
6813    * Misc
6814       * Added a preliminary REPL, `rusti`
6815       * License changed from MIT to dual MIT/APL2
6816
6817
6818 Version 0.4 (2012-10-15)
6819 ==========================
6820
6821    * ~2000 changes, numerous bugfixes
6822
6823    * Syntax
6824       * All keywords are now strict and may not be used as identifiers anywhere
6825       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6826         'of', 'with', 'to', 'class'.
6827       * Classes are replaced with simpler structs
6828       * Explicit method self types
6829       * `ret` became `return` and `alt` became `match`
6830       * `import` is now `use`; `use is now `extern mod`
6831       * `extern mod { ... }` is now `extern { ... }`
6832       * `use mod` is the recommended way to import modules
6833       * `pub` and `priv` replace deprecated export lists
6834       * The syntax of `match` pattern arms now uses fat arrow (=>)
6835       * `main` no longer accepts an args vector; use `os::args` instead
6836
6837    * Semantics
6838       * Trait implementations are now coherent, ala Haskell typeclasses
6839       * Trait methods may be static
6840       * Argument modes are deprecated
6841       * Borrowed pointers are much more mature and recommended for use
6842       * Strings and vectors in the static region are stored in constant memory
6843       * Typestate was removed
6844       * Resolution rewritten to be more reliable
6845       * Support for 'dual-mode' data structures (freezing and thawing)
6846
6847    * Libraries
6848       * Most binary operators can now be overloaded via the traits in
6849         `core::ops'
6850       * `std::net::url` for representing URLs
6851       * Sendable hash maps in `core::send_map`
6852       * `core::task' gained a (currently unsafe) task-local storage API
6853
6854    * Concurrency
6855       * An efficient new intertask communication primitive called the pipe,
6856         along with a number of higher-level channel types, in `core::pipes`
6857       * `std::arc`, an atomically reference counted, immutable, shared memory
6858         type
6859       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6860       * Futures are now based on pipes and sendable
6861       * More robust linked task failure
6862       * Improved task builder API
6863
6864    * Other
6865       * Improved error reporting
6866       * Preliminary JIT support
6867       * Preliminary work on precise GC
6868       * Extensive architectural improvements to rustc
6869       * Begun a transition away from buggy C++-based reflection (shape) code to
6870         Rust-based (visitor) code
6871       * All hash functions and tables converted to secure, randomized SipHash
6872
6873
6874 Version 0.3  (2012-07-12)
6875 ========================
6876
6877    * ~1900 changes, numerous bugfixes
6878
6879    * New coding conveniences
6880       * Integer-literal suffix inference
6881       * Per-item control over warnings, errors
6882       * #[cfg(windows)] and #[cfg(unix)] attributes
6883       * Documentation comments
6884       * More compact closure syntax
6885       * 'do' expressions for treating higher-order functions as
6886         control structures
6887       * *-patterns (wildcard extended to all constructor fields)
6888
6889    * Semantic cleanup
6890       * Name resolution pass and exhaustiveness checker rewritten
6891       * Region pointers and borrow checking supersede alias
6892         analysis
6893       * Init-ness checking is now provided by a region-based liveness
6894         pass instead of the typestate pass; same for last-use analysis
6895       * Extensive work on region pointers
6896
6897    * Experimental new language features
6898       * Slices and fixed-size, interior-allocated vectors
6899       * #!-comments for lang versioning, shell execution
6900       * Destructors and iface implementation for classes;
6901         type-parameterized classes and class methods
6902       * 'const' type kind for types that can be used to implement
6903         shared-memory concurrency patterns
6904
6905    * Type reflection
6906
6907    * Removal of various obsolete features
6908       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6909                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6910
6911       * Constructs: do-while loops ('do' repurposed), fn binding,
6912                     resources (replaced by destructors)
6913
6914    * Compiler reorganization
6915       * Syntax-layer of compiler split into separate crate
6916       * Clang (from LLVM project) integrated into build
6917       * Typechecker split into sub-modules
6918
6919    * New library code
6920       * New time functions
6921       * Extension methods for many built-in types
6922       * Arc: atomic-refcount read-only / exclusive-use shared cells
6923       * Par: parallel map and search routines
6924       * Extensive work on libuv interface
6925       * Much vector code moved to libraries
6926       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6927         #include, #include_str, #include_bin
6928
6929    * Tool improvements
6930       * Cargo automatically resolves dependencies
6931
6932
6933 Version 0.2  (2012-03-29)
6934 =========================
6935
6936    * >1500 changes, numerous bugfixes
6937
6938    * New docs and doc tooling
6939
6940    * New port: FreeBSD x86_64
6941
6942    * Compilation model enhancements
6943       * Generics now specialized, multiply instantiated
6944       * Functions now inlined across separate crates
6945
6946    * Scheduling, stack and threading fixes
6947       * Noticeably improved message-passing performance
6948       * Explicit schedulers
6949       * Callbacks from C
6950       * Helgrind clean
6951
6952    * Experimental new language features
6953       * Operator overloading
6954       * Region pointers
6955       * Classes
6956
6957    * Various language extensions
6958       * C-callback function types: 'crust fn ...'
6959       * Infinite-loop construct: 'loop { ... }'
6960       * Shorten 'mutable' to 'mut'
6961       * Required mutable-local qualifier: 'let mut ...'
6962       * Basic glob-exporting: 'export foo::*;'
6963       * Alt now exhaustive, 'alt check' for runtime-checked
6964       * Block-function form of 'for' loop, with 'break' and 'ret'.
6965
6966    * New library code
6967       * AST quasi-quote syntax extension
6968       * Revived libuv interface
6969       * New modules: core::{future, iter}, std::arena
6970       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6971       * Extensive cleanup, regularization in libstd, libcore
6972
6973
6974 Version 0.1  (2012-01-20)
6975 ===============================
6976
6977    * Most language features work, including:
6978       * Unique pointers, unique closures, move semantics
6979       * Interface-constrained generics
6980       * Static interface dispatch
6981       * Stack growth
6982       * Multithread task scheduling
6983       * Typestate predicates
6984       * Failure unwinding, destructors
6985       * Pattern matching and destructuring assignment
6986       * Lightweight block-lambda syntax
6987       * Preliminary macro-by-example
6988
6989    * Compiler works with the following configurations:
6990       * Linux: x86 and x86_64 hosts and targets
6991       * macOS: x86 and x86_64 hosts and targets
6992       * Windows: x86 hosts and targets
6993
6994    * Cross compilation / multi-target configuration supported.
6995
6996    * Preliminary API-documentation and package-management tools included.
6997
6998 Known issues:
6999
7000    * Documentation is incomplete.
7001
7002    * Performance is below intended target.
7003
7004    * Standard library APIs are subject to extensive change, reorganization.
7005
7006    * Language-level versioning is not yet operational - future code will
7007      break unexpectedly.