]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Merge branch 'master' into frewsxcv-dyn
[rust.git] / RELEASES.md
1 Version 1.31.0 (2018-12-06)
2 ==========================
3
4 Language
5 --------
6 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉 
7 - [New lifetime elision rules now allow for eliding lifetimes in functions and
8   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
9   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
10   in structs.
11 - [You can now define and use `const` functions.][54835] These are currently
12   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
13   [language reference][const-reference] for what exactly is available.
14 - [You can now use tool lints, which allow you to scope lints from external
15   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
16 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
17   a crate, not just in exported functions.][54451]
18 - [You can now use parentheses in pattern matches.][54497]
19
20 Compiler
21 --------
22 - [Updated musl to 1.1.20][54430]
23
24 Libraries
25 ---------
26 - [You can now convert `num::NonZero*` types to their raw equivalvents using the
27   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
28 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
29   into `Option<&mut T>` using the `From` trait.][53218]
30 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
31
32
33 Stabilized APIs
34 ---------------
35 - [`slice::align_to`]
36 - [`slice::align_to_mut`]
37 - [`slice::chunks_exact`]
38 - [`slice::chunks_exact_mut`]
39 - [`slice::rchunks`]
40 - [`slice::rchunks_mut`]
41 - [`slice::rchunks_exact`]
42 - [`slice::rchunks_exact_mut`]
43 - [`Option::replace`]
44
45 Cargo
46 -----
47 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
48 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
49   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
50
51 [52813]: https://github.com/rust-lang/rust/pull/52813/
52 [53218]: https://github.com/rust-lang/rust/pull/53218/
53 [53555]: https://github.com/rust-lang/rust/issues/53555/
54 [54057]: https://github.com/rust-lang/rust/pull/54057/
55 [54240]: https://github.com/rust-lang/rust/pull/54240/
56 [54430]: https://github.com/rust-lang/rust/pull/54430/
57 [54451]: https://github.com/rust-lang/rust/pull/54451/
58 [54497]: https://github.com/rust-lang/rust/pull/54497/
59 [54778]: https://github.com/rust-lang/rust/pull/54778/
60 [54835]: https://github.com/rust-lang/rust/pull/54835/
61 [54870]: https://github.com/rust-lang/rust/pull/54870/
62 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
63 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
64 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
65 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
66 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
67 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
68 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
69 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
70 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
71 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
72 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
73 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
74 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
75 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
76
77
78 Version 1.30.0 (2018-10-25)
79 ==========================
80
81 Language
82 --------
83 - [Procedural macros are now available.][52081] These kinds of macros allow for
84   more powerful code generation. There is a [new chapter available][proc-macros]
85   in the Rust Programming Language book that goes further in depth.
86 - [You can now use keywords as identifiers using the raw identifiers
87   syntax (`r#`),][53236] e.g. `let r#for = true;`
88 - [Using anonymous parameters in traits is now deprecated with a warning and
89   will be a hard error in the 2018 edition.][53272]
90 - [You can now use `crate` in paths.][54404] This allows you to refer to the
91   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
92 - [Using a external crate no longer requires being prefixed with `::`.][54404]
93   Previously, using a external crate in a module without a use statement
94   required `let json = ::serde_json::from_str(foo);` but can now be written
95   as `let json = serde_json::from_str(foo);`.
96 - [You can now apply the `#[used]` attribute to static items to prevent the
97   compiler from optimising them away, even if they appear to be unused,][51363]
98   e.g. `#[used] static FOO: u32 = 1;`
99 - [You can now import and reexport macros from other crates with the `use`
100   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
101   the root module of the crate. If your macro relies on calling other local
102   macros, it is recommended to export with the
103   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
104   those macros.
105 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
106   using the `vis` specifier.][53370]
107 - [Non-macro attributes now allow all forms of literals, not just
108   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
109   write `#[attr(true)]`.
110 - [You can now specify a function to handle a panic in the Rust runtime with the
111   `#[panic_handler]` attribute.][51366]
112
113 Compiler
114 --------
115 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
116 - [Added the `aarch64-unknown-netbsd` target][53165]
117
118 Libraries
119 ---------
120 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
121
122 Stabilized APIs
123 ---------------
124 - [`Ipv4Addr::BROADCAST`]
125 - [`Ipv4Addr::LOCALHOST`]
126 - [`Ipv4Addr::UNSPECIFIED`]
127 - [`Ipv6Addr::LOCALHOST`]
128 - [`Ipv6Addr::UNSPECIFIED`]
129 - [`Iterator::find_map`]
130
131   The following methods are replacement methods for `trim_left`, `trim_right`,
132   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
133   in 1.33.0:
134 - [`str::trim_end_matches`]
135 - [`str::trim_end`]
136 - [`str::trim_start_matches`]
137 - [`str::trim_start`]
138
139 Cargo
140 ----
141 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
142 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
143   equivalent to calling `rustdoc --error-format=json`.
144 - [Cargo will now provide a progress bar for builds.][cargo/5995]
145
146 Misc
147 ----
148 - [`rustdoc` allows you to specify what edition to treat your code as with the
149   `--edition` option.][54057]
150 - [`rustdoc` now has the `--color` (specify whether to output color) and
151   `--error-format` (specify error format, e.g. `json`) options.][53003]
152 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
153   debug symbols.][53774]
154 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
155   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
156
157 [50911]: https://github.com/rust-lang/rust/pull/50911/
158 [51363]: https://github.com/rust-lang/rust/pull/51363/
159 [51366]: https://github.com/rust-lang/rust/pull/51366/
160 [52081]: https://github.com/rust-lang/rust/pull/52081/
161 [53003]: https://github.com/rust-lang/rust/pull/53003/
162 [53033]: https://github.com/rust-lang/rust/pull/53033/
163 [53044]: https://github.com/rust-lang/rust/pull/53044/
164 [53165]: https://github.com/rust-lang/rust/pull/53165/
165 [53213]: https://github.com/rust-lang/rust/pull/53213/
166 [53236]: https://github.com/rust-lang/rust/pull/53236/
167 [53272]: https://github.com/rust-lang/rust/pull/53272/
168 [53370]: https://github.com/rust-lang/rust/pull/53370/
169 [53459]: https://github.com/rust-lang/rust/pull/53459/
170 [53774]: https://github.com/rust-lang/rust/pull/53774/
171 [53822]: https://github.com/rust-lang/rust/pull/53822/
172 [54057]: https://github.com/rust-lang/rust/pull/54057/
173 [54146]: https://github.com/rust-lang/rust/pull/54146/
174 [54404]: https://github.com/rust-lang/rust/pull/54404/
175 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
176 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
177 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
178 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
179
180 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
181 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
182 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
183 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
184 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
185 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
186 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
187 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
188 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
189 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
190
191
192 Version 1.29.2 (2018-10-11)
193 ===========================
194
195 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
196 - The `rls-preview` component on the windows-gnu targets has been restored.
197
198 [54639]: https://github.com/rust-lang/rust/pull/54639
199
200
201 Version 1.29.1 (2018-09-25)
202 ===========================
203
204 Security Notes
205 --------------
206
207 - The standard library's `str::repeat` function contained an out of bounds write
208   caused by an integer overflow. This has been fixed by deterministically
209   panicking when an overflow happens.
210
211   Thank you to Scott McMurray for responsibily disclosing this vulnerability to
212   us.
213
214
215 Version 1.29.0 (2018-09-13)
216 ==========================
217
218 Compiler
219 --------
220 - [Bumped minimum LLVM version to 5.0.][51899]
221 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
222 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
223
224 Libraries
225 ---------
226 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
227 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
228 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
229 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
230   for `&str`.][51178]
231 - [`Cell<T>` now allows `T` to be unsized.][50494]
232 - [`SocketAddr` is now stable on Redox.][52656]
233
234 Stabilized APIs
235 ---------------
236 - [`Arc::downcast`]
237 - [`Iterator::flatten`]
238 - [`Rc::downcast`]
239
240 Cargo
241 -----
242 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
243   `--locked` to disable this behavior.
244 - [`cargo-install` will now allow you to cross compile an install
245   using `--target`.][cargo/5614]
246 - [Added the `cargo-fix` subcommand to automatically move project code from
247   2015 edition to 2018.][cargo/5723]
248 - [`cargo doc` can now optionally document private types using the
249   `--document-private-items` flag.][cargo/5543]
250
251 Misc
252 ----
253 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
254   the specified level to that level.][52354] For example `--cap-lints warn`
255   will demote `deny` and `forbid` lints to `warn`.
256 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
257   fails and `101` if there is a panic.][52197]
258 - [A preview of clippy has been made available through rustup.][51122]
259   You can install the preview with `rustup component add clippy-preview`.
260
261 Compatibility Notes
262 -------------------
263 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
264   Use `str::get_unchecked(begin..end)` instead.
265 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
266   Consider using the `home_dir` function from
267   https://crates.io/crates/dirs instead.
268 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
269 - [`cfg` attributes and `--cfg` command line flags are now more
270   strictly validated.][53893]
271
272 [53893]: https://github.com/rust-lang/rust/pull/53893/
273 [52861]: https://github.com/rust-lang/rust/pull/52861/
274 [52656]: https://github.com/rust-lang/rust/pull/52656/
275 [52239]: https://github.com/rust-lang/rust/pull/52239/
276 [52330]: https://github.com/rust-lang/rust/pull/52330/
277 [52354]: https://github.com/rust-lang/rust/pull/52354/
278 [52402]: https://github.com/rust-lang/rust/pull/52402/
279 [52103]: https://github.com/rust-lang/rust/pull/52103/
280 [52197]: https://github.com/rust-lang/rust/pull/52197/
281 [51807]: https://github.com/rust-lang/rust/pull/51807/
282 [51899]: https://github.com/rust-lang/rust/pull/51899/
283 [51912]: https://github.com/rust-lang/rust/pull/51912/
284 [51511]: https://github.com/rust-lang/rust/pull/51511/
285 [51619]: https://github.com/rust-lang/rust/pull/51619/
286 [51656]: https://github.com/rust-lang/rust/pull/51656/
287 [51178]: https://github.com/rust-lang/rust/pull/51178/
288 [51122]: https://github.com/rust-lang/rust/pull/51122
289 [50494]: https://github.com/rust-lang/rust/pull/50494/
290 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
291 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
292 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
293 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
294 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
295 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
296 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
297
298
299 Version 1.28.0 (2018-08-02)
300 ===========================
301
302 Language
303 --------
304 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
305   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
306   the inner type across Foreign Function Interface (FFI) boundaries.
307 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
308   and can now be used as identifiers.][51196]
309 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
310   stable.][51241] This will allow users to specify a global allocator for
311   their program.
312 - [Unit test functions marked with the `#[test]` attribute can now return
313   `Result<(), E: Debug>` in addition to `()`.][51298]
314 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
315   allows macros to easily target lifetimes.
316
317 Compiler
318 --------
319 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
320   prioritise making smaller binary sizes. `z` is the same as `s` with the
321   exception that it does not vectorise loops, which typically results in an even
322   smaller binary.
323 - [The short error format is now stable.][49546] Specified with
324   `--error-format=short` this option will provide a more compressed output of
325   rust error messages.
326 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
327 - [Reduced the number of allocations in the macro parser.][50855] This can
328   improve compile times of macro heavy crates on average by 5%.
329
330 Libraries
331 ---------
332 - [Implemented `Default` for `&mut str`.][51306]
333 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
334 - [Implemented `Extend` for `()`.][50234]
335 - [The `Debug` implementation of `time::Duration` should now be more easily
336   human readable.][50364] Previously a `Duration` of one second would printed as
337   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
338 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
339   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
340   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
341   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
342   for `PathBuf`.][50170]
343 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
344   and `Wrapping<i128>`.][50465]
345 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
346   possible.][51050] This can provide up to a 40% speed increase.
347 - [Improved error messages when using `format!`.][50610]
348
349 Stabilized APIs
350 ---------------
351 - [`Iterator::step_by`]
352 - [`Path::ancestors`]
353 - [`SystemTime::UNIX_EPOCH`]
354 - [`alloc::GlobalAlloc`]
355 - [`alloc::Layout`]
356 - [`alloc::LayoutErr`]
357 - [`alloc::System`]
358 - [`alloc::alloc`]
359 - [`alloc::alloc_zeroed`]
360 - [`alloc::dealloc`]
361 - [`alloc::realloc`]
362 - [`alloc::handle_alloc_error`]
363 - [`btree_map::Entry::or_default`]
364 - [`fmt::Alignment`]
365 - [`hash_map::Entry::or_default`]
366 - [`iter::repeat_with`]
367 - [`num::NonZeroUsize`]
368 - [`num::NonZeroU128`]
369 - [`num::NonZeroU16`]
370 - [`num::NonZeroU32`]
371 - [`num::NonZeroU64`]
372 - [`num::NonZeroU8`]
373 - [`ops::RangeBounds`]
374 - [`slice::SliceIndex`]
375 - [`slice::from_mut`]
376 - [`slice::from_ref`]
377 - [`{Any + Send + Sync}::downcast_mut`]
378 - [`{Any + Send + Sync}::downcast_ref`]
379 - [`{Any + Send + Sync}::is`]
380
381 Cargo
382 -----
383 - [Cargo will now no longer allow you to publish crates with build scripts that
384   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
385   considered to be immutable.
386
387 Misc
388 ----
389 - [The `suggestion_applicability` field in `rustc`'s json output is now
390   stable.][50486] This will allow dev tools to check whether a code suggestion
391   would apply to them.
392
393 Compatibility Notes
394 -------------------
395 - [Rust will consider trait objects with duplicated constraints to be the same
396   type as without the duplicated constraint.][51276] For example the below code will
397   now fail to compile.
398   ```rust
399   trait Trait {}
400
401   impl Trait + Send {
402       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
403   }
404
405   impl Trait + Send + Send {
406       fn test(&self) { println!("two"); }
407   }
408   ```
409
410 [49546]: https://github.com/rust-lang/rust/pull/49546/
411 [50143]: https://github.com/rust-lang/rust/pull/50143/
412 [50170]: https://github.com/rust-lang/rust/pull/50170/
413 [50234]: https://github.com/rust-lang/rust/pull/50234/
414 [50265]: https://github.com/rust-lang/rust/pull/50265/
415 [50364]: https://github.com/rust-lang/rust/pull/50364/
416 [50385]: https://github.com/rust-lang/rust/pull/50385/
417 [50465]: https://github.com/rust-lang/rust/pull/50465/
418 [50486]: https://github.com/rust-lang/rust/pull/50486/
419 [50554]: https://github.com/rust-lang/rust/pull/50554/
420 [50610]: https://github.com/rust-lang/rust/pull/50610/
421 [50855]: https://github.com/rust-lang/rust/pull/50855/
422 [51050]: https://github.com/rust-lang/rust/pull/51050/
423 [51196]: https://github.com/rust-lang/rust/pull/51196/
424 [51200]: https://github.com/rust-lang/rust/pull/51200/
425 [51241]: https://github.com/rust-lang/rust/pull/51241/
426 [51276]: https://github.com/rust-lang/rust/pull/51276/
427 [51298]: https://github.com/rust-lang/rust/pull/51298/
428 [51306]: https://github.com/rust-lang/rust/pull/51306/
429 [51562]: https://github.com/rust-lang/rust/pull/51562/
430 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
431 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
432 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
433 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
434 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
435 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
436 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
437 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
438 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
439 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
440 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
441 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
442 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
443 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
444 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
445 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
446 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
447 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
448 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
449 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
450 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
451 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
452 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
453 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
454 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
455 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
456 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
457 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
458 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
459 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
460
461 Version 1.27.2 (2018-07-20)
462 ===========================
463
464 Compatibility Notes
465 -------------------
466
467 - The borrow checker was fixed to avoid potential unsoundness when using
468   match ergonomics: [#52213][52213].
469
470 [52213]: https://github.com/rust-lang/rust/issues/52213
471
472 Version 1.27.1 (2018-07-10)
473 ===========================
474
475 Security Notes
476 --------------
477
478 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
479   when running, which enabled executing code as some other user on a
480   given machine. This release fixes that vulnerability; you can read
481   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
482
483   Thank you to Red Hat for responsibily disclosing this vulnerability to us.
484
485 Compatibility Notes
486 -------------------
487
488 - The borrow checker was fixed to avoid an additional potential unsoundness when using
489   match ergonomics: [#51415][51415], [#49534][49534].
490
491 [51415]: https://github.com/rust-lang/rust/issues/51415
492 [49534]: https://github.com/rust-lang/rust/issues/49534
493 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
494 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
495
496 Version 1.27.0 (2018-06-21)
497 ==========================
498
499 Language
500 --------
501 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
502   be used as an identifier.
503 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
504   bare `Trait` syntax, and should make it clearer when being used in tandem with
505   `impl Trait` because it is equivalent to the following syntax:
506   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
507   `Box<Trait> == Box<dyn Trait>`.
508 - [Attributes on generic parameters such as types and lifetimes are
509   now stable.][48851] e.g.
510   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
511 - [The `#[must_use]` attribute can now also be used on functions as well as
512   types.][48925] It provides a lint that by default warns users when the
513   value returned by a function has not been used.
514
515 Compiler
516 --------
517 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
518
519 Libraries
520 ---------
521 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
522   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
523   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
524   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
525   the `cfg` attribute.
526 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
527   std are now available in core.][49896]
528 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
529   to `Self`.][49630]
530 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
531   that the operation isn't done in place.
532 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
533   the `#[must_use]` attribute][49533] to warn about unused potentially
534   expensive allocations.
535
536 Stabilized APIs
537 ---------------
538 - [`DoubleEndedIterator::rfind`]
539 - [`DoubleEndedIterator::rfold`]
540 - [`DoubleEndedIterator::try_rfold`]
541 - [`Duration::from_micros`]
542 - [`Duration::from_nanos`]
543 - [`Duration::subsec_micros`]
544 - [`Duration::subsec_millis`]
545 - [`HashMap::remove_entry`]
546 - [`Iterator::try_fold`]
547 - [`Iterator::try_for_each`]
548 - [`NonNull::cast`]
549 - [`Option::filter`]
550 - [`String::replace_range`]
551 - [`Take::set_limit`]
552 - [`hint::unreachable_unchecked`]
553 - [`os::unix::process::parent_id`]
554 - [`ptr::swap_nonoverlapping`]
555 - [`slice::rsplit_mut`]
556 - [`slice::rsplit`]
557 - [`slice::swap_with_slice`]
558
559 Cargo
560 -----
561 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
562   `readme`, and `repository` fields.][cargo/5386]
563 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
564 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
565   a different directory than `target` for placing compilation artifacts.
566 - [Cargo will be adding automatic target inference for binaries, benchmarks,
567   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
568   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
569   where cargo would infer a binary, Cargo will produce a warning. You can
570   disable this feature ahead of time by setting any of the following to false:
571   `autobins`, `autobenches`, `autoexamples`, `autotests`.
572 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
573   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
574
575 Misc
576 ----
577 - [Added “The Rustc book” into the official documentation.][49707]
578   [“The Rustc book”] documents and teaches how to use the rustc compiler.
579 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
580
581 Compatibility Notes
582 -------------------
583 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
584   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
585   compile, `"".is_empty()` will still compile.
586 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
587   will only print the inner type.][48553] E.g.
588   `print!("{:?}", AtomicBool::new(true))` will print `true`,
589   not `AtomicBool(true)`.
590 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
591   could enter higher numbers but they were not supported by LLVM. Up to 512MB
592   alignment should cover all use cases.
593 - The `.description()` method on the `std::error::Error` trait
594   [has been soft-deprecated][50163]. It is no longer required to implement it.
595
596 [48553]: https://github.com/rust-lang/rust/pull/48553/
597 [48851]: https://github.com/rust-lang/rust/pull/48851/
598 [48925]: https://github.com/rust-lang/rust/pull/48925/
599 [49533]: https://github.com/rust-lang/rust/pull/49533/
600 [49623]: https://github.com/rust-lang/rust/pull/49623/
601 [49630]: https://github.com/rust-lang/rust/pull/49630/
602 [49664]: https://github.com/rust-lang/rust/pull/49664/
603 [49699]: https://github.com/rust-lang/rust/pull/49699/
604 [49707]: https://github.com/rust-lang/rust/pull/49707/
605 [49719]: https://github.com/rust-lang/rust/pull/49719/
606 [49896]: https://github.com/rust-lang/rust/pull/49896/
607 [49968]: https://github.com/rust-lang/rust/pull/49968/
608 [50163]: https://github.com/rust-lang/rust/pull/50163
609 [50177]: https://github.com/rust-lang/rust/pull/50177/
610 [50378]: https://github.com/rust-lang/rust/pull/50378/
611 [50398]: https://github.com/rust-lang/rust/pull/50398/
612 [50423]: https://github.com/rust-lang/rust/pull/50423/
613 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
614 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
615 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
616 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
617 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
618 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
619 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
620 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
621 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
622 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
623 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
624 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
625 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
626 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
627 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
628 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
629 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
630 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
631 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
632 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
633 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
634 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
635 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
636 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
637 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
638 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
639 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
640 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
641 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
642 [“The Rustc book”]: https://doc.rust-lang.org/rustc
643
644
645 Version 1.26.2 (2018-06-05)
646 ==========================
647
648 Compatibility Notes
649 -------------------
650
651 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
652
653 [51117]: https://github.com/rust-lang/rust/issues/51117
654
655
656 Version 1.26.1 (2018-05-29)
657 ==========================
658
659 Tools
660 -----
661
662 - [RLS now works on Windows.][50646]
663 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
664
665
666 Compatibility Notes
667 --------
668
669 - [`fn main() -> impl Trait` no longer works for non-Termination
670   trait.][50656]
671   This reverts an accidental stabilization.
672 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
673 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
674
675 [50646]: https://github.com/rust-lang/rust/issues/50646
676 [50656]: https://github.com/rust-lang/rust/pull/50656
677 [50812]: https://github.com/rust-lang/rust/pull/50812
678 [50950]: https://github.com/rust-lang/rust/issues/50950
679 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
680
681 Version 1.26.0 (2018-05-10)
682 ==========================
683
684 Language
685 --------
686 - [Closures now implement `Copy` and/or `Clone` if all captured variables
687   implement either or both traits.][49299]
688 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
689 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
690   lifetime can be elided.][49458]
691 - [`impl Trait` is now stable allowing you to have abstract types in returns
692    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
693   `fn open(path: impl AsRef<Path>)`.
694 - [Pattern matching will now automatically apply dereferences.][49394]
695 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
696 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
697 - [A lot of operations are now available in a const context.][46882] E.g. You
698   can now index into constant arrays, reference and dereference into constants,
699   and use tuple struct constructors.
700 - [Fixed entry slice patterns are now stable.][48516] E.g.
701   ```rust
702   let points = [1, 2, 3, 4];
703   match points {
704       [1, 2, 3, 4] => println!("All points were sequential."),
705       _ => println!("Not all points were sequential."),
706   }
707   ```
708
709
710 Compiler
711 --------
712 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
713 - [Fixed exponential projection complexity on nested types.][48296]
714   This can provide up to a ~12% reduction in compile times for certain crates.
715 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
716   to remap path prefixes outputted by the compiler.
717 - [Added `powerpc-unknown-netbsd` target.][48281]
718
719 Libraries
720 ---------
721 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
722 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
723   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
724 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
725 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
726 - [`ascii::escape_default` is now available in libcore.][48735]
727 - [Trailing commas are now supported in std and core macros.][48056]
728 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
729 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
730
731 Stabilized APIs
732 ---------------
733 - [`*const T::add`]
734 - [`*const T::copy_to_nonoverlapping`]
735 - [`*const T::copy_to`]
736 - [`*const T::read_unaligned`]
737 - [`*const T::read_volatile`]
738 - [`*const T::read`]
739 - [`*const T::sub`]
740 - [`*const T::wrapping_add`]
741 - [`*const T::wrapping_sub`]
742 - [`*mut T::add`]
743 - [`*mut T::copy_to_nonoverlapping`]
744 - [`*mut T::copy_to`]
745 - [`*mut T::read_unaligned`]
746 - [`*mut T::read_volatile`]
747 - [`*mut T::read`]
748 - [`*mut T::replace`]
749 - [`*mut T::sub`]
750 - [`*mut T::swap`]
751 - [`*mut T::wrapping_add`]
752 - [`*mut T::wrapping_sub`]
753 - [`*mut T::write_bytes`]
754 - [`*mut T::write_unaligned`]
755 - [`*mut T::write_volatile`]
756 - [`*mut T::write`]
757 - [`Box::leak`]
758 - [`FromUtf8Error::as_bytes`]
759 - [`LocalKey::try_with`]
760 - [`Option::cloned`]
761 - [`btree_map::Entry::and_modify`]
762 - [`fs::read_to_string`]
763 - [`fs::read`]
764 - [`fs::write`]
765 - [`hash_map::Entry::and_modify`]
766 - [`iter::FusedIterator`]
767 - [`ops::RangeInclusive`]
768 - [`ops::RangeToInclusive`]
769 - [`process::id`]
770 - [`slice::rotate_left`]
771 - [`slice::rotate_right`]
772 - [`String::retain`]
773
774
775 Cargo
776 -----
777 - [Cargo will now output path to custom commands when `-v` is
778   passed with `--list`][cargo/5041]
779 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
780
781 Misc
782 ----
783 - [The second edition of "The Rust Programming Language" book is now recommended
784   over the first.][48404]
785
786 Compatibility Notes
787 -------------------
788
789 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
790   syntax is now invalid.
791   ```
792   use std::ops::Fn as dyn;
793   fn g(_: Box<dyn(std::fmt::Debug)>) {}
794   ```
795 - [The result of dereferences are no longer promoted to `'static`.][47408]
796   e.g.
797   ```rust
798   fn main() {
799       const PAIR: &(i32, i32) = &(0, 1);
800       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
801   }
802   ```
803 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
804 - [`".e0"` will now no longer parse as `0.0` and will instead cause
805   an error.][48235]
806 - [Removed hoedown from rustdoc.][48274]
807 - [Bounds on higher-kinded lifetimes a hard error.][48326]
808
809 [46882]: https://github.com/rust-lang/rust/pull/46882
810 [47379]: https://github.com/rust-lang/rust/pull/47379
811 [47408]: https://github.com/rust-lang/rust/pull/47408
812 [47813]: https://github.com/rust-lang/rust/pull/47813
813 [48056]: https://github.com/rust-lang/rust/pull/48056
814 [48125]: https://github.com/rust-lang/rust/pull/48125
815 [48166]: https://github.com/rust-lang/rust/pull/48166
816 [48235]: https://github.com/rust-lang/rust/pull/48235
817 [48274]: https://github.com/rust-lang/rust/pull/48274
818 [48281]: https://github.com/rust-lang/rust/pull/48281
819 [48296]: https://github.com/rust-lang/rust/pull/48296
820 [48326]: https://github.com/rust-lang/rust/pull/48326
821 [48359]: https://github.com/rust-lang/rust/pull/48359
822 [48404]: https://github.com/rust-lang/rust/pull/48404
823 [48481]: https://github.com/rust-lang/rust/pull/48481
824 [48516]: https://github.com/rust-lang/rust/pull/48516
825 [48628]: https://github.com/rust-lang/rust/pull/48628
826 [48629]: https://github.com/rust-lang/rust/pull/48629
827 [48657]: https://github.com/rust-lang/rust/pull/48657
828 [48735]: https://github.com/rust-lang/rust/pull/48735
829 [48978]: https://github.com/rust-lang/rust/pull/48978
830 [49101]: https://github.com/rust-lang/rust/pull/49101
831 [49109]: https://github.com/rust-lang/rust/pull/49109
832 [49121]: https://github.com/rust-lang/rust/pull/49121
833 [49162]: https://github.com/rust-lang/rust/pull/49162
834 [49184]: https://github.com/rust-lang/rust/pull/49184
835 [49234]: https://github.com/rust-lang/rust/pull/49234
836 [49255]: https://github.com/rust-lang/rust/pull/49255
837 [49299]: https://github.com/rust-lang/rust/pull/49299
838 [49305]: https://github.com/rust-lang/rust/pull/49305
839 [49394]: https://github.com/rust-lang/rust/pull/49394
840 [49458]: https://github.com/rust-lang/rust/pull/49458
841 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
842 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
843 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
844 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
845 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
846 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
847 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
848 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
849 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
850 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
851 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
852 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
853 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
854 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
855 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
856 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
857 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
858 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
859 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
860 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
861 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
862 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
863 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
864 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
865 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
866 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
867 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
868 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
869 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
870 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
871 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
872 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
873 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
874 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
875 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
876 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
877 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
878 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
879 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
880 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
881 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
882 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
883
884
885 Version 1.25.0 (2018-03-29)
886 ==========================
887
888 Language
889 --------
890 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
891 - [You can now use nested groups of imports.][47948]
892   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
893 - [You can now have `|` at the start of a match arm.][47947] e.g.
894 ```rust
895 enum Foo { A, B, C }
896
897 fn main() {
898     let x = Foo::A;
899     match x {
900         | Foo::A
901         | Foo::B => println!("AB"),
902         | Foo::C => println!("C"),
903     }
904 }
905 ```
906
907 Compiler
908 --------
909 - [Upgraded to LLVM 6.][47828]
910 - [Added `-C lto=val` option.][47521]
911 - [Added `i586-unknown-linux-musl` target][47282]
912
913 Libraries
914 ---------
915 - [Impl Send for `process::Command` on Unix.][47760]
916 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
917 - [`UnsafeCell::into_inner` is now safe.][47204]
918 - [Implement libstd for CloudABI.][47268]
919 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
920 - [Implement `AsRef<Path>` for Component][46985]
921 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
922 - [Moved `Duration` to libcore.][46666]
923
924 Stabilized APIs
925 ---------------
926 - [`Location::column`]
927 - [`ptr::NonNull`]
928
929 The following functions can now be used in a constant expression.
930 eg. `static MINUTE: Duration = Duration::from_secs(60);`
931 - [`Duration::new`][47300]
932 - [`Duration::from_secs`][47300]
933 - [`Duration::from_millis`][47300]
934
935 Cargo
936 -----
937 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
938 - [`cargo new` now defaults to creating a binary crate, instead of a
939   library crate.][cargo/5029]
940
941 Misc
942 ----
943 - [Rust by example is now shipped with new releases][46196]
944
945 Compatibility Notes
946 -------------------
947 - [Deprecated `net::lookup_host`.][47510]
948 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
949 - The borrow checker was sometimes incorrectly permitting overlapping borrows
950   around indexing operations (see [#47349][47349]). This has been fixed (which also
951   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
952 - [Removed deprecated unstable attribute `#[simd]`.][47251]
953
954 [33903]: https://github.com/rust-lang/rust/pull/33903
955 [47947]: https://github.com/rust-lang/rust/pull/47947
956 [47948]: https://github.com/rust-lang/rust/pull/47948
957 [47760]: https://github.com/rust-lang/rust/pull/47760
958 [47790]: https://github.com/rust-lang/rust/pull/47790
959 [47828]: https://github.com/rust-lang/rust/pull/47828
960 [47398]: https://github.com/rust-lang/rust/pull/47398
961 [47510]: https://github.com/rust-lang/rust/pull/47510
962 [47521]: https://github.com/rust-lang/rust/pull/47521
963 [47204]: https://github.com/rust-lang/rust/pull/47204
964 [47251]: https://github.com/rust-lang/rust/pull/47251
965 [47268]: https://github.com/rust-lang/rust/pull/47268
966 [47282]: https://github.com/rust-lang/rust/pull/47282
967 [47300]: https://github.com/rust-lang/rust/pull/47300
968 [47349]: https://github.com/rust-lang/rust/pull/47349
969 [46931]: https://github.com/rust-lang/rust/pull/46931
970 [46985]: https://github.com/rust-lang/rust/pull/46985
971 [47006]: https://github.com/rust-lang/rust/pull/47006
972 [46830]: https://github.com/rust-lang/rust/pull/46830
973 [46095]: https://github.com/rust-lang/rust/pull/46095
974 [46666]: https://github.com/rust-lang/rust/pull/46666
975 [46196]: https://github.com/rust-lang/rust/pull/46196
976 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
977 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
978 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
979 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
980 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
981
982
983 Version 1.24.1 (2018-03-01)
984 ==========================
985
986  - [Do not abort when unwinding through FFI][48251]
987  - [Emit UTF-16 files for linker arguments on Windows][48318]
988  - [Make the error index generator work again][48308]
989  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
990
991 [48251]: https://github.com/rust-lang/rust/issues/48251
992 [48308]: https://github.com/rust-lang/rust/issues/48308
993 [48318]: https://github.com/rust-lang/rust/issues/48318
994 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
995
996
997 Version 1.24.0 (2018-02-15)
998 ==========================
999
1000 Language
1001 --------
1002 - [External `sysv64` ffi is now available.][46528]
1003   eg. `extern "sysv64" fn foo () {}`
1004
1005 Compiler
1006 --------
1007 - [rustc now uses 16 codegen units by default for release builds.][46910]
1008   For the fastest builds, utilize `codegen-units=1`.
1009 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
1010 - [Add `aarch64-unknown-openbsd` support][46760]
1011
1012 Libraries
1013 ---------
1014 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
1015   improvement in performance in the majority of cases.
1016 - [`OsStr`'s `Debug` implementation is now lossless and consistent
1017   with Windows.][46798]
1018 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
1019 - [impl `From<bool>` for `AtomicBool`][46293]
1020 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
1021 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
1022 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
1023 - [float::from_bits now just uses transmute.][46012] This provides
1024   some optimisations from LLVM.
1025 - [Copied `AsciiExt` methods onto `char`][46077]
1026 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
1027 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
1028 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
1029 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
1030
1031 Stabilized APIs
1032 ---------------
1033 - [`RefCell::replace`]
1034 - [`RefCell::swap`]
1035 - [`atomic::spin_loop_hint`]
1036
1037 The following functions can now be used in a constant expression.
1038 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
1039
1040 - [`AtomicBool::new`][46287]
1041 - [`AtomicUsize::new`][46287]
1042 - [`AtomicIsize::new`][46287]
1043 - [`AtomicPtr::new`][46287]
1044 - [`Cell::new`][46287]
1045 - [`{integer}::min_value`][46287]
1046 - [`{integer}::max_value`][46287]
1047 - [`mem::size_of`][46287]
1048 - [`mem::align_of`][46287]
1049 - [`ptr::null`][46287]
1050 - [`ptr::null_mut`][46287]
1051 - [`RefCell::new`][46287]
1052 - [`UnsafeCell::new`][46287]
1053
1054 Cargo
1055 -----
1056 - [Added a `workspace.default-members` config that
1057   overrides implied `--all` in virtual workspaces.][cargo/4743]
1058 - [Enable incremental by default on development builds.][cargo/4817] Also added
1059   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
1060   per-project or global basis respectively.
1061
1062 Misc
1063 ----
1064
1065 Compatibility Notes
1066 -------------------
1067 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
1068 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
1069   in accordance with IETF RFC 4291 §2.2.
1070 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
1071 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
1072   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
1073 - [Leading zeros in tuple struct members is now an error][47084]
1074 - [`column!()` macro is one-based instead of zero-based][46977]
1075 - [`fmt::Arguments` can no longer be shared across threads][45198]
1076 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
1077 - [Cargo sets a different working directory for the compiler][cargo/4788]
1078
1079 [44884]: https://github.com/rust-lang/rust/pull/44884
1080 [45198]: https://github.com/rust-lang/rust/pull/45198
1081 [45506]: https://github.com/rust-lang/rust/pull/45506
1082 [45904]: https://github.com/rust-lang/rust/pull/45904
1083 [45990]: https://github.com/rust-lang/rust/pull/45990
1084 [46012]: https://github.com/rust-lang/rust/pull/46012
1085 [46077]: https://github.com/rust-lang/rust/pull/46077
1086 [46094]: https://github.com/rust-lang/rust/pull/46094
1087 [46284]: https://github.com/rust-lang/rust/pull/46284
1088 [46287]: https://github.com/rust-lang/rust/pull/46287
1089 [46293]: https://github.com/rust-lang/rust/pull/46293
1090 [46528]: https://github.com/rust-lang/rust/pull/46528
1091 [46671]: https://github.com/rust-lang/rust/pull/46671
1092 [46713]: https://github.com/rust-lang/rust/pull/46713
1093 [46735]: https://github.com/rust-lang/rust/pull/46735
1094 [46749]: https://github.com/rust-lang/rust/pull/46749
1095 [46760]: https://github.com/rust-lang/rust/pull/46760
1096 [46798]: https://github.com/rust-lang/rust/pull/46798
1097 [46828]: https://github.com/rust-lang/rust/pull/46828
1098 [46831]: https://github.com/rust-lang/rust/pull/46831
1099 [46833]: https://github.com/rust-lang/rust/pull/46833
1100 [46910]: https://github.com/rust-lang/rust/pull/46910
1101 [46977]: https://github.com/rust-lang/rust/pull/46977
1102 [47018]: https://github.com/rust-lang/rust/pull/47018
1103 [47080]: https://github.com/rust-lang/rust/pull/47080
1104 [47084]: https://github.com/rust-lang/rust/pull/47084
1105 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
1106 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
1107 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
1108 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
1109 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
1110 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
1111
1112
1113 Version 1.23.0 (2018-01-04)
1114 ==========================
1115
1116 Language
1117 --------
1118 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
1119 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
1120   Which should fix some confusing errors in some operations.
1121
1122 Compiler
1123 --------
1124 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
1125   undefined behavior.][45920]
1126 - [rustc now suggests renaming import if names clash.][45660]
1127 - [Display errors/warnings correctly when there are zero-width or
1128   wide characters.][45711]
1129 - [rustc now avoids unnecessary copies of arguments that are
1130   simple bindings][45380] This should improve memory usage on average by 5-10%.
1131 - [Updated musl used to build musl rustc to 1.1.17][45393]
1132
1133 Libraries
1134 ---------
1135 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
1136 - [Implement Hash for raw pointers to unsized types][45483]
1137 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
1138 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
1139 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
1140 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
1141   and `<*mut T>::as_mut`][44932]
1142 - [Optimized `Thread::{park, unpark}` implementation][45524]
1143 - [Improved `SliceExt::binary_search` performance.][45333]
1144 - [impl `FromIterator<()>` for `()`][45379]
1145 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
1146   is now deprecated.
1147
1148 Stabilized APIs
1149 ---------------
1150
1151 Cargo
1152 -----
1153 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
1154   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
1155 - [Added unit test checking to `cargo check`][cargo/4592]
1156 - [Cargo now lets you install a specific version
1157   using `cargo install --version`][cargo/4637]
1158
1159 Misc
1160 ----
1161 - [Releases now ship with the Cargo book documentation.][45692]
1162 - [rustdoc now prints rendering warnings on every run.][45324]
1163
1164 Compatibility Notes
1165 -------------------
1166 - [Changes have been made to type equality to make it more correct,
1167   in rare cases this could break some code.][45853] [Tracking issue for
1168   further information][45852]
1169 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
1170 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
1171   Android 9, the minimum supported version is Android 14.
1172 - [Bumped the minimum LLVM to 3.9][45326]
1173
1174 [44042]: https://github.com/rust-lang/rust/pull/44042
1175 [44932]: https://github.com/rust-lang/rust/pull/44932
1176 [45267]: https://github.com/rust-lang/rust/pull/45267
1177 [45324]: https://github.com/rust-lang/rust/pull/45324
1178 [45326]: https://github.com/rust-lang/rust/pull/45326
1179 [45333]: https://github.com/rust-lang/rust/pull/45333
1180 [45379]: https://github.com/rust-lang/rust/pull/45379
1181 [45380]: https://github.com/rust-lang/rust/pull/45380
1182 [45393]: https://github.com/rust-lang/rust/pull/45393
1183 [45435]: https://github.com/rust-lang/rust/pull/45435
1184 [45483]: https://github.com/rust-lang/rust/pull/45483
1185 [45524]: https://github.com/rust-lang/rust/pull/45524
1186 [45571]: https://github.com/rust-lang/rust/pull/45571
1187 [45580]: https://github.com/rust-lang/rust/pull/45580
1188 [45610]: https://github.com/rust-lang/rust/pull/45610
1189 [45660]: https://github.com/rust-lang/rust/pull/45660
1190 [45692]: https://github.com/rust-lang/rust/pull/45692
1191 [45711]: https://github.com/rust-lang/rust/pull/45711
1192 [45772]: https://github.com/rust-lang/rust/pull/45772
1193 [45852]: https://github.com/rust-lang/rust/issues/45852
1194 [45853]: https://github.com/rust-lang/rust/pull/45853
1195 [45887]: https://github.com/rust-lang/rust/pull/45887
1196 [45920]: https://github.com/rust-lang/rust/pull/45920
1197 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
1198 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
1199 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
1200
1201
1202 Version 1.22.1 (2017-11-22)
1203 ==========================
1204
1205 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
1206
1207 [46183]: https://github.com/rust-lang/rust/pull/46183
1208
1209 Version 1.22.0 (2017-11-22)
1210 ==========================
1211
1212 Language
1213 --------
1214 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
1215 - [Now accepts underscores in unicode escapes][43716]
1216 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
1217 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
1218
1219 Compiler
1220 --------
1221 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
1222 - [rustc will no longer inline in codegen units when compiling for debug][45075]
1223   This should decrease compile times for debug builds.
1224 - [strict memory alignment now enabled on ARMv6][45094]
1225 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
1226
1227 Libraries
1228 ---------
1229 - [Allow atomic operations up to 32 bits
1230   on `armv5te_unknown_linux_gnueabi`][44978]
1231 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
1232 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
1233 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
1234 - [Properly detect overflow in `Instant += Duration`.][44220]
1235 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
1236 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
1237 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
1238
1239 Stabilized APIs
1240 ---------------
1241
1242 Cargo
1243 -----
1244 - [Cargo will now build multi file examples in subdirectories of the `examples`
1245   folder that have a `main.rs` file.][cargo/4496]
1246 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
1247   the old format will continue to work and can be updated with `cargo update`.
1248 - [Now supports vendoring git repositories][cargo/3992]
1249
1250 Misc
1251 ----
1252 - [`libbacktrace` is now available on Apple platforms.][44251]
1253 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
1254   This now lets you specify that a given code example will fail to compile.
1255
1256 Compatibility Notes
1257 -------------------
1258 - [The minimum Android version that rustc can build for has been bumped
1259   to `4.0` from `2.3`][45656]
1260 - [Allowing `T op= &T` for numeric types has broken some type
1261   inference cases][45480]
1262
1263
1264 [42526]: https://github.com/rust-lang/rust/pull/42526
1265 [43017]: https://github.com/rust-lang/rust/pull/43017
1266 [43716]: https://github.com/rust-lang/rust/pull/43716
1267 [43949]: https://github.com/rust-lang/rust/pull/43949
1268 [44015]: https://github.com/rust-lang/rust/pull/44015
1269 [44220]: https://github.com/rust-lang/rust/pull/44220
1270 [44251]: https://github.com/rust-lang/rust/pull/44251
1271 [44287]: https://github.com/rust-lang/rust/pull/44287
1272 [44303]: https://github.com/rust-lang/rust/pull/44303
1273 [44456]: https://github.com/rust-lang/rust/pull/44456
1274 [44466]: https://github.com/rust-lang/rust/pull/44466
1275 [44895]: https://github.com/rust-lang/rust/pull/44895
1276 [44966]: https://github.com/rust-lang/rust/pull/44966
1277 [44978]: https://github.com/rust-lang/rust/pull/44978
1278 [45041]: https://github.com/rust-lang/rust/pull/45041
1279 [45064]: https://github.com/rust-lang/rust/pull/45064
1280 [45075]: https://github.com/rust-lang/rust/pull/45075
1281 [45094]: https://github.com/rust-lang/rust/pull/45094
1282 [45095]: https://github.com/rust-lang/rust/pull/45095
1283 [45480]: https://github.com/rust-lang/rust/issues/45480
1284 [45656]: https://github.com/rust-lang/rust/pull/45656
1285 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
1286 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
1287 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
1288
1289
1290
1291
1292
1293
1294 Version 1.21.0 (2017-10-12)
1295 ==========================
1296
1297 Language
1298 --------
1299 - [You can now use static references for literals.][43838]
1300   Example:
1301   ```rust
1302   fn main() {
1303       let x: &'static u32 = &0;
1304   }
1305   ```
1306 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
1307   Example:
1308   ```rust
1309   my_macro!(Vec<i32>::new); // Always worked
1310   my_macro!(Vec::<i32>::new); // Now works
1311   ```
1312
1313 Compiler
1314 --------
1315 - [Upgraded jemalloc to 4.5.0][43911]
1316 - [Enabled unwinding panics on Redox][43917]
1317 - [Now runs LLVM in parallel during translation phase.][43506]
1318   This should reduce peak memory usage.
1319
1320 Libraries
1321 ---------
1322 - [Generate builtin impls for `Clone` for all arrays and tuples that
1323   are `T: Clone`][43690]
1324 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
1325 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
1326   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
1327
1328 Stabilized APIs
1329 ---------------
1330
1331 [`std::mem::discriminant`]
1332
1333 Cargo
1334 -----
1335 - [You can now call `cargo install` with multiple package names][cargo/4216]
1336 - [Cargo commands inside a virtual workspace will now implicitly
1337   pass `--all`][cargo/4335]
1338 - [Added a `[patch]` section to `Cargo.toml` to handle
1339   prepublication dependencies][cargo/4123] [RFC 1969]
1340 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
1341   like patterns][cargo/4270]
1342 - [Added the `--all-targets` option][cargo/4400]
1343 - [Using required dependencies as a feature is now deprecated and emits
1344   a warning][cargo/4364]
1345
1346
1347 Misc
1348 ----
1349 - [Cargo docs are moving][43916]
1350   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
1351 - [The rustdoc book is now available][43863]
1352   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
1353 - [Added a preview of RLS has been made available through rustup][44204]
1354   Install with `rustup component add rls-preview`
1355 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
1356   Previously only showed `std::os::unix`.
1357
1358 Compatibility Notes
1359 -------------------
1360 - [Changes in method matching against higher-ranked types][43880] This may cause
1361   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
1362 - [rustc's JSON error output's byte position start at top of file.][42973]
1363   Was previously relative to the rustc's internal `CodeMap` struct which
1364   required the unstable library `libsyntax` to correctly use.
1365 - [`unused_results` lint no longer ignores booleans][43728]
1366
1367 [42565]: https://github.com/rust-lang/rust/pull/42565
1368 [42973]: https://github.com/rust-lang/rust/pull/42973
1369 [43348]: https://github.com/rust-lang/rust/pull/43348
1370 [43459]: https://github.com/rust-lang/rust/pull/43459
1371 [43506]: https://github.com/rust-lang/rust/pull/43506
1372 [43540]: https://github.com/rust-lang/rust/pull/43540
1373 [43690]: https://github.com/rust-lang/rust/pull/43690
1374 [43728]: https://github.com/rust-lang/rust/pull/43728
1375 [43838]: https://github.com/rust-lang/rust/pull/43838
1376 [43863]: https://github.com/rust-lang/rust/pull/43863
1377 [43880]: https://github.com/rust-lang/rust/pull/43880
1378 [43911]: https://github.com/rust-lang/rust/pull/43911
1379 [43916]: https://github.com/rust-lang/rust/pull/43916
1380 [43917]: https://github.com/rust-lang/rust/pull/43917
1381 [44204]: https://github.com/rust-lang/rust/pull/44204
1382 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
1383 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
1384 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1385 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
1386 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
1387 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
1388 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
1389 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
1390 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
1391
1392 Version 1.20.0 (2017-08-31)
1393 ===========================
1394
1395 Language
1396 --------
1397 - [Associated constants are now stabilised.][42809]
1398 - [A lot of macro bugs are now fixed.][42913]
1399
1400 Compiler
1401 --------
1402
1403 - [Struct fields are now properly coerced to the expected field type.][42807]
1404 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
1405   `wasm32-experimental-emscripten` target.
1406 - [Changed some of the error messages to be more helpful.][42033]
1407 - [Add support for RELRO(RELocation Read-Only) for platforms that support
1408   it.][43170]
1409 - [rustc now reports the total number of errors on compilation failure][43015]
1410   previously this was only the number of errors in the pass that failed.
1411 - [Expansion in rustc has been sped up 29x.][42533]
1412 - [added `msp430-none-elf` target.][43099]
1413 - [rustc will now suggest one-argument enum variant to fix type mismatch when
1414   applicable][43178]
1415 - [Fixes backtraces on Redox][43228]
1416 - [rustc now identifies different versions of same crate when absolute paths of
1417   different types match in an error message.][42826]
1418
1419 Libraries
1420 ---------
1421
1422
1423 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
1424 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
1425   tuples.][43011]
1426 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
1427   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
1428 - [Impl `Clone` for `DefaultHasher`.][42799]
1429 - [Impl `Sync` for `SyncSender`.][42397]
1430 - [Impl `FromStr` for `char`][42271]
1431 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
1432   NaN.][42431]
1433 - [allow messages in the `unimplemented!()` macro.][42155]
1434   ie. `unimplemented!("Waiting for 1.21 to be stable")`
1435 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
1436 - [Upgrade to Unicode 10.0.0][42999]
1437 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
1438 - [Skip the main thread's manual stack guard on Linux][43072]
1439 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
1440 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
1441   previously 2^15.
1442 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
1443
1444 Stabilized APIs
1445 ---------------
1446
1447 - [`CStr::into_c_string`]
1448 - [`CString::as_c_str`]
1449 - [`CString::into_boxed_c_str`]
1450 - [`Chain::get_mut`]
1451 - [`Chain::get_ref`]
1452 - [`Chain::into_inner`]
1453 - [`Option::get_or_insert_with`]
1454 - [`Option::get_or_insert`]
1455 - [`OsStr::into_os_string`]
1456 - [`OsString::into_boxed_os_str`]
1457 - [`Take::get_mut`]
1458 - [`Take::get_ref`]
1459 - [`Utf8Error::error_len`]
1460 - [`char::EscapeDebug`]
1461 - [`char::escape_debug`]
1462 - [`compile_error!`]
1463 - [`f32::from_bits`]
1464 - [`f32::to_bits`]
1465 - [`f64::from_bits`]
1466 - [`f64::to_bits`]
1467 - [`mem::ManuallyDrop`]
1468 - [`slice::sort_unstable_by_key`]
1469 - [`slice::sort_unstable_by`]
1470 - [`slice::sort_unstable`]
1471 - [`str::from_boxed_utf8_unchecked`]
1472 - [`str::as_bytes_mut`]
1473 - [`str::as_bytes_mut`]
1474 - [`str::from_utf8_mut`]
1475 - [`str::from_utf8_unchecked_mut`]
1476 - [`str::get_mut`]
1477 - [`str::get_unchecked_mut`]
1478 - [`str::get_unchecked`]
1479 - [`str::get`]
1480 - [`str::into_boxed_bytes`]
1481
1482
1483 Cargo
1484 -----
1485 - [Cargo API token location moved from `~/.cargo/config` to
1486   `~/.cargo/credentials`.][cargo/3978]
1487 - [Cargo will now build `main.rs` binaries that are in sub-directories of
1488   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
1489   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
1490 - [You can now specify version of a binary when installed through
1491   `cargo install` using `--vers`.][cargo/4229]
1492 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
1493   failure.][cargo/4248]
1494 - [Changed the convention around which file is the crate root.][cargo/4259]
1495 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
1496   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
1497
1498 Compatibility Notes
1499 -------------------
1500
1501 - [Functions with `'static` in their return types will now not be as usable as
1502   if they were using lifetime parameters instead.][42417]
1503 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
1504   takes the sign of NaN into account where previously didn't.][42430]
1505
1506 [42033]: https://github.com/rust-lang/rust/pull/42033
1507 [42155]: https://github.com/rust-lang/rust/pull/42155
1508 [42271]: https://github.com/rust-lang/rust/pull/42271
1509 [42397]: https://github.com/rust-lang/rust/pull/42397
1510 [42417]: https://github.com/rust-lang/rust/pull/42417
1511 [42430]: https://github.com/rust-lang/rust/pull/42430
1512 [42431]: https://github.com/rust-lang/rust/pull/42431
1513 [42533]: https://github.com/rust-lang/rust/pull/42533
1514 [42571]: https://github.com/rust-lang/rust/pull/42571
1515 [42613]: https://github.com/rust-lang/rust/pull/42613
1516 [42799]: https://github.com/rust-lang/rust/pull/42799
1517 [42807]: https://github.com/rust-lang/rust/pull/42807
1518 [42809]: https://github.com/rust-lang/rust/pull/42809
1519 [42822]: https://github.com/rust-lang/rust/pull/42822
1520 [42826]: https://github.com/rust-lang/rust/pull/42826
1521 [42854]: https://github.com/rust-lang/rust/pull/42854
1522 [42913]: https://github.com/rust-lang/rust/pull/42913
1523 [42999]: https://github.com/rust-lang/rust/pull/42999
1524 [43011]: https://github.com/rust-lang/rust/pull/43011
1525 [43015]: https://github.com/rust-lang/rust/pull/43015
1526 [43072]: https://github.com/rust-lang/rust/pull/43072
1527 [43077]: https://github.com/rust-lang/rust/pull/43077
1528 [43097]: https://github.com/rust-lang/rust/pull/43097
1529 [43099]: https://github.com/rust-lang/rust/pull/43099
1530 [43170]: https://github.com/rust-lang/rust/pull/43170
1531 [43178]: https://github.com/rust-lang/rust/pull/43178
1532 [43185]: https://github.com/rust-lang/rust/pull/43185
1533 [43228]: https://github.com/rust-lang/rust/pull/43228
1534 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
1535 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
1536 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
1537 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
1538 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
1539 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
1540 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
1541 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
1542 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
1543 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
1544 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
1545 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
1546 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
1547 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
1548 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
1549 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
1550 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
1551 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
1552 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
1553 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
1554 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
1555 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
1556 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
1557 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
1558 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
1559 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
1560 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
1561 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
1562 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
1563 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
1564 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
1565 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
1566 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
1567 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
1568 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
1569 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
1570 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
1571 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
1572 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
1573
1574
1575 Version 1.19.0 (2017-07-20)
1576 ===========================
1577
1578 Language
1579 --------
1580
1581 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
1582   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
1583 - [Macro recursion limit increased to 1024 from 64.][41676]
1584 - [Added lint for detecting unused macros.][41907]
1585 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
1586   For example: `let x = loop { break 7; };`
1587 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
1588   contain `Copy` types and cannot have a `Drop` implementation.
1589   Example: `union Foo { bar: u8, baz: usize }`
1590 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
1591   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
1592
1593 Compiler
1594 --------
1595
1596 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
1597 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
1598   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
1599   you should use `--target armv7-linux-androideabi`.
1600 - [Fixed ICE when removing a source file between compilation sessions.][41873]
1601 - [Minor optimisation of string operations.][42037]
1602 - [Compiler error message is now `aborting due to previous error(s)` instead of
1603   `aborting due to N previous errors`][42150] This was previously inaccurate and
1604   would only count certain kinds of errors.
1605 - [The compiler now supports Visual Studio 2017][42225]
1606 - [The compiler is now built against LLVM 4.0.1 by default][42948]
1607 - [Added a lot][42264] of [new error codes][42302]
1608 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
1609   libraries with C Run-time Libraries(CRT) to be statically linked.
1610 - [Fixed various ARM codegen bugs][42740]
1611
1612 Libraries
1613 ---------
1614
1615 - [`String` now implements `FromIterator<Cow<'a, str>>` and
1616   `Extend<Cow<'a, str>>`][41449]
1617 - [`Vec` now implements `From<&mut [T]>`][41530]
1618 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
1619 - [`SplitWhitespace` now implements `Clone`][41659]
1620 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
1621   1.5x faster][41764]
1622 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
1623   macros, but for printing to stderr.
1624
1625 Stabilized APIs
1626 ---------------
1627
1628 - [`OsString::shrink_to_fit`]
1629 - [`cmp::Reverse`]
1630 - [`Command::envs`]
1631 - [`thread::ThreadId`]
1632
1633 Cargo
1634 -----
1635
1636 - [Build scripts can now add environment variables to the environment
1637   the crate is being compiled in.
1638   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
1639 - [Subcommands now replace the current process rather than spawning a new
1640   child process][cargo/3970]
1641 - [Workspace members can now accept glob file patterns][cargo/3979]
1642 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
1643   the members in a given workspace.][cargo/3988]
1644 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
1645 - [Target directory path is now in the cargo metadata][cargo/4022]
1646 - [Cargo no longer checks out a local working directory for the
1647   crates.io index][cargo/4026] This should provide smaller file size for the
1648   registry, and improve cloning times, especially on Windows machines.
1649 - [Added an `--exclude` option for excluding certain packages when using the
1650   `--all` option][cargo/4031]
1651 - [Cargo will now automatically retry when receiving a 5xx error
1652   from crates.io][cargo/4032]
1653 - [The `--features` option now accepts multiple comma or space
1654   delimited values.][cargo/4084]
1655 - [Added support for custom target specific runners][cargo/3954]
1656
1657 Misc
1658 ----
1659
1660 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
1661   Windows Debugger.
1662 - [Rust will now release XZ compressed packages][rust-installer/57]
1663 - [rustup will now prefer to download rust packages with
1664   XZ compression][rustup/1100] over GZip packages.
1665 - [Added the ability to escape `#` in rust documentation][41785] By adding
1666   additional `#`'s ie. `##` is now `#`
1667
1668 Compatibility Notes
1669 -------------------
1670
1671 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
1672 - [`-Z` flags are now no longer allowed to be used on the stable
1673   compiler.][41751] This has been a warning for a year previous to this.
1674 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
1675   longer works][42844]. Users should migrate to the built-in `check`
1676   command, which has been available since 1.16.
1677 - [Ending a float literal with `._` is now a hard error.
1678   Example: `42._` .][41946]
1679 - [Any use of a private `extern crate` outside of its module is now a
1680   hard error.][36886] This was previously a warning.
1681 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
1682   relative while the `::` prefix makes a path absolute, but was ignored and the
1683   path was relative regardless.
1684 - [Floating point constants in match patterns is now a hard error][36890]
1685   This was previously a warning.
1686 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
1687   match patterns is now a hard error][36891] This was previously a warning.
1688 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
1689   a warning.
1690 - [From the pound escape, lines consisting of multiple `#`s are
1691   now visible][41785]
1692 - [It is an error to re-export private enum variants][42460]. This is
1693   known to break a number of crates that depend on an older version of
1694   mustache.
1695 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
1696   to use it to find the linker, and the build will fail where it did
1697   not previously][42607]
1698
1699 [36886]: https://github.com/rust-lang/rust/issues/36886
1700 [36888]: https://github.com/rust-lang/rust/issues/36888
1701 [36890]: https://github.com/rust-lang/rust/issues/36890
1702 [36891]: https://github.com/rust-lang/rust/issues/36891
1703 [36892]: https://github.com/rust-lang/rust/issues/36892
1704 [37406]: https://github.com/rust-lang/rust/issues/37406
1705 [39983]: https://github.com/rust-lang/rust/pull/39983
1706 [41145]: https://github.com/rust-lang/rust/pull/41145
1707 [41192]: https://github.com/rust-lang/rust/pull/41192
1708 [41258]: https://github.com/rust-lang/rust/pull/41258
1709 [41370]: https://github.com/rust-lang/rust/pull/41370
1710 [41449]: https://github.com/rust-lang/rust/pull/41449
1711 [41530]: https://github.com/rust-lang/rust/pull/41530
1712 [41624]: https://github.com/rust-lang/rust/pull/41624
1713 [41656]: https://github.com/rust-lang/rust/pull/41656
1714 [41659]: https://github.com/rust-lang/rust/pull/41659
1715 [41676]: https://github.com/rust-lang/rust/pull/41676
1716 [41751]: https://github.com/rust-lang/rust/pull/41751
1717 [41764]: https://github.com/rust-lang/rust/pull/41764
1718 [41785]: https://github.com/rust-lang/rust/pull/41785
1719 [41873]: https://github.com/rust-lang/rust/pull/41873
1720 [41907]: https://github.com/rust-lang/rust/pull/41907
1721 [41946]: https://github.com/rust-lang/rust/pull/41946
1722 [42016]: https://github.com/rust-lang/rust/pull/42016
1723 [42037]: https://github.com/rust-lang/rust/pull/42037
1724 [42068]: https://github.com/rust-lang/rust/pull/42068
1725 [42150]: https://github.com/rust-lang/rust/pull/42150
1726 [42162]: https://github.com/rust-lang/rust/pull/42162
1727 [42225]: https://github.com/rust-lang/rust/pull/42225
1728 [42264]: https://github.com/rust-lang/rust/pull/42264
1729 [42302]: https://github.com/rust-lang/rust/pull/42302
1730 [42460]: https://github.com/rust-lang/rust/issues/42460
1731 [42607]: https://github.com/rust-lang/rust/issues/42607
1732 [42740]: https://github.com/rust-lang/rust/pull/42740
1733 [42844]: https://github.com/rust-lang/rust/issues/42844
1734 [42948]: https://github.com/rust-lang/rust/pull/42948
1735 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
1736 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
1737 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
1738 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
1739 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
1740 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
1741 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
1742 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
1743 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
1744 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
1745 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
1746 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
1747 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
1748 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
1749 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
1750 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
1751 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
1752 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
1753 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
1754 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
1755 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
1756 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
1757
1758
1759 Version 1.18.0 (2017-06-08)
1760 ===========================
1761
1762 Language
1763 --------
1764
1765 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
1766   make the item visible to just that module tree. Also accepts the keyword
1767   `crate` to make something public to the whole crate but not users of the
1768   library. Example: `pub(crate) mod utils;`. [RFC 1422].
1769 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
1770   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
1771 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
1772   types like `Write + Send`, trailing `+` are now supported in trait objects,
1773   and better error reporting for trait objects starting with `?Sized`.
1774 - [0e+10 is now a valid floating point literal][40589]
1775 - [Now warns if you bind a lifetime parameter to 'static][40734]
1776 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
1777   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
1778   representation in some cases.][40377]
1779
1780 Compiler
1781 --------
1782
1783 - [rustc can now emit mir with `--emit mir`][39891]
1784 - [Improved LLVM IR for trivial functions][40367]
1785 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
1786 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
1787   opportunities found through profiling
1788 - [Improved backtrace formatting when panicking][38165]
1789
1790 Libraries
1791 ---------
1792
1793 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
1794   iterator hasn't been advanced the original `Vec` is reassembled with no actual
1795   iteration or reallocation.
1796 - [Simplified HashMap Bucket interface][40561] provides performance
1797   improvements for iterating and cloning.
1798 - [Specialize Vec::from_elem to use calloc][40409]
1799 - [Fixed Race condition in fs::create_dir_all][39799]
1800 - [No longer caching stdio on Windows][40516]
1801 - [Optimized insertion sort in slice][40807] insertion sort in some cases
1802   2.50%~ faster and in one case now 12.50% faster.
1803 - [Optimized `AtomicBool::fetch_nand`][41143]
1804
1805 Stabilized APIs
1806 ---------------
1807
1808 - [`Child::try_wait`]
1809 - [`HashMap::retain`]
1810 - [`HashSet::retain`]
1811 - [`PeekMut::pop`]
1812 - [`TcpStream::peek`]
1813 - [`UdpSocket::peek`]
1814 - [`UdpSocket::peek_from`]
1815
1816 Cargo
1817 -----
1818
1819 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
1820   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
1821 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
1822 - [Added Android build support][cargo/3885]
1823 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
1824   of a certain type, for example `cargo build --bins` will build all
1825   binaries.
1826 - [Added support for haiku][cargo/3952]
1827
1828 Misc
1829 ----
1830
1831 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
1832 - [Added rust-windbg script for better debugging on Windows][39983]
1833 - [Rust now uses the official cross compiler for NetBSD][40612]
1834 - [rustdoc now accepts `#` at the start of files][40828]
1835 - [Fixed jemalloc support for musl][41168]
1836
1837 Compatibility Notes
1838 -------------------
1839
1840 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
1841   always placed after the sign if it exists and before the digits. With the `#`
1842   flag the zeroes are placed after the prefix and before the digits.
1843 - [Due to the struct field optimisation][40377], using `transmute` on structs
1844   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
1845   always been undefined behavior, but is now more likely to break in practice.
1846 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
1847   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
1848   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
1849 - [Overlapping inherent `impl`s are now a hard error][40728]
1850 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
1851 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
1852   `out.asm` and `out.ll` instead of only one of the filetypes.
1853 - [ calling a function that returns `Self` will no longer work][41805] when
1854   the size of `Self` cannot be statically determined.
1855 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
1856   this has caused a few regressions namely:
1857
1858   - Changed the link order of local static/dynamic libraries (respecting the
1859     order on given rather than having the compiler reorder).
1860   - Changed how MinGW is linked, native code linked to dynamic libraries
1861     may require manually linking to the gcc support library (for the native
1862     code itself)
1863
1864 [38165]: https://github.com/rust-lang/rust/pull/38165
1865 [39799]: https://github.com/rust-lang/rust/pull/39799
1866 [39891]: https://github.com/rust-lang/rust/pull/39891
1867 [39983]: https://github.com/rust-lang/rust/pull/39983
1868 [40043]: https://github.com/rust-lang/rust/pull/40043
1869 [40241]: https://github.com/rust-lang/rust/pull/40241
1870 [40338]: https://github.com/rust-lang/rust/pull/40338
1871 [40367]: https://github.com/rust-lang/rust/pull/40367
1872 [40377]: https://github.com/rust-lang/rust/pull/40377
1873 [40409]: https://github.com/rust-lang/rust/pull/40409
1874 [40516]: https://github.com/rust-lang/rust/pull/40516
1875 [40556]: https://github.com/rust-lang/rust/pull/40556
1876 [40561]: https://github.com/rust-lang/rust/pull/40561
1877 [40589]: https://github.com/rust-lang/rust/pull/40589
1878 [40612]: https://github.com/rust-lang/rust/pull/40612
1879 [40723]: https://github.com/rust-lang/rust/pull/40723
1880 [40728]: https://github.com/rust-lang/rust/pull/40728
1881 [40731]: https://github.com/rust-lang/rust/pull/40731
1882 [40734]: https://github.com/rust-lang/rust/pull/40734
1883 [40805]: https://github.com/rust-lang/rust/pull/40805
1884 [40807]: https://github.com/rust-lang/rust/pull/40807
1885 [40828]: https://github.com/rust-lang/rust/pull/40828
1886 [40870]: https://github.com/rust-lang/rust/pull/40870
1887 [41085]: https://github.com/rust-lang/rust/pull/41085
1888 [41143]: https://github.com/rust-lang/rust/pull/41143
1889 [41168]: https://github.com/rust-lang/rust/pull/41168
1890 [41270]: https://github.com/rust-lang/rust/issues/41270
1891 [41469]: https://github.com/rust-lang/rust/pull/41469
1892 [41805]: https://github.com/rust-lang/rust/issues/41805
1893 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
1894 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
1895 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
1896 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
1897 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
1898 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
1899 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
1900 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
1901 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
1902 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
1903 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
1904 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
1905 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
1906 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
1907
1908
1909 Version 1.17.0 (2017-04-27)
1910 ===========================
1911
1912 Language
1913 --------
1914
1915 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
1916 * [Fields of structs may be initialized without duplicating the field/variable
1917   names][39761]. [RFC 1682]
1918 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
1919 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
1920   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
1921   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
1922   `'b`. Soundness fix.
1923 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
1924 * [Static variables may contain references to other statics][40027]
1925
1926 Compiler
1927 --------
1928
1929 * [Exit quickly on only `--emit dep-info`][40336]
1930 * [Make `-C relocation-model` more correctly determine whether the linker
1931   creates a position-independent executable][40245]
1932 * [Add `-C overflow-checks` to directly control whether integer overflow
1933   panics][40037]
1934 * [The rustc type checker now checks items on demand instead of in a single
1935   in-order pass][40008]. This is mostly an internal refactoring in support of
1936   future work, including incremental type checking, but also resolves [RFC
1937   1647], allowing `Self` to appear in `impl` `where` clauses.
1938 * [Optimize vtable loads][39995]
1939 * [Turn off vectorization for Emscripten targets][39990]
1940 * [Provide suggestions for unknown macros imported with `use`][39953]
1941 * [Fix ICEs in path resolution][39939]
1942 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
1943 * [Add clearer error message using `&str + &str`][39116]
1944
1945 Stabilized APIs
1946 ---------------
1947
1948 * [`Arc::into_raw`]
1949 * [`Arc::from_raw`]
1950 * [`Arc::ptr_eq`]
1951 * [`Rc::into_raw`]
1952 * [`Rc::from_raw`]
1953 * [`Rc::ptr_eq`]
1954 * [`Ordering::then`]
1955 * [`Ordering::then_with`]
1956 * [`BTreeMap::range`]
1957 * [`BTreeMap::range_mut`]
1958 * [`collections::Bound`]
1959 * [`process::abort`]
1960 * [`ptr::read_unaligned`]
1961 * [`ptr::write_unaligned`]
1962 * [`Result::expect_err`]
1963 * [`Cell::swap`]
1964 * [`Cell::replace`]
1965 * [`Cell::into_inner`]
1966 * [`Cell::take`]
1967
1968 Libraries
1969 ---------
1970
1971 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
1972 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
1973 * [`String` implements `FromIterator<&char>`][40028]
1974 * `Box` [implements][40009] a number of new conversions:
1975   `From<Box<str>> for String`,
1976   `From<Box<[T]>> for Vec<T>`,
1977   `From<Box<CStr>> for CString`,
1978   `From<Box<OsStr>> for OsString`,
1979   `From<Box<Path>> for PathBuf`,
1980   `Into<Box<str>> for String`,
1981   `Into<Box<[T]>> for Vec<T>`,
1982   `Into<Box<CStr>> for CString`,
1983   `Into<Box<OsStr>> for OsString`,
1984   `Into<Box<Path>> for PathBuf`,
1985   `Default for Box<str>`,
1986   `Default for Box<CStr>`,
1987   `Default for Box<OsStr>`,
1988   `From<&CStr> for Box<CStr>`,
1989   `From<&OsStr> for Box<OsStr>`,
1990   `From<&Path> for Box<Path>`
1991 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
1992 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
1993 * [Slightly optimize `slice::sort`][39538]
1994 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
1995 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
1996   `Box<str>` implements `From<&str>`][39438]
1997 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
1998   `From<(I, u16)> where I: Into<IpAddr>`][39372]
1999 * [`format!` estimates the needed capacity before writing a string][39356]
2000 * [Support unprivileged symlink creation in Windows][38921]
2001 * [`PathBuf` implements `Default`][38764]
2002 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
2003 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
2004   and poor hash functions.
2005
2006 Cargo
2007 -----
2008
2009 * [Add `cargo check --all`][cargo/3731]
2010 * [Add an option to ignore SSL revocation checking][cargo/3699]
2011 * [Add `cargo run --package`][cargo/3691]
2012 * [Add `required_features`][cargo/3667]
2013 * [Assume `build.rs` is a build script][cargo/3664]
2014 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
2015
2016 Misc
2017 ----
2018
2019 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
2020   `rustbook`][39633]
2021 * [The "Unstable Book" documents nightly-only features][ubook]
2022 * [Improve the style of the sidebar in rustdoc output][40265]
2023 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
2024 * [Fix MSP430 breakage due to `i128`][40257]
2025 * [Preliminary Solaris/SPARCv9 support][39903]
2026 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
2027   run without installing the MSVC runtime.
2028 * [`rustdoc --test` includes file names in test names][39788]
2029 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
2030   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
2031 * [Initial support for `aarch64-unknown-freebsd`][39491]
2032 * [Initial support for `i686-unknown-netbsd`][39426]
2033 * [This release no longer includes the old makefile build system][39431]. Rust
2034   is built with a custom build system, written in Rust, and with Cargo.
2035 * [Add Debug implementations for libcollection structs][39002]
2036 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
2037 * [`--test-threads=0` produces an error][38945]
2038 * [`rustup` installs documentation by default][40526]
2039 * [The Rust source includes NatVis visualizations][39843]. These can be used by
2040   WinDbg and Visual Studio to improve the debugging experience.
2041
2042 Compatibility Notes
2043 -------------------
2044
2045 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
2046   workaround, either use MSVC 2015 or run vcvars.bat.
2047 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
2048   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
2049   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
2050   fix.
2051 * [`format!` and `Display::to_string` panic if an underlying formatting
2052   implementation returns an error][40117]. Previously the error was silently
2053   ignored. It is incorrect for `write_fmt` to return an error when writing
2054   to a string.
2055 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
2056   crates were marked stable and could be accessed from the stable toolchain.
2057 * [Rust git source no longer includes vendored crates][39728]. Those that need
2058   to build with vendored crates should build from release tarballs.
2059 * [Fix inert attributes from `proc_macro_derives`][39572]
2060 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
2061   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
2062   build system.
2063 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
2064   existing code generally ignores the type of dead-code unless a type-hint is
2065   provided; this can cause surprising inference interactions particularly around
2066   defaulting. The new code uniformly ignores the result type of dead-code.
2067 * [Tuple-struct constructors with private fields are no longer visible][38932]
2068 * [Lifetime parameters that do not appear in the arguments are now considered
2069   early-bound][38897], resolving a soundness bug (#[32330]). The
2070   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
2071   April of 2016.
2072 * [rustdoc: fix doctests with non-feature crate attributes][38161]
2073 * [Make transmuting from fn item types to pointer-sized types a hard
2074   error][34198]
2075
2076 [27787]: https://github.com/rust-lang/rust/issues/27787
2077 [32330]: https://github.com/rust-lang/rust/issues/32330
2078 [34198]: https://github.com/rust-lang/rust/pull/34198
2079 [38161]: https://github.com/rust-lang/rust/pull/38161
2080 [38368]: https://github.com/rust-lang/rust/pull/38368
2081 [38584]: https://github.com/rust-lang/rust/issues/38584
2082 [38661]: https://github.com/rust-lang/rust/pull/38661
2083 [38764]: https://github.com/rust-lang/rust/pull/38764
2084 [38864]: https://github.com/rust-lang/rust/issues/38864
2085 [38897]: https://github.com/rust-lang/rust/pull/38897
2086 [38921]: https://github.com/rust-lang/rust/pull/38921
2087 [38932]: https://github.com/rust-lang/rust/pull/38932
2088 [38945]: https://github.com/rust-lang/rust/pull/38945
2089 [38981]: https://github.com/rust-lang/rust/pull/38981
2090 [39002]: https://github.com/rust-lang/rust/pull/39002
2091 [39116]: https://github.com/rust-lang/rust/pull/39116
2092 [39193]: https://github.com/rust-lang/rust/pull/39193
2093 [39265]: https://github.com/rust-lang/rust/pull/39265
2094 [39356]: https://github.com/rust-lang/rust/pull/39356
2095 [39372]: https://github.com/rust-lang/rust/pull/39372
2096 [39426]: https://github.com/rust-lang/rust/pull/39426
2097 [39431]: https://github.com/rust-lang/rust/pull/39431
2098 [39438]: https://github.com/rust-lang/rust/pull/39438
2099 [39440]: https://github.com/rust-lang/rust/pull/39440
2100 [39485]: https://github.com/rust-lang/rust/pull/39485
2101 [39491]: https://github.com/rust-lang/rust/pull/39491
2102 [39518]: https://github.com/rust-lang/rust/pull/39518
2103 [39538]: https://github.com/rust-lang/rust/pull/39538
2104 [39572]: https://github.com/rust-lang/rust/pull/39572
2105 [39633]: https://github.com/rust-lang/rust/pull/39633
2106 [39642]: https://github.com/rust-lang/rust/pull/39642
2107 [39728]: https://github.com/rust-lang/rust/pull/39728
2108 [39761]: https://github.com/rust-lang/rust/pull/39761
2109 [39788]: https://github.com/rust-lang/rust/pull/39788
2110 [39793]: https://github.com/rust-lang/rust/pull/39793
2111 [39837]: https://github.com/rust-lang/rust/pull/39837
2112 [39843]: https://github.com/rust-lang/rust/pull/39843
2113 [39851]: https://github.com/rust-lang/rust/pull/39851
2114 [39903]: https://github.com/rust-lang/rust/pull/39903
2115 [39939]: https://github.com/rust-lang/rust/pull/39939
2116 [39953]: https://github.com/rust-lang/rust/pull/39953
2117 [39960]: https://github.com/rust-lang/rust/pull/39960
2118 [39990]: https://github.com/rust-lang/rust/pull/39990
2119 [39995]: https://github.com/rust-lang/rust/pull/39995
2120 [40008]: https://github.com/rust-lang/rust/pull/40008
2121 [40009]: https://github.com/rust-lang/rust/pull/40009
2122 [40027]: https://github.com/rust-lang/rust/pull/40027
2123 [40028]: https://github.com/rust-lang/rust/pull/40028
2124 [40037]: https://github.com/rust-lang/rust/pull/40037
2125 [40117]: https://github.com/rust-lang/rust/pull/40117
2126 [40166]: https://github.com/rust-lang/rust/pull/40166
2127 [40245]: https://github.com/rust-lang/rust/pull/40245
2128 [40257]: https://github.com/rust-lang/rust/pull/40257
2129 [40261]: https://github.com/rust-lang/rust/pull/40261
2130 [40265]: https://github.com/rust-lang/rust/pull/40265
2131 [40319]: https://github.com/rust-lang/rust/pull/40319
2132 [40336]: https://github.com/rust-lang/rust/pull/40336
2133 [40526]: https://github.com/rust-lang/rust/pull/40526
2134 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2135 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
2136 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
2137 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
2138 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
2139 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
2140 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
2141 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
2142 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
2143 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
2144 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
2145 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
2146 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
2147 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
2148 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
2149 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
2150 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
2151 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
2152 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
2153 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
2154 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
2155 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
2156 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
2157 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
2158 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
2159 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
2160 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
2161 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
2162 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
2163 [mdbook]: https://crates.io/crates/mdbook
2164 [ubook]: https://doc.rust-lang.org/unstable-book/
2165
2166
2167 Version 1.16.0 (2017-03-16)
2168 ===========================
2169
2170 Language
2171 --------
2172
2173 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2174 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2175   match patterns][38069]
2176 * [Clean up semantics of `self` in an import list][38313]
2177 * [`Self` may appear in `impl` headers][38920]
2178 * [`Self` may appear in struct expressions][39282]
2179
2180 Compiler
2181 --------
2182
2183 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
2184   a `.rmeta` file containing only crate metadata][38571]. This can be
2185   used by tools like the Rust Language Service to perform
2186   metadata-only builds.
2187 * [Levenshtein based typo suggestions now work in most places, while
2188   previously they worked only for fields and sometimes for local
2189   variables][38927]. Together with the overhaul of "no
2190   resolution"/"unexpected resolution" errors (#[38154]) they result in
2191   large and systematic improvement in resolution diagnostics.
2192 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
2193   `U`][38670]
2194 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
2195 * [`rustc` no longer attempts to provide "consider using an explicit
2196   lifetime" suggestions][37057]. They were inaccurate.
2197
2198 Stabilized APIs
2199 ---------------
2200
2201 * [`VecDeque::truncate`]
2202 * [`VecDeque::resize`]
2203 * [`String::insert_str`]
2204 * [`Duration::checked_add`]
2205 * [`Duration::checked_sub`]
2206 * [`Duration::checked_div`]
2207 * [`Duration::checked_mul`]
2208 * [`str::replacen`]
2209 * [`str::repeat`]
2210 * [`SocketAddr::is_ipv4`]
2211 * [`SocketAddr::is_ipv6`]
2212 * [`IpAddr::is_ipv4`]
2213 * [`IpAddr::is_ipv6`]
2214 * [`Vec::dedup_by`]
2215 * [`Vec::dedup_by_key`]
2216 * [`Result::unwrap_or_default`]
2217 * [`<*const T>::wrapping_offset`]
2218 * [`<*mut T>::wrapping_offset`]
2219 * `CommandExt::creation_flags`
2220 * [`File::set_permissions`]
2221 * [`String::split_off`]
2222
2223 Libraries
2224 ---------
2225
2226 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
2227   their argument by `Borrow` parameter][37761]
2228 * [All public types in std implement `Debug`][38006]
2229 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
2230 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
2231 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2232   Windows][38274]
2233 * [std: Fix partial writes in `LineWriter`][38062]
2234 * [std: Clamp max read/write sizes on Unix][38062]
2235 * [Use more specific panic message for `&str` slicing errors][38066]
2236 * [`TcpListener::set_only_v6` is deprecated][38304]. This
2237   functionality cannot be achieved in std currently.
2238 * [`writeln!`, like `println!`, now accepts a form with no string
2239   or formatting arguments, to just print a newline][38469]
2240 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
2241 * [Reduce the size of static data in `std_unicode::tables`][38781]
2242 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
2243   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
2244   `Display`][38909]
2245 * [`Duration` implements `Sum`][38712]
2246 * [`String` implements `ToSocketAddrs`][39048]
2247
2248 Cargo
2249 -----
2250
2251 * [The `cargo check` command does a type check of a project without
2252   building it][cargo/3296]
2253 * [crates.io will display CI badges from Travis and AppVeyor, if
2254   specified in Cargo.toml][cargo/3546]
2255 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
2256 * [Compilation profiles accept integer values for `debug`, in addition
2257   to `true` and `false`. These are passed to `rustc` as the value to
2258   `-C debuginfo`][cargo/3534]
2259 * [Implement `cargo --version --verbose`][cargo/3604]
2260 * [All builds now output 'dep-info' build dependencies compatible with
2261   make and ninja][cargo/3557]
2262 * [Build all workspace members with `build --all`][cargo/3511]
2263 * [Document all workspace members with `doc --all`][cargo/3515]
2264 * [Path deps outside workspace are not members][cargo/3443]
2265
2266 Misc
2267 ----
2268
2269 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
2270   the path to the Rust implementation][38589]
2271 * [The `armv7-linux-androideabi` target no longer enables NEON
2272   extensions, per Google's ABI guide][38413]
2273 * [The stock standard library can be compiled for Redox OS][38401]
2274 * [Rust has initial SPARC support][38726]. Tier 3. No builds
2275   available.
2276 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
2277   builds available.
2278 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
2279
2280 Compatibility Notes
2281 -------------------
2282
2283 * [Uninhabitable enums (those without any variants) no longer permit wildcard
2284   match patterns][38069]
2285 * In this release, references to uninhabited types can not be
2286   pattern-matched. This was accidentally allowed in 1.15.
2287 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
2288 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
2289   Windows][38274]
2290 * [Clean up semantics of `self` in an import list][38313]
2291 * Reimplemented lifetime elision. This change was almost entirely compatible
2292   with existing code, but it did close a number of small bugs and loopholes,
2293   as well as being more accepting in some other [cases][41105].
2294
2295 [37057]: https://github.com/rust-lang/rust/pull/37057
2296 [37761]: https://github.com/rust-lang/rust/pull/37761
2297 [38006]: https://github.com/rust-lang/rust/pull/38006
2298 [38051]: https://github.com/rust-lang/rust/pull/38051
2299 [38062]: https://github.com/rust-lang/rust/pull/38062
2300 [38062]: https://github.com/rust-lang/rust/pull/38622
2301 [38066]: https://github.com/rust-lang/rust/pull/38066
2302 [38069]: https://github.com/rust-lang/rust/pull/38069
2303 [38131]: https://github.com/rust-lang/rust/pull/38131
2304 [38154]: https://github.com/rust-lang/rust/pull/38154
2305 [38274]: https://github.com/rust-lang/rust/pull/38274
2306 [38304]: https://github.com/rust-lang/rust/pull/38304
2307 [38313]: https://github.com/rust-lang/rust/pull/38313
2308 [38314]: https://github.com/rust-lang/rust/pull/38314
2309 [38327]: https://github.com/rust-lang/rust/pull/38327
2310 [38401]: https://github.com/rust-lang/rust/pull/38401
2311 [38413]: https://github.com/rust-lang/rust/pull/38413
2312 [38469]: https://github.com/rust-lang/rust/pull/38469
2313 [38559]: https://github.com/rust-lang/rust/pull/38559
2314 [38571]: https://github.com/rust-lang/rust/pull/38571
2315 [38580]: https://github.com/rust-lang/rust/pull/38580
2316 [38589]: https://github.com/rust-lang/rust/pull/38589
2317 [38670]: https://github.com/rust-lang/rust/pull/38670
2318 [38712]: https://github.com/rust-lang/rust/pull/38712
2319 [38726]: https://github.com/rust-lang/rust/pull/38726
2320 [38781]: https://github.com/rust-lang/rust/pull/38781
2321 [38798]: https://github.com/rust-lang/rust/pull/38798
2322 [38909]: https://github.com/rust-lang/rust/pull/38909
2323 [38920]: https://github.com/rust-lang/rust/pull/38920
2324 [38927]: https://github.com/rust-lang/rust/pull/38927
2325 [39048]: https://github.com/rust-lang/rust/pull/39048
2326 [39282]: https://github.com/rust-lang/rust/pull/39282
2327 [39379]: https://github.com/rust-lang/rust/pull/39379
2328 [41105]: https://github.com/rust-lang/rust/issues/41105
2329 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2330 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
2331 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
2332 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
2333 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
2334 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
2335 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
2336 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
2337 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
2338 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
2339 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
2340 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
2341 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
2342 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
2343 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
2344 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
2345 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
2346 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
2347 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
2348 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
2349 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
2350 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
2351 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
2352 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
2353 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
2354 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
2355 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
2356 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
2357 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
2358 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
2359
2360
2361 Version 1.15.1 (2017-02-09)
2362 ===========================
2363
2364 * [Fix IntoIter::as_mut_slice's signature][39466]
2365 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
2366
2367 [39466]: https://github.com/rust-lang/rust/pull/39466
2368 [39523]: https://github.com/rust-lang/rust/pull/39523
2369
2370
2371 Version 1.15.0 (2017-02-02)
2372 ===========================
2373
2374 Language
2375 --------
2376
2377 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
2378   stable. This allows popular code-generating crates like Serde and Diesel to
2379   work ergonomically. [RFC 1681].
2380 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
2381   with curly braces][36868]. Part of [RFC 1506].
2382 * [A number of minor changes to name resolution have been activated][37127].
2383   They add up to more consistent semantics, allowing for future evolution of
2384   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2385   details of what is different. The breaking changes here have been transitioned
2386   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2387 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
2388   bounds][38279]
2389 * [`?Sized` can be used in `where` clauses][37791]
2390 * [There is now a limit on the size of monomorphized types and it can be
2391   modified with the `#![type_size_limit]` crate attribute, similarly to
2392   the `#![recursion_limit]` attribute][37789]
2393
2394 Compiler
2395 --------
2396
2397 * [On Windows, the compiler will apply dllimport attributes when linking to
2398   extern functions][37973]. Additional attributes and flags can control which
2399   library kind is linked and its name. [RFC 1717].
2400 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2401 * [The `--test` flag works with procedural macro crates][38107]
2402 * [Fix `extern "aapcs" fn` ABI][37814]
2403 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
2404 * [The `format!` expander recognizes incorrect `printf` and shell-style
2405   formatting directives and suggests the correct format][37613].
2406 * [Only report one error for all unused imports in an import list][37456]
2407
2408 Compiler Performance
2409 --------------------
2410
2411 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
2412 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
2413 * [Don't clone in `UnificationTable::probe`][37848]
2414 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
2415 * [Use small vectors in type walker][37760]
2416 * [Macro expansion performance was improved][37701]
2417 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
2418 * [Replace FNV with a faster hash function][37229]
2419
2420 Stabilized APIs
2421 ---------------
2422
2423 * [`std::iter::Iterator::min_by`]
2424 * [`std::iter::Iterator::max_by`]
2425 * [`std::os::*::fs::FileExt`]
2426 * [`std::sync::atomic::Atomic*::get_mut`]
2427 * [`std::sync::atomic::Atomic*::into_inner`]
2428 * [`std::vec::IntoIter::as_slice`]
2429 * [`std::vec::IntoIter::as_mut_slice`]
2430 * [`std::sync::mpsc::Receiver::try_iter`]
2431 * [`std::os::unix::process::CommandExt::before_exec`]
2432 * [`std::rc::Rc::strong_count`]
2433 * [`std::rc::Rc::weak_count`]
2434 * [`std::sync::Arc::strong_count`]
2435 * [`std::sync::Arc::weak_count`]
2436 * [`std::char::encode_utf8`]
2437 * [`std::char::encode_utf16`]
2438 * [`std::cell::Ref::clone`]
2439 * [`std::io::Take::into_inner`]
2440
2441 Libraries
2442 ---------
2443
2444 * [The standard sorting algorithm has been rewritten for dramatic performance
2445   improvements][38192]. It is a hybrid merge sort, drawing influences from
2446   Timsort. Previously it was a naive merge sort.
2447 * [`Iterator::nth` no longer has a `Sized` bound][38134]
2448 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
2449   performance.
2450 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
2451   and `char_indices().last()`][37882]
2452 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
2453 * [Chinese characters display correctly in `fmt::Debug`][37855]
2454 * [Derive `Default` for `Duration`][37699]
2455 * [Support creation of anonymous pipes on WinXP/2k][37677]
2456 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
2457 * [Don't pass overlapped handles to processes][38835]
2458
2459 Cargo
2460 -----
2461
2462 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2463   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2464   should instead check the variable at runtime with `std::env`. That the value
2465   was set at build time was a bug, and incorrect when cross-compiling. This
2466   change is known to cause breakage.
2467 * [Add `--all` flag to `cargo test`][cargo/3221]
2468 * [Compile statically against the MSVC CRT][cargo/3363]
2469 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
2470 * [Link OpenSSL statically on OSX][cargo/3311]
2471 * [Apply new fingerprinting to build dir outputs][cargo/3310]
2472 * [Test for bad path overrides with summaries][cargo/3336]
2473 * [Require `cargo install --vers` to take a semver version][cargo/3338]
2474 * [Fix retrying crate downloads for network errors][cargo/3348]
2475 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
2476 * [Emit more info on --message-format=json][cargo/3319]
2477 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
2478 * [Don't ignore errors in workspace manifest][cargo/3409]
2479 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
2480
2481 Tooling
2482 -------
2483
2484 * [Test runners (binaries built with `--test`) now support a `--list` argument
2485   that lists the tests it contains][38185]
2486 * [Test runners now support a `--exact` argument that makes the test filter
2487   match exactly, instead of matching only a substring of the test name][38181]
2488 * [rustdoc supports a `--playground-url` flag][37763]
2489 * [rustdoc provides more details about `#[should_panic]` errors][37749]
2490
2491 Misc
2492 ----
2493
2494 * [The Rust build system is now written in Rust][37817]. The Makefiles may
2495   continue to be used in this release by passing `--disable-rustbuild` to the
2496   configure script, but they will be deleted soon. Note that the new build
2497   system uses a different on-disk layout that will likely affect any scripts
2498   building Rust.
2499 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
2500   releases.
2501 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
2502 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
2503   releases.
2504
2505 Compatibility Notes
2506 -------------------
2507
2508 * [A number of minor changes to name resolution have been activated][37127].
2509   They add up to more consistent semantics, allowing for future evolution of
2510   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
2511   details of what is different. The breaking changes here have been transitioned
2512   through the [`legacy_imports`] lint since 1.14, with no known regressions.
2513 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
2514   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
2515   should instead check the variable at runtime with `std::env`. That the value
2516   was set at build time was a bug, and incorrect when cross-compiling. This
2517   change is known to cause breakage.
2518 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
2519   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
2520   1.10 and is now an error by default. It will become a hard error in the near
2521   future.
2522 * [The semantics relating modules to file system directories are changing in
2523   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
2524   lint, which is a warning in this release, and will become a hard error in the
2525   future.
2526 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
2527 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
2528   the underlying iterator][37834]
2529
2530 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
2531 [33685]: https://github.com/rust-lang/rust/issues/33685
2532 [36868]: https://github.com/rust-lang/rust/pull/36868
2533 [37127]: https://github.com/rust-lang/rust/pull/37127
2534 [37229]: https://github.com/rust-lang/rust/pull/37229
2535 [37456]: https://github.com/rust-lang/rust/pull/37456
2536 [37527]: https://github.com/rust-lang/rust/pull/37527
2537 [37602]: https://github.com/rust-lang/rust/pull/37602
2538 [37613]: https://github.com/rust-lang/rust/pull/37613
2539 [37615]: https://github.com/rust-lang/rust/pull/37615
2540 [37636]: https://github.com/rust-lang/rust/pull/37636
2541 [37627]: https://github.com/rust-lang/rust/pull/37627
2542 [37642]: https://github.com/rust-lang/rust/pull/37642
2543 [37677]: https://github.com/rust-lang/rust/pull/37677
2544 [37699]: https://github.com/rust-lang/rust/pull/37699
2545 [37701]: https://github.com/rust-lang/rust/pull/37701
2546 [37705]: https://github.com/rust-lang/rust/pull/37705
2547 [37749]: https://github.com/rust-lang/rust/pull/37749
2548 [37760]: https://github.com/rust-lang/rust/pull/37760
2549 [37763]: https://github.com/rust-lang/rust/pull/37763
2550 [37764]: https://github.com/rust-lang/rust/pull/37764
2551 [37789]: https://github.com/rust-lang/rust/pull/37789
2552 [37791]: https://github.com/rust-lang/rust/pull/37791
2553 [37814]: https://github.com/rust-lang/rust/pull/37814
2554 [37817]: https://github.com/rust-lang/rust/pull/37817
2555 [37834]: https://github.com/rust-lang/rust/pull/37834
2556 [37848]: https://github.com/rust-lang/rust/pull/37848
2557 [37855]: https://github.com/rust-lang/rust/pull/37855
2558 [37882]: https://github.com/rust-lang/rust/pull/37882
2559 [37888]: https://github.com/rust-lang/rust/pull/37888
2560 [37973]: https://github.com/rust-lang/rust/pull/37973
2561 [37979]: https://github.com/rust-lang/rust/pull/37979
2562 [38086]: https://github.com/rust-lang/rust/pull/38086
2563 [38107]: https://github.com/rust-lang/rust/pull/38107
2564 [38117]: https://github.com/rust-lang/rust/pull/38117
2565 [38134]: https://github.com/rust-lang/rust/pull/38134
2566 [38146]: https://github.com/rust-lang/rust/pull/38146
2567 [38181]: https://github.com/rust-lang/rust/pull/38181
2568 [38182]: https://github.com/rust-lang/rust/pull/38182
2569 [38185]: https://github.com/rust-lang/rust/pull/38185
2570 [38192]: https://github.com/rust-lang/rust/pull/38192
2571 [38279]: https://github.com/rust-lang/rust/pull/38279
2572 [38835]: https://github.com/rust-lang/rust/pull/38835
2573 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2574 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
2575 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
2576 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
2577 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
2578 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
2579 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
2580 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
2581 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
2582 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
2583 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
2584 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
2585 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
2586 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
2587 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
2588 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
2589 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
2590 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
2591 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
2592 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
2593 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
2594 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
2595 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
2596 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
2597 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
2598 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
2599 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
2600 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
2601 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
2602 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
2603 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
2604 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
2605 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
2606 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
2607 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
2608 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
2609 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
2610 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
2611
2612
2613 Version 1.14.0 (2016-12-22)
2614 ===========================
2615
2616 Language
2617 --------
2618
2619 * [`..` matches multiple tuple fields in enum variants, structs
2620   and tuples][36843]. [RFC 1492].
2621 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
2622 * [`use *` and `use ::*` both glob-import from the crate root][37367]
2623 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
2624   dereferencing][36822]
2625
2626 Compiler
2627 --------
2628
2629 * [Mark enums with non-zero discriminant as non-zero][37224]
2630 * [Lower-case `static mut` names are linted like other
2631   statics and consts][37162]
2632 * [Fix ICE on some macros in const integer positions
2633    (e.g. `[u8; m!()]`)][36819]
2634 * [Improve error message and snippet for "did you mean `x`"][36798]
2635 * [Add a panic-strategy field to the target specification][36794]
2636 * [Include LLVM version in `--version --verbose`][37200]
2637
2638 Compile-time Optimizations
2639 --------------------------
2640
2641 * [Improve macro expansion performance][37569]
2642 * [Shrink `Expr_::ExprInlineAsm`][37445]
2643 * [Replace all uses of SHA-256 with BLAKE2b][37439]
2644 * [Reduce the number of bytes hashed by `IchHasher`][37427]
2645 * [Avoid more allocations when compiling html5ever][37373]
2646 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
2647 * [Avoid some allocations in the macro parser][37318]
2648 * [Use a faster deflate setting][37298]
2649 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
2650   during interning of slices][37270]
2651 * [Optimize `write_metadata`][37267]
2652 * [Don't process obligation forest cycles when stalled][37231]
2653 * [Avoid many `CrateConfig` clones][37161]
2654 * [Optimize `Substs::super_fold_with`][37108]
2655 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
2656 * [Speed up `plug_leaks`][36917]
2657
2658 Libraries
2659 ---------
2660
2661 * [`println!()`, with no arguments, prints newline][36825].
2662   Previously, an empty string was required to achieve the same.
2663 * [`Wrapping` impls standard binary and unary operators, as well as
2664    the `Sum` and `Product` iterators][37356]
2665 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
2666   Vec<T>`][37326]
2667 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
2668   `VecDeque` iterators][37315]
2669 * [Improve `SipHasher` performance on small values][37312]
2670 * [Add Iterator trait TrustedLen to enable better FromIterator /
2671   Extend][37306]
2672 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
2673 * [`ReadDir` implements `Debug`][37221]
2674 * [Implement `RefUnwindSafe` for atomic types][37178]
2675 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
2676 * [Avoid allocations in `Decoder::read_str`][37064]
2677 * [`io::Error` implements `From<io::ErrorKind>`][37037]
2678 * [Impl `Debug` for raw pointers to unsized data][36880]
2679 * [Don't reuse `HashMap` random seeds][37470]
2680 * [The internal memory layout of `HashMap` is more cache-friendly, for
2681   significant improvements in some operations][36692]
2682 * [`HashMap` uses less memory on 32-bit architectures][36595]
2683 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
2684
2685 Cargo
2686 -----
2687
2688 * [Expose rustc cfg values to build scripts][cargo/3243]
2689 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
2690 * [Fix passing --features when testing multiple packages][cargo/3280]
2691 * [Use a single profile set per workspace][cargo/3249]
2692 * [Load `replace` sections from lock files][cargo/3220]
2693 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
2694
2695 Tooling
2696 -------
2697
2698 * [rustup is the recommended Rust installation method][1.14rustup]
2699 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
2700   S390x. These are [tier 2] platforms and may have major defects. Follow the
2701   instructions on the website to install, or add the targets to an existing
2702   installation with `rustup target add`. The new target triples are:
2703   - `mips-unknown-linux-gnu`
2704   - `mipsel-unknown-linux-gnu`
2705   - `mips64-unknown-linux-gnuabi64`
2706   - `mips64el-unknown-linux-gnuabi64 `
2707   - `powerpc-unknown-linux-gnu`
2708   - `powerpc64-unknown-linux-gnu`
2709   - `powerpc64le-unknown-linux-gnu`
2710   - `s390x-unknown-linux-gnu `
2711 * This release includes target (std) builds for ARM Linux running MUSL
2712   libc. These are [tier 2] platforms and may have major defects. Add the
2713   following triples to an existing rustup installation with `rustup target add`:
2714   - `arm-unknown-linux-musleabi`
2715   - `arm-unknown-linux-musleabihf`
2716   - `armv7-unknown-linux-musleabihf`
2717 * This release includes [experimental support for WebAssembly][1.14wasm], via
2718   the `wasm32-unknown-emscripten` target. This target is known to have major
2719   defects. Please test, report, and fix.
2720 * rustup no longer installs documentation by default. Run `rustup
2721   component add rust-docs` to install.
2722 * [Fix line stepping in debugger][37310]
2723 * [Enable line number debuginfo in releases][37280]
2724
2725 Misc
2726 ----
2727
2728 * [Disable jemalloc on aarch64/powerpc/mips][37392]
2729 * [Add support for Fuchsia OS][37313]
2730 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
2731
2732 Compatibility Notes
2733 -------------------
2734
2735 * [A number of forward-compatibility lints used by the compiler
2736   to gradually introduce language changes have been converted
2737   to deny by default][36894]:
2738   - ["use of inaccessible extern crate erroneously allowed"][36886]
2739   - ["type parameter default erroneously allowed in invalid location"][36887]
2740   - ["detects super or self keywords at the beginning of global path"][36888]
2741   - ["two overlapping inherent impls define an item with the same name
2742     were erroneously allowed"][36889]
2743   - ["floating-point constants cannot be used in patterns"][36890]
2744   - ["constants of struct or enum type can only be used in a pattern if
2745      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
2746   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
2747 * [Prohibit patterns in trait methods without bodies][37378]
2748 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
2749 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
2750 * [The `$crate` macro variable is accepted in fewer locations][37213]
2751 * [Impls specifying extra region requirements beyond the trait
2752   they implement are rejected][37167]
2753 * [Enums may not be unsized][37111]. Unsized enums are intended to
2754   work but never have. For now they are forbidden.
2755 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
2756
2757 [tier 2]: https://forge.rust-lang.org/platform-support.html
2758 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
2759 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
2760 [36430]: https://github.com/rust-lang/rust/pull/36430
2761 [36595]: https://github.com/rust-lang/rust/pull/36595
2762 [36595]: https://github.com/rust-lang/rust/pull/36595
2763 [36692]: https://github.com/rust-lang/rust/pull/36692
2764 [36767]: https://github.com/rust-lang/rust/pull/36767
2765 [36794]: https://github.com/rust-lang/rust/pull/36794
2766 [36798]: https://github.com/rust-lang/rust/pull/36798
2767 [36819]: https://github.com/rust-lang/rust/pull/36819
2768 [36822]: https://github.com/rust-lang/rust/pull/36822
2769 [36825]: https://github.com/rust-lang/rust/pull/36825
2770 [36843]: https://github.com/rust-lang/rust/pull/36843
2771 [36880]: https://github.com/rust-lang/rust/pull/36880
2772 [36886]: https://github.com/rust-lang/rust/issues/36886
2773 [36887]: https://github.com/rust-lang/rust/issues/36887
2774 [36888]: https://github.com/rust-lang/rust/issues/36888
2775 [36889]: https://github.com/rust-lang/rust/issues/36889
2776 [36890]: https://github.com/rust-lang/rust/issues/36890
2777 [36891]: https://github.com/rust-lang/rust/issues/36891
2778 [36892]: https://github.com/rust-lang/rust/issues/36892
2779 [36894]: https://github.com/rust-lang/rust/pull/36894
2780 [36917]: https://github.com/rust-lang/rust/pull/36917
2781 [36993]: https://github.com/rust-lang/rust/pull/36993
2782 [37037]: https://github.com/rust-lang/rust/pull/37037
2783 [37064]: https://github.com/rust-lang/rust/pull/37064
2784 [37094]: https://github.com/rust-lang/rust/pull/37094
2785 [37108]: https://github.com/rust-lang/rust/pull/37108
2786 [37111]: https://github.com/rust-lang/rust/pull/37111
2787 [37161]: https://github.com/rust-lang/rust/pull/37161
2788 [37162]: https://github.com/rust-lang/rust/pull/37162
2789 [37167]: https://github.com/rust-lang/rust/pull/37167
2790 [37178]: https://github.com/rust-lang/rust/pull/37178
2791 [37200]: https://github.com/rust-lang/rust/pull/37200
2792 [37213]: https://github.com/rust-lang/rust/pull/37213
2793 [37221]: https://github.com/rust-lang/rust/pull/37221
2794 [37224]: https://github.com/rust-lang/rust/pull/37224
2795 [37230]: https://github.com/rust-lang/rust/pull/37230
2796 [37231]: https://github.com/rust-lang/rust/pull/37231
2797 [37247]: https://github.com/rust-lang/rust/pull/37247
2798 [37267]: https://github.com/rust-lang/rust/pull/37267
2799 [37270]: https://github.com/rust-lang/rust/pull/37270
2800 [37273]: https://github.com/rust-lang/rust/pull/37273
2801 [37280]: https://github.com/rust-lang/rust/pull/37280
2802 [37298]: https://github.com/rust-lang/rust/pull/37298
2803 [37306]: https://github.com/rust-lang/rust/pull/37306
2804 [37310]: https://github.com/rust-lang/rust/pull/37310
2805 [37312]: https://github.com/rust-lang/rust/pull/37312
2806 [37313]: https://github.com/rust-lang/rust/pull/37313
2807 [37315]: https://github.com/rust-lang/rust/pull/37315
2808 [37318]: https://github.com/rust-lang/rust/pull/37318
2809 [37322]: https://github.com/rust-lang/rust/pull/37322
2810 [37326]: https://github.com/rust-lang/rust/pull/37326
2811 [37351]: https://github.com/rust-lang/rust/pull/37351
2812 [37356]: https://github.com/rust-lang/rust/pull/37356
2813 [37367]: https://github.com/rust-lang/rust/pull/37367
2814 [37373]: https://github.com/rust-lang/rust/pull/37373
2815 [37378]: https://github.com/rust-lang/rust/pull/37378
2816 [37389]: https://github.com/rust-lang/rust/pull/37389
2817 [37392]: https://github.com/rust-lang/rust/pull/37392
2818 [37427]: https://github.com/rust-lang/rust/pull/37427
2819 [37439]: https://github.com/rust-lang/rust/pull/37439
2820 [37445]: https://github.com/rust-lang/rust/pull/37445
2821 [37470]: https://github.com/rust-lang/rust/pull/37470
2822 [37569]: https://github.com/rust-lang/rust/pull/37569
2823 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
2824 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
2825 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
2826 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
2827 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
2828 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
2829 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
2830
2831
2832 Version 1.13.0 (2016-11-10)
2833 ===========================
2834
2835 Language
2836 --------
2837
2838 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
2839   errors, like the `try!` macro, described in [RFC 0243].
2840 * [Stabilize macros in type position][36014]. Described in [RFC 873].
2841 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
2842 * [Fix `#[derive]` for empty tuple structs/variants][35728]
2843 * [Fix lifetime rules for 'if' conditions][36029]
2844 * [Avoid loading and parsing unconfigured non-inline modules][36482]
2845
2846 Compiler
2847 --------
2848
2849 * [Add the `-C link-arg` argument][36574]
2850 * [Remove the old AST-based backend from rustc_trans][35764]
2851 * [Don't enable NEON by default on armv7 Linux][35814]
2852 * [Fix debug line number info for macro expansions][35238]
2853 * [Do not emit "class method" debuginfo for types that are not
2854   DICompositeType][36008]
2855 * [Warn about multiple conflicting #[repr] hints][34623]
2856 * [When sizing DST, don't double-count nested struct prefixes][36351]
2857 * [Default RUST_MIN_STACK to 16MiB for now][36505]
2858 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
2859 * [Reject macros with empty repetitions to avoid infinite loop][36721]
2860 * [Expand macros without recursing to avoid stack overflows][36214]
2861
2862 Diagnostics
2863 -----------
2864
2865 * [Replace macro backtraces with labeled local uses][35702]
2866 * [Improve error message for misplaced doc comments][33922]
2867 * [Buffer unix and lock windows to prevent message interleaving][35975]
2868 * [Update lifetime errors to specifically note temporaries][36171]
2869 * [Special case a few colors for Windows][36178]
2870 * [Suggest `use self` when such an import resolves][36289]
2871 * [Be more specific when type parameter shadows primitive type][36338]
2872 * Many minor improvements
2873
2874 Compile-time Optimizations
2875 --------------------------
2876
2877 * [Compute and cache HIR hashes at beginning][35854]
2878 * [Don't hash types in loan paths][36004]
2879 * [Cache projections in trans][35761]
2880 * [Optimize the parser's last token handling][36527]
2881 * [Only instantiate #[inline] functions in codegen units referencing
2882   them][36524]. This leads to big improvements in cases where crates export
2883   define many inline functions without using them directly.
2884 * [Lazily allocate TypedArena's first chunk][36592]
2885 * [Don't allocate during default HashSet creation][36734]
2886
2887 Stabilized APIs
2888 ---------------
2889
2890 * [`checked_abs`]
2891 * [`wrapping_abs`]
2892 * [`overflowing_abs`]
2893 * [`RefCell::try_borrow`]
2894 * [`RefCell::try_borrow_mut`]
2895
2896 Libraries
2897 ---------
2898
2899 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
2900 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
2901   covariant][35354]
2902 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
2903 * [Implement `Debug` for `std::vec::IntoIter`][35707]
2904 * [`CString`: avoid excessive growth just to 0-terminate][35871]
2905 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
2906 * [Use arc4rand on FreeBSD][35884]
2907 * [memrchr: Correct aligned offset computation][35969]
2908 * [Improve Demangling of Rust Symbols][36059]
2909 * [Use monotonic time in condition variables][35048]
2910 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
2911 * [Implement conversion traits for `char`][35755]
2912 * [Fix illegal instruction caused by overflow in channel cloning][36104]
2913 * [Zero first byte of CString on drop][36264]
2914 * [Inherit overflow checks for sum and product][36372]
2915 * [Add missing Eq implementations][36423]
2916 * [Implement `Debug` for `DirEntry`][36631]
2917 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
2918   `errno`][36754]
2919 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2920 * [Implement more traits for `std::io::ErrorKind`][35911]
2921 * [Optimize BinaryHeap bounds checking][36072]
2922 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
2923   `extend_with_element`][36355]
2924 * [Fix overflow checking in unsigned pow()][34942]
2925
2926 Cargo
2927 -----
2928
2929 * This release includes security fixes to both curl and OpenSSL.
2930 * [Fix transitive doctests when panic=abort][cargo/3021]
2931 * [Add --all-features flag to cargo][cargo/3038]
2932 * [Reject path-based dependencies in `cargo package`][cargo/3060]
2933 * [Don't parse the home directory more than once][cargo/3078]
2934 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
2935 * [Update OpenSSL to 1.0.2j][cargo/3121]
2936 * [Add license and license_file to cargo metadata output][cargo/3110]
2937 * [Make crates-io registry URL optional in config; ignore all changes to
2938   source.crates-io][cargo/3089]
2939 * [Don't download dependencies from other platforms][cargo/3123]
2940 * [Build transitive dev-dependencies when needed][cargo/3125]
2941 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
2942 * [Avoid updating registry when adding existing deps][cargo/3144]
2943 * [Warn about path overrides that won't work][cargo/3136]
2944 * [Use workspaces during `cargo install`][cargo/3146]
2945 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
2946 * [Add --message-format flag][cargo/3000]
2947 * [Pass target environment for rustdoc][cargo/3205]
2948 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
2949 * [Update curl and curl-sys][cargo/3241]
2950 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
2951
2952 Tooling
2953 -------
2954
2955 * [rustdoc: Add the `--sysroot` argument][36586]
2956 * [rustdoc: Fix a couple of issues with the search results][35655]
2957 * [rustdoc: remove the `!` from macro URLs and titles][35234]
2958 * [gdb: Fix pretty-printing special-cased Rust types][35585]
2959 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
2960
2961 Misc
2962 ----
2963
2964 * [Remove unmaintained style guide][35124]
2965 * [Add s390x support][36369]
2966 * [Initial work at Haiku OS support][36727]
2967 * [Add mips-uclibc targets][35734]
2968 * [Crate-ify compiler-rt into compiler-builtins][35021]
2969 * [Add rustc version info (git hash + date) to dist tarball][36213]
2970 * Many documentation improvements
2971
2972 Compatibility Notes
2973 -------------------
2974
2975 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
2976 * [Deny (by default) transmuting from fn item types to pointer-sized
2977   types][34923]. Continuing the long transition to zero-sized fn items,
2978   per [RFC 401].
2979 * [Fix `#[derive]` for empty tuple structs/variants][35728].
2980   Part of [RFC 1506].
2981 * [Issue deprecation warnings for safe accesses to extern statics][36173]
2982 * [Fix lifetime rules for 'if' conditions][36029].
2983 * [Inherit overflow checks for sum and product][36372].
2984 * [Forbid user-defined macros named "macro_rules"][36730].
2985
2986 [33922]: https://github.com/rust-lang/rust/pull/33922
2987 [34623]: https://github.com/rust-lang/rust/pull/34623
2988 [34923]: https://github.com/rust-lang/rust/pull/34923
2989 [34942]: https://github.com/rust-lang/rust/pull/34942
2990 [34982]: https://github.com/rust-lang/rust/pull/34982
2991 [35021]: https://github.com/rust-lang/rust/pull/35021
2992 [35048]: https://github.com/rust-lang/rust/pull/35048
2993 [35074]: https://github.com/rust-lang/rust/pull/35074
2994 [35124]: https://github.com/rust-lang/rust/pull/35124
2995 [35234]: https://github.com/rust-lang/rust/pull/35234
2996 [35238]: https://github.com/rust-lang/rust/pull/35238
2997 [35354]: https://github.com/rust-lang/rust/pull/35354
2998 [35559]: https://github.com/rust-lang/rust/pull/35559
2999 [35585]: https://github.com/rust-lang/rust/pull/35585
3000 [35627]: https://github.com/rust-lang/rust/pull/35627
3001 [35655]: https://github.com/rust-lang/rust/pull/35655
3002 [35702]: https://github.com/rust-lang/rust/pull/35702
3003 [35707]: https://github.com/rust-lang/rust/pull/35707
3004 [35728]: https://github.com/rust-lang/rust/pull/35728
3005 [35734]: https://github.com/rust-lang/rust/pull/35734
3006 [35755]: https://github.com/rust-lang/rust/pull/35755
3007 [35761]: https://github.com/rust-lang/rust/pull/35761
3008 [35764]: https://github.com/rust-lang/rust/pull/35764
3009 [35814]: https://github.com/rust-lang/rust/pull/35814
3010 [35854]: https://github.com/rust-lang/rust/pull/35854
3011 [35871]: https://github.com/rust-lang/rust/pull/35871
3012 [35884]: https://github.com/rust-lang/rust/pull/35884
3013 [35911]: https://github.com/rust-lang/rust/pull/35911
3014 [35969]: https://github.com/rust-lang/rust/pull/35969
3015 [35975]: https://github.com/rust-lang/rust/pull/35975
3016 [36004]: https://github.com/rust-lang/rust/pull/36004
3017 [36008]: https://github.com/rust-lang/rust/pull/36008
3018 [36014]: https://github.com/rust-lang/rust/pull/36014
3019 [36029]: https://github.com/rust-lang/rust/pull/36029
3020 [36059]: https://github.com/rust-lang/rust/pull/36059
3021 [36072]: https://github.com/rust-lang/rust/pull/36072
3022 [36101]: https://github.com/rust-lang/rust/pull/36101
3023 [36104]: https://github.com/rust-lang/rust/pull/36104
3024 [36171]: https://github.com/rust-lang/rust/pull/36171
3025 [36173]: https://github.com/rust-lang/rust/pull/36173
3026 [36178]: https://github.com/rust-lang/rust/pull/36178
3027 [36213]: https://github.com/rust-lang/rust/pull/36213
3028 [36214]: https://github.com/rust-lang/rust/pull/36214
3029 [36264]: https://github.com/rust-lang/rust/pull/36264
3030 [36266]: https://github.com/rust-lang/rust/pull/36266
3031 [36289]: https://github.com/rust-lang/rust/pull/36289
3032 [36338]: https://github.com/rust-lang/rust/pull/36338
3033 [36351]: https://github.com/rust-lang/rust/pull/36351
3034 [36355]: https://github.com/rust-lang/rust/pull/36355
3035 [36369]: https://github.com/rust-lang/rust/pull/36369
3036 [36372]: https://github.com/rust-lang/rust/pull/36372
3037 [36423]: https://github.com/rust-lang/rust/pull/36423
3038 [36482]: https://github.com/rust-lang/rust/pull/36482
3039 [36505]: https://github.com/rust-lang/rust/pull/36505
3040 [36524]: https://github.com/rust-lang/rust/pull/36524
3041 [36527]: https://github.com/rust-lang/rust/pull/36527
3042 [36551]: https://github.com/rust-lang/rust/pull/36551
3043 [36574]: https://github.com/rust-lang/rust/pull/36574
3044 [36586]: https://github.com/rust-lang/rust/pull/36586
3045 [36592]: https://github.com/rust-lang/rust/pull/36592
3046 [36631]: https://github.com/rust-lang/rust/pull/36631
3047 [36639]: https://github.com/rust-lang/rust/pull/36639
3048 [36721]: https://github.com/rust-lang/rust/pull/36721
3049 [36727]: https://github.com/rust-lang/rust/pull/36727
3050 [36730]: https://github.com/rust-lang/rust/pull/36730
3051 [36734]: https://github.com/rust-lang/rust/pull/36734
3052 [36754]: https://github.com/rust-lang/rust/pull/36754
3053 [36995]: https://github.com/rust-lang/rust/pull/36995
3054 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
3055 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
3056 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3057 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3058 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
3059 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
3060 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
3061 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
3062 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
3063 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
3064 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
3065 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
3066 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
3067 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
3068 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
3069 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
3070 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
3071 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
3072 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
3073 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
3074 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
3075 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
3076 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
3077 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
3078 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
3079 [rustup]: https://www.rustup.rs
3080 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
3081 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
3082 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
3083 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
3084 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
3085 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
3086 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
3087
3088
3089 Version 1.12.1 (2016-10-20)
3090 ===========================
3091
3092 Regression Fixes
3093 ----------------
3094
3095 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
3096 * [Confusion with double negation and booleans][36856]
3097 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
3098 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
3099 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
3100 * [Corrupted memory after updated to 1.12][36936]
3101 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
3102 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
3103 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
3104
3105 [36381]: https://github.com/rust-lang/rust/issues/36381
3106 [36856]: https://github.com/rust-lang/rust/issues/36856
3107 [36875]: https://github.com/rust-lang/rust/issues/36875
3108 [36924]: https://github.com/rust-lang/rust/issues/36924
3109 [36926]: https://github.com/rust-lang/rust/issues/36926
3110 [36936]: https://github.com/rust-lang/rust/issues/36936
3111 [37026]: https://github.com/rust-lang/rust/issues/37026
3112 [37112]: https://github.com/rust-lang/rust/issues/37112
3113 [37153]: https://github.com/rust-lang/rust/issues/37153
3114
3115
3116 Version 1.12.0 (2016-09-29)
3117 ===========================
3118
3119 Highlights
3120 ----------
3121
3122 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3123   This translation pass is far simpler than the previous AST->LLVM pass, and
3124   creates opportunities to perform new optimizations directly on the MIR. It
3125   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3126 * [`rustc` presents a new, more readable error format, along with
3127   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3128   Most common editors supporting Rust have been updated to work with it. It was
3129   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3130
3131 Compiler
3132 --------
3133
3134 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
3135   This translation pass is far simpler than the previous AST->LLVM pass, and
3136   creates opportunities to perform new optimizations directly on the MIR. It
3137   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
3138 * [Print the Rust target name, not the LLVM target name, with
3139   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
3140 * [The computation of `TypeId` is correct in some cases where it was previously
3141   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
3142 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
3143 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
3144   `--print relocation-models`, and `--print code-models` print the available
3145   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
3146   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
3147 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
3148   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
3149   These targets produce statically-linked binaries. There are no binary release
3150   builds yet though.
3151
3152 Diagnostics
3153 -----------
3154
3155 * [`rustc` presents a new, more readable error format, along with
3156   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
3157   Most common editors supporting Rust have been updated to work with it. It was
3158   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
3159 * [In error descriptions, references are now described in plain English,
3160   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
3161 * [In error type descriptions, unknown numeric types are named `{integer}` or
3162   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
3163 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
3164
3165 Language
3166 --------
3167
3168 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
3169 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
3170 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
3171   useful](https://github.com/rust-lang/rust/pull/34908)
3172 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
3173   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
3174 * [Semicolons are properly required as statement delimiters inside
3175   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
3176 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3177
3178 Stabilized APIs
3179 ---------------
3180
3181 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
3182 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
3183 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
3184 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
3185 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
3186 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
3187 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
3188 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
3189 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
3190 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
3191   Both on Unix and Windows.
3192 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
3193 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
3194 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
3195 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
3196 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
3197 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
3198 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
3199 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
3200
3201 Libraries
3202 ---------
3203
3204 * [The `format!` macro and friends now allow a single argument to be formatted
3205   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
3206 * [The lifetime bounds on `[T]::binary_search_by` and
3207   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
3208 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
3209 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
3210 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
3211 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
3212 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
3213 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
3214 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
3215 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
3216   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
3217 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
3218   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
3219 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
3220 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
3221   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
3222 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
3223 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
3224 * [`mpsc::sync_channel` `Receiver`s return any available message before
3225   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
3226 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
3227 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
3228
3229 Cargo
3230 -----
3231
3232 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
3233 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
3234 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
3235 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
3236 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
3237 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
3238 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
3239 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
3240 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
3241 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
3242 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
3243 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
3244 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
3245 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
3246 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
3247 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
3248
3249 Performance
3250 -----------
3251
3252 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
3253 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
3254
3255 Tooling
3256 -------
3257
3258 * [Test binaries now support a `--test-threads` argument to specify the number
3259   of threads used to run tests, and which acts the same as the
3260   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
3261 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
3262 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
3263 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3264 * [Rust releases now come with source packages that can be installed by rustup
3265   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
3266   The resulting source code can be used by tools and IDES, located in the
3267   sysroot under `lib/rustlib/src`.
3268
3269 Misc
3270 ----
3271
3272 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
3273 * Many minor improvements to the documentation.
3274 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
3275
3276 Compatibility Notes
3277 -------------------
3278
3279 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
3280   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
3281 * [When formatting strings, if "precision" is specified, the "fill",
3282   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
3283 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
3284
3285
3286 Version 1.11.0 (2016-08-18)
3287 ===========================
3288
3289 Language
3290 --------
3291
3292 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
3293 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
3294 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
3295 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
3296 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
3297
3298 Stabilized APIs
3299 ---------------
3300
3301 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
3302 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
3303 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
3304 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
3305 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
3306 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
3307   (in libcore - previously stabilized in libstd)
3308 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
3309   (in libcore - previously stabilized in libstd)
3310 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
3311   (in libcore - previously stabilized in libstd)
3312 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
3313   (in libcore - previously stabilized in libstd)
3314 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3315 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
3316 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
3317 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
3318
3319 Libraries
3320 ---------
3321
3322 * [The `thread_local!` macro supports multiple definitions in a single
3323    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
3324 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
3325 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
3326   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
3327 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
3328 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
3329 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
3330 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
3331
3332 Cargo
3333 -----
3334
3335 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
3336 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
3337 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
3338 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
3339 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
3340   and `-vv` prints warnings for all crates.
3341 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
3342 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
3343   This provides room for expansion by arbitrary tools.
3344 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
3345 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
3346 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
3347 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
3348 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
3349 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
3350 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
3351
3352 Performance
3353 -----------
3354
3355 * [Caching projections speeds up type check dramatically for some
3356   workloads](https://github.com/rust-lang/rust/pull/33816)
3357 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
3358   This hasher is faster, but is believed to provide sufficient
3359   protection from collision attacks.
3360 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
3361
3362 Rustdoc
3363 -------
3364
3365 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
3366 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
3367 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
3368 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
3369 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
3370
3371 Tooling
3372 -------
3373
3374 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
3375 * [When emitting debug info, rustc emits frame pointers for closures,
3376   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
3377 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
3378 * Many more errors have been given error codes and extended
3379   explanations
3380 * API documentation continues to be improved, with many new examples
3381
3382 Misc
3383 ----
3384
3385 * [rustc no longer hangs when dependencies recursively re-export
3386   submodules](https://github.com/rust-lang/rust/pull/34542)
3387 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
3388 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
3389   rewritten](https://github.com/rust-lang/rust/pull/33895)
3390 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
3391   No targets use this yet, but it works toward AVR support.
3392
3393 Compatibility Notes
3394 -------------------
3395
3396 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
3397 * [The new follow-set rules that place restrictions on `macro_rules!`
3398   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
3399   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
3400   and has been a warning since 1.10.
3401 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
3402   This causes breakage in some corner cases.
3403
3404
3405 Version 1.10.0 (2016-07-07)
3406 ===========================
3407
3408 Language
3409 --------
3410
3411 * [Allow `concat_idents!` in type positions as well as in expression
3412   positions](https://github.com/rust-lang/rust/pull/33735).
3413 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
3414   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
3415 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
3416 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
3417 * [`panic!` can be converted to a runtime abort with the
3418   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
3419   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3420 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
3421   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
3422   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
3423   Note that Cargo does not yet directly support cdylibs.
3424
3425 Stabilized APIs
3426 ---------------
3427
3428 * `os::windows::fs::OpenOptionsExt::access_mode`
3429 * `os::windows::fs::OpenOptionsExt::share_mode`
3430 * `os::windows::fs::OpenOptionsExt::custom_flags`
3431 * `os::windows::fs::OpenOptionsExt::attributes`
3432 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
3433 * `os::unix::fs::OpenOptionsExt::custom_flags`
3434 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
3435 * `Default for sync::Weak`
3436 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
3437 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
3438 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
3439 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
3440 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
3441 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
3442 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
3443 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
3444 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
3445 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
3446 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
3447 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
3448 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
3449 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
3450 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
3451 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
3452 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
3453 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
3454 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
3455 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
3456 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
3457 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
3458 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
3459 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
3460 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
3461 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3462 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3463 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
3464 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
3465 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
3466 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
3467 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
3468 * Read/Write/RawFd impls for `UnixStream`
3469 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
3470 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
3471 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
3472 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
3473 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
3474 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
3475 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
3476 * RawFd impls for `UnixListener`
3477 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
3478 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
3479 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
3480 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
3481 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
3482 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
3483 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
3484 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
3485 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
3486 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
3487 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
3488 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
3489 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
3490 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
3491 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
3492 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
3493 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
3494 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
3495 * RawFd impls for `UnixDatagram`
3496 * `{BTree,Hash}Map::values_mut`
3497 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
3498
3499 Libraries
3500 ---------
3501
3502 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
3503   The semantics of this minor method are subtle and probably not what
3504   most people want.
3505 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
3506 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
3507   will fall back to `/dev/urandom` temporarily to avoid blocking
3508   during early boot](https://github.com/rust-lang/rust/pull/33086).
3509 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
3510 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
3511 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
3512 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
3513 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
3514 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
3515   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
3516
3517 Cargo
3518 -----
3519 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
3520   This controls the runtime behavior of the `panic!` macro
3521   and can be either "unwind" (the default), or "abort".
3522   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
3523 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
3524 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
3525 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
3526   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
3527 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
3528 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
3529 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
3530   By default they are retried twice, which can be customized with the
3531   `net.retry` value in `.cargo/config`.
3532 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
3533 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
3534 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
3535 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
3536   Makes it possible to install multiple crates in parallel.
3537 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
3538 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
3539 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
3540 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
3541 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
3542 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
3543
3544 Performance
3545 -----------
3546
3547 * [rustc memory usage was reduced by refactoring the context used for
3548   type checking](https://github.com/rust-lang/rust/pull/33425).
3549 * [Speed up creation of `HashMap`s by caching the random keys used
3550   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
3551 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
3552 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
3553 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
3554   10x faster than the previous lookup tables.
3555 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
3556
3557 Usability
3558 ---------
3559
3560 * Many incremental improvements to documentation and rustdoc.
3561 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
3562 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
3563 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
3564 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
3565 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
3566 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
3567 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
3568
3569 Misc
3570 ----
3571
3572 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
3573 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
3574 * [`std` no longer prints backtraces on platforms where the running
3575   module must be loaded with `env::current_exe`, which can't be relied
3576   on](https://github.com/rust-lang/rust/pull/33554).
3577 * This release includes std binaries for the i586-unknown-linux-gnu,
3578   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
3579   i586 target is for old x86 hardware without SSE2, and the armv7
3580   target is for Android running on modern ARM architectures.
3581 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
3582   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
3583 * [On Unix the runtime aborts by calling `libc::abort` instead of
3584   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
3585 * [Rust is now bootstrapped from the previous release of Rust,
3586   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
3587
3588 Compatibility Notes
3589 -------------------
3590
3591 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
3592 * [`target_env` for Linux ARM targets is just `gnu`, not
3593   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
3594 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
3595 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
3596 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
3597   Affects how macros are parsed.
3598 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
3599 * [Feature-gated attributes on macro-generated macro invocations are
3600   now rejected](https://github.com/rust-lang/rust/pull/32791).
3601 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
3602   This caused some minor changes to type inference.
3603
3604
3605 Version 1.9.0 (2016-05-26)
3606 ==========================
3607
3608 Language
3609 --------
3610
3611 * The `#[deprecated]` attribute when applied to an API will generate
3612   warnings when used. The warnings may be suppressed with
3613   `#[allow(deprecated)]`. [RFC 1270].
3614 * [`fn` item types are zero sized, and each `fn` names a unique
3615   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3616   `transmute` on a `fn` type will generate a warning for a few cycles,
3617   then will be converted to an error.
3618 * [Field and method resolution understand visibility, so private
3619   fields and methods cannot prevent the proper use of public fields
3620   and methods][1.9fv].
3621 * [The parser considers unicode codepoints in the
3622   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
3623
3624 Stabilized APIs
3625 ---------------
3626
3627 * [`std::panic`]
3628 * [`std::panic::catch_unwind`][] (renamed from `recover`)
3629 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
3630 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
3631 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
3632 * [`str::is_char_boundary`]
3633 * [`<*const T>::as_ref`]
3634 * [`<*mut T>::as_ref`]
3635 * [`<*mut T>::as_mut`]
3636 * [`AsciiExt::make_ascii_uppercase`]
3637 * [`AsciiExt::make_ascii_lowercase`]
3638 * [`char::decode_utf16`]
3639 * [`char::DecodeUtf16`]
3640 * [`char::DecodeUtf16Error`]
3641 * [`char::DecodeUtf16Error::unpaired_surrogate`]
3642 * [`BTreeSet::take`]
3643 * [`BTreeSet::replace`]
3644 * [`BTreeSet::get`]
3645 * [`HashSet::take`]
3646 * [`HashSet::replace`]
3647 * [`HashSet::get`]
3648 * [`OsString::with_capacity`]
3649 * [`OsString::clear`]
3650 * [`OsString::capacity`]
3651 * [`OsString::reserve`]
3652 * [`OsString::reserve_exact`]
3653 * [`OsStr::is_empty`]
3654 * [`OsStr::len`]
3655 * [`std::os::unix::thread`]
3656 * [`RawPthread`]
3657 * [`JoinHandleExt`]
3658 * [`JoinHandleExt::as_pthread_t`]
3659 * [`JoinHandleExt::into_pthread_t`]
3660 * [`HashSet::hasher`]
3661 * [`HashMap::hasher`]
3662 * [`CommandExt::exec`]
3663 * [`File::try_clone`]
3664 * [`SocketAddr::set_ip`]
3665 * [`SocketAddr::set_port`]
3666 * [`SocketAddrV4::set_ip`]
3667 * [`SocketAddrV4::set_port`]
3668 * [`SocketAddrV6::set_ip`]
3669 * [`SocketAddrV6::set_port`]
3670 * [`SocketAddrV6::set_flowinfo`]
3671 * [`SocketAddrV6::set_scope_id`]
3672 * [`slice::copy_from_slice`]
3673 * [`ptr::read_volatile`]
3674 * [`ptr::write_volatile`]
3675 * [`OpenOptions::create_new`]
3676 * [`TcpStream::set_nodelay`]
3677 * [`TcpStream::nodelay`]
3678 * [`TcpStream::set_ttl`]
3679 * [`TcpStream::ttl`]
3680 * [`TcpStream::set_only_v6`]
3681 * [`TcpStream::only_v6`]
3682 * [`TcpStream::take_error`]
3683 * [`TcpStream::set_nonblocking`]
3684 * [`TcpListener::set_ttl`]
3685 * [`TcpListener::ttl`]
3686 * [`TcpListener::set_only_v6`]
3687 * [`TcpListener::only_v6`]
3688 * [`TcpListener::take_error`]
3689 * [`TcpListener::set_nonblocking`]
3690 * [`UdpSocket::set_broadcast`]
3691 * [`UdpSocket::broadcast`]
3692 * [`UdpSocket::set_multicast_loop_v4`]
3693 * [`UdpSocket::multicast_loop_v4`]
3694 * [`UdpSocket::set_multicast_ttl_v4`]
3695 * [`UdpSocket::multicast_ttl_v4`]
3696 * [`UdpSocket::set_multicast_loop_v6`]
3697 * [`UdpSocket::multicast_loop_v6`]
3698 * [`UdpSocket::set_multicast_ttl_v6`]
3699 * [`UdpSocket::multicast_ttl_v6`]
3700 * [`UdpSocket::set_ttl`]
3701 * [`UdpSocket::ttl`]
3702 * [`UdpSocket::set_only_v6`]
3703 * [`UdpSocket::only_v6`]
3704 * [`UdpSocket::join_multicast_v4`]
3705 * [`UdpSocket::join_multicast_v6`]
3706 * [`UdpSocket::leave_multicast_v4`]
3707 * [`UdpSocket::leave_multicast_v6`]
3708 * [`UdpSocket::take_error`]
3709 * [`UdpSocket::connect`]
3710 * [`UdpSocket::send`]
3711 * [`UdpSocket::recv`]
3712 * [`UdpSocket::set_nonblocking`]
3713
3714 Libraries
3715 ---------
3716
3717 * [`std::sync::Once` is poisoned if its initialization function
3718   fails][1.9o].
3719 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
3720 * [Most types implement `fmt::Debug`][1.9db].
3721 * [The default buffer size used by `BufReader` and `BufWriter` was
3722   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
3723   used by other languages.
3724 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
3725   `Duration` additionally implements `*=` and `/=`][1.9ta].
3726 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
3727 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
3728 * [`Chain` implements `BufRead`][1.9ch].
3729 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
3730
3731 Cargo
3732 -----
3733
3734 * [Cargo can now run concurrently][1.9cc].
3735 * [Top-level overrides allow specific revisions of crates to be
3736   overridden through the entire crate graph][1.9ct].  This is intended
3737   to make upgrades easier for large projects, by allowing crates to be
3738   forked temporarily until they've been upgraded and republished.
3739 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
3740 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
3741   on the commandline][1.9cf]. `rustc` arguments can also be specified
3742   in the `build.rustflags` configuration key.
3743
3744 Performance
3745 -----------
3746
3747 * [The time complexity of comparing variables for equivalence during type
3748   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
3749   to major compilation time improvement in some scenarios.
3750 * [`ToString` is specialized for `str`, giving it the same performance
3751   as `to_owned`][1.9ts].
3752 * [Spawning processes with `Command::output` no longer creates extra
3753   threads][1.9sp].
3754 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
3755   for C-like enums][1.9cl].
3756
3757 Misc
3758 ----
3759
3760 * [Passing the `--quiet` flag to a test runner will produce
3761   much-abbreviated output][1.9q].
3762 * The Rust Project now publishes std binaries for the
3763   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
3764   `i586-pc-windows-msvc` targets.
3765
3766 Compatibility Notes
3767 -------------------
3768
3769 * [`std::sync::Once` is poisoned if its initialization function
3770   fails][1.9o].
3771 * [It is illegal to define methods with the same name in overlapping
3772   inherent `impl` blocks][1.9sn].
3773 * [`fn` item types are zero sized, and each `fn` names a unique
3774   type][1.9fn]. This will break code that transmutes `fn`s, so calling
3775   `transmute` on a `fn` type will generate a warning for a few cycles,
3776   then will be converted to an error.
3777 * [Improvements to const evaluation may trigger new errors when integer
3778   literals are out of range][1.9ce].
3779
3780
3781 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
3782 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
3783 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
3784 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
3785 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
3786 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
3787 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
3788 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
3789 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
3790 [1.9db]: https://github.com/rust-lang/rust/pull/32054
3791 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
3792 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
3793 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
3794 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
3795 [1.9o]: https://github.com/rust-lang/rust/pull/32325
3796 [1.9q]: https://github.com/rust-lang/rust/pull/31887
3797 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
3798 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
3799 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
3800 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
3801 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
3802 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
3803 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
3804 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
3805 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3806 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
3807 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
3808 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
3809 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
3810 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
3811 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
3812 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
3813 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
3814 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
3815 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
3816 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
3817 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
3818 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
3819 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
3820 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
3821 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
3822 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
3823 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
3824 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
3825 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
3826 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
3827 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
3828 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
3829 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
3830 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
3831 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
3832 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
3833 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
3834 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
3835 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
3836 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
3837 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
3838 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
3839 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
3840 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
3841 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3842 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3843 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3844 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3845 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3846 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3847 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
3848 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
3849 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
3850 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
3851 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
3852 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
3853 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
3854 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
3855 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
3856 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
3857 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
3858 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
3859 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
3860 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
3861 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
3862 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
3863 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
3864 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
3865 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
3866 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
3867 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
3868 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
3869 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
3870 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
3871 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
3872 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
3873 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
3874 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
3875 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
3876 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
3877 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
3878 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
3879 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
3880 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
3881 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
3882 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
3883 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
3884 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
3885 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
3886 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
3887 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
3888 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
3889 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
3890 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
3891
3892
3893 Version 1.8.0 (2016-04-14)
3894 ==========================
3895
3896 Language
3897 --------
3898
3899 * Rust supports overloading of compound assignment statements like
3900   `+=` by implementing the [`AddAssign`], [`SubAssign`],
3901   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
3902   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
3903   traits. [RFC 953].
3904 * Empty structs can be defined with braces, as in `struct Foo { }`, in
3905   addition to the non-braced form, `struct Foo;`. [RFC 218].
3906
3907 Libraries
3908 ---------
3909
3910 * Stabilized APIs:
3911   * [`str::encode_utf16`][] (renamed from `utf16_units`)
3912   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
3913   * [`Ref::map`]
3914   * [`RefMut::map`]
3915   * [`ptr::drop_in_place`]
3916   * [`time::Instant`]
3917   * [`time::SystemTime`]
3918   * [`Instant::now`]
3919   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
3920   * [`Instant::elapsed`]
3921   * [`SystemTime::now`]
3922   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
3923   * [`SystemTime::elapsed`]
3924   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
3925   * [`SystemTimeError`]
3926   * [`SystemTimeError::duration`]
3927   * Various impls for `SystemTimeError`
3928   * [`UNIX_EPOCH`]
3929   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
3930     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
3931     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
3932 * [The `write!` and `writeln!` macros correctly emit errors if any of
3933   their arguments can't be formatted][1.8w].
3934 * [Various I/O functions support large files on 32-bit Linux][1.8l].
3935 * [The Unix-specific `raw` modules, which contain a number of
3936   redefined C types are deprecated][1.8r], including `os::raw::unix`,
3937   `os::raw::macos`, and `os::raw::linux`. These modules defined types
3938   such as `ino_t` and `dev_t`. The inconsistency of these definitions
3939   across platforms was making it difficult to implement `std`
3940   correctly. Those that need these definitions should use the `libc`
3941   crate. [RFC 1415].
3942 * The Unix-specific `MetadataExt` traits, including
3943   `os::unix::fs::MetadataExt`, which expose values such as inode
3944   numbers [no longer return platform-specific types][1.8r], but
3945   instead return widened integers. [RFC 1415].
3946 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
3947 * [Atomic loads and stores are not volatile][1.8a].
3948 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
3949
3950 Performance
3951 -----------
3952
3953 * [Inlining hash functions lead to a 3% compile-time improvement in
3954   some workloads][1.8h].
3955 * When using jemalloc, its symbols are [unprefixed so that it
3956   overrides the libc malloc implementation][1.8h]. This means that for
3957   rustc, LLVM is now using jemalloc, which results in a 6%
3958   compile-time improvement on a specific workload.
3959 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
3960
3961 Misc
3962 ----
3963
3964 * [32-bit MSVC builds finally implement unwinding][1.8ms].
3965   i686-pc-windows-msvc is now considered a tier-1 platform.
3966 * [The `--print targets` flag prints a list of supported targets][1.8t].
3967 * [The `--print cfg` flag prints the `cfg`s defined for the current
3968   target][1.8cf].
3969 * [`rustc` can be built with an new Cargo-based build system, written
3970   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
3971   build system. To enable it configure with `configure --rustbuild`.
3972 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
3973   variants while also indicating the total number of missing variants
3974   if more than 3][1.8m].
3975 * [Executable stacks are disabled on Linux and BSD][1.8nx].
3976 * The Rust Project now publishes binary releases of the standard
3977   library for a number of tier-2 targets:
3978   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
3979   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
3980   `x86_64-rumprun-netbsd`. These can be installed with
3981   tools such as [multirust][1.8mr].
3982
3983 Cargo
3984 -----
3985
3986 * [`cargo init` creates a new Cargo project in the current
3987   directory][1.8ci].  It is otherwise like `cargo new`.
3988 * [Cargo has configuration keys for `-v` and
3989   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
3990   `[term]` section of `.cargo/config`.
3991 * [Configuration keys that evaluate to strings or integers can be set
3992   via environment variables][1.8ce]. For example the `build.jobs` key
3993   can be set via `CARGO_BUILD_JOBS`. Environment variables take
3994   precedence over config files.
3995 * [Target-specific dependencies support Rust `cfg` syntax for
3996   describing targets][1.8cfg] so that dependencies for multiple
3997   targets can be specified together. [RFC 1361].
3998 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
3999   `RUSTDOC` take precedence over the `build.target-dir`,
4000   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
4001 * [The child process tree is killed on Windows when Cargo is
4002   killed][1.8ck].
4003 * [The `build.target` configuration value sets the target platform,
4004   like `--target`][1.8ct].
4005
4006 Compatibility Notes
4007 -------------------
4008
4009 * [Unstable compiler flags have been further restricted][1.8u]. Since
4010   1.0 `-Z` flags have been considered unstable, and other flags that
4011   were considered unstable additionally required passing `-Z
4012   unstable-options` to access. Unlike unstable language and library
4013   features though, these options have been accessible on the stable
4014   release channel. Going forward, *new unstable flags will not be
4015   available on the stable release channel*, and old unstable flags
4016   will warn about their usage. In the future, all unstable flags will
4017   be unavailable on the stable release channel.
4018 * [It is no longer possible to `match` on empty enum variants using
4019   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
4020 * The Unix-specific `MetadataExt` traits, including
4021   `os::unix::fs::MetadataExt`, which expose values such as inode
4022   numbers [no longer return platform-specific types][1.8r], but
4023   instead return widened integers. [RFC 1415].
4024 * [Modules sourced from the filesystem cannot appear within arbitrary
4025   blocks, but only within other modules][1.8mf].
4026 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
4027 * On Unix, [stack overflow triggers a runtime abort instead of a
4028   SIGSEGV][1.8so].
4029 * [`Command::spawn` and its equivalents return an error if any of
4030   its command-line arguments contain interior `NUL`s][1.8n].
4031 * [Tuple and unit enum variants from other crates are in the type
4032   namespace][1.8tn].
4033 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
4034   type instead of `.a` files][1.8st]. Additionally, for the MSVC
4035   toolchain, `rustc` emits import libraries named `foo.dll.lib`
4036   instead of `foo.lib`.
4037
4038
4039 [1.8a]: https://github.com/rust-lang/rust/pull/30962
4040 [1.8b]: https://github.com/rust-lang/rust/pull/31123
4041 [1.8c]: https://github.com/rust-lang/rust/pull/31530
4042 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
4043 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
4044 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
4045 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
4046 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
4047 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
4048 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
4049 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
4050 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
4051 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
4052 [1.8h]: https://github.com/rust-lang/rust/pull/31460
4053 [1.8l]: https://github.com/rust-lang/rust/pull/31668
4054 [1.8m]: https://github.com/rust-lang/rust/pull/31020
4055 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
4056 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
4057 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
4058 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
4059 [1.8n]: https://github.com/rust-lang/rust/pull/31056
4060 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
4061 [1.8r]: https://github.com/rust-lang/rust/pull/31551
4062 [1.8so]: https://github.com/rust-lang/rust/pull/31333
4063 [1.8st]: https://github.com/rust-lang/rust/pull/29520
4064 [1.8t]: https://github.com/rust-lang/rust/pull/31358
4065 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
4066 [1.8u]: https://github.com/rust-lang/rust/pull/31793
4067 [1.8v]: https://github.com/rust-lang/rust/pull/31757
4068 [1.8w]: https://github.com/rust-lang/rust/pull/31904
4069 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
4070 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
4071 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
4072 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
4073 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
4074 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
4075 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
4076 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
4077 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
4078 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
4079 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
4080 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
4081 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
4082 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
4083 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
4084 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
4085 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
4086 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
4087 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
4088 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
4089 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
4090 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
4091 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
4092 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
4093 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
4094 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
4095 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
4096 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
4097 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
4098 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
4099
4100
4101 Version 1.7.0 (2016-03-03)
4102 ==========================
4103
4104 Libraries
4105 ---------
4106
4107 * Stabilized APIs
4108   * `Path`
4109     * [`Path::strip_prefix`][] (renamed from relative_from)
4110     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
4111   * `Ipv4Addr`
4112     * [`Ipv4Addr::is_loopback`]
4113     * [`Ipv4Addr::is_private`]
4114     * [`Ipv4Addr::is_link_local`]
4115     * [`Ipv4Addr::is_multicast`]
4116     * [`Ipv4Addr::is_broadcast`]
4117     * [`Ipv4Addr::is_documentation`]
4118   * `Ipv6Addr`
4119     * [`Ipv6Addr::is_unspecified`]
4120     * [`Ipv6Addr::is_loopback`]
4121     * [`Ipv6Addr::is_multicast`]
4122   * `Vec`
4123     * [`Vec::as_slice`]
4124     * [`Vec::as_mut_slice`]
4125   * `String`
4126     * [`String::as_str`]
4127     * [`String::as_mut_str`]
4128   * Slices
4129     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
4130     be the same length
4131     * `<[T]>::`[`sort_by_key`]
4132   * checked, saturated, and overflowing operations
4133     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
4134     * [`i32::saturating_mul`]
4135     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
4136     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
4137     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
4138     * [`u32::saturating_mul`]
4139     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
4140     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
4141     * and checked, saturated, and overflowing operations for other primitive types
4142   * FFI
4143     * [`ffi::IntoStringError`]
4144     * [`CString::into_string`]
4145     * [`CString::into_bytes`]
4146     * [`CString::into_bytes_with_nul`]
4147     * `From<CString> for Vec<u8>`
4148   * `IntoStringError`
4149     * [`IntoStringError::into_cstring`]
4150     * [`IntoStringError::utf8_error`]
4151     * `Error for IntoStringError`
4152   * Hashing
4153     * [`std::hash::BuildHasher`]
4154     * [`BuildHasher::Hasher`]
4155     * [`BuildHasher::build_hasher`]
4156     * [`std::hash::BuildHasherDefault`]
4157     * [`HashMap::with_hasher`]
4158     * [`HashMap::with_capacity_and_hasher`]
4159     * [`HashSet::with_hasher`]
4160     * [`HashSet::with_capacity_and_hasher`]
4161     * [`std::collections::hash_map::RandomState`]
4162     * [`RandomState::new`]
4163 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
4164   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
4165   from bytes is faster.
4166 * [The performance of `LineWriter` (and thus `io::stdout`) was
4167   improved by using `memchr` to search for newlines][1.7m].
4168 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
4169   `f64` variants were stabilized previously.
4170 * [`BTreeMap` was rewritten to use less memory and improve the performance
4171   of insertion and iteration, the latter by as much as 5x][1.7bm].
4172 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
4173   covariant over their contained type][1.7bt].
4174 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
4175   over their contained type][1.7ll].
4176 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
4177   searching methods.
4178 * [`Any` is implemented for unsized types][1.7a].
4179 * [`Hash` is implemented for `Duration`][1.7h].
4180
4181 Misc
4182 ----
4183
4184 * [When running tests with `--test`, rustdoc will pass `--cfg`
4185   arguments to the compiler][1.7dt].
4186 * [The compiler is built with RPATH information by default][1.7rpa].
4187   This means that it will be possible to run `rustc` when installed in
4188   unusual configurations without configuring the dynamic linker search
4189   path explicitly.
4190 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
4191   any RPATH entries (emitted with `-C rpath`) *not* take precedence
4192   over `LD_LIBRARY_PATH`.
4193
4194 Cargo
4195 -----
4196
4197 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
4198   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
4199 * [The `rerun-if-changed` build script directive no longer causes the
4200   build script to incorrectly run twice in certain scenarios][1.7rr].
4201
4202 Compatibility Notes
4203 -------------------
4204
4205 * Soundness fixes to the interactions between associated types and
4206   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
4207   code that violates the new rules. This is a significant change that
4208   is known to break existing code, so it has emitted warnings for the
4209   new error cases since 1.4 to give crate authors time to adapt. The
4210   details of what is changing are subtle; read the RFC for more.
4211 * [Several bugs in the compiler's visibility calculations were
4212   fixed][1.7v]. Since this was found to break significant amounts of
4213   code, the new errors will be emitted as warnings for several release
4214   cycles, under the `private_in_public` lint.
4215 * Defaulted type parameters were accidentally accepted in positions
4216   that were not intended. In this release, [defaulted type parameters
4217   appearing outside of type definitions will generate a
4218   warning][1.7d], which will become an error in future releases.
4219 * [Parsing "." as a float results in an error instead of 0][1.7p].
4220   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
4221 * [Borrows of closure parameters may not outlive the closure][1.7bc].
4222
4223 [1.7a]: https://github.com/rust-lang/rust/pull/30928
4224 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
4225 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
4226 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
4227 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
4228 [1.7d]: https://github.com/rust-lang/rust/pull/30724
4229 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
4230 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
4231 [1.7f]: https://github.com/rust-lang/rust/pull/30672
4232 [1.7h]: https://github.com/rust-lang/rust/pull/30818
4233 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
4234 [1.7m]: https://github.com/rust-lang/rust/pull/30381
4235 [1.7p]: https://github.com/rust-lang/rust/pull/30681
4236 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
4237 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
4238 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
4239 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
4240 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
4241 [1.7v]: https://github.com/rust-lang/rust/pull/29973
4242 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4243 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
4244 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
4245 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
4246 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
4247 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
4248 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
4249 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
4250 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
4251 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
4252 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
4253 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
4254 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
4255 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
4256 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
4257 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
4258 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
4259 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
4260 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
4261 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
4262 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
4263 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
4264 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
4265 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
4266 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
4267 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
4268 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
4269 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
4270 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
4271 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
4272 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
4273 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
4274 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
4275 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
4276 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
4277 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
4278 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
4279 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
4280 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
4281 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
4282 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
4283 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
4284 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
4285 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
4286 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
4287 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
4288 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
4289 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4290 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
4291 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
4292 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
4293 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
4294 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
4295 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
4296 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
4297 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
4298 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
4299 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
4300 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
4301 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
4302
4303
4304 Version 1.6.0 (2016-01-21)
4305 ==========================
4306
4307 Language
4308 --------
4309
4310 * The `#![no_std]` attribute causes a crate to not be linked to the
4311   standard library, but only the [core library][1.6co], as described
4312   in [RFC 1184]. The core library defines common types and traits but
4313   has no platform dependencies whatsoever, and is the basis for Rust
4314   software in environments that cannot support a full port of the
4315   standard library, such as operating systems. Most of the core
4316   library is now stable.
4317
4318 Libraries
4319 ---------
4320
4321 * Stabilized APIs:
4322   [`Read::read_exact`],
4323   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
4324   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
4325   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
4326   [`os::unix::fs::DirBuilderExt`],
4327   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
4328   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
4329   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
4330   [`collections::hash_map::Drain`],
4331   [`collections::hash_map::HashMap::drain`],
4332   [`collections::hash_set::Drain`],
4333   [`collections::hash_set::HashSet::drain`],
4334   [`collections::binary_heap::Drain`],
4335   [`collections::binary_heap::BinaryHeap::drain`],
4336   [`Vec::extend_from_slice`][] (renamed from `push_all`),
4337   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
4338   [`RwLock::into_inner`],
4339   [`Iterator::min_by_key`][] (renamed from `min_by`),
4340   [`Iterator::max_by_key`][] (renamed from `max_by`).
4341 * The [core library][1.6co] is stable, as are most of its APIs.
4342 * [The `assert_eq!` macro supports arguments that don't implement
4343   `Sized`][1.6ae], such as arrays. In this way it behaves more like
4344   `assert!`.
4345 * Several timer functions that take duration in milliseconds [are
4346   deprecated in favor of those that take `Duration`][1.6ms]. These
4347   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
4348   `thread::park_timeout_ms`.
4349 * The algorithm by which `Vec` reserves additional elements was
4350   [tweaked to not allocate excessive space][1.6a] while still growing
4351   exponentially.
4352 * `From` conversions are [implemented from integers to floats][1.6f]
4353   in cases where the conversion is lossless. Thus they are not
4354   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
4355   or `f64`. They are also not implemented for `isize` and `usize`
4356   because the implementations would be platform-specific. `From` is
4357   also implemented from `f32` to `f64`.
4358 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
4359 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
4360 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
4361 * [`BinaryHeap` was refactored][1.6bh] for modest performance
4362   improvements.
4363 * Sorting slices that are already sorted [is 50% faster in some
4364   cases][1.6s].
4365
4366 Cargo
4367 -----
4368
4369 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
4370 * Cargo build scripts can specify their dependencies by emitting the
4371   [`rerun-if-changed`][1.6rr] key.
4372 * crates.io will reject publication of crates with dependencies that
4373   have a wildcard version constraint. Crates with wildcard
4374   dependencies were seen to cause a variety of problems, as described
4375   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
4376   warning.
4377 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
4378   release folder.  A variety of artifacts that Cargo failed to clean
4379   are now correctly deleted.
4380
4381 Misc
4382 ----
4383
4384 * The `unreachable_code` lint [warns when a function call's argument
4385   diverges][1.6dv].
4386 * The parser indicates [failures that may be caused by
4387   confusingly-similar Unicode characters][1.6uc]
4388 * Certain macro errors [are reported at definition time][1.6m], not
4389   expansion.
4390
4391 Compatibility Notes
4392 -------------------
4393
4394 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
4395   environment variable when locating crates. This was a pre-cargo
4396   feature for integrating with the package manager that was
4397   accidentally never removed.
4398 * [A number of bugs were fixed in the privacy checker][1.6p] that
4399   could cause previously-accepted code to break.
4400 * [Modules and unit/tuple structs may not share the same name][1.6ts].
4401 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
4402   struct pattern syntax (`Foo(..)`) can no longer be used to match
4403   unit structs. This is a warning now, but will become an error in
4404   future releases. Patterns that share the same name as a const are
4405   now an error.
4406 * A bug was fixed that causes [rustc not to apply default type
4407   parameters][1.6xc] when resolving certain method implementations of
4408   traits defined in other crates.
4409
4410 [1.6a]: https://github.com/rust-lang/rust/pull/29454
4411 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
4412 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
4413 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
4414 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
4415 [1.6co]: http://doc.rust-lang.org/core/index.html
4416 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
4417 [1.6f]: https://github.com/rust-lang/rust/pull/29129
4418 [1.6m]: https://github.com/rust-lang/rust/pull/29828
4419 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
4420 [1.6p]: https://github.com/rust-lang/rust/pull/29726
4421 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
4422 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
4423 [1.6s]: https://github.com/rust-lang/rust/pull/29675
4424 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
4425 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
4426 [1.6us]: https://github.com/rust-lang/rust/pull/29383
4427 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
4428 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
4429 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4430 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
4431 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
4432 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
4433 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
4434 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
4435 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
4436 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
4437 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
4438 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
4439 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
4440 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
4441 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
4442 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
4443 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
4444 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
4445 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
4446 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
4447 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
4448 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
4449 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
4450 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
4451 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
4452 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
4453 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
4454 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
4455 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
4456 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
4457
4458
4459 Version 1.5.0 (2015-12-10)
4460 ==========================
4461
4462 * ~700 changes, numerous bugfixes
4463
4464 Highlights
4465 ----------
4466
4467 * Stabilized APIs:
4468   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
4469   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
4470   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
4471   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
4472   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
4473   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
4474   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
4475   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
4476   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
4477   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
4478   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
4479   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
4480   [`Path::read_link`], [`Path::symlink_metadata`],
4481   [`Utf8Error::valid_up_to`], [`Vec::resize`],
4482   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
4483   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
4484   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
4485   [`slice::split_first_mut`], [`slice::split_first`],
4486   [`slice::split_last_mut`], [`slice::split_last`],
4487   [`char::from_u32_unchecked`], [`fs::canonicalize`],
4488   [`str::MatchIndices`], [`str::RMatchIndices`],
4489   [`str::match_indices`], [`str::rmatch_indices`],
4490   [`str::slice_mut_unchecked`], [`string::ParseError`].
4491 * Rust applications hosted on crates.io can be installed locally to
4492   `~/.cargo/bin` with the [`cargo install`] command. Among other
4493   things this makes it easier to augment Cargo with new subcommands:
4494   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
4495   invoked as `cargo foo`.
4496 * Crates with wildcard (`*`) dependencies will [emit warnings when
4497   published][1.5w]. In 1.6 it will no longer be possible to publish
4498   crates with wildcard dependencies.
4499
4500 Breaking Changes
4501 ----------------
4502
4503 * The rules determining when a particular lifetime must outlive
4504   a particular value (known as '[dropck]') have been [modified
4505   to not rely on parametricity][1.5p].
4506 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
4507   and `Arc`][1.5a]. Because these smart pointer types implement
4508   `Deref`, this causes breakage in cases where the interior type
4509   contains methods of the same name.
4510 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
4511   that they could drop their content. Soundness fix.
4512 * All method invocations are [properly checked][1.5wf1] for
4513   [well-formedness][1.5wf2]. Soundness fix.
4514 * Traits whose supertraits contain `Self` are [not object
4515   safe][1.5o]. Soundness fix.
4516 * Target specifications support a [`no_default_libraries`][1.5nd]
4517   setting that controls whether `-nodefaultlibs` is passed to the
4518   linker, and in turn the `is_like_windows` setting no longer affects
4519   the `-nodefaultlibs` flag.
4520 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
4521 * The `#[inline]` and `#[repr]` attributes [can only appear
4522   in valid locations][1.5at].
4523 * Native libraries linked from the local crate are [passed to
4524   the linker before native libraries from upstream crates][1.5nl].
4525 * Two rarely-used attributes, `#[no_debug]` and
4526   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
4527 * Negation of unsigned integers, which has been a warning for
4528   several releases, [is now behind a feature gate and will
4529   generate errors][1.5nu].
4530 * The parser accidentally accepted visibility modifiers on
4531   enum variants, a bug [which has been fixed][1.5ev].
4532 * [A bug was fixed that allowed `use` statements to import unstable
4533   features][1.5use].
4534
4535 Language
4536 --------
4537
4538 * When evaluating expressions at compile-time that are not
4539   compile-time constants (const-evaluating expressions in non-const
4540   contexts), incorrect code such as overlong bitshifts and arithmetic
4541   overflow will [generate a warning instead of an error][1.5ce],
4542   delaying the error until runtime. This will allow the
4543   const-evaluator to be expanded in the future backwards-compatibly.
4544 * The `improper_ctypes` lint [no longer warns about using `isize` and
4545   `usize` in FFI][1.5ict].
4546
4547 Libraries
4548 ---------
4549
4550 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
4551   invariant][1.5c].
4552 * `Default` is [implemented for mutable slices][1.5d].
4553 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
4554 * There are now `From` conversions [between floating point
4555   types][1.5f] where the conversions are lossless.
4556 * There are now `From` conversions [between integer types][1.5i] where
4557   the conversions are lossless.
4558 * [`fs::Metadata` implements `Clone`][1.5fs].
4559 * The `parse` method [accepts a leading "+" when parsing
4560   integers][1.5pi].
4561 * [`AsMut` is implemented for `Vec`][1.5am].
4562 * The `clone_from` implementations for `String` and `BinaryHeap` [have
4563   been optimized][1.5cf] and no longer rely on the default impl.
4564 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
4565   `unsafe extern "C"` function types now [implement `Clone`,
4566   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
4567   `fmt::Debug` for up to 12 arguments][1.5fp].
4568 * [Dropping `Vec`s is much faster in unoptimized builds when the
4569   element types don't implement `Drop`][1.5dv].
4570 * A bug that caused in incorrect behavior when [combining `VecDeque`
4571   with zero-sized types][1.5vdz] was resolved.
4572 * [`PartialOrd` for slices is faster][1.5po].
4573
4574 Miscellaneous
4575 -------------
4576
4577 * [Crate metadata size was reduced by 20%][1.5md].
4578 * [Improvements to code generation reduced the size of libcore by 3.3
4579   MB and rustc's memory usage by 18MB][1.5m].
4580 * [Improvements to deref translation increased performance in
4581   unoptimized builds][1.5dr].
4582 * Various errors in trait resolution [are deduplicated to only be
4583   reported once][1.5te].
4584 * Rust has preliminary [support for rumprun kernels][1.5rr].
4585 * Rust has preliminary [support for NetBSD on amd64][1.5na].
4586
4587 [1.5use]: https://github.com/rust-lang/rust/pull/28364
4588 [1.5po]: https://github.com/rust-lang/rust/pull/28436
4589 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
4590 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
4591 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
4592 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
4593 [1.5md]: https://github.com/rust-lang/rust/pull/28521
4594 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
4595 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
4596 [1.5na]: https://github.com/rust-lang/rust/pull/28543
4597 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
4598 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
4599 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
4600 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
4601 [1.5te]: https://github.com/rust-lang/rust/pull/28645
4602 [1.5at]: https://github.com/rust-lang/rust/pull/28650
4603 [1.5am]: https://github.com/rust-lang/rust/pull/28663
4604 [1.5m]: https://github.com/rust-lang/rust/pull/28778
4605 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
4606 [1.5a]: https://github.com/rust-lang/rust/pull/28811
4607 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
4608 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
4609 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
4610 [1.5i]: https://github.com/rust-lang/rust/pull/28921
4611 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
4612 [1.5f]: https://github.com/rust-lang/rust/pull/29129
4613 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
4614 [1.5s]: https://github.com/rust-lang/rust/pull/29190
4615 [1.5d]: https://github.com/rust-lang/rust/pull/29245
4616 [1.5o]: https://github.com/rust-lang/rust/pull/29259
4617 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
4618 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4619 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
4620 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
4621 [1.5c]: https://github.com/rust-lang/rust/pull/29110
4622 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
4623 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
4624 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
4625 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
4626 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
4627 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
4628 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
4629 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
4630 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
4631 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
4632 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
4633 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
4634 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
4635 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
4636 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
4637 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
4638 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
4639 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
4640 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
4641 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
4642 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
4643 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
4644 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
4645 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
4646 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
4647 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
4648 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
4649 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
4650 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
4651 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
4652 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
4653 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
4654 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
4655 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
4656 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
4657 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
4658 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
4659 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
4660 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
4661 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
4662 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
4663 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
4664 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
4665 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
4666 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
4667 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
4668 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
4669 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
4670 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
4671 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
4672 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
4673 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
4674 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
4675 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
4676
4677 Version 1.4.0 (2015-10-29)
4678 ==========================
4679
4680 * ~1200 changes, numerous bugfixes
4681
4682 Highlights
4683 ----------
4684
4685 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
4686   GNU) are now supported and recommended for use.
4687
4688 Breaking Changes
4689 ----------------
4690
4691 * [Several changes have been made to fix type soundness and improve
4692   the behavior of associated types][sound]. See [RFC 1214]. Although
4693   we have mostly introduced these changes as warnings this release, to
4694   become errors next release, there are still some scenarios that will
4695   see immediate breakage.
4696 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
4697   line breaks in addition to `\n`][crlf].
4698 * [Loans of `'static` lifetime extend to the end of a function][stat].
4699 * [`str::parse` no longer introduces avoidable rounding error when
4700   parsing floating point numbers. Together with earlier changes to
4701   float formatting/output, "round trips" like f.to_string().parse()
4702   now preserve the value of f exactly. Additionally, leading plus
4703   signs are now accepted][fp3].
4704
4705
4706 Language
4707 --------
4708
4709 * `use` statements that import multiple items [can now rename
4710   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
4711 * [Binops work correctly on fat pointers][binfat].
4712 * `pub extern crate`, which does not behave as expected, [issues a
4713   warning][pec] until a better solution is found.
4714
4715 Libraries
4716 ---------
4717
4718 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
4719   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
4720   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
4721   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
4722   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
4723   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
4724   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
4725   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
4726   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
4727   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
4728   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
4729   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
4730   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
4731   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
4732   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
4733   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
4734   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
4735   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
4736   [`thread::sleep`].
4737 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
4738   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
4739   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
4740   `f64::from_str_radix`.
4741 * [Reverse-searching strings is faster with the 'two-way'
4742   algorithm][s].
4743 * [`std::io::copy` allows `?Sized` arguments][cc].
4744 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
4745   [override `count`, `nth` and `last` with an O(1)
4746   implementation][it].
4747 * [`Default` is implemented for arrays up to `[T; 32]`][d].
4748 * [`IntoRawFd` has been added to the Unix-specific prelude,
4749   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
4750   prelude][pr].
4751 * [`Extend<String>` and `FromIterator<String` are both implemented for
4752   `String`][es].
4753 * [`IntoIterator` is implemented for references to `Option` and
4754   `Result`][into2].
4755 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
4756   Copy`][ext] as part of [RFC 839]. This will cause type inference
4757   breakage in rare situations.
4758 * [`BinaryHeap` implements `Debug`][bh2].
4759 * [`Borrow` and `BorrowMut` are implemented for fixed-size
4760   arrays][bm].
4761 * [`extern fn`s with the "Rust" and "C" ABIs implement common
4762   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
4763 * [String comparison is faster][faststr].
4764 * `&mut T` where `T: std::fmt::Write` [also implements
4765   `std::fmt::Write`][mutw].
4766 * [A stable regression in `VecDeque::push_back` and other
4767   capacity-altering methods that caused panics for zero-sized types
4768   was fixed][vd].
4769 * [Function pointers implement traits for up to 12 parameters][fp2].
4770
4771 Miscellaneous
4772 -------------
4773
4774 * The compiler [no longer uses the 'morestack' feature to prevent
4775   stack overflow][mm]. Instead it uses guard pages and stack
4776   probes (though stack probes are not yet implemented on any platform
4777   but Windows).
4778 * [The compiler matches traits faster when projections are involved][p].
4779 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
4780   `usize`][ffi].
4781 * [Cargo now displays useful information about what its doing during
4782   `cargo update`][cu].
4783
4784 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
4785 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
4786 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
4787 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
4788 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
4789 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
4790 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
4791 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
4792 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
4793 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
4794 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
4795 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
4796 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
4797 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
4798 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
4799 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
4800 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
4801 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
4802 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4803 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4804 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4805 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4806 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
4807 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
4808 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
4809 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
4810 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
4811 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
4812 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
4813 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
4814 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
4815 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
4816 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
4817 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
4818 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
4819 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
4820 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
4821 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
4822 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
4823 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
4824 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
4825 [bh2]: https://github.com/rust-lang/rust/pull/28156
4826 [binfat]: https://github.com/rust-lang/rust/pull/28270
4827 [bm]: https://github.com/rust-lang/rust/pull/28197
4828 [cc]: https://github.com/rust-lang/rust/pull/27531
4829 [crlf]: https://github.com/rust-lang/rust/pull/28034
4830 [cu]: https://github.com/rust-lang/cargo/pull/1931
4831 [d]: https://github.com/rust-lang/rust/pull/27825
4832 [dep]: https://github.com/rust-lang/rust/pull/28339
4833 [es]: https://github.com/rust-lang/rust/pull/27956
4834 [ext]: https://github.com/rust-lang/rust/pull/28094
4835 [faststr]: https://github.com/rust-lang/rust/pull/28338
4836 [ffi]: https://github.com/rust-lang/rust/pull/28779
4837 [fp]: https://github.com/rust-lang/rust/pull/28268
4838 [fp2]: https://github.com/rust-lang/rust/pull/28560
4839 [fp3]: https://github.com/rust-lang/rust/pull/27307
4840 [i]: https://github.com/rust-lang/rust/pull/27451
4841 [into2]: https://github.com/rust-lang/rust/pull/28039
4842 [it]: https://github.com/rust-lang/rust/pull/27652
4843 [mm]: https://github.com/rust-lang/rust/pull/27338
4844 [mutw]: https://github.com/rust-lang/rust/pull/28368
4845 [sound]: https://github.com/rust-lang/rust/pull/27641
4846 [p]: https://github.com/rust-lang/rust/pull/27866
4847 [pec]: https://github.com/rust-lang/rust/pull/28486
4848 [pr]: https://github.com/rust-lang/rust/pull/27896
4849 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
4850 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
4851 [s]: https://github.com/rust-lang/rust/pull/27474
4852 [stab]: https://github.com/rust-lang/rust/pull/28339
4853 [stat]: https://github.com/rust-lang/rust/pull/28321
4854 [vd]: https://github.com/rust-lang/rust/pull/28494
4855
4856 Version 1.3.0 (2015-09-17)
4857 ==============================
4858
4859 * ~900 changes, numerous bugfixes
4860
4861 Highlights
4862 ----------
4863
4864 * The [new object lifetime defaults][nold] have been [turned
4865   on][nold2] after a cycle of warnings about the change. Now types
4866   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
4867   being interpreted as `&'a Box<Trait+'a>` to `&'a
4868   Box<Trait+'static>`.
4869 * [The Rustonomicon][nom] is a new book in the official documentation
4870   that dives into writing unsafe Rust.
4871 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
4872   timekeeping is employed by other std APIs, as well as out-of-tree
4873   time crates.
4874
4875 Breaking Changes
4876 ----------------
4877
4878 * The [new object lifetime defaults][nold] have been [turned
4879   on][nold2] after a cycle of warnings about the change.
4880 * There is a known [regression][lr] in how object lifetime elision is
4881   interpreted, the proper solution for which is undetermined.
4882 * The `#[prelude_import]` attribute, an internal implementation
4883   detail, was accidentally stabilized previously. [It has been put
4884   behind the `prelude_import` feature gate][pi]. This change is
4885   believed to break no existing code.
4886 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4887   [more sane for dynamically sized types][dst3]. Code that relied on
4888   the previous behavior is thought to be broken.
4889 * The `dropck` rules, which checks that destructors can't access
4890   destroyed values, [have been updated][dropck] to match the
4891   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
4892   cause some previously-compiling code to no longer build.
4893
4894 Language
4895 --------
4896
4897 * The [new object lifetime defaults][nold] have been [turned
4898   on][nold2] after a cycle of warnings about the change.
4899 * Semicolons may [now follow types and paths in
4900   macros](https://github.com/rust-lang/rust/pull/27000).
4901 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
4902   [more sane for dynamically sized types][dst3]. Code that relied on
4903   the previous behavior is not known to exist, and suspected to be
4904   broken.
4905 * `'static` variables [may now be recursive][st].
4906 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
4907   implementations correctly.
4908 * The `dropck` rules, which checks that destructors can't access
4909   destroyed values, [have been updated][dropck] to match the
4910   [RFC][dropckrfc].
4911
4912 Libraries
4913 ---------
4914
4915 * The [`Duration`] API, [has been stabilized][ds], as well as the
4916   `std::time` module, which presently contains only `Duration`.
4917 * `Box<str>` and `Box<[T]>` both implement `Clone`.
4918 * The owned C string, [`CString`], implements [`Borrow`] and the
4919   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
4920   these allow C strings to be borrowed and cloned in generic code.
4921 * [`CStr`] implements [`Debug`].
4922 * [`AtomicPtr`] implements [`Debug`].
4923 * [`Error`] trait objects [can be downcast to their concrete types][e]
4924   in many common configurations, using the [`is`], [`downcast`],
4925   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
4926   [`Any`] trait.
4927 * Searching for substrings now [employs the two-way algorithm][search]
4928   instead of doing a naive search. This gives major speedups to a
4929   number of methods, including [`contains`][sc], [`find`][sf],
4930   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
4931   [`ends_with`][sew] are also faster.
4932 * The performance of `PartialEq` for slices is [much faster][ps].
4933 * The [`Hash`] trait offers the default method, [`hash_slice`], which
4934   is overridden and optimized by the implementations for scalars.
4935 * The [`Hasher`] trait now has a number of specialized `write_*`
4936   methods for primitive types, for efficiency.
4937 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
4938   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
4939   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
4940   of [`std::error::Error::cause`][iec] also delegates to the inner
4941   error.
4942 * [`process::Child`][pc] gained the [`id`] method, which returns a
4943   `u32` representing the platform-specific process identifier.
4944 * The [`connect`] method on slices is deprecated, replaced by the new
4945   [`join`] method (note that both of these are on the *unstable*
4946   [`SliceConcatExt`] trait, but through the magic of the prelude are
4947   available to stable code anyway).
4948 * The [`Div`] operator is implemented for [`Wrapping`] types.
4949 * [`DerefMut` is implemented for `String`][dms].
4950 * Performance of SipHash (the default hasher for `HashMap`) is
4951   [better for long data][sh].
4952 * [`AtomicPtr`] implements [`Send`].
4953 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
4954   are now [specialized to use uninitialized buffers for increased
4955   performance][rte].
4956 * Lifetime parameters of foreign functions [are now resolved
4957   properly][f].
4958
4959 Misc
4960 ----
4961
4962 * Rust can now, with some coercion, [produce programs that run on
4963   Windows XP][xp], though XP is not considered a supported platform.
4964 * Porting Rust on Windows from the GNU toolchain to MSVC continues
4965   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
4966   recommended for use in 1.3, though should be fully-functional
4967   in the [64-bit 1.4 beta][b14].
4968 * On Fedora-based systems installation will [properly configure the
4969   dynamic linker][fl].
4970 * The compiler gained many new extended error descriptions, which can
4971   be accessed with the `--explain` flag.
4972 * The `dropck` pass, which checks that destructors can't access
4973   destroyed values, [has been rewritten][dropck]. This fixes some
4974   soundness holes, and as such will cause some previously-compiling
4975   code to no longer build.
4976 * `rustc` now uses [LLVM to write archive files where possible][ar].
4977   Eventually this will eliminate the compiler's dependency on the ar
4978   utility.
4979 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
4980   supported FreeBSD on x86_64).
4981 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
4982   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
4983   more strict.
4984 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
4985   will kill the process instead of leaking][nlp].
4986
4987 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
4988 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
4989 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
4990 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
4991 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
4992 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
4993 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
4994 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
4995 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
4996 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
4997 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
4998 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
4999 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
5000 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5001 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
5002 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
5003 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
5004 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
5005 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5006 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
5007 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
5008 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
5009 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
5010 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5011 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
5012 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
5013 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
5014 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
5015 [ar]: https://github.com/rust-lang/rust/pull/26926
5016 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
5017 [dms]: https://github.com/rust-lang/rust/pull/26241
5018 [dropck]: https://github.com/rust-lang/rust/pull/27261
5019 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5020 [ds]: https://github.com/rust-lang/rust/pull/26818
5021 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
5022 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
5023 [dst3]: https://github.com/rust-lang/rust/pull/27351
5024 [e]: https://github.com/rust-lang/rust/pull/24793
5025 [f]: https://github.com/rust-lang/rust/pull/26588
5026 [fb]: https://github.com/rust-lang/rust/pull/26959
5027 [fl]: https://github.com/rust-lang/rust-installer/pull/41
5028 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
5029 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
5030 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
5031 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
5032 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
5033 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
5034 [lic]: https://github.com/rust-lang/rust/pull/26583
5035 [lnu]: https://github.com/rust-lang/rust/pull/27026
5036 [lr]: https://github.com/rust-lang/rust/issues/27248
5037 [lum]: https://github.com/rust-lang/rust/pull/26378
5038 [lur]: https://github.com/rust-lang/rust/pull/26783
5039 [nlp]: https://github.com/rust-lang/rust/pull/27176
5040 [nold2]: https://github.com/rust-lang/rust/pull/27045
5041 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
5042 [nom]: http://doc.rust-lang.org/nightly/nomicon/
5043 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
5044 [pi]: https://github.com/rust-lang/rust/pull/26699
5045 [ps]: https://github.com/rust-lang/rust/pull/26884
5046 [rte]: https://github.com/rust-lang/rust/pull/26950
5047 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
5048 [search]: https://github.com/rust-lang/rust/pull/26327
5049 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
5050 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
5051 [sh]: https://github.com/rust-lang/rust/pull/27280
5052 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
5053 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
5054 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
5055 [st]: https://github.com/rust-lang/rust/pull/26630
5056 [win1]: https://github.com/rust-lang/rust/pull/26569
5057 [win2]: https://github.com/rust-lang/rust/pull/26741
5058 [win3]: https://github.com/rust-lang/rust/pull/26741
5059 [win4]: https://github.com/rust-lang/rust/pull/27210
5060 [xp]: https://github.com/rust-lang/rust/pull/26569
5061
5062 Version 1.2.0 (2015-08-07)
5063 ==========================
5064
5065 * ~1200 changes, numerous bugfixes
5066
5067 Highlights
5068 ----------
5069
5070 * [Dynamically-sized-type coercions][dst] allow smart pointer types
5071   like `Rc` to contain types without a fixed size, arrays and trait
5072   objects, finally enabling use of `Rc<[T]>` and completing the
5073   implementation of DST.
5074 * [Parallel codegen][parcodegen] is now working again, which can
5075   substantially speed up large builds in debug mode; It also gets
5076   another ~33% speedup when bootstrapping on a 4 core machine (using 8
5077   jobs). It's not enabled by default, but will be "in the near
5078   future". It can be activated with the `-C codegen-units=N` flag to
5079   `rustc`.
5080 * This is the first release with [experimental support for linking
5081   with the MSVC linker and lib C on Windows (instead of using the GNU
5082   variants via MinGW)][win]. It is yet recommended only for the most
5083   intrepid Rustaceans.
5084 * Benchmark compilations are showing a 30% improvement in
5085   bootstrapping over 1.1.
5086
5087 Breaking Changes
5088 ----------------
5089
5090 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
5091   unicode case mapping, which is a previously-planned change in
5092   behavior and considered a bugfix.
5093 * [`mem::align_of`] now specifies [the *minimum alignment* for
5094   T][align], which is usually the alignment programs are interested
5095   in, and the same value reported by clang's
5096   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
5097   break real code.
5098 * [The `#[packed]` attribute is no longer silently accepted by the
5099   compiler][packed]. This attribute did nothing and code that
5100   mentioned it likely did not work as intended.
5101 * Associated type defaults are [now behind the
5102   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
5103   defaults *did not work*, but could be mentioned syntactically. As
5104   such this breakage has minimal impact.
5105
5106 Language
5107 --------
5108
5109 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
5110   matching against dereferenceable values.
5111
5112 Libraries
5113 ---------
5114
5115 * The [`Extend`] trait, which grows a collection from an iterator, is
5116   implemented over iterators of references, for `String`, `Vec`,
5117   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
5118   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
5119 * The [`iter::once`] function returns an iterator that yields a single
5120   element, and [`iter::empty`] returns an iterator that yields no
5121   elements.
5122 * The [`matches`] and [`rmatches`] methods on `str` return iterators
5123   over substring matches.
5124 * [`Cell`] and [`RefCell`] both implement `Eq`.
5125 * A number of methods for wrapping arithmetic are added to the
5126   integral types, [`wrapping_div`], [`wrapping_rem`],
5127   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
5128   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
5129   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
5130   type.. It is illegal for the default arithmetic operations in Rust
5131   to overflow; the desire to wrap must be explicit.
5132 * The `{:#?}` formatting specifier [displays the alternate,
5133   pretty-printed][debugfmt] form of the `Debug` formatter. This
5134   feature was actually introduced prior to 1.0 with little
5135   fanfare.
5136 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
5137   for writing data to formatted strings, similar to [`io::Write`].
5138 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
5139   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
5140   are used by code generators to emit implementations of [`Debug`].
5141 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
5142   methods that convert case, following Unicode case mapping.
5143 * It is now easier to handle poisoned locks. The [`PoisonError`]
5144   type, returned by failing lock operations, exposes `into_inner`,
5145   `get_ref`, and `get_mut`, which all give access to the inner lock
5146   guard, and allow the poisoned lock to continue to operate. The
5147   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
5148   poisoned lock without attempting to take the lock.
5149 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
5150   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
5151   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
5152   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
5153   `ChildStderr`.
5154 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
5155   malformed input.
5156
5157 Misc
5158 ----
5159
5160 * `rustc` employs smarter heuristics for guessing at [typos].
5161 * `rustc` emits more efficient code for [no-op conversions between
5162   unsafe pointers][nop].
5163 * Fat pointers are now [passed in pairs of immediate arguments][fat],
5164   resulting in faster compile times and smaller code.
5165
5166 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
5167 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
5168 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
5169 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
5170 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
5171 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
5172 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
5173 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
5174 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
5175 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
5176 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
5177 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
5178 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
5179 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
5180 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
5181 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
5182 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
5183 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
5184 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
5185 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
5186 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
5187 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
5188 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
5189 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
5190 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
5191 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
5192 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
5193 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
5194 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
5195 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
5196 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
5197 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
5198 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
5199 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5200 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5201 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
5202 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
5203 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
5204 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
5205 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
5206 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
5207 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
5208 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
5209 [align]: https://github.com/rust-lang/rust/pull/25646
5210 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
5211 [typos]: https://github.com/rust-lang/rust/pull/26087
5212 [nop]: https://github.com/rust-lang/rust/pull/26336
5213 [fat]: https://github.com/rust-lang/rust/pull/26411
5214 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
5215 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
5216 [packed]: https://github.com/rust-lang/rust/pull/25541
5217 [ad]: https://github.com/rust-lang/rust/pull/27382
5218 [win]: https://github.com/rust-lang/rust/pull/25350
5219
5220 Version 1.1.0 (2015-06-25)
5221 =========================
5222
5223 * ~850 changes, numerous bugfixes
5224
5225 Highlights
5226 ----------
5227
5228 * The [`std::fs` module has been expanded][fs] to expand the set of
5229   functionality exposed:
5230   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
5231     don't incur a syscall on some platforms.
5232   * A `symlink_metadata` function has been added.
5233   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
5234     access to all underlying information.
5235 * The compiler now contains extended explanations of many errors. When an error
5236   with an explanation occurs the compiler suggests using the `--explain` flag
5237   to read the explanation. Error explanations are also [available online][err-index].
5238 * Thanks to multiple [improvements][sk] to [type checking][pre], as
5239   well as other work, the time to bootstrap the compiler decreased by
5240   32%.
5241
5242 Libraries
5243 ---------
5244
5245 * The [`str::split_whitespace`] method splits a string on unicode
5246   whitespace boundaries.
5247 * On both Windows and Unix, new extension traits provide conversion of
5248   I/O types to and from the underlying system handles. On Unix, these
5249   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
5250   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
5251   `TcpListener`, and `UpdSocket`. Further implementations for
5252   `std::process` will be stabilized later.
5253 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
5254   Windows, symlinks can be created with
5255   `std::os::windows::symlink_dir` and
5256   `std::os::windows::symlink_file`.
5257 * The `mpsc::Receiver` type can now be converted into an iterator with
5258   `into_iter` on the [`IntoIterator`] trait.
5259 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
5260   implementation of the [`From`] trait.
5261 * The `Debug` implementation for `RangeFull` [creates output that is
5262   more consistent with other implementations][rf].
5263 * [`Debug` is implemented for `File`][file].
5264 * The `Default` implementation for `Arc` [no longer requires `Sync +
5265   Send`][arc].
5266 * [The `Iterator` methods `count`, `nth`, and `last` have been
5267   overridden for slices to have O(1) performance instead of O(n)][si].
5268 * Incorrect handling of paths on Windows has been improved in both the
5269   compiler and the standard library.
5270 * [`AtomicPtr` gained a `Default` implementation][ap].
5271 * In accordance with Rust's policy on arithmetic overflow `abs` now
5272   [panics on overflow when debug assertions are enabled][abs].
5273 * The [`Cloned`] iterator, which was accidentally left unstable for
5274   1.0 [has been stabilized][c].
5275 * The [`Incoming`] iterator, which iterates over incoming TCP
5276   connections, and which was accidentally unnamable in 1.0, [is now
5277   properly exported][inc].
5278 * [`BinaryHeap`] no longer corrupts itself [when functions called by
5279   `sift_up` or `sift_down` panic][bh].
5280 * The [`split_off`] method of `LinkedList` [no longer corrupts
5281   the list in certain scenarios][ll].
5282
5283 Misc
5284 ----
5285
5286 * Type checking performance [has improved notably][sk] with
5287   [multiple improvements][pre].
5288 * The compiler [suggests code changes][ch] for more errors.
5289 * rustc and it's build system have experimental support for [building
5290   toolchains against MUSL][m] instead of glibc on Linux.
5291 * The compiler defines the `target_env` cfg value, which is used for
5292   distinguishing toolchains that are otherwise for the same
5293   platform. Presently this is set to `gnu` for common GNU Linux
5294   targets and for MinGW targets, and `musl` for MUSL Linux targets.
5295 * The [`cargo rustc`][crc] command invokes a build with custom flags
5296   to rustc.
5297 * [Android executables are always position independent][pie].
5298 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
5299   with `Drop`][drop].
5300
5301 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
5302 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
5303 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
5304 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
5305 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
5306 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
5307 [rf]: https://github.com/rust-lang/rust/pull/24491
5308 [err-index]: https://doc.rust-lang.org/error-index.html
5309 [sk]: https://github.com/rust-lang/rust/pull/24615
5310 [pre]: https://github.com/rust-lang/rust/pull/25323
5311 [file]: https://github.com/rust-lang/rust/pull/24598
5312 [ch]: https://github.com/rust-lang/rust/pull/24683
5313 [arc]: https://github.com/rust-lang/rust/pull/24695
5314 [si]: https://github.com/rust-lang/rust/pull/24701
5315 [ap]: https://github.com/rust-lang/rust/pull/24834
5316 [m]: https://github.com/rust-lang/rust/pull/24777
5317 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
5318 [crc]: https://github.com/rust-lang/cargo/pull/1568
5319 [pie]: https://github.com/rust-lang/rust/pull/24953
5320 [abs]: https://github.com/rust-lang/rust/pull/25441
5321 [c]: https://github.com/rust-lang/rust/pull/25496
5322 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
5323 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
5324 [inc]: https://github.com/rust-lang/rust/pull/25522
5325 [bh]: https://github.com/rust-lang/rust/pull/25856
5326 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
5327 [ll]: https://github.com/rust-lang/rust/pull/26022
5328 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
5329 [drop]: https://github.com/rust-lang/rust/pull/24935
5330
5331 Version 1.0.0 (2015-05-15)
5332 ========================
5333
5334 * ~1500 changes, numerous bugfixes
5335
5336 Highlights
5337 ----------
5338
5339 * The vast majority of the standard library is now `#[stable]`. It is
5340   no longer possible to use unstable features with a stable build of
5341   the compiler.
5342 * Many popular crates on [crates.io] now work on the stable release
5343   channel.
5344 * Arithmetic on basic integer types now [checks for overflow in debug
5345   builds][overflow].
5346
5347 Language
5348 --------
5349
5350 * Several [restrictions have been added to trait coherence][coh] in
5351   order to make it easier for upstream authors to change traits
5352   without breaking downstream code.
5353 * Digits of binary and octal literals are [lexed more eagerly][lex] to
5354   improve error messages and macro behavior. For example, `0b1234` is
5355   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
5356 * Trait bounds [are always invariant][inv], eliminating the need for
5357   the `PhantomFn` and `MarkerTrait` lang items, which have been
5358   removed.
5359 * ["-" is no longer a valid character in crate names][cr], the `extern crate
5360   "foo" as bar` syntax has been replaced with `extern crate foo as
5361   bar`, and Cargo now automatically translates "-" in *package* names
5362   to underscore for the crate name.
5363 * [Lifetime shadowing is an error][lt].
5364 * [`Send` no longer implies `'static`][send-rfc].
5365 * [UFCS now supports trait-less associated paths][moar-ufcs] like
5366   `MyType::default()`.
5367 * Primitive types [now have inherent methods][prim-inherent],
5368   obviating the need for extension traits like `SliceExt`.
5369 * Methods with `Self: Sized` in their `where` clause are [considered
5370   object-safe][self-sized], allowing many extension traits like
5371   `IteratorExt` to be merged into the traits they extended.
5372 * You can now [refer to associated types][assoc-where] whose
5373   corresponding trait bounds appear only in a `where` clause.
5374 * The final bits of [OIBIT landed][oibit-final], meaning that traits
5375   like `Send` and `Sync` are now library-defined.
5376 * A [Reflect trait][reflect] was introduced, which means that
5377   downcasting via the `Any` trait is effectively limited to concrete
5378   types. This helps retain the potentially-important "parametricity"
5379   property: generic code cannot behave differently for different type
5380   arguments except in minor ways.
5381 * The `unsafe_destructor` feature is now deprecated in favor of the
5382   [new `dropck`][dropck]. This change is a major reduction in unsafe
5383   code.
5384
5385 Libraries
5386 ---------
5387
5388 * The `thread_local` module [has been renamed to `std::thread`][th].
5389 * The methods of `IteratorExt` [have been moved to the `Iterator`
5390   trait itself][ie].
5391 * Several traits that implement Rust's conventions for type
5392   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
5393   [centralized in the `std::convert` module][con].
5394 * The `FromError` trait [was removed in favor of `From`][fe].
5395 * The basic sleep function [has moved to
5396   `std::thread::sleep_ms`][slp].
5397 * The `splitn` function now takes an `n` parameter that represents the
5398   number of items yielded by the returned iterator [instead of the
5399   number of 'splits'][spl].
5400 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
5401 * [Derived implementations of `PartialOrd` now order enums according
5402   to their explicitly-assigned discriminants][po].
5403 * [Methods for searching strings are generic over `Pattern`s][pat],
5404   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
5405   some others.
5406 * [In method resolution, object methods are resolved before inherent
5407   methods][meth].
5408 * [`String::from_str` has been deprecated in favor of the `From` impl,
5409   `String::from`][sf].
5410 * [`io::Error` implements `Sync`][ios].
5411 * [The `words` method on `&str` has been replaced with
5412   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
5413   a word?'
5414 * The new path and IO modules are complete and `#[stable]`. This
5415   was the major library focus for this cycle.
5416 * The path API was [revised][path-normalize] to normalize `.`,
5417   adjusting the tradeoffs in favor of the most common usage.
5418 * A large number of remaining APIs in `std` were also stabilized
5419   during this cycle; about 75% of the non-deprecated API surface
5420   is now stable.
5421 * The new [string pattern API][string-pattern] landed, which makes
5422   the string slice API much more internally consistent and flexible.
5423 * A new set of [generic conversion traits][conversion] replaced
5424   many existing ad hoc traits.
5425 * Generic numeric traits were [completely removed][num-traits]. This
5426   was made possible thanks to inherent methods for primitive types,
5427   and the removal gives maximal flexibility for designing a numeric
5428   hierarchy in the future.
5429 * The `Fn` traits are now related via [inheritance][fn-inherit]
5430   and provide ergonomic [blanket implementations][fn-blanket].
5431 * The `Index` and `IndexMut` traits were changed to
5432   [take the index by value][index-value], enabling code like
5433   `hash_map["string"]` to work.
5434 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
5435   `Copy` data is known to be `Clone` as well.
5436
5437 Misc
5438 ----
5439
5440 * Many errors now have extended explanations that can be accessed with
5441   the `--explain` flag to `rustc`.
5442 * Many new examples have been added to the standard library
5443   documentation.
5444 * rustdoc has received a number of improvements focused on completion
5445   and polish.
5446 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
5447 * Much headway was made on ecosystem-wide CI, making it possible
5448   to [compare builds for breakage][ci-compare].
5449
5450
5451 [crates.io]: http://crates.io
5452 [clo]: https://github.com/rust-lang/rust/pull/24034
5453 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
5454 [con]: https://github.com/rust-lang/rust/pull/23875
5455 [cr]: https://github.com/rust-lang/rust/pull/23419
5456 [fe]: https://github.com/rust-lang/rust/pull/23879
5457 [ie]: https://github.com/rust-lang/rust/pull/23300
5458 [inv]: https://github.com/rust-lang/rust/pull/23938
5459 [ios]: https://github.com/rust-lang/rust/pull/24133
5460 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
5461 [lt]: https://github.com/rust-lang/rust/pull/24057
5462 [meth]: https://github.com/rust-lang/rust/pull/24056
5463 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
5464 [po]: https://github.com/rust-lang/rust/pull/24270
5465 [sf]: https://github.com/rust-lang/rust/pull/24517
5466 [slp]: https://github.com/rust-lang/rust/pull/23949
5467 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
5468 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
5469 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
5470 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
5471 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
5472 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
5473 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
5474 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
5475 [self-sized]: https://github.com/rust-lang/rust/pull/22301
5476 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
5477 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
5478 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
5479 [reflect]: https://github.com/rust-lang/rust/pull/23712
5480 [conversion]: https://github.com/rust-lang/rfcs/pull/529
5481 [num-traits]: https://github.com/rust-lang/rust/pull/23549
5482 [index-value]: https://github.com/rust-lang/rust/pull/23601
5483 [dropck]: https://github.com/rust-lang/rfcs/pull/769
5484 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
5485 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
5486 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
5487 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
5488 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
5489
5490
5491 Version 1.0.0-alpha.2 (2015-02-20)
5492 =====================================
5493
5494 * ~1300 changes, numerous bugfixes
5495
5496 * Highlights
5497
5498     * The various I/O modules were [overhauled][io-rfc] to reduce
5499       unnecessary abstractions and provide better interoperation with
5500       the underlying platform. The old `io` module remains temporarily
5501       at `std::old_io`.
5502     * The standard library now [participates in feature gating][feat],
5503       so use of unstable libraries now requires a `#![feature(...)]`
5504       attribute. The impact of this change is [described on the
5505       forum][feat-forum]. [RFC][feat-rfc].
5506
5507 * Language
5508
5509     * `for` loops [now operate on the `IntoIterator` trait][into],
5510       which eliminates the need to call `.iter()`, etc. to iterate
5511       over collections. There are some new subtleties to remember
5512       though regarding what sort of iterators various types yield, in
5513       particular that `for foo in bar { }` yields values from a move
5514       iterator, destroying the original collection. [RFC][into-rfc].
5515     * Objects now have [default lifetime bounds][obj], so you don't
5516       have to write `Box<Trait+'static>` when you don't care about
5517       storing references. [RFC][obj-rfc].
5518     * In types that implement `Drop`, [lifetimes must outlive the
5519       value][drop]. This will soon make it possible to safely
5520       implement `Drop` for types where `#[unsafe_destructor]` is now
5521       required. Read the [gorgeous RFC][drop-rfc] for details.
5522     * The fully qualified <T as Trait>::X syntax lets you set the Self
5523       type for a trait method or associated type. [RFC][ufcs-rfc].
5524     * References to types that implement `Deref<U>` now [automatically
5525       coerce to references][deref] to the dereferenced type `U`,
5526       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
5527       should eliminate many unsightly uses of `&*`, as when converting
5528       from references to vectors into references to
5529       slices. [RFC][deref-rfc].
5530     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
5531       `|:|`) is obsolete and closure kind is inferred from context.
5532     * [`Self` is a keyword][Self].
5533
5534 * Libraries
5535
5536     * The `Show` and `String` formatting traits [have been
5537       renamed][fmt] to `Debug` and `Display` to more clearly reflect
5538       their related purposes. Automatically getting a string
5539       conversion to use with `format!("{:?}", something_to_debug)` is
5540       now written `#[derive(Debug)]`.
5541     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
5542       OsStr}`, provide strings in platform-specific encodings for easier
5543       interop with system APIs. [RFC][osstr-rfc].
5544     * The `boxed::into_raw` and `Box::from_raw` functions [convert
5545       between `Box<T>` and `*mut T`][boxraw], a common pattern for
5546       creating raw pointers.
5547
5548 * Tooling
5549
5550     * Certain long error messages of the form 'expected foo found bar'
5551       are now [split neatly across multiple
5552       lines][multiline]. Examples in the PR.
5553     * On Unix Rust can be [uninstalled][un] by running
5554       `/usr/local/lib/rustlib/uninstall.sh`.
5555     * The `#[rustc_on_unimplemented]` attribute, requiring the
5556       'on_unimplemented' feature, lets rustc [display custom error
5557       messages when a trait is expected to be implemented for a type
5558       but is not][onun].
5559
5560 * Misc
5561
5562     * Rust is tested against a [LALR grammar][lalr], which parses
5563       almost all the Rust files that rustc does.
5564
5565 [boxraw]: https://github.com/rust-lang/rust/pull/21318
5566 [close]: https://github.com/rust-lang/rust/pull/21843
5567 [deref]: https://github.com/rust-lang/rust/pull/21351
5568 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
5569 [drop]: https://github.com/rust-lang/rust/pull/21972
5570 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
5571 [feat]: https://github.com/rust-lang/rust/pull/21248
5572 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
5573 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
5574 [fmt]: https://github.com/rust-lang/rust/pull/21457
5575 [into]: https://github.com/rust-lang/rust/pull/20790
5576 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
5577 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5578 [lalr]: https://github.com/rust-lang/rust/pull/21452
5579 [multiline]: https://github.com/rust-lang/rust/pull/19870
5580 [obj]: https://github.com/rust-lang/rust/pull/22230
5581 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
5582 [onun]: https://github.com/rust-lang/rust/pull/20889
5583 [osstr]: https://github.com/rust-lang/rust/pull/21488
5584 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
5585 [Self]: https://github.com/rust-lang/rust/pull/22158
5586 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
5587 [un]: https://github.com/rust-lang/rust/pull/22256
5588
5589
5590 Version 1.0.0-alpha (2015-01-09)
5591 ==================================
5592
5593   * ~2400 changes, numerous bugfixes
5594
5595   * Highlights
5596
5597     * The language itself is considered feature complete for 1.0,
5598       though there will be many usability improvements and bugfixes
5599       before the final release.
5600     * Nearly 50% of the public API surface of the standard library has
5601       been declared 'stable'. Those interfaces are unlikely to change
5602       before 1.0.
5603     * The long-running debate over integer types has been
5604       [settled][ints]: Rust will ship with types named `isize` and
5605       `usize`, rather than `int` and `uint`, for pointer-sized
5606       integers. Guidelines will be rolled out during the alpha cycle.
5607     * Most crates that are not `std` have been moved out of the Rust
5608       distribution into the Cargo ecosystem so they can evolve
5609       separately and don't need to be stabilized as quickly, including
5610       'time', 'getopts', 'num', 'regex', and 'term'.
5611     * Documentation continues to be expanded with more API coverage, more
5612       examples, and more in-depth explanations. The guides have been
5613       consolidated into [The Rust Programming Language][trpl].
5614     * "[Rust By Example][rbe]" is now maintained by the Rust team.
5615     * All official Rust binary installers now come with [Cargo], the
5616       Rust package manager.
5617
5618 * Language
5619
5620     * Closures have been [completely redesigned][unboxed] to be
5621       implemented in terms of traits, can now be used as generic type
5622       bounds and thus monomorphized and inlined, or via an opaque
5623       pointer (boxed) as in the old system. The new system is often
5624       referred to as 'unboxed' closures.
5625     * Traits now support [associated types][assoc], allowing families
5626       of related types to be defined together and used generically in
5627       powerful ways.
5628     * Enum variants are [namespaced by their type names][enum].
5629     * [`where` clauses][where] provide a more versatile and attractive
5630       syntax for specifying generic bounds, though the previous syntax
5631       remains valid.
5632     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
5633       numeric types.
5634     * Rust [no longer has a runtime][rt] of any description, and only
5635       supports OS threads, not green threads.
5636     * At long last, Rust has been overhauled for 'dynamically-sized
5637       types' ([DST]), which integrates 'fat pointers' (object types,
5638       arrays, and `str`) more deeply into the type system, making it
5639       more consistent.
5640     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
5641       `..j` that produce range types and which, when combined with the
5642       `Index` operator and multidispatch, leads to a convenient slice
5643       notation, `[i..j]`.
5644     * The new range syntax revealed an ambiguity in the fixed-length
5645       array syntax, so now fixed length arrays [are written `[T;
5646       N]`][arrays].
5647     * The `Copy` trait is no longer implemented automatically. Unsafe
5648       pointers no longer implement `Sync` and `Send` so types
5649       containing them don't automatically either. `Sync` and `Send`
5650       are now 'unsafe traits' so one can "forcibly" implement them via
5651       `unsafe impl` if a type confirms to the requirements for them
5652       even though the internals do not (e.g. structs containing unsafe
5653       pointers like `Arc`). These changes are intended to prevent some
5654       footguns and are collectively known as [opt-in built-in
5655       traits][oibit] (though `Sync` and `Send` will soon become pure
5656       library types unknown to the compiler).
5657     * Operator traits now take their operands [by value][ops], and
5658       comparison traits can use multidispatch to compare one type
5659       against multiple other types, allowing e.g. `String` to be
5660       compared with `&str`.
5661     * `if let` and `while let` are no longer feature-gated.
5662     * Rust has adopted a more [uniform syntax for escaping unicode
5663       characters][unicode].
5664     * `macro_rules!` [has been declared stable][mac]. Though it is a
5665       flawed system it is sufficiently popular that it must be usable
5666       for 1.0. Effort has gone into [future-proofing][mac-future] it
5667       in ways that will allow other macro systems to be developed in
5668       parallel, and won't otherwise impact the evolution of the
5669       language.
5670     * The prelude has been [pared back significantly][prelude] such
5671       that it is the minimum necessary to support the most pervasive
5672       code patterns, and through [generalized where clauses][where]
5673       many of the prelude extension traits have been consolidated.
5674     * Rust's rudimentary reflection [has been removed][refl], as it
5675       incurred too much code generation for little benefit.
5676     * [Struct variants][structvars] are no longer feature-gated.
5677     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
5678       known as 'higher-ranked trait bounds', this crucially allows
5679       unboxed closures to work.
5680     * Macros invocations surrounded by parens or square brackets and
5681       not terminated by a semicolon are [parsed as
5682       expressions][macros], which makes expressions like `vec![1i32,
5683       2, 3].len()` work as expected.
5684     * Trait objects now implement their traits automatically, and
5685       traits that can be coerced to objects now must be [object
5686       safe][objsafe].
5687     * Automatically deriving traits is now done with `#[derive(...)]`
5688       not `#[deriving(...)]` for [consistency with other naming
5689       conventions][derive].
5690     * Importing the containing module or enum at the same time as
5691       items or variants they contain is [now done with `self` instead
5692       of `mod`][self], as in use `foo::{self, bar}`
5693     * Glob imports are no longer feature-gated.
5694     * The `box` operator and `box` patterns have been feature-gated
5695       pending a redesign. For now unique boxes should be allocated
5696       like other containers, with `Box::new`.
5697
5698 * Libraries
5699
5700     * A [series][coll1] of [efforts][coll2] to establish
5701       [conventions][coll3] for collections types has resulted in API
5702       improvements throughout the standard library.
5703     * New [APIs for error handling][err] provide ergonomic interop
5704       between error types, and [new conventions][err-conv] describe
5705       more clearly the recommended error handling strategies in Rust.
5706     * The `fail!` macro has been renamed to [`panic!`][panic] so that
5707       it is easier to discuss failure in the context of error handling
5708       without making clarifications as to whether you are referring to
5709       the 'fail' macro or failure more generally.
5710     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
5711       syscall when available.
5712     * The 'serialize' crate has been renamed 'rustc-serialize' and
5713       moved out of the distribution to Cargo. Although it is widely
5714       used now, it is expected to be superseded in the near future.
5715     * The `Show` formatter, typically implemented with
5716       `#[derive(Show)]` is [now requested with the `{:?}`
5717       specifier][show] and is intended for use by all types, for uses
5718       such as `println!` debugging. The new `String` formatter must be
5719       implemented by hand, uses the `{}` specifier, and is intended
5720       for full-fidelity conversions of things that can logically be
5721       represented as strings.
5722
5723 * Tooling
5724
5725     * [Flexible target specification][flex] allows rustc's code
5726       generation to be configured to support otherwise-unsupported
5727       platforms.
5728     * Rust comes with rust-gdb and rust-lldb scripts that launch their
5729       respective debuggers with Rust-appropriate pretty-printing.
5730     * The Windows installation of Rust is distributed with the
5731       MinGW components currently required to link binaries on that
5732       platform.
5733
5734 * Misc
5735
5736     * Nullable enum optimizations have been extended to more types so
5737       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
5738       space than the inner types themselves.
5739     * Work has begun on supporting AArch64.
5740
5741 [Cargo]: https://crates.io
5742 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
5743 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
5744 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
5745 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
5746 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
5747 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
5748 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
5749 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
5750 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
5751 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
5752 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
5753 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
5754 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
5755 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
5756 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
5757 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
5758 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
5759 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
5760 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
5761 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
5762 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
5763 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
5764 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
5765 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
5766 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
5767 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
5768 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
5769 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
5770 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
5771 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
5772 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
5773 [trpl]: https://doc.rust-lang.org/book/index.html
5774 [rbe]: http://rustbyexample.com/
5775
5776
5777 Version 0.12.0 (2014-10-09)
5778 =============================
5779
5780   * ~1900 changes, numerous bugfixes
5781
5782   * Highlights
5783
5784     * The introductory documentation (now called The Rust Guide) has
5785       been completely rewritten, as have a number of supplementary
5786       guides.
5787     * Rust's package manager, Cargo, continues to improve and is
5788       sometimes considered to be quite awesome.
5789     * Many API's in `std` have been reviewed and updated for
5790       consistency with the in-development Rust coding
5791       guidelines. The standard library documentation tracks
5792       stabilization progress.
5793     * Minor libraries have been moved out-of-tree to the rust-lang org
5794       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
5795       be installed with Cargo.
5796     * Lifetime elision allows lifetime annotations to be left off of
5797       function declarations in many common scenarios.
5798     * Rust now works on 64-bit Windows.
5799
5800   * Language
5801     * Indexing can be overloaded with the `Index` and `IndexMut`
5802       traits.
5803     * The `if let` construct takes a branch only if the `let` pattern
5804       matches, currently behind the 'if_let' feature gate.
5805     * 'where clauses', a more flexible syntax for specifying trait
5806       bounds that is more aesthetic, have been added for traits and
5807       free functions. Where clauses will in the future make it
5808       possible to constrain associated types, which would be
5809       impossible with the existing syntax.
5810     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
5811       the 'slicing_syntax' feature gate, and can be overloaded with
5812       the `Slice` or `SliceMut` traits.
5813     * The syntax for matching of sub-slices has been changed to use a
5814       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
5815       consistency with other uses of `..` and to future-proof
5816       potential additional uses of the syntax.
5817     * The syntax for matching inclusive ranges in patterns has changed
5818       from `0..3` to `0...4` to be consistent with the exclusive range
5819       syntax for slicing.
5820     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
5821       c]`) has been put behind the 'advanced_slice_patterns' feature
5822       gate and may be removed in the future.
5823     * Components of tuples and tuple structs can be extracted using
5824       the `value.0` syntax, currently behind the `tuple_indexing`
5825       feature gate.
5826     * The `#[crate_id]` attribute is no longer supported; versioning
5827       is handled by the package manager.
5828     * Renaming crate imports are now written `extern crate foo as bar`
5829       instead of `extern crate bar = foo`.
5830     * Renaming use statements are now written `use foo as bar` instead
5831       of `use bar = foo`.
5832     * `let` and `match` bindings and argument names in macros are now
5833       hygienic.
5834     * The new, more efficient, closure types ('unboxed closures') have
5835       been added under a feature gate, 'unboxed_closures'. These will
5836       soon replace the existing closure types, once higher-ranked
5837       trait lifetimes are added to the language.
5838     * `move` has been added as a keyword, for indicating closures
5839       that capture by value.
5840     * Mutation and assignment is no longer allowed in pattern guards.
5841     * Generic structs and enums can now have trait bounds.
5842     * The `Share` trait is now called `Sync` to free up the term
5843       'shared' to refer to 'shared reference' (the default reference
5844       type.
5845     * Dynamically-sized types have been mostly implemented,
5846       unifying the behavior of fat-pointer types with the rest of the
5847       type system.
5848     * As part of dynamically-sized types, the `Sized` trait has been
5849       introduced, which qualifying types implement by default, and
5850       which type parameters expect by default. To specify that a type
5851       parameter does not need to be sized, write `<Sized? T>`. Most
5852       types are `Sized`, notable exceptions being unsized arrays
5853       (`[T]`) and trait types.
5854     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
5855     * Lifetime bounds can now be applied to type parameters and object
5856       types.
5857     * The old, reference counted GC type, `Gc<T>` which was once
5858       denoted by the `@` sigil, has finally been removed. GC will be
5859       revisited in the future.
5860
5861   * Libraries
5862     * Library documentation has been improved for a number of modules.
5863     * Bit-vectors, collections::bitv has been modernized.
5864     * The url crate is deprecated in favor of
5865       http://github.com/servo/rust-url, which can be installed with
5866       Cargo.
5867     * Most I/O stream types can be cloned and subsequently closed from
5868       a different thread.
5869     * A `std::time::Duration` type has been added for use in I/O
5870       methods that rely on timers, as well as in the 'time' crate's
5871       `Timespec` arithmetic.
5872     * The runtime I/O abstraction layer that enabled the green thread
5873       scheduler to do non-thread-blocking I/O has been removed, along
5874       with the libuv-based implementation employed by the green thread
5875       scheduler. This will greatly simplify the future I/O work.
5876     * `collections::btree` has been rewritten to have a more
5877       idiomatic and efficient design.
5878
5879   * Tooling
5880     * rustdoc output now indicates the stability levels of API's.
5881     * The `--crate-name` flag can specify the name of the crate
5882       being compiled, like `#[crate_name]`.
5883     * The `-C metadata` specifies additional metadata to hash into
5884       symbol names, and `-C extra-filename` specifies additional
5885       information to put into the output filename, for use by the
5886       package manager for versioning.
5887     * debug info generation has continued to improve and should be
5888       more reliable under both gdb and lldb.
5889     * rustc has experimental support for compiling in parallel
5890       using the `-C codegen-units` flag.
5891     * rustc no longer encodes rpath information into binaries by
5892       default.
5893
5894   * Misc
5895     * Stack usage has been optimized with LLVM lifetime annotations.
5896     * Official Rust binaries on Linux are more compatible with older
5897       kernels and distributions, built on CentOS 5.10.
5898
5899
5900 Version 0.11.0 (2014-07-02)
5901 ==========================
5902
5903   * ~1700 changes, numerous bugfixes
5904
5905   * Language
5906     * ~[T] has been removed from the language. This type is superseded by
5907       the Vec<T> type.
5908     * ~str has been removed from the language. This type is superseded by
5909       the String type.
5910     * ~T has been removed from the language. This type is superseded by the
5911       Box<T> type.
5912     * @T has been removed from the language. This type is superseded by the
5913       standard library's std::gc::Gc<T> type.
5914     * Struct fields are now all private by default.
5915     * Vector indices and shift amounts are both required to be a `uint`
5916       instead of any integral type.
5917     * Byte character, byte string, and raw byte string literals are now all
5918       supported by prefixing the normal literal with a `b`.
5919     * Multiple ABIs are no longer allowed in an ABI string
5920     * The syntax for lifetimes on closures/procedures has been tweaked
5921       slightly: `<'a>|A, B|: 'b + K -> T`
5922     * Floating point modulus has been removed from the language; however it
5923       is still provided by a library implementation.
5924     * Private enum variants are now disallowed.
5925     * The `priv` keyword has been removed from the language.
5926     * A closure can no longer be invoked through a &-pointer.
5927     * The `use foo, bar, baz;` syntax has been removed from the language.
5928     * The transmute intrinsic no longer works on type parameters.
5929     * Statics now allow blocks/items in their definition.
5930     * Trait bounds are separated from objects with + instead of : now.
5931     * Objects can no longer be read while they are mutably borrowed.
5932     * The address of a static is now marked as insignificant unless the
5933       #[inline(never)] attribute is placed it.
5934     * The #[unsafe_destructor] attribute is now behind a feature gate.
5935     * Struct literals are no longer allowed in ambiguous positions such as
5936       if, while, match, and for..in.
5937     * Declaration of lang items and intrinsics are now feature-gated by
5938       default.
5939     * Integral literals no longer default to `int`, and floating point
5940       literals no longer default to `f64`. Literals must be suffixed with an
5941       appropriate type if inference cannot determine the type of the
5942       literal.
5943     * The Box<T> type is no longer implicitly borrowed to &mut T.
5944     * Procedures are now required to not capture borrowed references.
5945
5946   * Libraries
5947     * The standard library is now a "facade" over a number of underlying
5948       libraries. This means that development on the standard library should
5949       be speedier due to smaller crates, as well as a clearer line between
5950       all dependencies.
5951     * A new library, libcore, lives under the standard library's facade
5952       which is Rust's "0-assumption" library, suitable for embedded and
5953       kernel development for example.
5954     * A regex crate has been added to the standard distribution. This crate
5955       includes statically compiled regular expressions.
5956     * The unwrap/unwrap_err methods on Result require a Show bound for
5957       better error messages.
5958     * The return types of the std::comm primitives have been centralized
5959       around the Result type.
5960     * A number of I/O primitives have gained the ability to time out their
5961       operations.
5962     * A number of I/O primitives have gained the ability to close their
5963       reading/writing halves to cancel pending operations.
5964     * Reverse iterator methods have been removed in favor of `rev()` on
5965       their forward-iteration counterparts.
5966     * A bitflags! macro has been added to enable easy interop with C and
5967       management of bit flags.
5968     * A debug_assert! macro is now provided which is disabled when
5969       `--cfg ndebug` is passed to the compiler.
5970     * A graphviz crate has been added for creating .dot files.
5971     * The std::cast module has been migrated into std::mem.
5972     * The std::local_data api has been migrated from freestanding functions
5973       to being based on methods.
5974     * The Pod trait has been renamed to Copy.
5975     * jemalloc has been added as the default allocator for types.
5976     * The API for allocating memory has been changed to use proper alignment
5977       and sized deallocation
5978     * Connecting a TcpStream or binding a TcpListener is now based on a
5979       string address and a u16 port. This allows connecting to a hostname as
5980       opposed to an IP.
5981     * The Reader trait now contains a core method, read_at_least(), which
5982       correctly handles many repeated 0-length reads.
5983     * The process-spawning API is now centered around a builder-style
5984       Command struct.
5985     * The :? printing qualifier has been moved from the standard library to
5986       an external libdebug crate.
5987     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
5988       have been renamed to Eq/Ord.
5989     * The select/plural methods have been removed from format!. The escapes
5990       for { and } have also changed from \{ and \} to {{ and }},
5991       respectively.
5992     * The TaskBuilder API has been re-worked to be a true builder, and
5993       extension traits for spawning native/green tasks have been added.
5994
5995   * Tooling
5996     * All breaking changes to the language or libraries now have their
5997       commit message annotated with `[breaking-change]` to allow for easy
5998       discovery of breaking changes.
5999     * The compiler will now try to suggest how to annotate lifetimes if a
6000       lifetime-related error occurs.
6001     * Debug info continues to be improved greatly with general bug fixes and
6002       better support for situations like link time optimization (LTO).
6003     * Usage of syntax extensions when cross-compiling has been fixed.
6004     * Functionality equivalent to GCC & Clang's -ffunction-sections,
6005       -fdata-sections and --gc-sections has been enabled by default
6006     * The compiler is now stricter about where it will load module files
6007       from when a module is declared via `mod foo;`.
6008     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
6009       Syntax extensions are now discovered via a "plugin registrar" type
6010       which will be extended in the future to other various plugins.
6011     * Lints have been restructured to allow for dynamically loadable lints.
6012     * A number of rustdoc improvements:
6013       * The HTML output has been visually redesigned.
6014       * Markdown is now powered by hoedown instead of sundown.
6015       * Searching heuristics have been greatly improved.
6016       * The search index has been reduced in size by a great amount.
6017       * Cross-crate documentation via `pub use` has been greatly improved.
6018       * Primitive types are now hyperlinked and documented.
6019     * Documentation has been moved from static.rust-lang.org/doc to
6020       doc.rust-lang.org
6021     * A new sandbox, play.rust-lang.org, is available for running and
6022       sharing rust code examples on-line.
6023     * Unused attributes are now more robustly warned about.
6024     * The dead_code lint now warns about unused struct fields.
6025     * Cross-compiling to iOS is now supported.
6026     * Cross-compiling to mipsel is now supported.
6027     * Stability attributes are now inherited by default and no longer apply
6028       to intra-crate usage, only inter-crate usage.
6029     * Error message related to non-exhaustive match expressions have been
6030       greatly improved.
6031
6032
6033 Version 0.10 (2014-04-03)
6034 =========================
6035
6036   * ~1500 changes, numerous bugfixes
6037
6038   * Language
6039     * A new RFC process is now in place for modifying the language.
6040     * Patterns with `@`-pointers have been removed from the language.
6041     * Patterns with unique vectors (`~[T]`) have been removed from the
6042       language.
6043     * Patterns with unique strings (`~str`) have been removed from the
6044       language.
6045     * `@str` has been removed from the language.
6046     * `@[T]` has been removed from the language.
6047     * `@self` has been removed from the language.
6048     * `@Trait` has been removed from the language.
6049     * Headers on `~` allocations which contain `@` boxes inside the type for
6050       reference counting have been removed.
6051     * The semantics around the lifetimes of temporary expressions have changed,
6052       see #3511 and #11585 for more information.
6053     * Cross-crate syntax extensions are now possible, but feature gated. See
6054       #11151 for more information. This includes both `macro_rules!` macros as
6055       well as syntax extensions such as `format!`.
6056     * New lint modes have been added, and older ones have been turned on to be
6057       warn-by-default.
6058       * Unnecessary parentheses
6059       * Uppercase statics
6060       * Camel Case types
6061       * Uppercase variables
6062       * Publicly visible private types
6063       * `#[deriving]` with raw pointers
6064     * Unsafe functions can no longer be coerced to closures.
6065     * Various obscure macros such as `log_syntax!` are now behind feature gates.
6066     * The `#[simd]` attribute is now behind a feature gate.
6067     * Visibility is no longer allowed on `extern crate` statements, and
6068       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
6069     * Trailing commas are now allowed in argument lists and tuple patterns.
6070     * The `do` keyword has been removed, it is now a reserved keyword.
6071     * Default type parameters have been implemented, but are feature gated.
6072     * Borrowed variables through captures in closures are now considered soundly.
6073     * `extern mod` is now `extern crate`
6074     * The `Freeze` trait has been removed.
6075     * The `Share` trait has been added for types that can be shared among
6076       threads.
6077     * Labels in macros are now hygienic.
6078     * Expression/statement macro invocations can be delimited with `{}` now.
6079     * Treatment of types allowed in `static mut` locations has been tweaked.
6080     * The `*` and `.` operators are now overloadable through the `Deref` and
6081       `DerefMut` traits.
6082     * `~Trait` and `proc` no longer have `Send` bounds by default.
6083     * Partial type hints are now supported with the `_` type marker.
6084     * An `Unsafe` type was introduced for interior mutability. It is now
6085       considered undefined to transmute from `&T` to `&mut T` without using the
6086       `Unsafe` type.
6087     * The #[linkage] attribute was implemented for extern statics/functions.
6088     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
6089     * `Pod` was renamed to `Copy`.
6090
6091   * Libraries
6092     * The `libextra` library has been removed. It has now been decomposed into
6093       component libraries with smaller and more focused nuggets of
6094       functionality. The full list of libraries can be found on the
6095       documentation index page.
6096     * std: `std::condition` has been removed. All I/O errors are now propagated
6097       through the `Result` type. In order to assist with error handling, a
6098       `try!` macro for unwrapping errors with an early return and a lint for
6099       unused results has been added. See #12039 for more information.
6100     * std: The `vec` module has been renamed to `slice`.
6101     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
6102       This will become the only growable vector in the future.
6103     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
6104       are now found at `std::io::BufferedReader` instead of
6105       `std::io::buffered::BufferedReader`.
6106     * std: `print` and `println` are no longer in the prelude, the `print!` and
6107       `println!` macros are intended to be used instead.
6108     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
6109       attempts to statically prevent cycles.
6110     * std: The standard distribution is adopting the policy of pushing failure
6111       to the user rather than failing in libraries. Many functions (such as
6112       `slice::last()`) now return `Option<T>` instead of `T` + failing.
6113     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
6114       deriving mode: `#[deriving(Show)]`.
6115     * std: `ToStr` is now implemented for all types implementing `Show`.
6116     * std: The formatting trait methods now take `&self` instead of `&T`
6117     * std: The `invert()` method on iterators has been renamed to `rev()`
6118     * std: `std::num` has seen a reduction in the genericity of its traits,
6119       consolidating functionality into a few core traits.
6120     * std: Backtraces are now printed on task failure if the environment
6121       variable `RUST_BACKTRACE` is present.
6122     * std: Naming conventions for iterators have been standardized. More details
6123       can be found on the wiki's style guide.
6124     * std: `eof()` has been removed from the `Reader` trait. Specific types may
6125       still implement the function.
6126     * std: Networking types are now cloneable to allow simultaneous reads/writes.
6127     * std: `assert_approx_eq!` has been removed
6128     * std: The `e` and `E` formatting specifiers for floats have been added to
6129       print them in exponential notation.
6130     * std: The `Times` trait has been removed
6131     * std: Indications of variance and opting out of builtin bounds is done
6132       through marker types in `std::kinds::marker` now
6133     * std: `hash` has been rewritten, `IterBytes` has been removed, and
6134       `#[deriving(Hash)]` is now possible.
6135     * std: `SharedChan` has been removed, `Sender` is now cloneable.
6136     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
6137     * std: `Chan::new` is now `channel()`.
6138     * std: A new synchronous channel type has been implemented.
6139     * std: A `select!` macro is now provided for selecting over `Receiver`s.
6140     * std: `hashmap` and `trie` have been moved to `libcollections`
6141     * std: `run` has been rolled into `io::process`
6142     * std: `assert_eq!` now uses `{}` instead of `{:?}`
6143     * std: The equality and comparison traits have seen some reorganization.
6144     * std: `rand` has moved to `librand`.
6145     * std: `to_{lower,upper}case` has been implemented for `char`.
6146     * std: Logging has been moved to `liblog`.
6147     * collections: `HashMap` has been rewritten for higher performance and less
6148       memory usage.
6149     * native: The default runtime is now `libnative`. If `libgreen` is desired,
6150       it can be booted manually. The runtime guide has more information and
6151       examples.
6152     * native: All I/O functionality except signals has been implemented.
6153     * green: Task spawning with `libgreen` has been optimized with stack caching
6154       and various trimming of code.
6155     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
6156     * sync: The `extra::sync` module has been updated to modern rust (and moved
6157       to the `sync` library), tweaking and improving various interfaces while
6158       dropping redundant functionality.
6159     * sync: A new `Barrier` type has been added to the `sync` library.
6160     * sync: An efficient mutex for native and green tasks has been implemented.
6161     * serialize: The `base64` module has seen some improvement. It treats
6162       newlines better, has non-string error values, and has seen general
6163       cleanup.
6164     * fourcc: A `fourcc!` macro was introduced
6165     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
6166       hexadecimal literal.
6167
6168   * Tooling
6169     * `rustpkg` has been deprecated and removed from the main repository. Its
6170       replacement, `cargo`, is under development.
6171     * Nightly builds of rust are now available
6172     * The memory usage of rustc has been improved many times throughout this
6173       release cycle.
6174     * The build process supports disabling rpath support for the rustc binary
6175       itself.
6176     * Code generation has improved in some cases, giving more information to the
6177       LLVM optimization passes to enable more extensive optimizations.
6178     * Debuginfo compatibility with lldb on OSX has been restored.
6179     * The master branch is now gated on an android bot, making building for
6180       android much more reliable.
6181     * Output flags have been centralized into one `--emit` flag.
6182     * Crate type flags have been centralized into one `--crate-type` flag.
6183     * Codegen flags have been consolidated behind a `-C` flag.
6184     * Linking against outdated crates now has improved error messages.
6185     * Error messages with lifetimes will often suggest how to annotate the
6186       function to fix the error.
6187     * Many more types are documented in the standard library, and new guides
6188       were written.
6189     * Many `rustdoc` improvements:
6190       * code blocks are syntax highlighted.
6191       * render standalone markdown files.
6192       * the --test flag tests all code blocks by default.
6193       * exported macros are displayed.
6194       * re-exported types have their documentation inlined at the location of the
6195         first re-export.
6196       * search works across crates that have been rendered to the same output
6197         directory.
6198
6199
6200 Version 0.9 (2014-01-09)
6201 ==========================
6202
6203    * ~1800 changes, numerous bugfixes
6204
6205    * Language
6206       * The `float` type has been removed. Use `f32` or `f64` instead.
6207       * A new facility for enabling experimental features (feature gating) has
6208         been added, using the crate-level `#[feature(foo)]` attribute.
6209       * Managed boxes (@) are now behind a feature gate
6210         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
6211         standard library's `Gc` or `Rc` types instead.
6212       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
6213       * Jumping back to the top of a loop is now done with `continue` instead of
6214         `loop`.
6215       * Strings can no longer be mutated through index assignment.
6216       * Raw strings can be created via the basic `r"foo"` syntax or with matched
6217         hash delimiters, as in `r###"foo"###`.
6218       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
6219         called once.
6220       * The `&fn` type is now written `|args| -> ret` to match the literal form.
6221       * `@fn`s have been removed.
6222       * `do` only works with procs in order to make it obvious what the cost
6223         of `do` is.
6224       * Single-element tuple-like structs can no longer be dereferenced to
6225         obtain the inner value. A more comprehensive solution for overloading
6226         the dereference operator will be provided in the future.
6227       * The `#[link(...)]` attribute has been replaced with
6228         `#[crate_id = "name#vers"]`.
6229       * Empty `impl`s must be terminated with empty braces and may not be
6230         terminated with a semicolon.
6231       * Keywords are no longer allowed as lifetime names; the `self` lifetime
6232         no longer has any special meaning.
6233       * The old `fmt!` string formatting macro has been removed.
6234       * `printf!` and `printfln!` (old-style formatting) removed in favor of
6235         `print!` and `println!`.
6236       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
6237       * The `extern mod foo (name = "bar")` syntax has been removed. Use
6238         `extern mod foo = "bar"` instead.
6239       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
6240       * Macros can have attributes.
6241       * Macros can expand to items with attributes.
6242       * Macros can expand to multiple items.
6243       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
6244       * Comments may be nested.
6245       * Values automatically coerce to trait objects they implement, without
6246         an explicit `as`.
6247       * Enum discriminants are no longer an entire word but as small as needed to
6248         contain all the variants. The `repr` attribute can be used to override
6249         the discriminant size, as in `#[repr(int)]` for integer-sized, and
6250         `#[repr(C)]` to match C enums.
6251       * Non-string literals are not allowed in attributes (they never worked).
6252       * The FFI now supports variadic functions.
6253       * Octal numeric literals, as in `0o7777`.
6254       * The `concat!` syntax extension performs compile-time string concatenation.
6255       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
6256         removed as Rust no longer uses segmented stacks.
6257       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
6258       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
6259         not `*`; ignoring remaining fields of a struct is also done with `..`,
6260         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
6261       * `rustc` supports the "win64" calling convention via `extern "win64"`.
6262       * `rustc` supports the "system" calling convention, which defaults to the
6263         preferred convention for the target platform, "stdcall" on 32-bit Windows,
6264         "C" elsewhere.
6265       * The `type_overflow` lint (default: warn) checks literals for overflow.
6266       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
6267       * The `attribute_usage` lint (default: warn) warns about unknown
6268         attributes.
6269       * The `unknown_features` lint (default: warn) warns about unknown
6270         feature gates.
6271       * The `dead_code` lint (default: warn) checks for dead code.
6272       * Rust libraries can be linked statically to one another
6273       * `#[link_args]` is behind the `link_args` feature gate.
6274       * Native libraries are now linked with `#[link(name = "foo")]`
6275       * Native libraries can be statically linked to a rust crate
6276         (`#[link(name = "foo", kind = "static")]`).
6277       * Native OS X frameworks are now officially supported
6278         (`#[link(name = "foo", kind = "framework")]`).
6279       * The `#[thread_local]` attribute creates thread-local (not task-local)
6280         variables. Currently behind the `thread_local` feature gate.
6281       * The `return` keyword may be used in closures.
6282       * Types that can be copied via a memcpy implement the `Pod` kind.
6283       * The `cfg` attribute can now be used on struct fields and enum variants.
6284
6285    * Libraries
6286       * std: The `option` and `result` API's have been overhauled to make them
6287         simpler, more consistent, and more composable.
6288       * std: The entire `std::io` module has been replaced with one that is
6289         more comprehensive and that properly interfaces with the underlying
6290         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
6291         implemented.
6292       * std: `io::util` contains a number of useful implementations of
6293         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
6294         `ZeroReader`, `TeeReader`.
6295       * std: The reference counted pointer type `extra::rc` moved into std.
6296       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
6297         just a wrapper around it).
6298       * std: The `Either` type has been removed.
6299       * std: `fmt::Default` can be implemented for any type to provide default
6300         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
6301       * std: The `rand` API continues to be tweaked.
6302       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
6303         on failure in gdb, is now named `rust_fail`.
6304       * std: The `each_key` and `each_value` methods on `HashMap` have been
6305         replaced by the `keys` and `values` iterators.
6306       * std: Functions dealing with type size and alignment have moved from the
6307         `sys` module to the `mem` module.
6308       * std: The `path` module was written and API changed.
6309       * std: `str::from_utf8` has been changed to cast instead of allocate.
6310       * std: `starts_with` and `ends_with` methods added to vectors via the
6311         `ImmutableEqVector` trait, which is in the prelude.
6312       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
6313         if the index is out of bounds.
6314       * std: Task failure no longer propagates between tasks, as the model was
6315         complex, expensive, and incompatible with thread-based tasks.
6316       * std: The `Any` type can be used for dynamic typing.
6317       * std: `~Any` can be passed to the `fail!` macro and retrieved via
6318         `task::try`.
6319       * std: Methods that produce iterators generally do not have an `_iter`
6320         suffix now.
6321       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
6322         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
6323       * std: `util::ignore` renamed to `prelude::drop`.
6324       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
6325         trait.
6326       * std: `vec::raw` has seen a lot of cleanup and API changes.
6327       * std: The standard library no longer includes any C++ code, and very
6328         minimal C, eliminating the dependency on libstdc++.
6329       * std: Runtime scheduling and I/O functionality has been factored out into
6330         extensible interfaces and is now implemented by two different crates:
6331         libnative, for native threading and I/O; and libgreen, for green threading
6332         and I/O. This paves the way for using the standard library in more limited
6333         embedded environments.
6334       * std: The `comm` module has been rewritten to be much faster, have a
6335         simpler, more consistent API, and to work for both native and green
6336         threading.
6337       * std: All libuv dependencies have been moved into the rustuv crate.
6338       * native: New implementations of runtime scheduling on top of OS threads.
6339       * native: New native implementations of TCP, UDP, file I/O, process spawning,
6340         and other I/O.
6341       * green: The green thread scheduler and message passing types are almost
6342         entirely lock-free.
6343       * extra: The `flatpipes` module had bitrotted and was removed.
6344       * extra: All crypto functions have been removed and Rust now has a policy of
6345         not reimplementing crypto in the standard library. In the future crypto
6346         will be provided by external crates with bindings to established libraries.
6347       * extra: `c_vec` has been modernized.
6348       * extra: The `sort` module has been removed. Use the `sort` method on
6349         mutable slices.
6350
6351    * Tooling
6352       * The `rust` and `rusti` commands have been removed, due to lack of
6353         maintenance.
6354       * `rustdoc` was completely rewritten.
6355       * `rustdoc` can test code examples in documentation.
6356       * `rustpkg` can test packages with the argument, 'test'.
6357       * `rustpkg` supports arbitrary dependencies, including C libraries.
6358       * `rustc`'s support for generating debug info is improved again.
6359       * `rustc` has better error reporting for unbalanced delimiters.
6360       * `rustc`'s JIT support was removed due to bitrot.
6361       * Executables and static libraries can be built with LTO (-Z lto)
6362       * `rustc` adds a `--dep-info` flag for communicating dependencies to
6363         build tools.
6364
6365
6366 Version 0.8 (2013-09-26)
6367 ============================
6368
6369    * ~2200 changes, numerous bugfixes
6370
6371    * Language
6372       * The `for` loop syntax has changed to work with the `Iterator` trait.
6373       * At long last, unwinding works on Windows.
6374       * Default methods are ready for use.
6375       * Many trait inheritance bugs fixed.
6376       * Owned and borrowed trait objects work more reliably.
6377       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
6378       * rustc can omit emission of code for the `debug!` macro if it is passed
6379         `--cfg ndebug`
6380       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
6381         for foo.rs, then foo/mod.rs, and will generate an error when both are
6382         present.
6383       * Strings no longer contain trailing nulls. The new `std::c_str` module
6384         provides new mechanisms for converting to C strings.
6385       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
6386       * The FFI has been overhauled such that foreign functions are called directly,
6387         instead of through a stack-switching wrapper.
6388       * Calling a foreign function must be done through a Rust function with the
6389         `#[fixed_stack_segment]` attribute.
6390       * The `externfn!` macro can be used to declare both a foreign function and
6391         a `#[fixed_stack_segment]` wrapper at once.
6392       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
6393       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
6394       * `priv` is disallowed everywhere except for struct fields and enum variants.
6395       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
6396       * `ref` bindings in irrefutable patterns work correctly now.
6397       * `char` is now prevented from containing invalid code points.
6398       * Casting to `bool` is no longer allowed.
6399       * `\0` is now accepted as an escape in chars and strings.
6400       * `yield` is a reserved keyword.
6401       * `typeof` is a reserved keyword.
6402       * Crates may be imported by URL with `extern mod foo = "url";`.
6403       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
6404       * Static vectors can be initialized with repeating elements,
6405         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
6406       * Static structs can be initialized with functional record update,
6407         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
6408       * `cfg!` can be used to conditionally execute code based on the crate
6409         configuration, similarly to `#[cfg(...)]`.
6410       * The `unnecessary_qualification` lint detects unneeded module
6411         prefixes (default: allow).
6412       * Arithmetic operations have been implemented on the SIMD types in
6413         `std::unstable::simd`.
6414       * Exchange allocation headers were removed, reducing memory usage.
6415       * `format!` implements a completely new, extensible, and higher-performance
6416         string formatting system. It will replace `fmt!`.
6417       * `print!` and `println!` write formatted strings (using the `format!`
6418         extension) to stdout.
6419       * `write!` and `writeln!` write formatted strings (using the `format!`
6420         extension) to the new Writers in `std::rt::io`.
6421       * The library section in which a function or static is placed may
6422         be specified with `#[link_section = "..."]`.
6423       * The `proto!` syntax extension for defining bounded message protocols
6424         was removed.
6425       * `macro_rules!` is hygienic for `let` declarations.
6426       * The `#[export_name]` attribute specifies the name of a symbol.
6427       * `unreachable!` can be used to indicate unreachable code, and fails
6428         if executed.
6429
6430    * Libraries
6431       * std: Transitioned to the new runtime, written in Rust.
6432       * std: Added an experimental I/O library, `rt::io`, based on the new
6433         runtime.
6434       * std: A new generic `range` function was added to the prelude, replacing
6435         `uint::range` and friends.
6436       * std: `range_rev` no longer exists. Since range is an iterator it can be
6437         reversed with `range(lo, hi).invert()`.
6438       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
6439         renamed to `unwrap_or`.
6440       * std: The `iterator` module was renamed to `iter`.
6441       * std: Integral types now support the `checked_add`, `checked_sub`, and
6442         `checked_mul` operations for detecting overflow.
6443       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
6444         consistency.
6445       * std: Methods are standardizing on conventions for casting methods:
6446         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
6447         and cheap casts.
6448       * std: The `CString` type in `c_str` provides new ways to convert to and
6449         from C strings.
6450       * std: `DoubleEndedIterator` can yield elements in two directions.
6451       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
6452         two splices.
6453       * std: `str::from_bytes` renamed to `str::from_utf8`.
6454       * std: `pop_opt` and `shift_opt` methods added to vectors.
6455       * std: The task-local data interface no longer uses @, and keys are
6456         no longer function pointers.
6457       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
6458       * std: Added `SharedPort` to `comm`.
6459       * std: `Eq` has a default method for `ne`; only `eq` is required
6460         in implementations.
6461       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
6462         is required in implementations.
6463       * std: `is_utf8` performance is improved, impacting many string functions.
6464       * std: `os::MemoryMap` provides cross-platform mmap.
6465       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
6466         are not 'in-bounds' are considered undefined.
6467       * std: Many freestanding functions in `vec` removed in favor of methods.
6468       * std: Many freestanding functions on scalar types removed in favor of
6469         methods.
6470       * std: Many options to task builders were removed since they don't make
6471         sense in the new scheduler design.
6472       * std: More containers implement `FromIterator` so can be created by the
6473         `collect` method.
6474       * std: More complete atomic types in `unstable::atomics`.
6475       * std: `comm::PortSet` removed.
6476       * std: Mutating methods in the `Set` and `Map` traits have been moved into
6477         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
6478         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
6479         default implementations.
6480       * std: Various `from_str` functions were removed in favor of a generic
6481         `from_str` which is available in the prelude.
6482       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
6483       * extra: `dlist`, the doubly-linked list was modernized.
6484       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
6485       * extra: Added `glob` module, replacing `std::os::glob`.
6486       * extra: `rope` was removed.
6487       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
6488       * extra: `net`, and `timer` were removed. The experimental replacements
6489         are `std::rt::io::net` and `std::rt::io::timer`.
6490       * extra: Iterators implemented for `SmallIntMap`.
6491       * extra: Iterators implemented for `Bitv` and `BitvSet`.
6492       * extra: `SmallIntSet` removed. Use `BitvSet`.
6493       * extra: Performance of JSON parsing greatly improved.
6494       * extra: `semver` updated to SemVer 2.0.0.
6495       * extra: `term` handles more terminals correctly.
6496       * extra: `dbg` module removed.
6497       * extra: `par` module removed.
6498       * extra: `future` was cleaned up, with some method renames.
6499       * extra: Most free functions in `getopts` were converted to methods.
6500
6501    * Other
6502       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
6503       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
6504         similarly to gcc's `--march` flag.
6505       * rustc's performance compiling small crates is much better.
6506       * rustpkg has received many improvements.
6507       * rustpkg supports git tags as package IDs.
6508       * rustpkg builds into target-specific directories so it can be used for
6509         cross-compiling.
6510       * The number of concurrent test tasks is controlled by the environment
6511         variable RUST_TEST_TASKS.
6512       * The test harness can now report metrics for benchmarks.
6513       * All tools have man pages.
6514       * Programs compiled with `--test` now support the `-h` and `--help` flags.
6515       * The runtime uses jemalloc for allocations.
6516       * Segmented stacks are temporarily disabled as part of the transition to
6517         the new runtime. Stack overflows are possible!
6518       * A new documentation backend, rustdoc_ng, is available for use. It is
6519         still invoked through the normal `rustdoc` command.
6520
6521
6522 Version 0.7 (2013-07-03)
6523 =======================
6524
6525    * ~2000 changes, numerous bugfixes
6526
6527    * Language
6528       * `impl`s no longer accept a visibility qualifier. Put them on methods
6529         instead.
6530       * The borrow checker has been rewritten with flow-sensitivity, fixing
6531         many bugs and inconveniences.
6532       * The `self` parameter no longer implicitly means `&'self self`,
6533         and can be explicitly marked with a lifetime.
6534       * Overloadable compound operators (`+=`, etc.) have been temporarily
6535         removed due to bugs.
6536       * The `for` loop protocol now requires `for`-iterators to return `bool`
6537         so they compose better.
6538       * The `Durable` trait is replaced with the `'static` bounds.
6539       * Trait default methods work more often.
6540       * Structs with the `#[packed]` attribute have byte alignment and
6541         no padding between fields.
6542       * Type parameters bound by `Copy` must now be copied explicitly with
6543         the `copy` keyword.
6544       * It is now illegal to move out of a dereferenced unsafe pointer.
6545       * `Option<~T>` is now represented as a nullable pointer.
6546       * `@mut` does dynamic borrow checks correctly.
6547       * The `main` function is only detected at the topmost level of the crate.
6548         The `#[main]` attribute is still valid anywhere.
6549       * Struct fields may no longer be mutable. Use inherited mutability.
6550       * The `#[no_send]` attribute makes a type that would otherwise be
6551         `Send`, not.
6552       * The `#[no_freeze]` attribute makes a type that would otherwise be
6553         `Freeze`, not.
6554       * Unbounded recursion will abort the process after reaching the limit
6555         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
6556       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
6557         are never implicitly copyable.
6558       * `#[static_assert]` makes compile-time assertions about static bools.
6559       * At long last, 'argument modes' no longer exist.
6560       * The rarely used `use mod` statement no longer exists.
6561
6562    * Syntax extensions
6563       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
6564         argument list.
6565       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
6566         `Rand`, `Zero` and `ToStr` can all be automatically derived with
6567         `#[deriving(...)]`.
6568       * The `bytes!` macro returns a vector of bytes for string, u8, char,
6569         and unsuffixed integer literals.
6570
6571    * Libraries
6572       * The `core` crate was renamed to `std`.
6573       * The `std` crate was renamed to `extra`.
6574       * More and improved documentation.
6575       * std: `iterator` module for external iterator objects.
6576       * Many old-style (internal, higher-order function) iterators replaced by
6577         implementations of `Iterator`.
6578       * std: Many old internal vector and string iterators,
6579         incl. `any`, `all`. removed.
6580       * std: The `finalize` method of `Drop` renamed to `drop`.
6581       * std: The `drop` method now takes `&mut self` instead of `&self`.
6582       * std: The prelude no longer re-exports any modules, only types and traits.
6583       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
6584         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
6585       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
6586         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
6587       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
6588         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
6589       * std: Many types implement `Clone`.
6590       * std: `path` type renamed to `Path`.
6591       * std: `mut` module and `Mut` type removed.
6592       * std: Many standalone functions removed in favor of methods and iterators
6593         in `vec`, `str`. In the future methods will also work as functions.
6594       * std: `reinterpret_cast` removed. Use `transmute`.
6595       * std: ascii string handling in `std::ascii`.
6596       * std: `Rand` is implemented for ~/@.
6597       * std: `run` module for spawning processes overhauled.
6598       * std: Various atomic types added to `unstable::atomic`.
6599       * std: Various types implement `Zero`.
6600       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
6601       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
6602       * std: Added `os::mkdir_recursive`.
6603       * std: Added `os::glob` function performs filesystems globs.
6604       * std: `FuzzyEq` renamed to `ApproxEq`.
6605       * std: `Map` now defines `pop` and `swap` methods.
6606       * std: `Cell` constructors converted to static methods.
6607       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
6608       * extra: `flate` module moved from `std` to `extra`.
6609       * extra: `fileinput` module for iterating over a series of files.
6610       * extra: `Complex` number type and `complex` module.
6611       * extra: `Rational` number type and `rational` module.
6612       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
6613       * extra: `term` uses terminfo now, is more correct.
6614       * extra: `arc` functions converted to methods.
6615       * extra: Implementation of fixed output size variations of SHA-2.
6616
6617    * Tooling
6618       * `unused_variable`  lint mode for unused variables (default: warn).
6619       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
6620         (default: warn).
6621       * `unused_mut` lint mode for identifying unused `mut` qualifiers
6622         (default: warn).
6623       * `dead_assignment` lint mode for unread variables (default: warn).
6624       * `unnecessary_allocation` lint mode detects some heap allocations that are
6625         immediately borrowed so could be written without allocating (default: warn).
6626       * `missing_doc` lint mode (default: allow).
6627       * `unreachable_code` lint mode (default: warn).
6628       * The `rusti` command has been rewritten and a number of bugs addressed.
6629       * rustc outputs in color on more terminals.
6630       * rustc accepts a `--link-args` flag to pass arguments to the linker.
6631       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
6632       * Compiling with `-g` will make the binary record information about
6633         dynamic borrowcheck failures for debugging.
6634       * rustdoc has a nicer stylesheet.
6635       * Various improvements to rustdoc.
6636       * Improvements to rustpkg (see the detailed release notes).
6637
6638
6639 Version 0.6 (2013-04-03)
6640 ========================
6641
6642    * ~2100 changes, numerous bugfixes
6643
6644    * Syntax changes
6645       * The self type parameter in traits is now spelled `Self`
6646       * The `self` parameter in trait and impl methods must now be explicitly
6647         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
6648       * Static methods no longer require the `static` keyword and instead
6649         are distinguished by the lack of a `self` parameter
6650       * Replaced the `Durable` trait with the `'static` lifetime
6651       * The old closure type syntax with the trailing sigil has been
6652         removed in favor of the more consistent leading sigil
6653       * `super` is a keyword, and may be prefixed to paths
6654       * Trait bounds are separated with `+` instead of whitespace
6655       * Traits are implemented with `impl Trait for Type`
6656         instead of `impl Type: Trait`
6657       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
6658       * The `export` keyword has finally been removed
6659       * The `move` keyword has been removed (see "Semantic changes")
6660       * The interior mutability qualifier on vectors, `[mut T]`, has been
6661         removed. Use `&mut [T]`, etc.
6662       * `mut` is no longer valid in `~mut T`. Use inherited mutability
6663       * `fail` is no longer a keyword. Use `fail!()`
6664       * `assert` is no longer a keyword. Use `assert!()`
6665       * `log` is no longer a keyword. use `debug!`, etc.
6666       * 1-tuples may be represented as `(T,)`
6667       * Struct fields may no longer be `mut`. Use inherited mutability,
6668         `@mut T`, `core::mut` or `core::cell`
6669       * `extern mod { ... }` is no longer valid syntax for foreign
6670         function modules. Use extern blocks: `extern { ... }`
6671       * Newtype enums removed. Use tuple-structs.
6672       * Trait implementations no longer support visibility modifiers
6673       * Pattern matching over vectors improved and expanded
6674       * `const` renamed to `static` to correspond to lifetime name,
6675         and make room for future `static mut` unsafe mutable globals.
6676       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
6677       * `Clone` implementations can be automatically generated with
6678         `#[deriving(Clone)]`
6679       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
6680         instead of `foo as Bar`.
6681       * Fixed length vector types are now written as `[int, .. 3]`
6682         instead of `[int * 3]`.
6683       * Fixed length vector types can express the length as a constant
6684         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
6685
6686    * Semantic changes
6687       * Types with owned pointers or custom destructors move by default,
6688         eliminating the `move` keyword
6689       * All foreign functions are considered unsafe
6690       * &mut is now unaliasable
6691       * Writes to borrowed @mut pointers are prevented dynamically
6692       * () has size 0
6693       * The name of the main function can be customized using #[main]
6694       * The default type of an inferred closure is &fn instead of @fn
6695       * `use` statements may no longer be "chained" - they cannot import
6696         identifiers imported by previous `use` statements
6697       * `use` statements are crate relative, importing from the "top"
6698         of the crate by default. Paths may be prefixed with `super::`
6699         or `self::` to change the search behavior.
6700       * Method visibility is inherited from the implementation declaration
6701       * Structural records have been removed
6702       * Many more types can be used in static items, including enums
6703         'static-lifetime pointers and vectors
6704       * Pattern matching over vectors improved and expanded
6705       * Typechecking of closure types has been overhauled to
6706         improve inference and eliminate unsoundness
6707       * Macros leave scope at the end of modules, unless that module is
6708         tagged with #[macro_escape]
6709
6710    * Libraries
6711       * Added big integers to `std::bigint`
6712       * Removed `core::oldcomm` module
6713       * Added pipe-based `core::comm` module
6714       * Numeric traits have been reorganized under `core::num`
6715       * `vec::slice` finally returns a slice
6716       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
6717       * Containers reorganized around traits in `core::container`
6718       * `core::dvec` removed, `~[T]` is a drop-in replacement
6719       * `core::send_map` renamed to `core::hashmap`
6720       * `std::map` removed; replaced with `core::hashmap`
6721       * `std::treemap` reimplemented as an owned balanced tree
6722       * `std::deque` and `std::smallintmap` reimplemented as owned containers
6723       * `core::trie` added as a fast ordered map for integer keys
6724       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
6725       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
6726         overload the comparison operators, whereas `TotalOrd` is used
6727         by certain container types
6728
6729    * Other
6730       * Replaced the 'cargo' package manager with 'rustpkg'
6731       * Added all-purpose 'rust' tool
6732       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
6733       * rustc now *attempts* to offer spelling suggestions
6734       * Improved support for ARM and Android
6735       * Preliminary MIPS backend
6736       * Improved foreign function ABI implementation for x86, x86_64
6737       * Various memory usage improvements
6738       * Rust code may be embedded in foreign code under limited circumstances
6739       * Inline assembler supported by new asm!() syntax extension.
6740
6741
6742 Version 0.5 (2012-12-21)
6743 ===========================
6744
6745    * ~900 changes, numerous bugfixes
6746
6747    * Syntax changes
6748       * Removed `<-` move operator
6749       * Completed the transition from the `#fmt` extension syntax to `fmt!`
6750       * Removed old fixed length vector syntax - `[T]/N`
6751       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
6752       * Macros may now expand to items and statements
6753       * `a.b()` is always parsed as a method call, never as a field projection
6754       * `Eq` and `IterBytes` implementations can be automatically generated
6755         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
6756       * Removed the special crate language for `.rc` files
6757       * Function arguments may consist of any irrefutable pattern
6758
6759    * Semantic changes
6760       * `&` and `~` pointers may point to objects
6761       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
6762       * Enum variants may be structs
6763       * Destructors can be added to all nominal types with the Drop trait
6764       * Structs and nullary enum variants may be constants
6765       * Values that cannot be implicitly copied are now automatically moved
6766         without writing `move` explicitly
6767       * `&T` may now be coerced to `*T`
6768       * Coercions happen in `let` statements as well as function calls
6769       * `use` statements now take crate-relative paths
6770       * The module and type namespaces have been merged so that static
6771         method names can be resolved under the trait in which they are
6772         declared
6773
6774    * Improved support for language features
6775       * Trait inheritance works in many scenarios
6776       * More support for explicit self arguments in methods - `self`, `&self`
6777         `@self`, and `~self` all generally work as expected
6778       * Static methods work in more situations
6779       * Experimental: Traits may declare default methods for the implementations
6780         to use
6781
6782    * Libraries
6783       * New condition handling system in `core::condition`
6784       * Timsort added to `std::sort`
6785       * New priority queue, `std::priority_queue`
6786       * Pipes for serializable types, `std::flatpipes'
6787       * Serialization overhauled to be trait-based
6788       * Expanded `getopts` definitions
6789       * Moved futures to `std`
6790       * More functions are pure now
6791       * `core::comm` renamed to `oldcomm`. Still deprecated
6792       * `rustdoc` and `cargo` are libraries now
6793
6794    * Misc
6795       * Added a preliminary REPL, `rusti`
6796       * License changed from MIT to dual MIT/APL2
6797
6798
6799 Version 0.4 (2012-10-15)
6800 ==========================
6801
6802    * ~2000 changes, numerous bugfixes
6803
6804    * Syntax
6805       * All keywords are now strict and may not be used as identifiers anywhere
6806       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
6807         'of', 'with', 'to', 'class'.
6808       * Classes are replaced with simpler structs
6809       * Explicit method self types
6810       * `ret` became `return` and `alt` became `match`
6811       * `import` is now `use`; `use is now `extern mod`
6812       * `extern mod { ... }` is now `extern { ... }`
6813       * `use mod` is the recommended way to import modules
6814       * `pub` and `priv` replace deprecated export lists
6815       * The syntax of `match` pattern arms now uses fat arrow (=>)
6816       * `main` no longer accepts an args vector; use `os::args` instead
6817
6818    * Semantics
6819       * Trait implementations are now coherent, ala Haskell typeclasses
6820       * Trait methods may be static
6821       * Argument modes are deprecated
6822       * Borrowed pointers are much more mature and recommended for use
6823       * Strings and vectors in the static region are stored in constant memory
6824       * Typestate was removed
6825       * Resolution rewritten to be more reliable
6826       * Support for 'dual-mode' data structures (freezing and thawing)
6827
6828    * Libraries
6829       * Most binary operators can now be overloaded via the traits in
6830         `core::ops'
6831       * `std::net::url` for representing URLs
6832       * Sendable hash maps in `core::send_map`
6833       * `core::task' gained a (currently unsafe) task-local storage API
6834
6835    * Concurrency
6836       * An efficient new intertask communication primitive called the pipe,
6837         along with a number of higher-level channel types, in `core::pipes`
6838       * `std::arc`, an atomically reference counted, immutable, shared memory
6839         type
6840       * `std::sync`, various exotic synchronization tools based on arcs and pipes
6841       * Futures are now based on pipes and sendable
6842       * More robust linked task failure
6843       * Improved task builder API
6844
6845    * Other
6846       * Improved error reporting
6847       * Preliminary JIT support
6848       * Preliminary work on precise GC
6849       * Extensive architectural improvements to rustc
6850       * Begun a transition away from buggy C++-based reflection (shape) code to
6851         Rust-based (visitor) code
6852       * All hash functions and tables converted to secure, randomized SipHash
6853
6854
6855 Version 0.3  (2012-07-12)
6856 ========================
6857
6858    * ~1900 changes, numerous bugfixes
6859
6860    * New coding conveniences
6861       * Integer-literal suffix inference
6862       * Per-item control over warnings, errors
6863       * #[cfg(windows)] and #[cfg(unix)] attributes
6864       * Documentation comments
6865       * More compact closure syntax
6866       * 'do' expressions for treating higher-order functions as
6867         control structures
6868       * *-patterns (wildcard extended to all constructor fields)
6869
6870    * Semantic cleanup
6871       * Name resolution pass and exhaustiveness checker rewritten
6872       * Region pointers and borrow checking supersede alias
6873         analysis
6874       * Init-ness checking is now provided by a region-based liveness
6875         pass instead of the typestate pass; same for last-use analysis
6876       * Extensive work on region pointers
6877
6878    * Experimental new language features
6879       * Slices and fixed-size, interior-allocated vectors
6880       * #!-comments for lang versioning, shell execution
6881       * Destructors and iface implementation for classes;
6882         type-parameterized classes and class methods
6883       * 'const' type kind for types that can be used to implement
6884         shared-memory concurrency patterns
6885
6886    * Type reflection
6887
6888    * Removal of various obsolete features
6889       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
6890                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
6891
6892       * Constructs: do-while loops ('do' repurposed), fn binding,
6893                     resources (replaced by destructors)
6894
6895    * Compiler reorganization
6896       * Syntax-layer of compiler split into separate crate
6897       * Clang (from LLVM project) integrated into build
6898       * Typechecker split into sub-modules
6899
6900    * New library code
6901       * New time functions
6902       * Extension methods for many built-in types
6903       * Arc: atomic-refcount read-only / exclusive-use shared cells
6904       * Par: parallel map and search routines
6905       * Extensive work on libuv interface
6906       * Much vector code moved to libraries
6907       * Syntax extensions: #line, #col, #file, #mod, #stringify,
6908         #include, #include_str, #include_bin
6909
6910    * Tool improvements
6911       * Cargo automatically resolves dependencies
6912
6913
6914 Version 0.2  (2012-03-29)
6915 =========================
6916
6917    * >1500 changes, numerous bugfixes
6918
6919    * New docs and doc tooling
6920
6921    * New port: FreeBSD x86_64
6922
6923    * Compilation model enhancements
6924       * Generics now specialized, multiply instantiated
6925       * Functions now inlined across separate crates
6926
6927    * Scheduling, stack and threading fixes
6928       * Noticeably improved message-passing performance
6929       * Explicit schedulers
6930       * Callbacks from C
6931       * Helgrind clean
6932
6933    * Experimental new language features
6934       * Operator overloading
6935       * Region pointers
6936       * Classes
6937
6938    * Various language extensions
6939       * C-callback function types: 'crust fn ...'
6940       * Infinite-loop construct: 'loop { ... }'
6941       * Shorten 'mutable' to 'mut'
6942       * Required mutable-local qualifier: 'let mut ...'
6943       * Basic glob-exporting: 'export foo::*;'
6944       * Alt now exhaustive, 'alt check' for runtime-checked
6945       * Block-function form of 'for' loop, with 'break' and 'ret'.
6946
6947    * New library code
6948       * AST quasi-quote syntax extension
6949       * Revived libuv interface
6950       * New modules: core::{future, iter}, std::arena
6951       * Merged per-platform std::{os*, fs*} to core::{libc, os}
6952       * Extensive cleanup, regularization in libstd, libcore
6953
6954
6955 Version 0.1  (2012-01-20)
6956 ===============================
6957
6958    * Most language features work, including:
6959       * Unique pointers, unique closures, move semantics
6960       * Interface-constrained generics
6961       * Static interface dispatch
6962       * Stack growth
6963       * Multithread task scheduling
6964       * Typestate predicates
6965       * Failure unwinding, destructors
6966       * Pattern matching and destructuring assignment
6967       * Lightweight block-lambda syntax
6968       * Preliminary macro-by-example
6969
6970    * Compiler works with the following configurations:
6971       * Linux: x86 and x86_64 hosts and targets
6972       * macOS: x86 and x86_64 hosts and targets
6973       * Windows: x86 hosts and targets
6974
6975    * Cross compilation / multi-target configuration supported.
6976
6977    * Preliminary API-documentation and package-management tools included.
6978
6979 Known issues:
6980
6981    * Documentation is incomplete.
6982
6983    * Performance is below intended target.
6984
6985    * Standard library APIs are subject to extensive change, reorganization.
6986
6987    * Language-level versioning is not yet operational - future code will
6988      break unexpectedly.