]> git.lizzy.rs Git - rust.git/blob - RELEASES.md
Rollup merge of #67215 - nnethercote:fix-Zprint-type-size-zero-sized-fields, r=pnkfelix
[rust.git] / RELEASES.md
1 Version 1.40.0 (2019-12-19)
2 ===========================
3
4 Language
5 --------
6 - [You can now use tuple `struct`s and tuple `enum` variant's constructors in
7   `const` contexts.][65188] e.g.
8
9   ```rust
10   pub struct Point(i32, i32);
11
12   const ORIGIN: Point = {
13       let constructor = Point;
14
15       constructor(0, 0)
16   };
17   ```
18
19 - [You can now mark `struct`s, `enum`s, and `enum` variants with the `#[non_exhaustive]` attribute to
20   indicate that there may be variants or fields added in the future.][64639]
21   For example this requires adding a wild-card branch (`_ => {}`) to any match
22   statements on a non-exhaustive `enum`. [(RFC 2008)]
23 - [You can now use function-like procedural macros in `extern` blocks and in
24   type positions.][63931] e.g. `type Generated = macro!();`
25 - [Function-like and attribute procedural macros can now emit
26   `macro_rules!` items, so you can now have your macros generate macros.][64035]
27 - [The `meta` pattern matcher in `macro_rules!` now correctly matches the modern
28   attribute syntax.][63674] For example `(#[$m:meta])` now matches `#[attr]`,
29   `#[attr{tokens}]`, `#[attr[tokens]]`, and `#[attr(tokens)]`.
30
31 Compiler
32 --------
33 - [Added tier 3 support\* for the
34   `thumbv7neon-unknown-linux-musleabihf` target.][66103]
35 - [Added tier 3 support for the
36   `aarch64-unknown-none-softfloat` target.][64589]
37 - [Added tier 3 support for the `mips64-unknown-linux-muslabi64`, and
38   `mips64el-unknown-linux-muslabi64` targets.][65843]
39
40 \* Refer to Rust's [platform support page][forge-platform-support] for more
41   information on Rust's tiered platform support.
42
43 Libraries
44 ---------
45 - [The `is_power_of_two` method on unsigned numeric types is now a `const` function.][65092]
46
47 Stabilized APIs
48 ---------------
49 - [`BTreeMap::get_key_value`]
50 - [`HashMap::get_key_value`]
51 - [`Option::as_deref_mut`]
52 - [`Option::as_deref`]
53 - [`Option::flatten`]
54 - [`UdpSocket::peer_addr`]
55 - [`f32::to_be_bytes`]
56 - [`f32::to_le_bytes`]
57 - [`f32::to_ne_bytes`]
58 - [`f64::to_be_bytes`]
59 - [`f64::to_le_bytes`]
60 - [`f64::to_ne_bytes`]
61 - [`f32::from_be_bytes`]
62 - [`f32::from_le_bytes`]
63 - [`f32::from_ne_bytes`]
64 - [`f64::from_be_bytes`]
65 - [`f64::from_le_bytes`]
66 - [`f64::from_ne_bytes`]
67 - [`mem::take`]
68 - [`slice::repeat`]
69 - [`todo!`]
70
71 Cargo
72 -----
73 - [Cargo will now always display warnings, rather than only on
74   fresh builds.][cargo/7450]
75 - [Feature flags (except `--all-features`) passed to a virtual workspace will
76   now produce an error.][cargo/7507] Previously these flags were ignored.
77 - [You can now publish `dev-dependencies` without including
78   a `version`.][cargo/7333]
79
80 Misc
81 ----
82 - [You can now specify the `#[cfg(doctest)]` attribute to include an item only
83   when running documentation tests with `rustdoc`.][63803]
84
85 Compatibility Notes
86 -------------------
87 - [As previously announced, any previous NLL warnings in the 2015 edition are
88   now hard errors.][64221]
89 - [The `include!` macro will now warn if it failed to include the
90   entire file.][64284] The `include!` macro unintentionally only includes the
91   first _expression_ in a file, and this can be unintuitive. This will become
92   either a hard error in a future release, or the behavior may be fixed to include all expressions as expected.
93 - [Using `#[inline]` on function prototypes and consts now emits a warning under
94   `unused_attribute` lint.][65294] Using `#[inline]` anywhere else inside traits
95   or `extern` blocks now correctly emits a hard error.
96   
97 [65294]: https://github.com/rust-lang/rust/pull/65294/
98 [66103]: https://github.com/rust-lang/rust/pull/66103/
99 [65843]: https://github.com/rust-lang/rust/pull/65843/
100 [65188]: https://github.com/rust-lang/rust/pull/65188/
101 [65092]: https://github.com/rust-lang/rust/pull/65092/
102 [64589]: https://github.com/rust-lang/rust/pull/64589/
103 [64639]: https://github.com/rust-lang/rust/pull/64639/
104 [64221]: https://github.com/rust-lang/rust/pull/64221/
105 [64284]: https://github.com/rust-lang/rust/pull/64284/
106 [63931]: https://github.com/rust-lang/rust/pull/63931/
107 [64035]: https://github.com/rust-lang/rust/pull/64035/
108 [63674]: https://github.com/rust-lang/rust/pull/63674/
109 [63803]: https://github.com/rust-lang/rust/pull/63803/
110 [cargo/7450]: https://github.com/rust-lang/cargo/pull/7450/
111 [cargo/7507]: https://github.com/rust-lang/cargo/pull/7507/
112 [cargo/7525]: https://github.com/rust-lang/cargo/pull/7525/
113 [cargo/7333]: https://github.com/rust-lang/cargo/pull/7333/
114 [(rfc 2008)]: https://rust-lang.github.io/rfcs/2008-non-exhaustive.html
115 [`f32::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_be_bytes
116 [`f32::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_le_bytes
117 [`f32::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_ne_bytes
118 [`f64::to_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_be_bytes
119 [`f64::to_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_le_bytes
120 [`f64::to_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_ne_bytes
121 [`f32::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_be_bytes
122 [`f32::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_le_bytes
123 [`f32::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_ne_bytes
124 [`f64::from_be_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_be_bytes
125 [`f64::from_le_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_le_bytes
126 [`f64::from_ne_bytes`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_ne_bytes
127 [`option::flatten`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.flatten
128 [`option::as_deref`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref
129 [`option::as_deref_mut`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.as_deref_mut
130 [`hashmap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.get_key_value
131 [`btreemap::get_key_value`]: https://doc.rust-lang.org/std/collections/struct.BTreeMap.html#method.get_key_value
132 [`slice::repeat`]: https://doc.rust-lang.org/std/primitive.slice.html#method.repeat
133 [`mem::take`]: https://doc.rust-lang.org/std/mem/fn.take.html
134 [`udpsocket::peer_addr`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peer_addr
135 [`todo!`]: https://doc.rust-lang.org/std/macro.todo.html
136
137
138 Version 1.39.0 (2019-11-07)
139 ===========================
140
141 Language
142 --------
143 - [You can now create `async` functions and blocks with `async fn`, `async move {}`, and
144   `async {}` respectively, and you can now call `.await` on async expressions.][63209]
145 - [You can now use certain attributes on function, closure, and function pointer
146   parameters.][64010] These attributes include `cfg`, `cfg_attr`, `allow`, `warn`,
147   `deny`, `forbid` as well as inert helper attributes used by procedural macro
148   attributes applied to items. e.g.
149   ```rust
150   fn len(
151       #[cfg(windows)] slice: &[u16],
152       #[cfg(not(windows))] slice: &[u8],
153   ) -> usize {
154       slice.len()
155   }
156   ```
157 - [You can now take shared references to bind-by-move patterns in the `if` guards
158   of `match` arms.][63118] e.g.
159   ```rust
160   fn main() {
161       let array: Box<[u8; 4]> = Box::new([1, 2, 3, 4]);
162
163       match array {
164           nums
165   //      ---- `nums` is bound by move.
166               if nums.iter().sum::<u8>() == 10
167   //                 ^------ `.iter()` implicitly takes a reference to `nums`.
168           => {
169               drop(nums);
170   //          ----------- Legal as `nums` was bound by move and so we have ownership.
171           }
172           _ => unreachable!(),
173       }
174   }
175   ```
176
177
178
179 Compiler
180 --------
181 - [Added tier 3\* support for the `i686-unknown-uefi` target.][64334]
182 - [Added tier 3 support for the `sparc64-unknown-openbsd` target.][63595]
183 - [rustc will now trim code snippets in diagnostics to fit in your terminal.][63402]
184   **Note** Cargo currently doesn't use this feature. Refer to
185   [cargo#7315][cargo/7315] to track this feature's progress.
186 - [You can now pass `--show-output` argument to test binaries to print the
187   output of successful tests.][62600]
188
189
190 \* Refer to Rust's [platform support page][forge-platform-support] for more
191 information on Rust's tiered platform support.
192
193 Libraries
194 ---------
195 - [`Vec::new` and `String::new` are now `const` functions.][64028]
196 - [`LinkedList::new` is now a `const` function.][63684]
197 - [`str::len`, `[T]::len` and `str::as_bytes` are now `const` functions.][63770]
198 - [The `abs`, `wrapping_abs`, and `overflowing_abs` numeric functions are
199   now `const`.][63786]
200
201 Stabilized APIs
202 ---------------
203 - [`Pin::into_inner`]
204 - [`Instant::checked_duration_since`]
205 - [`Instant::saturating_duration_since`]
206
207 Cargo
208 -----
209 - [You can now publish git dependencies if supplied with a `version`.][cargo/7237]
210 - [The `--all` flag has been renamed to `--workspace`.][cargo/7241] Using
211   `--all` is now deprecated.
212
213 Misc
214 ----
215 - [You can now pass `-Clinker` to rustdoc to control the linker used
216   for compiling doctests.][63834]
217
218 Compatibility Notes
219 -------------------
220 - [Code that was previously accepted by the old borrow checker, but rejected by
221   the NLL borrow checker is now a hard error in Rust 2018.][63565] This was
222   previously a warning, and will also become a hard error in the Rust 2015
223   edition in the 1.40.0 release.
224 - [`rustdoc` now requires `rustc` to be installed and in the same directory to
225   run tests.][63827] This should improve performance when running a large
226   amount of doctests.
227 - [The `try!` macro will now issue a deprecation warning.][62672] It is
228   recommended to use the `?` operator instead.
229 - [`asinh(-0.0)` now correctly returns `-0.0`.][63698] Previously this
230   returned `0.0`.
231
232 [62600]: https://github.com/rust-lang/rust/pull/62600/
233 [62672]: https://github.com/rust-lang/rust/pull/62672/
234 [63118]: https://github.com/rust-lang/rust/pull/63118/
235 [63209]: https://github.com/rust-lang/rust/pull/63209/
236 [63402]: https://github.com/rust-lang/rust/pull/63402/
237 [63565]: https://github.com/rust-lang/rust/pull/63565/
238 [63595]: https://github.com/rust-lang/rust/pull/63595/
239 [63684]: https://github.com/rust-lang/rust/pull/63684/
240 [63698]: https://github.com/rust-lang/rust/pull/63698/
241 [63770]: https://github.com/rust-lang/rust/pull/63770/
242 [63786]: https://github.com/rust-lang/rust/pull/63786/
243 [63827]: https://github.com/rust-lang/rust/pull/63827/
244 [63834]: https://github.com/rust-lang/rust/pull/63834/
245 [63927]: https://github.com/rust-lang/rust/pull/63927/
246 [63933]: https://github.com/rust-lang/rust/pull/63933/
247 [63934]: https://github.com/rust-lang/rust/pull/63934/
248 [63938]: https://github.com/rust-lang/rust/pull/63938/
249 [63940]: https://github.com/rust-lang/rust/pull/63940/
250 [63941]: https://github.com/rust-lang/rust/pull/63941/
251 [63945]: https://github.com/rust-lang/rust/pull/63945/
252 [64010]: https://github.com/rust-lang/rust/pull/64010/
253 [64028]: https://github.com/rust-lang/rust/pull/64028/
254 [64334]: https://github.com/rust-lang/rust/pull/64334/
255 [cargo/7237]: https://github.com/rust-lang/cargo/pull/7237/
256 [cargo/7241]: https://github.com/rust-lang/cargo/pull/7241/
257 [cargo/7315]: https://github.com/rust-lang/cargo/pull/7315/
258 [`Pin::into_inner`]: https://doc.rust-lang.org/std/pin/struct.Pin.html#method.into_inner
259 [`Instant::checked_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_duration_since
260 [`Instant::saturating_duration_since`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.saturating_duration_since
261
262 Version 1.38.0 (2019-09-26)
263 ==========================
264
265 Language
266 --------
267 - [The `#[global_allocator]` attribute can now be used in submodules.][62735]
268 - [The `#[deprecated]` attribute can now be used on macros.][62042]
269
270 Compiler
271 --------
272 - [Added pipelined compilation support to `rustc`.][62766] This will
273   improve compilation times in some cases. For further information please refer
274   to the [_"Evaluating pipelined rustc compilation"_][pipeline-internals] thread.
275 - [Added tier 3\* support for the `aarch64-uwp-windows-msvc`, `i686-uwp-windows-gnu`,
276   `i686-uwp-windows-msvc`, `x86_64-uwp-windows-gnu`, and
277   `x86_64-uwp-windows-msvc` targets.][60260]
278 - [Added tier 3 support for the `armv7-unknown-linux-gnueabi` and
279   `armv7-unknown-linux-musleabi` targets.][63107]
280 - [Added tier 3 support for the `hexagon-unknown-linux-musl` target.][62814]
281 - [Added tier 3 support for the `riscv32i-unknown-none-elf` target.][62784]
282
283 \* Refer to Rust's [platform support page][forge-platform-support] for more
284 information on Rust's tiered platform support.
285
286 Libraries
287 ---------
288 - [`ascii::EscapeDefault` now implements `Clone` and `Display`.][63421]
289 - [Derive macros for prelude traits (e.g. `Clone`, `Debug`, `Hash`) are now
290   available at the same path as the trait.][63056] (e.g. The `Clone` derive macro
291   is available at `std::clone::Clone`). This also makes all built-in macros
292   available in `std`/`core` root. e.g. `std::include_bytes!`.
293 - [`str::Chars` now implements `Debug`.][63000]
294 - [`slice::{concat, connect, join}` now accepts `&[T]` in addition to `&T`.][62528]
295 - [`*const T` and `*mut T` now implement `marker::Unpin`.][62583]
296 - [`Arc<[T]>` and `Rc<[T]>` now implement `FromIterator<T>`.][61953]
297 - [Added euclidean remainder and division operations (`div_euclid`,
298   `rem_euclid`) to all numeric primitives.][61884] Additionally `checked`,
299   `overflowing`, and `wrapping` versions are available for all
300   integer primitives.
301 - [`thread::AccessError` now implements `Clone`, `Copy`, `Eq`, `Error`, and
302   `PartialEq`.][61491]
303 - [`iter::{StepBy, Peekable, Take}` now implement `DoubleEndedIterator`.][61457]
304
305 Stabilized APIs
306 ---------------
307 - [`<*const T>::cast`]
308 - [`<*mut T>::cast`]
309 - [`Duration::as_secs_f32`]
310 - [`Duration::as_secs_f64`]
311 - [`Duration::div_f32`]
312 - [`Duration::div_f64`]
313 - [`Duration::from_secs_f32`]
314 - [`Duration::from_secs_f64`]
315 - [`Duration::mul_f32`]
316 - [`Duration::mul_f64`]
317 - [`any::type_name`]
318
319 Cargo
320 -----
321 - [Added pipelined compilation support to `cargo`.][cargo/7143]
322 - [You can now pass the `--features` option multiple times to enable
323   multiple features.][cargo/7084]
324
325 Misc
326 ----
327 - [`rustc` will now warn about some incorrect uses of
328   `mem::{uninitialized, zeroed}` that are known to cause undefined behaviour.][63346]
329
330 Compatibility Notes
331 -------------------
332 - The [`x86_64-unknown-uefi` platform can not be built][62785] with rustc
333   1.38.0.
334 - The [`armv7-unknown-linux-gnueabihf` platform is known to have
335   issues][62896] with certain crates such as libc.
336
337 [60260]: https://github.com/rust-lang/rust/pull/60260/
338 [61457]: https://github.com/rust-lang/rust/pull/61457/
339 [61491]: https://github.com/rust-lang/rust/pull/61491/
340 [61884]: https://github.com/rust-lang/rust/pull/61884/
341 [61953]: https://github.com/rust-lang/rust/pull/61953/
342 [62042]: https://github.com/rust-lang/rust/pull/62042/
343 [62528]: https://github.com/rust-lang/rust/pull/62528/
344 [62583]: https://github.com/rust-lang/rust/pull/62583/
345 [62735]: https://github.com/rust-lang/rust/pull/62735/
346 [62766]: https://github.com/rust-lang/rust/pull/62766/
347 [62784]: https://github.com/rust-lang/rust/pull/62784/
348 [62785]: https://github.com/rust-lang/rust/issues/62785/
349 [62814]: https://github.com/rust-lang/rust/pull/62814/
350 [62896]: https://github.com/rust-lang/rust/issues/62896/
351 [63000]: https://github.com/rust-lang/rust/pull/63000/
352 [63056]: https://github.com/rust-lang/rust/pull/63056/
353 [63107]: https://github.com/rust-lang/rust/pull/63107/
354 [63346]: https://github.com/rust-lang/rust/pull/63346/
355 [63421]: https://github.com/rust-lang/rust/pull/63421/
356 [cargo/7084]: https://github.com/rust-lang/cargo/pull/7084/
357 [cargo/7143]: https://github.com/rust-lang/cargo/pull/7143/
358 [`<*const T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
359 [`<*mut T>::cast`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.cast
360 [`Duration::as_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f32
361 [`Duration::as_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs_f64
362 [`Duration::div_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f32
363 [`Duration::div_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.div_f64
364 [`Duration::from_secs_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f32
365 [`Duration::from_secs_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_secs_f64
366 [`Duration::mul_f32`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f32
367 [`Duration::mul_f64`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.mul_f64
368 [`any::type_name`]: https://doc.rust-lang.org/std/any/fn.type_name.html
369 [forge-platform-support]: https://forge.rust-lang.org/platform-support.html
370 [pipeline-internals]: https://internals.rust-lang.org/t/evaluating-pipelined-rustc-compilation/10199
371
372 Version 1.37.0 (2019-08-15)
373 ==========================
374
375 Language
376 --------
377 - `#[must_use]` will now warn if the type is contained in a [tuple][61100],
378   [`Box`][62228], or an [array][62235] and unused.
379 - [You can now use the `cfg` and `cfg_attr` attributes on
380   generic parameters.][61547]
381 - [You can now use enum variants through type alias.][61682] e.g. You can
382   write the following:
383   ```rust
384   type MyOption = Option<u8>;
385
386   fn increment_or_zero(x: MyOption) -> u8 {
387       match x {
388           MyOption::Some(y) => y + 1,
389           MyOption::None => 0,
390       }
391   }
392   ```
393 - [You can now use `_` as an identifier for consts.][61347] e.g. You can write
394   `const _: u32 = 5;`.
395 - [You can now use `#[repr(align(X)]` on enums.][61229]
396 - [The  `?` Kleene macro operator is now available in the
397   2015 edition.][60932]
398
399 Compiler
400 --------
401 - [You can now enable Profile-Guided Optimization with the `-C profile-generate`
402   and `-C profile-use` flags.][61268] For more information on how to use profile
403   guided optimization, please refer to the [rustc book][rustc-book-pgo].
404 - [The `rust-lldb` wrapper script should now work again.][61827]
405
406 Libraries
407 ---------
408 - [`mem::MaybeUninit<T>` is now ABI-compatible with `T`.][61802]
409
410 Stabilized APIs
411 ---------------
412 - [`BufReader::buffer`]
413 - [`BufWriter::buffer`]
414 - [`Cell::from_mut`]
415 - [`Cell<[T]>::as_slice_of_cells`][`Cell<slice>::as_slice_of_cells`]
416 - [`DoubleEndedIterator::nth_back`]
417 - [`Option::xor`]
418 - [`Wrapping::reverse_bits`]
419 - [`i128::reverse_bits`]
420 - [`i16::reverse_bits`]
421 - [`i32::reverse_bits`]
422 - [`i64::reverse_bits`]
423 - [`i8::reverse_bits`]
424 - [`isize::reverse_bits`]
425 - [`slice::copy_within`]
426 - [`u128::reverse_bits`]
427 - [`u16::reverse_bits`]
428 - [`u32::reverse_bits`]
429 - [`u64::reverse_bits`]
430 - [`u8::reverse_bits`]
431 - [`usize::reverse_bits`]
432
433 Cargo
434 -----
435 - [`Cargo.lock` files are now included by default when publishing executable crates
436   with executables.][cargo/7026]
437 - [You can now specify `default-run="foo"` in `[package]` to specify the
438   default executable to use for `cargo run`.][cargo/7056]
439
440 Misc
441 ----
442
443 Compatibility Notes
444 -------------------
445 - [Using `...` for inclusive range patterns will now warn by default.][61342]
446   Please transition your code to using the `..=` syntax for inclusive
447   ranges instead.
448 - [Using a trait object without the `dyn` will now warn by default.][61203]
449   Please transition your code to use `dyn Trait` for trait objects instead.
450
451 [62228]: https://github.com/rust-lang/rust/pull/62228/
452 [62235]: https://github.com/rust-lang/rust/pull/62235/
453 [61802]: https://github.com/rust-lang/rust/pull/61802/
454 [61827]: https://github.com/rust-lang/rust/pull/61827/
455 [61547]: https://github.com/rust-lang/rust/pull/61547/
456 [61682]: https://github.com/rust-lang/rust/pull/61682/
457 [61268]: https://github.com/rust-lang/rust/pull/61268/
458 [61342]: https://github.com/rust-lang/rust/pull/61342/
459 [61347]: https://github.com/rust-lang/rust/pull/61347/
460 [61100]: https://github.com/rust-lang/rust/pull/61100/
461 [61203]: https://github.com/rust-lang/rust/pull/61203/
462 [61229]: https://github.com/rust-lang/rust/pull/61229/
463 [60932]: https://github.com/rust-lang/rust/pull/60932/
464 [cargo/7026]: https://github.com/rust-lang/cargo/pull/7026/
465 [cargo/7056]: https://github.com/rust-lang/cargo/pull/7056/
466 [`BufReader::buffer`]: https://doc.rust-lang.org/std/io/struct.BufReader.html#method.buffer
467 [`BufWriter::buffer`]: https://doc.rust-lang.org/std/io/struct.BufWriter.html#method.buffer
468 [`Cell::from_mut`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.from_mut
469 [`Cell<slice>::as_slice_of_cells`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_slice_of_cells
470 [`DoubleEndedIterator::nth_back`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.nth_back
471 [`Option::xor`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.xor
472 [`RefCell::try_borrow_unguarded`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_unguarded
473 [`Wrapping::reverse_bits`]: https://doc.rust-lang.org/std/num/struct.Wrapping.html#method.reverse_bits
474 [`i128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i128.html#method.reverse_bits
475 [`i16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i16.html#method.reverse_bits
476 [`i32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i32.html#method.reverse_bits
477 [`i64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits
478 [`i8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.i8.html#method.reverse_bits
479 [`isize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.isize.html#method.reverse_bits
480 [`slice::copy_within`]: https://doc.rust-lang.org/std/primitive.slice.html#method.copy_within
481 [`u128::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u128.html#method.reverse_bits
482 [`u16::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u16.html#method.reverse_bits
483 [`u32::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u32.html#method.reverse_bits
484 [`u64::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u64.html#method.reverse_bits
485 [`u8::reverse_bits`]: https://doc.rust-lang.org/std/primitive.u8.html#method.reverse_bits
486 [`usize::reverse_bits`]: https://doc.rust-lang.org/std/primitive.usize.html#method.reverse_bits
487 [rustc-book-pgo]: https://doc.rust-lang.org/rustc/profile-guided-optimization.html
488
489
490 Version 1.36.0 (2019-07-04)
491 ==========================
492
493 Language
494 --------
495 - [Non-Lexical Lifetimes are now enabled on the 2015 edition.][59114]
496 - [The order of traits in trait objects no longer affects the semantics of that
497   object.][59445] e.g. `dyn Send + fmt::Debug` is now equivalent to
498   `dyn fmt::Debug + Send`, where this was previously not the case.
499
500 Libraries
501 ---------
502 - [`HashMap`'s implementation has been replaced with `hashbrown::HashMap` implementation.][58623]
503 - [`TryFromSliceError` now implements `From<Infallible>`.][60318]
504 - [`mem::needs_drop` is now available as a const fn.][60364]
505 - [`alloc::Layout::from_size_align_unchecked` is now available as a const fn.][60370]
506 - [`String` now implements `BorrowMut<str>`.][60404]
507 - [`io::Cursor` now implements `Default`.][60234]
508 - [Both `NonNull::{dangling, cast}` are now const fns.][60244]
509 - [The `alloc` crate is now stable.][59675] `alloc` allows you to use a subset
510   of `std` (e.g. `Vec`, `Box`, `Arc`) in `#![no_std]` environments if the
511   environment has access to heap memory allocation.
512 - [`String` now implements `From<&String>`.][59825]
513 - [You can now pass multiple arguments to the `dbg!` macro.][59826] `dbg!` will
514   return a tuple of each argument when there is multiple arguments.
515 - [`Result::{is_err, is_ok}` are now `#[must_use]` and will produce a warning if
516   not used.][59648]
517
518 Stabilized APIs
519 ---------------
520 - [`VecDeque::rotate_left`]
521 - [`VecDeque::rotate_right`]
522 - [`Iterator::copied`]
523 - [`io::IoSlice`]
524 - [`io::IoSliceMut`]
525 - [`Read::read_vectored`]
526 - [`Write::write_vectored`]
527 - [`str::as_mut_ptr`]
528 - [`mem::MaybeUninit`]
529 - [`pointer::align_offset`]
530 - [`future::Future`]
531 - [`task::Context`]
532 - [`task::RawWaker`]
533 - [`task::RawWakerVTable`]
534 - [`task::Waker`]
535 - [`task::Poll`]
536
537 Cargo
538 -----
539 - [Cargo will now produce an error if you attempt to use the name of a required dependency as a feature.][cargo/6860]
540 - [You can now pass the `--offline` flag to run cargo without accessing the network.][cargo/6934]
541
542 You can find further change's in [Cargo's 1.36.0 release notes][cargo-1-36-0].
543
544 Clippy
545 ------
546 There have been numerous additions and fixes to clippy, see [Clippy's 1.36.0 release notes][clippy-1-36-0] for more details.
547
548 Misc
549 ----
550
551 Compatibility Notes
552 -------------------
553 - With the stabilisation of `mem::MaybeUninit`, `mem::uninitialized` use is no
554   longer recommended, and will be deprecated in 1.39.0.
555
556 [60318]: https://github.com/rust-lang/rust/pull/60318/
557 [60364]: https://github.com/rust-lang/rust/pull/60364/
558 [60370]: https://github.com/rust-lang/rust/pull/60370/
559 [60404]: https://github.com/rust-lang/rust/pull/60404/
560 [60234]: https://github.com/rust-lang/rust/pull/60234/
561 [60244]: https://github.com/rust-lang/rust/pull/60244/
562 [58623]: https://github.com/rust-lang/rust/pull/58623/
563 [59648]: https://github.com/rust-lang/rust/pull/59648/
564 [59675]: https://github.com/rust-lang/rust/pull/59675/
565 [59825]: https://github.com/rust-lang/rust/pull/59825/
566 [59826]: https://github.com/rust-lang/rust/pull/59826/
567 [59445]: https://github.com/rust-lang/rust/pull/59445/
568 [59114]: https://github.com/rust-lang/rust/pull/59114/
569 [cargo/6860]: https://github.com/rust-lang/cargo/pull/6860/
570 [cargo/6934]: https://github.com/rust-lang/cargo/pull/6934/
571 [`VecDeque::rotate_left`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_left
572 [`VecDeque::rotate_right`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.rotate_right
573 [`Iterator::copied`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#tymethod.copied
574 [`io::IoSlice`]: https://doc.rust-lang.org/std/io/struct.IoSlice.html
575 [`io::IoSliceMut`]: https://doc.rust-lang.org/std/io/struct.IoSliceMut.html
576 [`Read::read_vectored`]: https://doc.rust-lang.org/std/io/trait.Read.html#method.read_vectored
577 [`Write::write_vectored`]: https://doc.rust-lang.org/std/io/trait.Write.html#method.write_vectored
578 [`str::as_mut_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_mut_ptr
579 [`mem::MaybeUninit`]: https://doc.rust-lang.org/std/mem/union.MaybeUninit.html
580 [`pointer::align_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.align_offset
581 [`future::Future`]: https://doc.rust-lang.org/std/future/trait.Future.html
582 [`task::Context`]: https://doc.rust-lang.org/beta/std/task/struct.Context.html
583 [`task::RawWaker`]: https://doc.rust-lang.org/beta/std/task/struct.RawWaker.html
584 [`task::RawWakerVTable`]: https://doc.rust-lang.org/beta/std/task/struct.RawWakerVTable.html
585 [`task::Waker`]: https://doc.rust-lang.org/beta/std/task/struct.Waker.html
586 [`task::Poll`]: https://doc.rust-lang.org/beta/std/task/enum.Poll.html
587 [clippy-1-36-0]: https://github.com/rust-lang/rust-clippy/blob/master/CHANGELOG.md#rust-136
588 [cargo-1-36-0]: https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md#cargo-136-2019-07-04
589
590
591 Version 1.35.0 (2019-05-23)
592 ==========================
593
594 Language
595 --------
596 - [`FnOnce`, `FnMut`, and the `Fn` traits are now implemented for `Box<FnOnce>`,
597   `Box<FnMut>`, and `Box<Fn>` respectively.][59500]
598 - [You can now coerce closures into unsafe function pointers.][59580] e.g.
599   ```rust
600   unsafe fn call_unsafe(func: unsafe fn()) {
601       func()
602   }
603
604   pub fn main() {
605       unsafe { call_unsafe(|| {}); }
606   }
607   ```
608
609
610 Compiler
611 --------
612 - [Added the `armv6-unknown-freebsd-gnueabihf` and
613   `armv7-unknown-freebsd-gnueabihf` targets.][58080]
614 - [Added the `wasm32-unknown-wasi` target.][59464]
615
616
617 Libraries
618 ---------
619 - [`Thread` will now show its ID in `Debug` output.][59460]
620 - [`StdinLock`, `StdoutLock`, and `StderrLock` now implement `AsRawFd`.][59512]
621 - [`alloc::System` now implements `Default`.][59451]
622 - [Expanded `Debug` output (`{:#?}`) for structs now has a trailing comma on the
623   last field.][59076]
624 - [`char::{ToLowercase, ToUppercase}` now
625   implement `ExactSizeIterator`.][58778]
626 - [All `NonZero` numeric types now implement `FromStr`.][58717]
627 - [Removed the `Read` trait bounds
628   on the `BufReader::{get_ref, get_mut, into_inner}` methods.][58423]
629 - [You can now call the `dbg!` macro without any parameters to print the file
630   and line where it is called.][57847]
631 - [In place ASCII case conversions are now up to 4× faster.][59283]
632   e.g. `str::make_ascii_lowercase`
633 - [`hash_map::{OccupiedEntry, VacantEntry}` now implement `Sync`
634   and `Send`.][58369]
635
636 Stabilized APIs
637 ---------------
638 - [`f32::copysign`]
639 - [`f64::copysign`]
640 - [`RefCell::replace_with`]
641 - [`RefCell::map_split`]
642 - [`ptr::hash`]
643 - [`Range::contains`]
644 - [`RangeFrom::contains`]
645 - [`RangeTo::contains`]
646 - [`RangeInclusive::contains`]
647 - [`RangeToInclusive::contains`]
648 - [`Option::copied`]
649
650 Cargo
651 -----
652 - [You can now set `cargo:rustc-cdylib-link-arg` at build time to pass custom
653   linker arguments when building a `cdylib`.][cargo/6298] Its usage is highly
654   platform specific.
655
656 Misc
657 ----
658 - [The Rust toolchain is now available natively for musl based distros.][58575]
659
660 [59460]: https://github.com/rust-lang/rust/pull/59460/
661 [59464]: https://github.com/rust-lang/rust/pull/59464/
662 [59500]: https://github.com/rust-lang/rust/pull/59500/
663 [59512]: https://github.com/rust-lang/rust/pull/59512/
664 [59580]: https://github.com/rust-lang/rust/pull/59580/
665 [59283]: https://github.com/rust-lang/rust/pull/59283/
666 [59451]: https://github.com/rust-lang/rust/pull/59451/
667 [59076]: https://github.com/rust-lang/rust/pull/59076/
668 [58778]: https://github.com/rust-lang/rust/pull/58778/
669 [58717]: https://github.com/rust-lang/rust/pull/58717/
670 [58369]: https://github.com/rust-lang/rust/pull/58369/
671 [58423]: https://github.com/rust-lang/rust/pull/58423/
672 [58080]: https://github.com/rust-lang/rust/pull/58080/
673 [57847]: https://github.com/rust-lang/rust/pull/57847/
674 [58575]: https://github.com/rust-lang/rust/pull/58575
675 [cargo/6298]: https://github.com/rust-lang/cargo/pull/6298/
676 [`f32::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f32.html#method.copysign
677 [`f64::copysign`]: https://doc.rust-lang.org/stable/std/primitive.f64.html#method.copysign
678 [`RefCell::replace_with`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.replace_with
679 [`RefCell::map_split`]: https://doc.rust-lang.org/stable/std/cell/struct.RefCell.html#method.map_split
680 [`ptr::hash`]: https://doc.rust-lang.org/stable/std/ptr/fn.hash.html
681 [`Range::contains`]: https://doc.rust-lang.org/std/ops/struct.Range.html#method.contains
682 [`RangeFrom::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeFrom.html#method.contains
683 [`RangeTo::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeTo.html#method.contains
684 [`RangeInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.contains
685 [`RangeToInclusive::contains`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html#method.contains
686 [`Option::copied`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.copied
687
688 Version 1.34.2 (2019-05-14)
689 ===========================
690
691 * [Destabilize the `Error::type_id` function due to a security
692    vulnerability][60785] ([CVE-2019-12083])
693
694 [60785]: https://github.com/rust-lang/rust/pull/60785
695 [CVE-2019-12083]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-12083
696
697 Version 1.34.1 (2019-04-25)
698 ===========================
699
700 * [Fix false positives for the `redundant_closure` Clippy lint][clippy/3821]
701 * [Fix false positives for the `missing_const_for_fn` Clippy lint][clippy/3844]
702 * [Fix Clippy panic when checking some macros][clippy/3805]
703
704 [clippy/3821]: https://github.com/rust-lang/rust-clippy/pull/3821
705 [clippy/3844]: https://github.com/rust-lang/rust-clippy/pull/3844
706 [clippy/3805]: https://github.com/rust-lang/rust-clippy/pull/3805
707
708 Version 1.34.0 (2019-04-11)
709 ==========================
710
711 Language
712 --------
713 - [You can now use `#[deprecated = "reason"]`][58166] as a shorthand for
714   `#[deprecated(note = "reason")]`. This was previously allowed by mistake
715   but had no effect.
716 - [You can now accept token streams in `#[attr()]`,`#[attr[]]`, and
717   `#[attr{}]` procedural macros.][57367]
718 - [You can now write `extern crate self as foo;`][57407] to import your
719   crate's root into the extern prelude.
720
721
722 Compiler
723 --------
724 - [You can now target `riscv64imac-unknown-none-elf` and
725   `riscv64gc-unknown-none-elf`.][58406]
726 - [You can now enable linker plugin LTO optimisations with
727   `-C linker-plugin-lto`.][58057] This allows rustc to compile your Rust code
728   into LLVM bitcode allowing LLVM to perform LTO optimisations across C/C++ FFI
729   boundaries.
730 - [You can now target `powerpc64-unknown-freebsd`.][57809]
731
732
733 Libraries
734 ---------
735 - [The trait bounds have been removed on some of `HashMap<K, V, S>`'s and
736   `HashSet<T, S>`'s basic methods.][58370] Most notably you no longer require
737   the `Hash` trait to create an iterator.
738 - [The `Ord` trait bounds have been removed on some of `BinaryHeap<T>`'s basic
739   methods.][58421] Most notably you no longer require the `Ord` trait to create
740   an iterator.
741 - [The methods `overflowing_neg` and `wrapping_neg` are now `const` functions
742   for all numeric types.][58044]
743 - [Indexing a `str` is now generic over all types that
744   implement `SliceIndex<str>`.][57604]
745 - [`str::trim`, `str::trim_matches`, `str::trim_{start, end}`, and
746   `str::trim_{start, end}_matches` are now `#[must_use]`][57106] and will
747   produce a warning if their returning type is unused.
748 - [The methods `checked_pow`, `saturating_pow`, `wrapping_pow`, and
749   `overflowing_pow` are now available for all numeric types.][57873] These are
750   equivalent to methods such as `wrapping_add` for the `pow` operation.
751
752
753 Stabilized APIs
754 ---------------
755
756 #### std & core
757 * [`Any::type_id`]
758 * [`Error::type_id`]
759 * [`atomic::AtomicI16`]
760 * [`atomic::AtomicI32`]
761 * [`atomic::AtomicI64`]
762 * [`atomic::AtomicI8`]
763 * [`atomic::AtomicU16`]
764 * [`atomic::AtomicU32`]
765 * [`atomic::AtomicU64`]
766 * [`atomic::AtomicU8`]
767 * [`convert::Infallible`]
768 * [`convert::TryFrom`]
769 * [`convert::TryInto`]
770 * [`iter::from_fn`]
771 * [`iter::successors`]
772 * [`num::NonZeroI128`]
773 * [`num::NonZeroI16`]
774 * [`num::NonZeroI32`]
775 * [`num::NonZeroI64`]
776 * [`num::NonZeroI8`]
777 * [`num::NonZeroIsize`]
778 * [`slice::sort_by_cached_key`]
779 * [`str::escape_debug`]
780 * [`str::escape_default`]
781 * [`str::escape_unicode`]
782 * [`str::split_ascii_whitespace`]
783
784 #### std
785 * [`Instant::checked_add`]
786 * [`Instant::checked_sub`]
787 * [`SystemTime::checked_add`]
788 * [`SystemTime::checked_sub`]
789
790 Cargo
791 -----
792 - [You can now use alternative registries to crates.io.][cargo/6654]
793
794 Misc
795 ----
796 - [You can now use the `?` operator in your documentation tests without manually
797   adding `fn main() -> Result<(), _> {}`.][56470]
798
799 Compatibility Notes
800 -------------------
801 - [`Command::before_exec` is being replaced by the unsafe method
802   `Command::pre_exec`][58059] and will be deprecated with Rust 1.37.0.
803 - [Use of `ATOMIC_{BOOL, ISIZE, USIZE}_INIT` is now deprecated][57425] as you
804   can now use `const` functions in `static` variables.
805
806 [58370]: https://github.com/rust-lang/rust/pull/58370/
807 [58406]: https://github.com/rust-lang/rust/pull/58406/
808 [58421]: https://github.com/rust-lang/rust/pull/58421/
809 [58166]: https://github.com/rust-lang/rust/pull/58166/
810 [58044]: https://github.com/rust-lang/rust/pull/58044/
811 [58057]: https://github.com/rust-lang/rust/pull/58057/
812 [58059]: https://github.com/rust-lang/rust/pull/58059/
813 [57809]: https://github.com/rust-lang/rust/pull/57809/
814 [57873]: https://github.com/rust-lang/rust/pull/57873/
815 [57604]: https://github.com/rust-lang/rust/pull/57604/
816 [57367]: https://github.com/rust-lang/rust/pull/57367/
817 [57407]: https://github.com/rust-lang/rust/pull/57407/
818 [57425]: https://github.com/rust-lang/rust/pull/57425/
819 [57106]: https://github.com/rust-lang/rust/pull/57106/
820 [56470]: https://github.com/rust-lang/rust/pull/56470/
821 [cargo/6654]: https://github.com/rust-lang/cargo/pull/6654/
822 [`Any::type_id`]: https://doc.rust-lang.org/std/any/trait.Any.html#tymethod.type_id
823 [`Error::type_id`]: https://doc.rust-lang.org/std/error/trait.Error.html#method.type_id
824 [`atomic::AtomicI16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI16.html
825 [`atomic::AtomicI32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI32.html
826 [`atomic::AtomicI64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI64.html
827 [`atomic::AtomicI8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicI8.html
828 [`atomic::AtomicU16`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU16.html
829 [`atomic::AtomicU32`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU32.html
830 [`atomic::AtomicU64`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU64.html
831 [`atomic::AtomicU8`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html
832 [`convert::Infallible`]: https://doc.rust-lang.org/std/convert/enum.Infallible.html
833 [`convert::TryFrom`]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html
834 [`convert::TryInto`]: https://doc.rust-lang.org/std/convert/trait.TryInto.html
835 [`iter::from_fn`]: https://doc.rust-lang.org/std/iter/fn.from_fn.html
836 [`iter::successors`]: https://doc.rust-lang.org/std/iter/fn.successors.html
837 [`num::NonZeroI128`]: https://doc.rust-lang.org/std/num/struct.NonZeroI128.html
838 [`num::NonZeroI16`]: https://doc.rust-lang.org/std/num/struct.NonZeroI16.html
839 [`num::NonZeroI32`]: https://doc.rust-lang.org/std/num/struct.NonZeroI32.html
840 [`num::NonZeroI64`]: https://doc.rust-lang.org/std/num/struct.NonZeroI64.html
841 [`num::NonZeroI8`]: https://doc.rust-lang.org/std/num/struct.NonZeroI8.html
842 [`num::NonZeroIsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroIsize.html
843 [`slice::sort_by_cached_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_by_cached_key
844 [`str::escape_debug`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_debug
845 [`str::escape_default`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_default
846 [`str::escape_unicode`]: https://doc.rust-lang.org/std/primitive.str.html#method.escape_unicode
847 [`str::split_ascii_whitespace`]: https://doc.rust-lang.org/std/primitive.str.html#method.split_ascii_whitespace
848 [`Instant::checked_add`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_add
849 [`Instant::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Instant.html#method.checked_sub
850 [`SystemTime::checked_add`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_add
851 [`SystemTime::checked_sub`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#method.checked_sub
852
853
854 Version 1.33.0 (2019-02-28)
855 ==========================
856
857 Language
858 --------
859 - [You can now use the `cfg(target_vendor)` attribute.][57465] E.g.
860   `#[cfg(target_vendor="apple")] fn main() { println!("Hello Apple!"); }`
861 - [Integer patterns such as in a match expression can now be exhaustive.][56362]
862   E.g. You can have match statement on a `u8` that covers `0..=255` and
863   you would no longer be required to have a `_ => unreachable!()` case.
864 - [You can now have multiple patterns in `if let` and `while let`
865   expressions.][57532] You can do this with the same syntax as a `match`
866   expression. E.g.
867   ```rust
868   enum Creature {
869       Crab(String),
870       Lobster(String),
871       Person(String),
872   }
873
874   fn main() {
875       let state = Creature::Crab("Ferris");
876
877       if let Creature::Crab(name) | Creature::Person(name) = state {
878           println!("This creature's name is: {}", name);
879       }
880   }
881   ```
882 - [You can now have irrefutable `if let` and `while let` patterns.][57535] Using
883   this feature will by default produce a warning as this behaviour can be
884   unintuitive. E.g. `if let _ = 5 {}`
885 - [You can now use `let` bindings, assignments, expression statements,
886   and irrefutable pattern destructuring in const functions.][57175]
887 - [You can now call unsafe const functions.][57067] E.g.
888   ```rust
889   const unsafe fn foo() -> i32 { 5 }
890   const fn bar() -> i32 {
891       unsafe { foo() }
892   }
893   ```
894 - [You can now specify multiple attributes in a `cfg_attr` attribute.][57332]
895   E.g. `#[cfg_attr(all(), must_use, optimize)]`
896 - [You can now specify a specific alignment with the `#[repr(packed)]`
897   attribute.][57049] E.g. `#[repr(packed(2))] struct Foo(i16, i32);` is a struct
898   with an alignment of 2 bytes and a size of 6 bytes.
899 - [You can now import an item from a module as an `_`.][56303] This allows you to
900   import a trait's impls, and not have the name in the namespace. E.g.
901   ```rust
902   use std::io::Read as _;
903
904   // Allowed as there is only one `Read` in the module.
905   pub trait Read {}
906   ```
907 - [You may now use `Rc`, `Arc`, and `Pin` as method receivers][56805].
908
909 Compiler
910 --------
911 - [You can now set a linker flavor for `rustc` with the `-Clinker-flavor`
912   command line argument.][56351]
913 - [The minimum required LLVM version has been bumped to 6.0.][56642]
914 - [Added support for the PowerPC64 architecture on FreeBSD.][57615]
915 - [The `x86_64-fortanix-unknown-sgx` target support has been upgraded to
916   tier 2 support.][57130] Visit the [platform support][platform-support] page for
917   information on Rust's platform support.
918 - [Added support for the `thumbv7neon-linux-androideabi` and
919   `thumbv7neon-unknown-linux-gnueabihf` targets.][56947]
920 - [Added support for the `x86_64-unknown-uefi` target.][56769]
921
922 Libraries
923 ---------
924 - [The methods `overflowing_{add, sub, mul, shl, shr}` are now `const`
925   functions for all numeric types.][57566]
926 - [The methods `rotate_left`, `rotate_right`, and `wrapping_{add, sub, mul, shl, shr}`
927   are now `const` functions for all numeric types.][57105]
928 - [The methods `is_positive` and `is_negative` are now `const` functions for
929   all signed numeric types.][57105]
930 - [The `get` method for all `NonZero` types is now `const`.][57167]
931 - [The methods `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`,
932   `swap_bytes`, `from_be`, `from_le`, `to_be`, `to_le` are now `const` for all
933   numeric types.][57234]
934 - [`Ipv4Addr::new` is now a `const` function][57234]
935
936 Stabilized APIs
937 ---------------
938 - [`unix::FileExt::read_exact_at`]
939 - [`unix::FileExt::write_all_at`]
940 - [`Option::transpose`]
941 - [`Result::transpose`]
942 - [`convert::identity`]
943 - [`pin::Pin`]
944 - [`marker::Unpin`]
945 - [`marker::PhantomPinned`]
946 - [`Vec::resize_with`]
947 - [`VecDeque::resize_with`]
948 - [`Duration::as_millis`]
949 - [`Duration::as_micros`]
950 - [`Duration::as_nanos`]
951
952
953 Cargo
954 -----
955 - [You can now publish crates that require a feature flag to compile with
956   `cargo publish --features` or `cargo publish --all-features`.][cargo/6453]
957 - [Cargo should now rebuild a crate if a file was modified during the initial
958   build.][cargo/6484]
959
960 Compatibility Notes
961 -------------------
962 - The methods `str::{trim_left, trim_right, trim_left_matches, trim_right_matches}`
963   are now deprecated in the standard library, and their usage will now produce a warning.
964   Please use the `str::{trim_start, trim_end, trim_start_matches, trim_end_matches}`
965   methods instead.
966 - The `Error::cause` method has been deprecated in favor of `Error::source` which supports
967   downcasting.
968 - [Libtest no longer creates a new thread for each test when
969   `--test-threads=1`.  It also runs the tests in deterministic order][56243]
970
971 [55982]: https://github.com/rust-lang/rust/pull/55982/
972 [56243]: https://github.com/rust-lang/rust/pull/56243
973 [56303]: https://github.com/rust-lang/rust/pull/56303/
974 [56351]: https://github.com/rust-lang/rust/pull/56351/
975 [56362]: https://github.com/rust-lang/rust/pull/56362
976 [56642]: https://github.com/rust-lang/rust/pull/56642/
977 [56769]: https://github.com/rust-lang/rust/pull/56769/
978 [56805]: https://github.com/rust-lang/rust/pull/56805
979 [56947]: https://github.com/rust-lang/rust/pull/56947/
980 [57049]: https://github.com/rust-lang/rust/pull/57049/
981 [57067]: https://github.com/rust-lang/rust/pull/57067/
982 [57105]: https://github.com/rust-lang/rust/pull/57105
983 [57130]: https://github.com/rust-lang/rust/pull/57130/
984 [57167]: https://github.com/rust-lang/rust/pull/57167/
985 [57175]: https://github.com/rust-lang/rust/pull/57175/
986 [57234]: https://github.com/rust-lang/rust/pull/57234/
987 [57332]: https://github.com/rust-lang/rust/pull/57332/
988 [57465]: https://github.com/rust-lang/rust/pull/57465/
989 [57532]: https://github.com/rust-lang/rust/pull/57532/
990 [57535]: https://github.com/rust-lang/rust/pull/57535/
991 [57566]: https://github.com/rust-lang/rust/pull/57566/
992 [57615]: https://github.com/rust-lang/rust/pull/57615/
993 [cargo/6453]: https://github.com/rust-lang/cargo/pull/6453/
994 [cargo/6484]: https://github.com/rust-lang/cargo/pull/6484/
995 [`unix::FileExt::read_exact_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.read_exact_at
996 [`unix::FileExt::write_all_at`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html#method.write_all_at
997 [`Option::transpose`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.transpose
998 [`Result::transpose`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.transpose
999 [`convert::identity`]: https://doc.rust-lang.org/std/convert/fn.identity.html
1000 [`pin::Pin`]: https://doc.rust-lang.org/std/pin/struct.Pin.html
1001 [`marker::Unpin`]: https://doc.rust-lang.org/stable/std/marker/trait.Unpin.html
1002 [`marker::PhantomPinned`]: https://doc.rust-lang.org/nightly/std/marker/struct.PhantomPinned.html
1003 [`Vec::resize_with`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.resize_with
1004 [`VecDeque::resize_with`]: https://doc.rust-lang.org/std/collections/struct.VecDeque.html#method.resize_with
1005 [`Duration::as_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_millis
1006 [`Duration::as_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_micros
1007 [`Duration::as_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_nanos
1008 [platform-support]: https://forge.rust-lang.org/platform-support.html
1009
1010 Version 1.32.0 (2019-01-17)
1011 ==========================
1012
1013 Language
1014 --------
1015 #### 2018 edition
1016 - [You can now use the `?` operator in macro definitions.][56245] The `?`
1017   operator allows you to specify zero or one repetitions similar to the `*` and
1018   `+` operators.
1019 - [Module paths with no leading keyword like `super`, `self`, or `crate`, will
1020   now always resolve to the item (`enum`, `struct`, etc.) available in the
1021   module if present, before resolving to a external crate or an item the prelude.][56759]
1022   E.g.
1023   ```rust
1024   enum Color { Red, Green, Blue }
1025
1026   use Color::*;
1027   ```
1028
1029 #### All editions
1030 - [You can now match against `PhantomData<T>` types.][55837]
1031 - [You can now match against literals in macros with the `literal`
1032   specifier.][56072] This will match against a literal of any type.
1033   E.g. `1`, `'A'`, `"Hello World"`
1034 - [Self can now be used as a constructor and pattern for unit and tuple structs.][56365] E.g.
1035   ```rust
1036   struct Point(i32, i32);
1037
1038   impl Point {
1039       pub fn new(x: i32, y: i32) -> Self {
1040           Self(x, y)
1041       }
1042
1043       pub fn is_origin(&self) -> bool {
1044           match self {
1045               Self(0, 0) => true,
1046               _ => false,
1047           }
1048       }
1049   }
1050   ```
1051 - [Self can also now be used in type definitions.][56366] E.g.
1052   ```rust
1053   enum List<T>
1054   where
1055       Self: PartialOrd<Self> // can write `Self` instead of `List<T>`
1056   {
1057       Nil,
1058       Cons(T, Box<Self>) // likewise here
1059   }
1060   ```
1061 - [You can now mark traits with `#[must_use]`.][55663] This provides a warning if
1062   a `impl Trait` or `dyn Trait` is returned and unused in the program.
1063
1064 Compiler
1065 --------
1066 - [The default allocator has changed from jemalloc to the default allocator on
1067   your system.][55238] The compiler itself on Linux & macOS will still use
1068   jemalloc, but programs compiled with it will use the system allocator.
1069 - [Added the `aarch64-pc-windows-msvc` target.][55702]
1070
1071 Libraries
1072 ---------
1073 - [`PathBuf` now implements `FromStr`.][55148]
1074 - [`Box<[T]>` now implements `FromIterator<T>`.][55843]
1075 - [The `dbg!` macro has been stabilized.][56395] This macro enables you to
1076   easily debug expressions in your rust program. E.g.
1077   ```rust
1078   let a = 2;
1079   let b = dbg!(a * 2) + 1;
1080   //      ^-- prints: [src/main.rs:4] a * 2 = 4
1081   assert_eq!(b, 5);
1082   ```
1083
1084 The following APIs are now `const` functions and can be used in a
1085 `const` context.
1086
1087 - [`Cell::as_ptr`]
1088 - [`UnsafeCell::get`]
1089 - [`char::is_ascii`]
1090 - [`iter::empty`]
1091 - [`ManuallyDrop::new`]
1092 - [`ManuallyDrop::into_inner`]
1093 - [`RangeInclusive::start`]
1094 - [`RangeInclusive::end`]
1095 - [`NonNull::as_ptr`]
1096 - [`slice::as_ptr`]
1097 - [`str::as_ptr`]
1098 - [`Duration::as_secs`]
1099 - [`Duration::subsec_millis`]
1100 - [`Duration::subsec_micros`]
1101 - [`Duration::subsec_nanos`]
1102 - [`CStr::as_ptr`]
1103 - [`Ipv4Addr::is_unspecified`]
1104 - [`Ipv6Addr::new`]
1105 - [`Ipv6Addr::octets`]
1106
1107 Stabilized APIs
1108 ---------------
1109 - [`i8::to_be_bytes`]
1110 - [`i8::to_le_bytes`]
1111 - [`i8::to_ne_bytes`]
1112 - [`i8::from_be_bytes`]
1113 - [`i8::from_le_bytes`]
1114 - [`i8::from_ne_bytes`]
1115 - [`i16::to_be_bytes`]
1116 - [`i16::to_le_bytes`]
1117 - [`i16::to_ne_bytes`]
1118 - [`i16::from_be_bytes`]
1119 - [`i16::from_le_bytes`]
1120 - [`i16::from_ne_bytes`]
1121 - [`i32::to_be_bytes`]
1122 - [`i32::to_le_bytes`]
1123 - [`i32::to_ne_bytes`]
1124 - [`i32::from_be_bytes`]
1125 - [`i32::from_le_bytes`]
1126 - [`i32::from_ne_bytes`]
1127 - [`i64::to_be_bytes`]
1128 - [`i64::to_le_bytes`]
1129 - [`i64::to_ne_bytes`]
1130 - [`i64::from_be_bytes`]
1131 - [`i64::from_le_bytes`]
1132 - [`i64::from_ne_bytes`]
1133 - [`i128::to_be_bytes`]
1134 - [`i128::to_le_bytes`]
1135 - [`i128::to_ne_bytes`]
1136 - [`i128::from_be_bytes`]
1137 - [`i128::from_le_bytes`]
1138 - [`i128::from_ne_bytes`]
1139 - [`isize::to_be_bytes`]
1140 - [`isize::to_le_bytes`]
1141 - [`isize::to_ne_bytes`]
1142 - [`isize::from_be_bytes`]
1143 - [`isize::from_le_bytes`]
1144 - [`isize::from_ne_bytes`]
1145 - [`u8::to_be_bytes`]
1146 - [`u8::to_le_bytes`]
1147 - [`u8::to_ne_bytes`]
1148 - [`u8::from_be_bytes`]
1149 - [`u8::from_le_bytes`]
1150 - [`u8::from_ne_bytes`]
1151 - [`u16::to_be_bytes`]
1152 - [`u16::to_le_bytes`]
1153 - [`u16::to_ne_bytes`]
1154 - [`u16::from_be_bytes`]
1155 - [`u16::from_le_bytes`]
1156 - [`u16::from_ne_bytes`]
1157 - [`u32::to_be_bytes`]
1158 - [`u32::to_le_bytes`]
1159 - [`u32::to_ne_bytes`]
1160 - [`u32::from_be_bytes`]
1161 - [`u32::from_le_bytes`]
1162 - [`u32::from_ne_bytes`]
1163 - [`u64::to_be_bytes`]
1164 - [`u64::to_le_bytes`]
1165 - [`u64::to_ne_bytes`]
1166 - [`u64::from_be_bytes`]
1167 - [`u64::from_le_bytes`]
1168 - [`u64::from_ne_bytes`]
1169 - [`u128::to_be_bytes`]
1170 - [`u128::to_le_bytes`]
1171 - [`u128::to_ne_bytes`]
1172 - [`u128::from_be_bytes`]
1173 - [`u128::from_le_bytes`]
1174 - [`u128::from_ne_bytes`]
1175 - [`usize::to_be_bytes`]
1176 - [`usize::to_le_bytes`]
1177 - [`usize::to_ne_bytes`]
1178 - [`usize::from_be_bytes`]
1179 - [`usize::from_le_bytes`]
1180 - [`usize::from_ne_bytes`]
1181
1182 Cargo
1183 -----
1184 - [You can now run `cargo c` as an alias for `cargo check`.][cargo/6218]
1185 - [Usernames are now allowed in alt registry URLs.][cargo/6242]
1186
1187 Misc
1188 ----
1189 - [`libproc_macro` has been added to the `rust-src` distribution.][55280]
1190
1191 Compatibility Notes
1192 -------------------
1193 - [The argument types for AVX's
1194   `_mm256_stream_si256`, `_mm256_stream_pd`, `_mm256_stream_ps`][55610] have
1195   been changed from `*const` to `*mut` as the previous implementation
1196   was unsound.
1197
1198
1199 [55148]: https://github.com/rust-lang/rust/pull/55148/
1200 [55238]: https://github.com/rust-lang/rust/pull/55238/
1201 [55280]: https://github.com/rust-lang/rust/pull/55280/
1202 [55610]: https://github.com/rust-lang/rust/pull/55610/
1203 [55663]: https://github.com/rust-lang/rust/pull/55663/
1204 [55702]: https://github.com/rust-lang/rust/pull/55702/
1205 [55837]: https://github.com/rust-lang/rust/pull/55837/
1206 [55843]: https://github.com/rust-lang/rust/pull/55843/
1207 [56072]: https://github.com/rust-lang/rust/pull/56072/
1208 [56245]: https://github.com/rust-lang/rust/pull/56245/
1209 [56365]: https://github.com/rust-lang/rust/pull/56365/
1210 [56366]: https://github.com/rust-lang/rust/pull/56366/
1211 [56395]: https://github.com/rust-lang/rust/pull/56395/
1212 [56759]: https://github.com/rust-lang/rust/pull/56759/
1213 [cargo/6218]: https://github.com/rust-lang/cargo/pull/6218/
1214 [cargo/6242]: https://github.com/rust-lang/cargo/pull/6242/
1215 [`CStr::as_ptr`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.as_ptr
1216 [`Cell::as_ptr`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr
1217 [`Duration::as_secs`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.as_secs
1218 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1219 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1220 [`Duration::subsec_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_nanos
1221 [`Ipv4Addr::is_unspecified`]: https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified
1222 [`Ipv6Addr::new`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.new
1223 [`Ipv6Addr::octets`]: https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets
1224 [`ManuallyDrop::into_inner`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.into_inner
1225 [`ManuallyDrop::new`]: https://doc.rust-lang.org/std/mem/struct.ManuallyDrop.html#method.new
1226 [`NonNull::as_ptr`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.as_ptr
1227 [`RangeInclusive::end`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.end
1228 [`RangeInclusive::start`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html#method.start
1229 [`UnsafeCell::get`]: https://doc.rust-lang.org/std/cell/struct.UnsafeCell.html#method.get
1230 [`slice::as_ptr`]: https://doc.rust-lang.org/std/primitive.slice.html#method.as_ptr
1231 [`char::is_ascii`]: https://doc.rust-lang.org/std/primitive.char.html#method.is_ascii
1232 [`i128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_be_bytes
1233 [`i128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_le_bytes
1234 [`i128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.from_ne_bytes
1235 [`i128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_be_bytes
1236 [`i128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_le_bytes
1237 [`i128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i128.html#method.to_ne_bytes
1238 [`i16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_be_bytes
1239 [`i16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_le_bytes
1240 [`i16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.from_ne_bytes
1241 [`i16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_be_bytes
1242 [`i16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_le_bytes
1243 [`i16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i16.html#method.to_ne_bytes
1244 [`i32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_be_bytes
1245 [`i32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_le_bytes
1246 [`i32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.from_ne_bytes
1247 [`i32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_be_bytes
1248 [`i32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_le_bytes
1249 [`i32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i32.html#method.to_ne_bytes
1250 [`i64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_be_bytes
1251 [`i64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_le_bytes
1252 [`i64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.from_ne_bytes
1253 [`i64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_be_bytes
1254 [`i64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_le_bytes
1255 [`i64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i64.html#method.to_ne_bytes
1256 [`i8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_be_bytes
1257 [`i8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_le_bytes
1258 [`i8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.from_ne_bytes
1259 [`i8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_be_bytes
1260 [`i8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_le_bytes
1261 [`i8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.i8.html#method.to_ne_bytes
1262 [`isize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_be_bytes
1263 [`isize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_le_bytes
1264 [`isize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.from_ne_bytes
1265 [`isize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_be_bytes
1266 [`isize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_le_bytes
1267 [`isize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.isize.html#method.to_ne_bytes
1268 [`iter::empty`]: https://doc.rust-lang.org/std/iter/fn.empty.html
1269 [`str::as_ptr`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_ptr
1270 [`u128::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_be_bytes
1271 [`u128::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_le_bytes
1272 [`u128::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.from_ne_bytes
1273 [`u128::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_be_bytes
1274 [`u128::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_le_bytes
1275 [`u128::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u128.html#method.to_ne_bytes
1276 [`u16::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_be_bytes
1277 [`u16::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_le_bytes
1278 [`u16::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.from_ne_bytes
1279 [`u16::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_be_bytes
1280 [`u16::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_le_bytes
1281 [`u16::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u16.html#method.to_ne_bytes
1282 [`u32::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_be_bytes
1283 [`u32::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_le_bytes
1284 [`u32::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.from_ne_bytes
1285 [`u32::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_be_bytes
1286 [`u32::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_le_bytes
1287 [`u32::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u32.html#method.to_ne_bytes
1288 [`u64::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_be_bytes
1289 [`u64::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_le_bytes
1290 [`u64::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.from_ne_bytes
1291 [`u64::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_be_bytes
1292 [`u64::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_le_bytes
1293 [`u64::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u64.html#method.to_ne_bytes
1294 [`u8::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_be_bytes
1295 [`u8::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_le_bytes
1296 [`u8::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.from_ne_bytes
1297 [`u8::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_be_bytes
1298 [`u8::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_le_bytes
1299 [`u8::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.u8.html#method.to_ne_bytes
1300 [`usize::from_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_be_bytes
1301 [`usize::from_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_le_bytes
1302 [`usize::from_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.from_ne_bytes
1303 [`usize::to_be_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_be_bytes
1304 [`usize::to_le_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_le_bytes
1305 [`usize::to_ne_bytes`]: https://doc.rust-lang.org/stable/std/primitive.usize.html#method.to_ne_bytes
1306
1307
1308 Version 1.31.1 (2018-12-20)
1309 ===========================
1310
1311 - [Fix Rust failing to build on `powerpc-unknown-netbsd`][56562]
1312 - [Fix broken go-to-definition in RLS][rls/1171]
1313 - [Fix infinite loop on hover in RLS][rls/1170]
1314
1315 [56562]: https://github.com/rust-lang/rust/pull/56562
1316 [rls/1171]: https://github.com/rust-lang/rls/issues/1171
1317 [rls/1170]: https://github.com/rust-lang/rls/pull/1170
1318
1319 Version 1.31.0 (2018-12-06)
1320 ==========================
1321
1322 Language
1323 --------
1324 - 🎉 [This version marks the release of the 2018 edition of Rust.][54057] 🎉
1325 - [New lifetime elision rules now allow for eliding lifetimes in functions and
1326   impl headers.][54778] E.g. `impl<'a> Reader for BufReader<'a> {}` can now be
1327   `impl Reader for BufReader<'_> {}`. Lifetimes are still required to be defined
1328   in structs.
1329 - [You can now define and use `const` functions.][54835] These are currently
1330   a strict minimal subset of the [const fn RFC][RFC-911]. Refer to the
1331   [language reference][const-reference] for what exactly is available.
1332 - [You can now use tool lints, which allow you to scope lints from external
1333   tools using attributes.][54870] E.g. `#[allow(clippy::filter_map)]`.
1334 - [`#[no_mangle]` and `#[export_name]` attributes can now be located anywhere in
1335   a crate, not just in exported functions.][54451]
1336 - [You can now use parentheses in pattern matches.][54497]
1337
1338 Compiler
1339 --------
1340 - [Updated musl to 1.1.20][54430]
1341
1342 Libraries
1343 ---------
1344 - [You can now convert `num::NonZero*` types to their raw equivalents using the
1345   `From` trait.][54240] E.g. `u8` now implements `From<NonZeroU8>`.
1346 - [You can now convert a `&Option<T>` into `Option<&T>` and `&mut Option<T>`
1347   into `Option<&mut T>` using the `From` trait.][53218]
1348 - [You can now multiply (`*`) a `time::Duration` by a `u32`.][52813]
1349
1350
1351 Stabilized APIs
1352 ---------------
1353 - [`slice::align_to`]
1354 - [`slice::align_to_mut`]
1355 - [`slice::chunks_exact`]
1356 - [`slice::chunks_exact_mut`]
1357 - [`slice::rchunks`]
1358 - [`slice::rchunks_mut`]
1359 - [`slice::rchunks_exact`]
1360 - [`slice::rchunks_exact_mut`]
1361 - [`Option::replace`]
1362
1363 Cargo
1364 -----
1365 - [Cargo will now download crates in parallel using HTTP/2.][cargo/6005]
1366 - [You can now rename packages in your Cargo.toml][cargo/6319] We have a guide
1367   on [how to use the `package` key in your dependencies.][cargo-rename-reference]
1368
1369 [52813]: https://github.com/rust-lang/rust/pull/52813/
1370 [53218]: https://github.com/rust-lang/rust/pull/53218/
1371 [53555]: https://github.com/rust-lang/rust/issues/53555/
1372 [54057]: https://github.com/rust-lang/rust/pull/54057/
1373 [54240]: https://github.com/rust-lang/rust/pull/54240/
1374 [54430]: https://github.com/rust-lang/rust/pull/54430/
1375 [54451]: https://github.com/rust-lang/rust/pull/54451/
1376 [54497]: https://github.com/rust-lang/rust/pull/54497/
1377 [54778]: https://github.com/rust-lang/rust/pull/54778/
1378 [54835]: https://github.com/rust-lang/rust/pull/54835/
1379 [54870]: https://github.com/rust-lang/rust/pull/54870/
1380 [RFC-911]: https://github.com/rust-lang/rfcs/pull/911
1381 [`Option::replace`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.replace
1382 [`slice::align_to_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to_mut
1383 [`slice::align_to`]: https://doc.rust-lang.org/std/primitive.slice.html#method.align_to
1384 [`slice::chunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact_mut
1385 [`slice::chunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.chunks_exact
1386 [`slice::rchunks_exact_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1387 [`slice::rchunks_exact`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_exact
1388 [`slice::rchunks_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks_mut
1389 [`slice::rchunks`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rchunks
1390 [cargo/6005]: https://github.com/rust-lang/cargo/pull/6005/
1391 [cargo/6319]: https://github.com/rust-lang/cargo/pull/6319/
1392 [cargo-rename-reference]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#renaming-dependencies-in-cargotoml
1393 [const-reference]: https://doc.rust-lang.org/reference/items/functions.html#const-functions
1394
1395 Version 1.30.1 (2018-11-08)
1396 ===========================
1397
1398 - [Fixed overflow ICE in rustdoc][54199]
1399 - [Cap Cargo progress bar width at 60 in MSYS terminals][cargo/6122]
1400
1401 [54199]: https://github.com/rust-lang/rust/pull/54199
1402 [cargo/6122]: https://github.com/rust-lang/cargo/pull/6122
1403
1404 Version 1.30.0 (2018-10-25)
1405 ==========================
1406
1407 Language
1408 --------
1409 - [Procedural macros are now available.][52081] These kinds of macros allow for
1410   more powerful code generation. There is a [new chapter available][proc-macros]
1411   in the Rust Programming Language book that goes further in depth.
1412 - [You can now use keywords as identifiers using the raw identifiers
1413   syntax (`r#`),][53236] e.g. `let r#for = true;`
1414 - [Using anonymous parameters in traits is now deprecated with a warning and
1415   will be a hard error in the 2018 edition.][53272]
1416 - [You can now use `crate` in paths.][54404] This allows you to refer to the
1417   crate root in the path, e.g. `use crate::foo;` refers to `foo` in `src/lib.rs`.
1418 - [Using a external crate no longer requires being prefixed with `::`.][54404]
1419   Previously, using a external crate in a module without a use statement
1420   required `let json = ::serde_json::from_str(foo);` but can now be written
1421   as `let json = serde_json::from_str(foo);`.
1422 - [You can now apply the `#[used]` attribute to static items to prevent the
1423   compiler from optimising them away, even if they appear to be unused,][51363]
1424   e.g. `#[used] static FOO: u32 = 1;`
1425 - [You can now import and reexport macros from other crates with the `use`
1426   syntax.][50911] Macros exported with `#[macro_export]` are now placed into
1427   the root module of the crate. If your macro relies on calling other local
1428   macros, it is recommended to export with the
1429   `#[macro_export(local_inner_macros)]` attribute so users won't have to import
1430   those macros.
1431 - [You can now catch visibility keywords (e.g. `pub`, `pub(crate)`) in macros
1432   using the `vis` specifier.][53370]
1433 - [Non-macro attributes now allow all forms of literals, not just
1434   strings.][53044] Previously, you would write `#[attr("true")]`, and you can now
1435   write `#[attr(true)]`.
1436 - [You can now specify a function to handle a panic in the Rust runtime with the
1437   `#[panic_handler]` attribute.][51366]
1438
1439 Compiler
1440 --------
1441 - [Added the `riscv32imc-unknown-none-elf` target.][53822]
1442 - [Added the `aarch64-unknown-netbsd` target][53165]
1443
1444 Libraries
1445 ---------
1446 - [`ManuallyDrop` now allows the inner type to be unsized.][53033]
1447
1448 Stabilized APIs
1449 ---------------
1450 - [`Ipv4Addr::BROADCAST`]
1451 - [`Ipv4Addr::LOCALHOST`]
1452 - [`Ipv4Addr::UNSPECIFIED`]
1453 - [`Ipv6Addr::LOCALHOST`]
1454 - [`Ipv6Addr::UNSPECIFIED`]
1455 - [`Iterator::find_map`]
1456
1457   The following methods are replacement methods for `trim_left`, `trim_right`,
1458   `trim_left_matches`, and `trim_right_matches`, which will be deprecated
1459   in 1.33.0:
1460 - [`str::trim_end_matches`]
1461 - [`str::trim_end`]
1462 - [`str::trim_start_matches`]
1463 - [`str::trim_start`]
1464
1465 Cargo
1466 ----
1467 - [`cargo run` doesn't require specifying a package in workspaces.][cargo/5877]
1468 - [`cargo doc` now supports `--message-format=json`.][cargo/5878] This is
1469   equivalent to calling `rustdoc --error-format=json`.
1470 - [Cargo will now provide a progress bar for builds.][cargo/5995]
1471
1472 Misc
1473 ----
1474 - [`rustdoc` allows you to specify what edition to treat your code as with the
1475   `--edition` option.][54057]
1476 - [`rustdoc` now has the `--color` (specify whether to output color) and
1477   `--error-format` (specify error format, e.g. `json`) options.][53003]
1478 - [We now distribute a `rust-gdbgui` script that invokes `gdbgui` with Rust
1479   debug symbols.][53774]
1480 - [Attributes from Rust tools such as `rustfmt` or `clippy` are now
1481   available,][53459] e.g. `#[rustfmt::skip]` will skip formatting the next item.
1482
1483 [50911]: https://github.com/rust-lang/rust/pull/50911/
1484 [51363]: https://github.com/rust-lang/rust/pull/51363/
1485 [51366]: https://github.com/rust-lang/rust/pull/51366/
1486 [52081]: https://github.com/rust-lang/rust/pull/52081/
1487 [53003]: https://github.com/rust-lang/rust/pull/53003/
1488 [53033]: https://github.com/rust-lang/rust/pull/53033/
1489 [53044]: https://github.com/rust-lang/rust/pull/53044/
1490 [53165]: https://github.com/rust-lang/rust/pull/53165/
1491 [53213]: https://github.com/rust-lang/rust/pull/53213/
1492 [53236]: https://github.com/rust-lang/rust/pull/53236/
1493 [53272]: https://github.com/rust-lang/rust/pull/53272/
1494 [53370]: https://github.com/rust-lang/rust/pull/53370/
1495 [53459]: https://github.com/rust-lang/rust/pull/53459/
1496 [53774]: https://github.com/rust-lang/rust/pull/53774/
1497 [53822]: https://github.com/rust-lang/rust/pull/53822/
1498 [54057]: https://github.com/rust-lang/rust/pull/54057/
1499 [54146]: https://github.com/rust-lang/rust/pull/54146/
1500 [54404]: https://github.com/rust-lang/rust/pull/54404/
1501 [cargo/5877]: https://github.com/rust-lang/cargo/pull/5877/
1502 [cargo/5878]: https://github.com/rust-lang/cargo/pull/5878/
1503 [cargo/5995]: https://github.com/rust-lang/cargo/pull/5995/
1504 [proc-macros]: https://doc.rust-lang.org/nightly/book/2018-edition/ch19-06-macros.html
1505
1506 [`Ipv4Addr::BROADCAST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.BROADCAST
1507 [`Ipv4Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.LOCALHOST
1508 [`Ipv4Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#associatedconstant.UNSPECIFIED
1509 [`Ipv6Addr::LOCALHOST`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.LOCALHOST
1510 [`Ipv6Addr::UNSPECIFIED`]: https://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#associatedconstant.UNSPECIFIED
1511 [`Iterator::find_map`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.find_map
1512 [`str::trim_end_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end_matches
1513 [`str::trim_end`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_end
1514 [`str::trim_start_matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start_matches
1515 [`str::trim_start`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.trim_start
1516
1517
1518 Version 1.29.2 (2018-10-11)
1519 ===========================
1520
1521 - [Workaround for an aliasing-related LLVM bug, which caused miscompilation.][54639]
1522 - The `rls-preview` component on the windows-gnu targets has been restored.
1523
1524 [54639]: https://github.com/rust-lang/rust/pull/54639
1525
1526
1527 Version 1.29.1 (2018-09-25)
1528 ===========================
1529
1530 Security Notes
1531 --------------
1532
1533 - The standard library's `str::repeat` function contained an out of bounds write
1534   caused by an integer overflow. This has been fixed by deterministically
1535   panicking when an overflow happens.
1536
1537   Thank you to Scott McMurray for responsibly disclosing this vulnerability to
1538   us.
1539
1540
1541 Version 1.29.0 (2018-09-13)
1542 ==========================
1543
1544 Compiler
1545 --------
1546 - [Bumped minimum LLVM version to 5.0.][51899]
1547 - [Added `powerpc64le-unknown-linux-musl` target.][51619]
1548 - [Added `aarch64-unknown-hermit` and `x86_64-unknown-hermit` targets.][52861]
1549
1550 Libraries
1551 ---------
1552 - [`Once::call_once` no longer requires `Once` to be `'static`.][52239]
1553 - [`BuildHasherDefault` now implements `PartialEq` and `Eq`.][52402]
1554 - [`Box<CStr>`, `Box<OsStr>`, and `Box<Path>` now implement `Clone`.][51912]
1555 - [Implemented `PartialEq<&str>` for `OsString` and `PartialEq<OsString>`
1556   for `&str`.][51178]
1557 - [`Cell<T>` now allows `T` to be unsized.][50494]
1558 - [`SocketAddr` is now stable on Redox.][52656]
1559
1560 Stabilized APIs
1561 ---------------
1562 - [`Arc::downcast`]
1563 - [`Iterator::flatten`]
1564 - [`Rc::downcast`]
1565
1566 Cargo
1567 -----
1568 - [Cargo can silently fix some bad lockfiles.][cargo/5831] You can use
1569   `--locked` to disable this behavior.
1570 - [`cargo-install` will now allow you to cross compile an install
1571   using `--target`.][cargo/5614]
1572 - [Added the `cargo-fix` subcommand to automatically move project code from
1573   2015 edition to 2018.][cargo/5723]
1574 - [`cargo doc` can now optionally document private types using the
1575   `--document-private-items` flag.][cargo/5543]
1576
1577 Misc
1578 ----
1579 - [`rustdoc` now has the `--cap-lints` option which demotes all lints above
1580   the specified level to that level.][52354] For example `--cap-lints warn`
1581   will demote `deny` and `forbid` lints to `warn`.
1582 - [`rustc` and `rustdoc` will now have the exit code of `1` if compilation
1583   fails and `101` if there is a panic.][52197]
1584 - [A preview of clippy has been made available through rustup.][51122]
1585   You can install the preview with `rustup component add clippy-preview`.
1586
1587 Compatibility Notes
1588 -------------------
1589 - [`str::{slice_unchecked, slice_unchecked_mut}` are now deprecated.][51807]
1590   Use `str::get_unchecked(begin..end)` instead.
1591 - [`std::env::home_dir` is now deprecated for its unintuitive behavior.][51656]
1592   Consider using the `home_dir` function from
1593   https://crates.io/crates/dirs instead.
1594 - [`rustc` will no longer silently ignore invalid data in target spec.][52330]
1595 - [`cfg` attributes and `--cfg` command line flags are now more
1596   strictly validated.][53893]
1597
1598 [53893]: https://github.com/rust-lang/rust/pull/53893/
1599 [52861]: https://github.com/rust-lang/rust/pull/52861/
1600 [52656]: https://github.com/rust-lang/rust/pull/52656/
1601 [52239]: https://github.com/rust-lang/rust/pull/52239/
1602 [52330]: https://github.com/rust-lang/rust/pull/52330/
1603 [52354]: https://github.com/rust-lang/rust/pull/52354/
1604 [52402]: https://github.com/rust-lang/rust/pull/52402/
1605 [52103]: https://github.com/rust-lang/rust/pull/52103/
1606 [52197]: https://github.com/rust-lang/rust/pull/52197/
1607 [51807]: https://github.com/rust-lang/rust/pull/51807/
1608 [51899]: https://github.com/rust-lang/rust/pull/51899/
1609 [51912]: https://github.com/rust-lang/rust/pull/51912/
1610 [51511]: https://github.com/rust-lang/rust/pull/51511/
1611 [51619]: https://github.com/rust-lang/rust/pull/51619/
1612 [51656]: https://github.com/rust-lang/rust/pull/51656/
1613 [51178]: https://github.com/rust-lang/rust/pull/51178/
1614 [51122]: https://github.com/rust-lang/rust/pull/51122
1615 [50494]: https://github.com/rust-lang/rust/pull/50494/
1616 [cargo/5543]: https://github.com/rust-lang/cargo/pull/5543
1617 [cargo/5614]: https://github.com/rust-lang/cargo/pull/5614/
1618 [cargo/5723]: https://github.com/rust-lang/cargo/pull/5723/
1619 [cargo/5831]: https://github.com/rust-lang/cargo/pull/5831/
1620 [`Arc::downcast`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.downcast
1621 [`Iterator::flatten`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.flatten
1622 [`Rc::downcast`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.downcast
1623
1624
1625 Version 1.28.0 (2018-08-02)
1626 ===========================
1627
1628 Language
1629 --------
1630 - [The `#[repr(transparent)]` attribute is now stable.][51562] This attribute
1631   allows a Rust newtype wrapper (`struct NewType<T>(T);`) to be represented as
1632   the inner type across Foreign Function Interface (FFI) boundaries.
1633 - [The keywords `pure`, `sizeof`, `alignof`, and `offsetof` have been unreserved
1634   and can now be used as identifiers.][51196]
1635 - [The `GlobalAlloc` trait and `#[global_allocator]` attribute are now
1636   stable.][51241] This will allow users to specify a global allocator for
1637   their program.
1638 - [Unit test functions marked with the `#[test]` attribute can now return
1639   `Result<(), E: Debug>` in addition to `()`.][51298]
1640 - [The `lifetime` specifier for `macro_rules!` is now stable.][50385] This
1641   allows macros to easily target lifetimes.
1642
1643 Compiler
1644 --------
1645 - [The `s` and `z` optimisation levels are now stable.][50265] These optimisations
1646   prioritise making smaller binary sizes. `z` is the same as `s` with the
1647   exception that it does not vectorise loops, which typically results in an even
1648   smaller binary.
1649 - [The short error format is now stable.][49546] Specified with
1650   `--error-format=short` this option will provide a more compressed output of
1651   rust error messages.
1652 - [Added a lint warning when you have duplicated `macro_export`s.][50143]
1653 - [Reduced the number of allocations in the macro parser.][50855] This can
1654   improve compile times of macro heavy crates on average by 5%.
1655
1656 Libraries
1657 ---------
1658 - [Implemented `Default` for `&mut str`.][51306]
1659 - [Implemented `From<bool>` for all integer and unsigned number types.][50554]
1660 - [Implemented `Extend` for `()`.][50234]
1661 - [The `Debug` implementation of `time::Duration` should now be more easily
1662   human readable.][50364] Previously a `Duration` of one second would printed as
1663   `Duration { secs: 1, nanos: 0 }` and will now be printed as `1s`.
1664 - [Implemented `From<&String>` for `Cow<str>`, `From<&Vec<T>>` for `Cow<[T]>`,
1665   `From<Cow<CStr>>` for `CString`, `From<CString>, From<CStr>, From<&CString>`
1666   for `Cow<CStr>`, `From<OsString>, From<OsStr>, From<&OsString>` for
1667   `Cow<OsStr>`, `From<&PathBuf>` for `Cow<Path>`, and `From<Cow<Path>>`
1668   for `PathBuf`.][50170]
1669 - [Implemented `Shl` and `Shr` for `Wrapping<u128>`
1670   and `Wrapping<i128>`.][50465]
1671 - [`DirEntry::metadata` now uses `fstatat` instead of `lstat` when
1672   possible.][51050] This can provide up to a 40% speed increase.
1673 - [Improved error messages when using `format!`.][50610]
1674
1675 Stabilized APIs
1676 ---------------
1677 - [`Iterator::step_by`]
1678 - [`Path::ancestors`]
1679 - [`SystemTime::UNIX_EPOCH`]
1680 - [`alloc::GlobalAlloc`]
1681 - [`alloc::Layout`]
1682 - [`alloc::LayoutErr`]
1683 - [`alloc::System`]
1684 - [`alloc::alloc`]
1685 - [`alloc::alloc_zeroed`]
1686 - [`alloc::dealloc`]
1687 - [`alloc::realloc`]
1688 - [`alloc::handle_alloc_error`]
1689 - [`btree_map::Entry::or_default`]
1690 - [`fmt::Alignment`]
1691 - [`hash_map::Entry::or_default`]
1692 - [`iter::repeat_with`]
1693 - [`num::NonZeroUsize`]
1694 - [`num::NonZeroU128`]
1695 - [`num::NonZeroU16`]
1696 - [`num::NonZeroU32`]
1697 - [`num::NonZeroU64`]
1698 - [`num::NonZeroU8`]
1699 - [`ops::RangeBounds`]
1700 - [`slice::SliceIndex`]
1701 - [`slice::from_mut`]
1702 - [`slice::from_ref`]
1703 - [`{Any + Send + Sync}::downcast_mut`]
1704 - [`{Any + Send + Sync}::downcast_ref`]
1705 - [`{Any + Send + Sync}::is`]
1706
1707 Cargo
1708 -----
1709 - [Cargo will now no longer allow you to publish crates with build scripts that
1710   modify the `src` directory.][cargo/5584] The `src` directory in a crate should be
1711   considered to be immutable.
1712
1713 Misc
1714 ----
1715 - [The `suggestion_applicability` field in `rustc`'s json output is now
1716   stable.][50486] This will allow dev tools to check whether a code suggestion
1717   would apply to them.
1718
1719 Compatibility Notes
1720 -------------------
1721 - [Rust will consider trait objects with duplicated constraints to be the same
1722   type as without the duplicated constraint.][51276] For example the below code will
1723   now fail to compile.
1724   ```rust
1725   trait Trait {}
1726
1727   impl Trait + Send {
1728       fn test(&self) { println!("one"); } //~ ERROR duplicate definitions with name `test`
1729   }
1730
1731   impl Trait + Send + Send {
1732       fn test(&self) { println!("two"); }
1733   }
1734   ```
1735
1736 [49546]: https://github.com/rust-lang/rust/pull/49546/
1737 [50143]: https://github.com/rust-lang/rust/pull/50143/
1738 [50170]: https://github.com/rust-lang/rust/pull/50170/
1739 [50234]: https://github.com/rust-lang/rust/pull/50234/
1740 [50265]: https://github.com/rust-lang/rust/pull/50265/
1741 [50364]: https://github.com/rust-lang/rust/pull/50364/
1742 [50385]: https://github.com/rust-lang/rust/pull/50385/
1743 [50465]: https://github.com/rust-lang/rust/pull/50465/
1744 [50486]: https://github.com/rust-lang/rust/pull/50486/
1745 [50554]: https://github.com/rust-lang/rust/pull/50554/
1746 [50610]: https://github.com/rust-lang/rust/pull/50610/
1747 [50855]: https://github.com/rust-lang/rust/pull/50855/
1748 [51050]: https://github.com/rust-lang/rust/pull/51050/
1749 [51196]: https://github.com/rust-lang/rust/pull/51196/
1750 [51200]: https://github.com/rust-lang/rust/pull/51200/
1751 [51241]: https://github.com/rust-lang/rust/pull/51241/
1752 [51276]: https://github.com/rust-lang/rust/pull/51276/
1753 [51298]: https://github.com/rust-lang/rust/pull/51298/
1754 [51306]: https://github.com/rust-lang/rust/pull/51306/
1755 [51562]: https://github.com/rust-lang/rust/pull/51562/
1756 [cargo/5584]: https://github.com/rust-lang/cargo/pull/5584/
1757 [`Iterator::step_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.step_by
1758 [`Path::ancestors`]: https://doc.rust-lang.org/std/path/struct.Path.html#method.ancestors
1759 [`SystemTime::UNIX_EPOCH`]: https://doc.rust-lang.org/std/time/struct.SystemTime.html#associatedconstant.UNIX_EPOCH
1760 [`alloc::GlobalAlloc`]: https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
1761 [`alloc::Layout`]: https://doc.rust-lang.org/std/alloc/struct.Layout.html
1762 [`alloc::LayoutErr`]: https://doc.rust-lang.org/std/alloc/struct.LayoutErr.html
1763 [`alloc::System`]: https://doc.rust-lang.org/std/alloc/struct.System.html
1764 [`alloc::alloc`]: https://doc.rust-lang.org/std/alloc/fn.alloc.html
1765 [`alloc::alloc_zeroed`]: https://doc.rust-lang.org/std/alloc/fn.alloc_zeroed.html
1766 [`alloc::dealloc`]: https://doc.rust-lang.org/std/alloc/fn.dealloc.html
1767 [`alloc::realloc`]: https://doc.rust-lang.org/std/alloc/fn.realloc.html
1768 [`alloc::handle_alloc_error`]: https://doc.rust-lang.org/std/alloc/fn.handle_alloc_error.html
1769 [`btree_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.or_default
1770 [`fmt::Alignment`]: https://doc.rust-lang.org/std/fmt/enum.Alignment.html
1771 [`hash_map::Entry::or_default`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.or_default
1772 [`iter::repeat_with`]: https://doc.rust-lang.org/std/iter/fn.repeat_with.html
1773 [`num::NonZeroUsize`]: https://doc.rust-lang.org/std/num/struct.NonZeroUsize.html
1774 [`num::NonZeroU128`]: https://doc.rust-lang.org/std/num/struct.NonZeroU128.html
1775 [`num::NonZeroU16`]: https://doc.rust-lang.org/std/num/struct.NonZeroU16.html
1776 [`num::NonZeroU32`]: https://doc.rust-lang.org/std/num/struct.NonZeroU32.html
1777 [`num::NonZeroU64`]: https://doc.rust-lang.org/std/num/struct.NonZeroU64.html
1778 [`num::NonZeroU8`]: https://doc.rust-lang.org/std/num/struct.NonZeroU8.html
1779 [`ops::RangeBounds`]: https://doc.rust-lang.org/std/ops/trait.RangeBounds.html
1780 [`slice::SliceIndex`]: https://doc.rust-lang.org/std/slice/trait.SliceIndex.html
1781 [`slice::from_mut`]: https://doc.rust-lang.org/std/slice/fn.from_mut.html
1782 [`slice::from_ref`]: https://doc.rust-lang.org/std/slice/fn.from_ref.html
1783 [`{Any + Send + Sync}::downcast_mut`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_mut-2
1784 [`{Any + Send + Sync}::downcast_ref`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.downcast_ref-2
1785 [`{Any + Send + Sync}::is`]: https://doc.rust-lang.org/std/any/trait.Any.html#method.is-2
1786
1787 Version 1.27.2 (2018-07-20)
1788 ===========================
1789
1790 Compatibility Notes
1791 -------------------
1792
1793 - The borrow checker was fixed to avoid potential unsoundness when using
1794   match ergonomics: [#52213][52213].
1795
1796 [52213]: https://github.com/rust-lang/rust/issues/52213
1797
1798 Version 1.27.1 (2018-07-10)
1799 ===========================
1800
1801 Security Notes
1802 --------------
1803
1804 - rustdoc would execute plugins in the /tmp/rustdoc/plugins directory
1805   when running, which enabled executing code as some other user on a
1806   given machine. This release fixes that vulnerability; you can read
1807   more about this on the [blog][rustdoc-sec]. The associated CVE is [CVE-2018-1000622].
1808
1809   Thank you to Red Hat for responsibly disclosing this vulnerability to us.
1810
1811 Compatibility Notes
1812 -------------------
1813
1814 - The borrow checker was fixed to avoid an additional potential unsoundness when using
1815   match ergonomics: [#51415][51415], [#49534][49534].
1816
1817 [51415]: https://github.com/rust-lang/rust/issues/51415
1818 [49534]: https://github.com/rust-lang/rust/issues/49534
1819 [rustdoc-sec]: https://blog.rust-lang.org/2018/07/06/security-advisory-for-rustdoc.html
1820 [CVE-2018-1000622]: https://cve.mitre.org/cgi-bin/cvename.cgi?name=%20CVE-2018-1000622
1821
1822 Version 1.27.0 (2018-06-21)
1823 ==========================
1824
1825 Language
1826 --------
1827 - [Removed 'proc' from the reserved keywords list.][49699] This allows `proc` to
1828   be used as an identifier.
1829 - [The dyn syntax is now available.][49968] This syntax is equivalent to the
1830   bare `Trait` syntax, and should make it clearer when being used in tandem with
1831   `impl Trait` because it is equivalent to the following syntax:
1832   `&Trait == &dyn Trait`, `&mut Trait == &mut dyn Trait`, and
1833   `Box<Trait> == Box<dyn Trait>`.
1834 - [Attributes on generic parameters such as types and lifetimes are
1835   now stable.][48851] e.g.
1836   `fn foo<#[lifetime_attr] 'a, #[type_attr] T: 'a>() {}`
1837 - [The `#[must_use]` attribute can now also be used on functions as well as
1838   types.][48925] It provides a lint that by default warns users when the
1839   value returned by a function has not been used.
1840
1841 Compiler
1842 --------
1843 - [Added the `armv5te-unknown-linux-musleabi` target.][50423]
1844
1845 Libraries
1846 ---------
1847 - [SIMD (Single Instruction Multiple Data) on x86/x86_64 is now stable.][49664]
1848   This includes [`arch::x86`] & [`arch::x86_64`] modules which contain
1849   SIMD intrinsics, a new macro called `is_x86_feature_detected!`, the
1850   `#[target_feature(enable="")]` attribute, and adding `target_feature = ""` to
1851   the `cfg` attribute.
1852 - [A lot of methods for `[u8]`, `f32`, and `f64` previously only available in
1853   std are now available in core.][49896]
1854 - [The generic `Rhs` type parameter on `ops::{Shl, ShlAssign, Shr}` now defaults
1855   to `Self`.][49630]
1856 - [`std::str::replace` now has the `#[must_use]` attribute][50177] to clarify
1857   that the operation isn't done in place.
1858 - [`Clone::clone`, `Iterator::collect`, and `ToOwned::to_owned` now have
1859   the `#[must_use]` attribute][49533] to warn about unused potentially
1860   expensive allocations.
1861
1862 Stabilized APIs
1863 ---------------
1864 - [`DoubleEndedIterator::rfind`]
1865 - [`DoubleEndedIterator::rfold`]
1866 - [`DoubleEndedIterator::try_rfold`]
1867 - [`Duration::from_micros`]
1868 - [`Duration::from_nanos`]
1869 - [`Duration::subsec_micros`]
1870 - [`Duration::subsec_millis`]
1871 - [`HashMap::remove_entry`]
1872 - [`Iterator::try_fold`]
1873 - [`Iterator::try_for_each`]
1874 - [`NonNull::cast`]
1875 - [`Option::filter`]
1876 - [`String::replace_range`]
1877 - [`Take::set_limit`]
1878 - [`hint::unreachable_unchecked`]
1879 - [`os::unix::process::parent_id`]
1880 - [`ptr::swap_nonoverlapping`]
1881 - [`slice::rsplit_mut`]
1882 - [`slice::rsplit`]
1883 - [`slice::swap_with_slice`]
1884
1885 Cargo
1886 -----
1887 - [`cargo-metadata` now includes `authors`, `categories`, `keywords`,
1888   `readme`, and `repository` fields.][cargo/5386]
1889 - [`cargo-metadata` now includes a package's `metadata` table.][cargo/5360]
1890 - [Added the `--target-dir` optional argument.][cargo/5393] This allows you to specify
1891   a different directory than `target` for placing compilation artifacts.
1892 - [Cargo will be adding automatic target inference for binaries, benchmarks,
1893   examples, and tests in the Rust 2018 edition.][cargo/5335] If your project specifies
1894   specific targets, e.g. using `[[bin]]`, and have other binaries in locations
1895   where cargo would infer a binary, Cargo will produce a warning. You can
1896   disable this feature ahead of time by setting any of the following to false:
1897   `autobins`, `autobenches`, `autoexamples`, `autotests`.
1898 - [Cargo will now cache compiler information.][cargo/5359] This can be disabled by
1899   setting `CARGO_CACHE_RUSTC_INFO=0` in your environment.
1900
1901 Misc
1902 ----
1903 - [Added “The Rustc book” into the official documentation.][49707]
1904   [“The Rustc book”] documents and teaches how to use the rustc compiler.
1905 - [All books available on `doc.rust-lang.org` are now searchable.][49623]
1906
1907 Compatibility Notes
1908 -------------------
1909 - [Calling a `CharExt` or `StrExt` method directly on core will no longer
1910   work.][49896] e.g. `::core::prelude::v1::StrExt::is_empty("")` will not
1911   compile, `"".is_empty()` will still compile.
1912 - [`Debug` output on `atomic::{AtomicBool, AtomicIsize, AtomicPtr, AtomicUsize}`
1913   will only print the inner type.][48553] E.g.
1914   `print!("{:?}", AtomicBool::new(true))` will print `true`,
1915   not `AtomicBool(true)`.
1916 - [The maximum number for `repr(align(N))` is now 2²⁹.][50378] Previously you
1917   could enter higher numbers but they were not supported by LLVM. Up to 512MB
1918   alignment should cover all use cases.
1919 - The `.description()` method on the `std::error::Error` trait
1920   [has been soft-deprecated][50163]. It is no longer required to implement it.
1921
1922 [48553]: https://github.com/rust-lang/rust/pull/48553/
1923 [48851]: https://github.com/rust-lang/rust/pull/48851/
1924 [48925]: https://github.com/rust-lang/rust/pull/48925/
1925 [49533]: https://github.com/rust-lang/rust/pull/49533/
1926 [49623]: https://github.com/rust-lang/rust/pull/49623/
1927 [49630]: https://github.com/rust-lang/rust/pull/49630/
1928 [49664]: https://github.com/rust-lang/rust/pull/49664/
1929 [49699]: https://github.com/rust-lang/rust/pull/49699/
1930 [49707]: https://github.com/rust-lang/rust/pull/49707/
1931 [49719]: https://github.com/rust-lang/rust/pull/49719/
1932 [49896]: https://github.com/rust-lang/rust/pull/49896/
1933 [49968]: https://github.com/rust-lang/rust/pull/49968/
1934 [50163]: https://github.com/rust-lang/rust/pull/50163
1935 [50177]: https://github.com/rust-lang/rust/pull/50177/
1936 [50378]: https://github.com/rust-lang/rust/pull/50378/
1937 [50398]: https://github.com/rust-lang/rust/pull/50398/
1938 [50423]: https://github.com/rust-lang/rust/pull/50423/
1939 [cargo/5203]: https://github.com/rust-lang/cargo/pull/5203/
1940 [cargo/5335]: https://github.com/rust-lang/cargo/pull/5335/
1941 [cargo/5359]: https://github.com/rust-lang/cargo/pull/5359/
1942 [cargo/5360]: https://github.com/rust-lang/cargo/pull/5360/
1943 [cargo/5386]: https://github.com/rust-lang/cargo/pull/5386/
1944 [cargo/5393]: https://github.com/rust-lang/cargo/pull/5393/
1945 [`DoubleEndedIterator::rfind`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfind
1946 [`DoubleEndedIterator::rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.rfold
1947 [`DoubleEndedIterator::try_rfold`]: https://doc.rust-lang.org/std/iter/trait.DoubleEndedIterator.html#method.try_rfold
1948 [`Duration::from_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_micros
1949 [`Duration::from_nanos`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.from_nanos
1950 [`Duration::subsec_micros`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_micros
1951 [`Duration::subsec_millis`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.subsec_millis
1952 [`HashMap::remove_entry`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.remove_entry
1953 [`Iterator::try_fold`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_fold
1954 [`Iterator::try_for_each`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.try_for_each
1955 [`NonNull::cast`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html#method.cast
1956 [`Option::filter`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.filter
1957 [`String::replace_range`]: https://doc.rust-lang.org/std/string/struct.String.html#method.replace_range
1958 [`Take::set_limit`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.set_limit
1959 [`hint::unreachable_unchecked`]: https://doc.rust-lang.org/std/hint/fn.unreachable_unchecked.html
1960 [`os::unix::process::parent_id`]: https://doc.rust-lang.org/std/os/unix/process/fn.parent_id.html
1961 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
1962 [`ptr::swap_nonoverlapping`]: https://doc.rust-lang.org/std/ptr/fn.swap_nonoverlapping.html
1963 [`slice::rsplit_mut`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit_mut
1964 [`slice::rsplit`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rsplit
1965 [`slice::swap_with_slice`]: https://doc.rust-lang.org/std/primitive.slice.html#method.swap_with_slice
1966 [`arch::x86_64`]: https://doc.rust-lang.org/std/arch/x86_64/index.html
1967 [`arch::x86`]: https://doc.rust-lang.org/std/arch/x86/index.html
1968 [“The Rustc book”]: https://doc.rust-lang.org/rustc
1969
1970
1971 Version 1.26.2 (2018-06-05)
1972 ==========================
1973
1974 Compatibility Notes
1975 -------------------
1976
1977 - [The borrow checker was fixed to avoid unsoundness when using match ergonomics.][51117]
1978
1979 [51117]: https://github.com/rust-lang/rust/issues/51117
1980
1981
1982 Version 1.26.1 (2018-05-29)
1983 ==========================
1984
1985 Tools
1986 -----
1987
1988 - [RLS now works on Windows.][50646]
1989 - [Rustfmt stopped badly formatting text in some cases.][rustfmt/2695]
1990
1991
1992 Compatibility Notes
1993 --------
1994
1995 - [`fn main() -> impl Trait` no longer works for non-Termination
1996   trait.][50656]
1997   This reverts an accidental stabilization.
1998 - [`NaN > NaN` no longer returns true in const-fn contexts.][50812]
1999 - [Prohibit using turbofish for `impl Trait` in method arguments.][50950]
2000
2001 [50646]: https://github.com/rust-lang/rust/issues/50646
2002 [50656]: https://github.com/rust-lang/rust/pull/50656
2003 [50812]: https://github.com/rust-lang/rust/pull/50812
2004 [50950]: https://github.com/rust-lang/rust/issues/50950
2005 [rustfmt/2695]: https://github.com/rust-lang-nursery/rustfmt/issues/2695
2006
2007 Version 1.26.0 (2018-05-10)
2008 ==========================
2009
2010 Language
2011 --------
2012 - [Closures now implement `Copy` and/or `Clone` if all captured variables
2013   implement either or both traits.][49299]
2014 - [The inclusive range syntax e.g. `for x in 0..=10` is now stable.][47813]
2015 - [The `'_` lifetime is now stable. The underscore lifetime can be used anywhere a
2016   lifetime can be elided.][49458]
2017 - [`impl Trait` is now stable allowing you to have abstract types in returns
2018    or in function parameters.][49255] E.g. `fn foo() -> impl Iterator<Item=u8>` or
2019   `fn open(path: impl AsRef<Path>)`.
2020 - [Pattern matching will now automatically apply dereferences.][49394]
2021 - [128-bit integers in the form of `u128` and `i128` are now stable.][49101]
2022 - [`main` can now return `Result<(), E: Debug>`][49162] in addition to `()`.
2023 - [A lot of operations are now available in a const context.][46882] E.g. You
2024   can now index into constant arrays, reference and dereference into constants,
2025   and use tuple struct constructors.
2026 - [Fixed entry slice patterns are now stable.][48516] E.g.
2027   ```rust
2028   let points = [1, 2, 3, 4];
2029   match points {
2030       [1, 2, 3, 4] => println!("All points were sequential."),
2031       _ => println!("Not all points were sequential."),
2032   }
2033   ```
2034
2035
2036 Compiler
2037 --------
2038 - [LLD is now used as the default linker for `wasm32-unknown-unknown`.][48125]
2039 - [Fixed exponential projection complexity on nested types.][48296]
2040   This can provide up to a ~12% reduction in compile times for certain crates.
2041 - [Added the `--remap-path-prefix` option to rustc.][48359] Allowing you
2042   to remap path prefixes outputted by the compiler.
2043 - [Added `powerpc-unknown-netbsd` target.][48281]
2044
2045 Libraries
2046 ---------
2047 - [Implemented `From<u16> for usize` & `From<{u8, i16}> for isize`.][49305]
2048 - [Added hexadecimal formatting for integers with fmt::Debug][48978]
2049   e.g. `assert!(format!("{:02x?}", b"Foo\0") == "[46, 6f, 6f, 00]")`
2050 - [Implemented `Default, Hash` for `cmp::Reverse`.][48628]
2051 - [Optimized `str::repeat` being 8x faster in large cases.][48657]
2052 - [`ascii::escape_default` is now available in libcore.][48735]
2053 - [Trailing commas are now supported in std and core macros.][48056]
2054 - [Implemented `Copy, Clone` for `cmp::Reverse`][47379]
2055 - [Implemented `Clone` for `char::{ToLowercase, ToUppercase}`.][48629]
2056
2057 Stabilized APIs
2058 ---------------
2059 - [`*const T::add`]
2060 - [`*const T::copy_to_nonoverlapping`]
2061 - [`*const T::copy_to`]
2062 - [`*const T::read_unaligned`]
2063 - [`*const T::read_volatile`]
2064 - [`*const T::read`]
2065 - [`*const T::sub`]
2066 - [`*const T::wrapping_add`]
2067 - [`*const T::wrapping_sub`]
2068 - [`*mut T::add`]
2069 - [`*mut T::copy_to_nonoverlapping`]
2070 - [`*mut T::copy_to`]
2071 - [`*mut T::read_unaligned`]
2072 - [`*mut T::read_volatile`]
2073 - [`*mut T::read`]
2074 - [`*mut T::replace`]
2075 - [`*mut T::sub`]
2076 - [`*mut T::swap`]
2077 - [`*mut T::wrapping_add`]
2078 - [`*mut T::wrapping_sub`]
2079 - [`*mut T::write_bytes`]
2080 - [`*mut T::write_unaligned`]
2081 - [`*mut T::write_volatile`]
2082 - [`*mut T::write`]
2083 - [`Box::leak`]
2084 - [`FromUtf8Error::as_bytes`]
2085 - [`LocalKey::try_with`]
2086 - [`Option::cloned`]
2087 - [`btree_map::Entry::and_modify`]
2088 - [`fs::read_to_string`]
2089 - [`fs::read`]
2090 - [`fs::write`]
2091 - [`hash_map::Entry::and_modify`]
2092 - [`iter::FusedIterator`]
2093 - [`ops::RangeInclusive`]
2094 - [`ops::RangeToInclusive`]
2095 - [`process::id`]
2096 - [`slice::rotate_left`]
2097 - [`slice::rotate_right`]
2098 - [`String::retain`]
2099
2100
2101 Cargo
2102 -----
2103 - [Cargo will now output path to custom commands when `-v` is
2104   passed with `--list`][cargo/5041]
2105 - [The Cargo binary version is now the same as the Rust version][cargo/5083]
2106
2107 Misc
2108 ----
2109 - [The second edition of "The Rust Programming Language" book is now recommended
2110   over the first.][48404]
2111
2112 Compatibility Notes
2113 -------------------
2114
2115 - [aliasing a `Fn` trait as `dyn` no longer works.][48481] E.g. the following
2116   syntax is now invalid.
2117   ```
2118   use std::ops::Fn as dyn;
2119   fn g(_: Box<dyn(std::fmt::Debug)>) {}
2120   ```
2121 - [The result of dereferences are no longer promoted to `'static`.][47408]
2122   e.g.
2123   ```rust
2124   fn main() {
2125       const PAIR: &(i32, i32) = &(0, 1);
2126       let _reversed_pair: &'static _ = &(PAIR.1, PAIR.0); // Doesn't work
2127   }
2128   ```
2129 - [Deprecate `AsciiExt` trait in favor of inherent methods.][49109]
2130 - [`".e0"` will now no longer parse as `0.0` and will instead cause
2131   an error.][48235]
2132 - [Removed hoedown from rustdoc.][48274]
2133 - [Bounds on higher-kinded lifetimes a hard error.][48326]
2134
2135 [46882]: https://github.com/rust-lang/rust/pull/46882
2136 [47379]: https://github.com/rust-lang/rust/pull/47379
2137 [47408]: https://github.com/rust-lang/rust/pull/47408
2138 [47813]: https://github.com/rust-lang/rust/pull/47813
2139 [48056]: https://github.com/rust-lang/rust/pull/48056
2140 [48125]: https://github.com/rust-lang/rust/pull/48125
2141 [48166]: https://github.com/rust-lang/rust/pull/48166
2142 [48235]: https://github.com/rust-lang/rust/pull/48235
2143 [48274]: https://github.com/rust-lang/rust/pull/48274
2144 [48281]: https://github.com/rust-lang/rust/pull/48281
2145 [48296]: https://github.com/rust-lang/rust/pull/48296
2146 [48326]: https://github.com/rust-lang/rust/pull/48326
2147 [48359]: https://github.com/rust-lang/rust/pull/48359
2148 [48404]: https://github.com/rust-lang/rust/pull/48404
2149 [48481]: https://github.com/rust-lang/rust/pull/48481
2150 [48516]: https://github.com/rust-lang/rust/pull/48516
2151 [48628]: https://github.com/rust-lang/rust/pull/48628
2152 [48629]: https://github.com/rust-lang/rust/pull/48629
2153 [48657]: https://github.com/rust-lang/rust/pull/48657
2154 [48735]: https://github.com/rust-lang/rust/pull/48735
2155 [48978]: https://github.com/rust-lang/rust/pull/48978
2156 [49101]: https://github.com/rust-lang/rust/pull/49101
2157 [49109]: https://github.com/rust-lang/rust/pull/49109
2158 [49121]: https://github.com/rust-lang/rust/pull/49121
2159 [49162]: https://github.com/rust-lang/rust/pull/49162
2160 [49184]: https://github.com/rust-lang/rust/pull/49184
2161 [49234]: https://github.com/rust-lang/rust/pull/49234
2162 [49255]: https://github.com/rust-lang/rust/pull/49255
2163 [49299]: https://github.com/rust-lang/rust/pull/49299
2164 [49305]: https://github.com/rust-lang/rust/pull/49305
2165 [49394]: https://github.com/rust-lang/rust/pull/49394
2166 [49458]: https://github.com/rust-lang/rust/pull/49458
2167 [`*const T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add
2168 [`*const T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping
2169 [`*const T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to
2170 [`*const T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned
2171 [`*const T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile
2172 [`*const T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read
2173 [`*const T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub
2174 [`*const T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add
2175 [`*const T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub
2176 [`*mut T::add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.add-1
2177 [`*mut T::copy_to_nonoverlapping`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to_nonoverlapping-1
2178 [`*mut T::copy_to`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.copy_to-1
2179 [`*mut T::read_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_unaligned-1
2180 [`*mut T::read_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read_volatile-1
2181 [`*mut T::read`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.read-1
2182 [`*mut T::replace`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.replace
2183 [`*mut T::sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.sub-1
2184 [`*mut T::swap`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.swap
2185 [`*mut T::wrapping_add`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_add-1
2186 [`*mut T::wrapping_sub`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_sub-1
2187 [`*mut T::write_bytes`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_bytes
2188 [`*mut T::write_unaligned`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_unaligned
2189 [`*mut T::write_volatile`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write_volatile
2190 [`*mut T::write`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.write
2191 [`Box::leak`]: https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
2192 [`FromUtf8Error::as_bytes`]: https://doc.rust-lang.org/std/string/struct.FromUtf8Error.html#method.as_bytes
2193 [`LocalKey::try_with`]: https://doc.rust-lang.org/std/thread/struct.LocalKey.html#method.try_with
2194 [`Option::cloned`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.cloned
2195 [`btree_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/btree_map/enum.Entry.html#method.and_modify
2196 [`fs::read_to_string`]: https://doc.rust-lang.org/std/fs/fn.read_to_string.html
2197 [`fs::read`]: https://doc.rust-lang.org/std/fs/fn.read.html
2198 [`fs::write`]: https://doc.rust-lang.org/std/fs/fn.write.html
2199 [`hash_map::Entry::and_modify`]: https://doc.rust-lang.org/std/collections/hash_map/enum.Entry.html#method.and_modify
2200 [`iter::FusedIterator`]: https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
2201 [`ops::RangeInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeInclusive.html
2202 [`ops::RangeToInclusive`]: https://doc.rust-lang.org/std/ops/struct.RangeToInclusive.html
2203 [`process::id`]: https://doc.rust-lang.org/std/process/fn.id.html
2204 [`slice::rotate_left`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_left
2205 [`slice::rotate_right`]: https://doc.rust-lang.org/std/primitive.slice.html#method.rotate_right
2206 [`String::retain`]: https://doc.rust-lang.org/std/string/struct.String.html#method.retain
2207 [cargo/5041]: https://github.com/rust-lang/cargo/pull/5041
2208 [cargo/5083]: https://github.com/rust-lang/cargo/pull/5083
2209
2210
2211 Version 1.25.0 (2018-03-29)
2212 ==========================
2213
2214 Language
2215 --------
2216 - [The `#[repr(align(x))]` attribute is now stable.][47006] [RFC 1358]
2217 - [You can now use nested groups of imports.][47948]
2218   e.g. `use std::{fs::File, io::Read, path::{Path, PathBuf}};`
2219 - [You can now have `|` at the start of a match arm.][47947] e.g.
2220 ```rust
2221 enum Foo { A, B, C }
2222
2223 fn main() {
2224     let x = Foo::A;
2225     match x {
2226         | Foo::A
2227         | Foo::B => println!("AB"),
2228         | Foo::C => println!("C"),
2229     }
2230 }
2231 ```
2232
2233 Compiler
2234 --------
2235 - [Upgraded to LLVM 6.][47828]
2236 - [Added `-C lto=val` option.][47521]
2237 - [Added `i586-unknown-linux-musl` target][47282]
2238
2239 Libraries
2240 ---------
2241 - [Impl Send for `process::Command` on Unix.][47760]
2242 - [Impl PartialEq and Eq for `ParseCharError`.][47790]
2243 - [`UnsafeCell::into_inner` is now safe.][47204]
2244 - [Implement libstd for CloudABI.][47268]
2245 - [`Float::{from_bits, to_bits}` is now available in libcore.][46931]
2246 - [Implement `AsRef<Path>` for Component][46985]
2247 - [Implemented `Write` for `Cursor<&mut Vec<u8>>`][46830]
2248 - [Moved `Duration` to libcore.][46666]
2249
2250 Stabilized APIs
2251 ---------------
2252 - [`Location::column`]
2253 - [`ptr::NonNull`]
2254
2255 The following functions can now be used in a constant expression.
2256 eg. `static MINUTE: Duration = Duration::from_secs(60);`
2257 - [`Duration::new`][47300]
2258 - [`Duration::from_secs`][47300]
2259 - [`Duration::from_millis`][47300]
2260
2261 Cargo
2262 -----
2263 - [`cargo new` no longer removes `rust` or `rs` prefixs/suffixs.][cargo/5013]
2264 - [`cargo new` now defaults to creating a binary crate, instead of a
2265   library crate.][cargo/5029]
2266
2267 Misc
2268 ----
2269 - [Rust by example is now shipped with new releases][46196]
2270
2271 Compatibility Notes
2272 -------------------
2273 - [Deprecated `net::lookup_host`.][47510]
2274 - [`rustdoc` has switched to pulldown as the default markdown renderer.][47398]
2275 - The borrow checker was sometimes incorrectly permitting overlapping borrows
2276   around indexing operations (see [#47349][47349]). This has been fixed (which also
2277   enabled some correct code that used to cause errors (e.g. [#33903][33903] and [#46095][46095]).
2278 - [Removed deprecated unstable attribute `#[simd]`.][47251]
2279
2280 [33903]: https://github.com/rust-lang/rust/pull/33903
2281 [47947]: https://github.com/rust-lang/rust/pull/47947
2282 [47948]: https://github.com/rust-lang/rust/pull/47948
2283 [47760]: https://github.com/rust-lang/rust/pull/47760
2284 [47790]: https://github.com/rust-lang/rust/pull/47790
2285 [47828]: https://github.com/rust-lang/rust/pull/47828
2286 [47398]: https://github.com/rust-lang/rust/pull/47398
2287 [47510]: https://github.com/rust-lang/rust/pull/47510
2288 [47521]: https://github.com/rust-lang/rust/pull/47521
2289 [47204]: https://github.com/rust-lang/rust/pull/47204
2290 [47251]: https://github.com/rust-lang/rust/pull/47251
2291 [47268]: https://github.com/rust-lang/rust/pull/47268
2292 [47282]: https://github.com/rust-lang/rust/pull/47282
2293 [47300]: https://github.com/rust-lang/rust/pull/47300
2294 [47349]: https://github.com/rust-lang/rust/pull/47349
2295 [46931]: https://github.com/rust-lang/rust/pull/46931
2296 [46985]: https://github.com/rust-lang/rust/pull/46985
2297 [47006]: https://github.com/rust-lang/rust/pull/47006
2298 [46830]: https://github.com/rust-lang/rust/pull/46830
2299 [46095]: https://github.com/rust-lang/rust/pull/46095
2300 [46666]: https://github.com/rust-lang/rust/pull/46666
2301 [46196]: https://github.com/rust-lang/rust/pull/46196
2302 [cargo/5013]: https://github.com/rust-lang/cargo/pull/5013
2303 [cargo/5029]: https://github.com/rust-lang/cargo/pull/5029
2304 [RFC 1358]: https://github.com/rust-lang/rfcs/pull/1358
2305 [`Location::column`]: https://doc.rust-lang.org/std/panic/struct.Location.html#method.column
2306 [`ptr::NonNull`]: https://doc.rust-lang.org/std/ptr/struct.NonNull.html
2307
2308
2309 Version 1.24.1 (2018-03-01)
2310 ==========================
2311
2312  - [Do not abort when unwinding through FFI][48251]
2313  - [Emit UTF-16 files for linker arguments on Windows][48318]
2314  - [Make the error index generator work again][48308]
2315  - [Cargo will warn on Windows 7 if an update is needed][cargo/5069].
2316
2317 [48251]: https://github.com/rust-lang/rust/issues/48251
2318 [48308]: https://github.com/rust-lang/rust/issues/48308
2319 [48318]: https://github.com/rust-lang/rust/issues/48318
2320 [cargo/5069]: https://github.com/rust-lang/cargo/pull/5069
2321
2322
2323 Version 1.24.0 (2018-02-15)
2324 ==========================
2325
2326 Language
2327 --------
2328 - [External `sysv64` ffi is now available.][46528]
2329   eg. `extern "sysv64" fn foo () {}`
2330
2331 Compiler
2332 --------
2333 - [rustc now uses 16 codegen units by default for release builds.][46910]
2334   For the fastest builds, utilize `codegen-units=1`.
2335 - [Added `armv4t-unknown-linux-gnueabi` target.][47018]
2336 - [Add `aarch64-unknown-openbsd` support][46760]
2337
2338 Libraries
2339 ---------
2340 - [`str::find::<char>` now uses memchr.][46735] This should lead to a 10x
2341   improvement in performance in the majority of cases.
2342 - [`OsStr`'s `Debug` implementation is now lossless and consistent
2343   with Windows.][46798]
2344 - [`time::{SystemTime, Instant}` now implement `Hash`.][46828]
2345 - [impl `From<bool>` for `AtomicBool`][46293]
2346 - [impl `From<{CString, &CStr}>` for `{Arc<CStr>, Rc<CStr>}`][45990]
2347 - [impl `From<{OsString, &OsStr}>` for `{Arc<OsStr>, Rc<OsStr>}`][45990]
2348 - [impl `From<{PathBuf, &Path}>` for `{Arc<Path>, Rc<Path>}`][45990]
2349 - [float::from_bits now just uses transmute.][46012] This provides
2350   some optimisations from LLVM.
2351 - [Copied `AsciiExt` methods onto `char`][46077]
2352 - [Remove `T: Sized` requirement on `ptr::is_null()`][46094]
2353 - [impl `From<RecvError>` for `{TryRecvError, RecvTimeoutError}`][45506]
2354 - [Optimised `f32::{min, max}` to generate more efficient x86 assembly][47080]
2355 - [`[u8]::contains` now uses memchr which provides a 3x speed improvement][46713]
2356
2357 Stabilized APIs
2358 ---------------
2359 - [`RefCell::replace`]
2360 - [`RefCell::swap`]
2361 - [`atomic::spin_loop_hint`]
2362
2363 The following functions can now be used in a constant expression.
2364 eg. `let buffer: [u8; size_of::<usize>()];`, `static COUNTER: AtomicUsize = AtomicUsize::new(1);`
2365
2366 - [`AtomicBool::new`][46287]
2367 - [`AtomicUsize::new`][46287]
2368 - [`AtomicIsize::new`][46287]
2369 - [`AtomicPtr::new`][46287]
2370 - [`Cell::new`][46287]
2371 - [`{integer}::min_value`][46287]
2372 - [`{integer}::max_value`][46287]
2373 - [`mem::size_of`][46287]
2374 - [`mem::align_of`][46287]
2375 - [`ptr::null`][46287]
2376 - [`ptr::null_mut`][46287]
2377 - [`RefCell::new`][46287]
2378 - [`UnsafeCell::new`][46287]
2379
2380 Cargo
2381 -----
2382 - [Added a `workspace.default-members` config that
2383   overrides implied `--all` in virtual workspaces.][cargo/4743]
2384 - [Enable incremental by default on development builds.][cargo/4817] Also added
2385   configuration keys to `Cargo.toml` and `.cargo/config` to disable on a
2386   per-project or global basis respectively.
2387
2388 Misc
2389 ----
2390
2391 Compatibility Notes
2392 -------------------
2393 - [Floating point types `Debug` impl now always prints a decimal point.][46831]
2394 - [`Ipv6Addr` now rejects superfluous `::`'s in IPv6 addresses][46671] This is
2395   in accordance with IETF RFC 4291 §2.2.
2396 - [Unwinding will no longer go past FFI boundaries, and will instead abort.][46833]
2397 - [`Formatter::flags` method is now deprecated.][46284] The `sign_plus`,
2398   `sign_minus`, `alternate`, and `sign_aware_zero_pad` should be used instead.
2399 - [Leading zeros in tuple struct members is now an error][47084]
2400 - [`column!()` macro is one-based instead of zero-based][46977]
2401 - [`fmt::Arguments` can no longer be shared across threads][45198]
2402 - [Access to `#[repr(packed)]` struct fields is now unsafe][44884]
2403 - [Cargo sets a different working directory for the compiler][cargo/4788]
2404
2405 [44884]: https://github.com/rust-lang/rust/pull/44884
2406 [45198]: https://github.com/rust-lang/rust/pull/45198
2407 [45506]: https://github.com/rust-lang/rust/pull/45506
2408 [45904]: https://github.com/rust-lang/rust/pull/45904
2409 [45990]: https://github.com/rust-lang/rust/pull/45990
2410 [46012]: https://github.com/rust-lang/rust/pull/46012
2411 [46077]: https://github.com/rust-lang/rust/pull/46077
2412 [46094]: https://github.com/rust-lang/rust/pull/46094
2413 [46284]: https://github.com/rust-lang/rust/pull/46284
2414 [46287]: https://github.com/rust-lang/rust/pull/46287
2415 [46293]: https://github.com/rust-lang/rust/pull/46293
2416 [46528]: https://github.com/rust-lang/rust/pull/46528
2417 [46671]: https://github.com/rust-lang/rust/pull/46671
2418 [46713]: https://github.com/rust-lang/rust/pull/46713
2419 [46735]: https://github.com/rust-lang/rust/pull/46735
2420 [46749]: https://github.com/rust-lang/rust/pull/46749
2421 [46760]: https://github.com/rust-lang/rust/pull/46760
2422 [46798]: https://github.com/rust-lang/rust/pull/46798
2423 [46828]: https://github.com/rust-lang/rust/pull/46828
2424 [46831]: https://github.com/rust-lang/rust/pull/46831
2425 [46833]: https://github.com/rust-lang/rust/pull/46833
2426 [46910]: https://github.com/rust-lang/rust/pull/46910
2427 [46977]: https://github.com/rust-lang/rust/pull/46977
2428 [47018]: https://github.com/rust-lang/rust/pull/47018
2429 [47080]: https://github.com/rust-lang/rust/pull/47080
2430 [47084]: https://github.com/rust-lang/rust/pull/47084
2431 [cargo/4743]: https://github.com/rust-lang/cargo/pull/4743
2432 [cargo/4788]: https://github.com/rust-lang/cargo/pull/4788
2433 [cargo/4817]: https://github.com/rust-lang/cargo/pull/4817
2434 [`RefCell::replace`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.replace
2435 [`RefCell::swap`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.swap
2436 [`atomic::spin_loop_hint`]: https://doc.rust-lang.org/std/sync/atomic/fn.spin_loop_hint.html
2437
2438
2439 Version 1.23.0 (2018-01-04)
2440 ==========================
2441
2442 Language
2443 --------
2444 - [Arbitrary `auto` traits are now permitted in trait objects.][45772]
2445 - [rustc now uses subtyping on the left hand side of binary operations.][45435]
2446   Which should fix some confusing errors in some operations.
2447
2448 Compiler
2449 --------
2450 - [Enabled `TrapUnreachable` in LLVM which should mitigate the impact of
2451   undefined behavior.][45920]
2452 - [rustc now suggests renaming import if names clash.][45660]
2453 - [Display errors/warnings correctly when there are zero-width or
2454   wide characters.][45711]
2455 - [rustc now avoids unnecessary copies of arguments that are
2456   simple bindings][45380] This should improve memory usage on average by 5-10%.
2457 - [Updated musl used to build musl rustc to 1.1.17][45393]
2458
2459 Libraries
2460 ---------
2461 - [Allow a trailing comma in `assert_eq/ne` macro][45887]
2462 - [Implement Hash for raw pointers to unsized types][45483]
2463 - [impl `From<*mut T>` for `AtomicPtr<T>`][45610]
2464 - [impl `From<usize/isize>` for `AtomicUsize/AtomicIsize`.][45610]
2465 - [Removed the `T: Sync` requirement for `RwLock<T>: Send`][45267]
2466 - [Removed `T: Sized` requirement for `{<*const T>, <*mut T>}::as_ref`
2467   and `<*mut T>::as_mut`][44932]
2468 - [Optimized `Thread::{park, unpark}` implementation][45524]
2469 - [Improved `SliceExt::binary_search` performance.][45333]
2470 - [impl `FromIterator<()>` for `()`][45379]
2471 - [Copied `AsciiExt` trait methods to primitive types.][44042] Use of `AsciiExt`
2472   is now deprecated.
2473
2474 Stabilized APIs
2475 ---------------
2476
2477 Cargo
2478 -----
2479 - [Cargo now supports uninstallation of multiple packages][cargo/4561]
2480   eg. `cargo uninstall foo bar` uninstalls `foo` and `bar`.
2481 - [Added unit test checking to `cargo check`][cargo/4592]
2482 - [Cargo now lets you install a specific version
2483   using `cargo install --version`][cargo/4637]
2484
2485 Misc
2486 ----
2487 - [Releases now ship with the Cargo book documentation.][45692]
2488 - [rustdoc now prints rendering warnings on every run.][45324]
2489
2490 Compatibility Notes
2491 -------------------
2492 - [Changes have been made to type equality to make it more correct,
2493   in rare cases this could break some code.][45853] [Tracking issue for
2494   further information][45852]
2495 - [`char::escape_debug` now uses Unicode 10 over 9.][45571]
2496 - [Upgraded Android SDK to 27, and NDK to r15c.][45580] This drops support for
2497   Android 9, the minimum supported version is Android 14.
2498 - [Bumped the minimum LLVM to 3.9][45326]
2499
2500 [44042]: https://github.com/rust-lang/rust/pull/44042
2501 [44932]: https://github.com/rust-lang/rust/pull/44932
2502 [45267]: https://github.com/rust-lang/rust/pull/45267
2503 [45324]: https://github.com/rust-lang/rust/pull/45324
2504 [45326]: https://github.com/rust-lang/rust/pull/45326
2505 [45333]: https://github.com/rust-lang/rust/pull/45333
2506 [45379]: https://github.com/rust-lang/rust/pull/45379
2507 [45380]: https://github.com/rust-lang/rust/pull/45380
2508 [45393]: https://github.com/rust-lang/rust/pull/45393
2509 [45435]: https://github.com/rust-lang/rust/pull/45435
2510 [45483]: https://github.com/rust-lang/rust/pull/45483
2511 [45524]: https://github.com/rust-lang/rust/pull/45524
2512 [45571]: https://github.com/rust-lang/rust/pull/45571
2513 [45580]: https://github.com/rust-lang/rust/pull/45580
2514 [45610]: https://github.com/rust-lang/rust/pull/45610
2515 [45660]: https://github.com/rust-lang/rust/pull/45660
2516 [45692]: https://github.com/rust-lang/rust/pull/45692
2517 [45711]: https://github.com/rust-lang/rust/pull/45711
2518 [45772]: https://github.com/rust-lang/rust/pull/45772
2519 [45852]: https://github.com/rust-lang/rust/issues/45852
2520 [45853]: https://github.com/rust-lang/rust/pull/45853
2521 [45887]: https://github.com/rust-lang/rust/pull/45887
2522 [45920]: https://github.com/rust-lang/rust/pull/45920
2523 [cargo/4561]: https://github.com/rust-lang/cargo/pull/4561
2524 [cargo/4592]: https://github.com/rust-lang/cargo/pull/4592
2525 [cargo/4637]: https://github.com/rust-lang/cargo/pull/4637
2526
2527
2528 Version 1.22.1 (2017-11-22)
2529 ==========================
2530
2531 - [Update Cargo to fix an issue with macOS 10.13 "High Sierra"][46183]
2532
2533 [46183]: https://github.com/rust-lang/rust/pull/46183
2534
2535 Version 1.22.0 (2017-11-22)
2536 ==========================
2537
2538 Language
2539 --------
2540 - [`non_snake_case` lint now allows extern no-mangle functions][44966]
2541 - [Now accepts underscores in unicode escapes][43716]
2542 - [`T op= &T` now works for numeric types.][44287] eg. `let mut x = 2; x += &8;`
2543 - [types that impl `Drop` are now allowed in `const` and `static` types][44456]
2544
2545 Compiler
2546 --------
2547 - [rustc now defaults to having 16 codegen units at debug on supported platforms.][45064]
2548 - [rustc will no longer inline in codegen units when compiling for debug][45075]
2549   This should decrease compile times for debug builds.
2550 - [strict memory alignment now enabled on ARMv6][45094]
2551 - [Remove support for the PNaCl target `le32-unknown-nacl`][45041]
2552
2553 Libraries
2554 ---------
2555 - [Allow atomic operations up to 32 bits
2556   on `armv5te_unknown_linux_gnueabi`][44978]
2557 - [`Box<Error>` now impls `From<Cow<str>>`][44466]
2558 - [`std::mem::Discriminant` is now guaranteed to be `Send + Sync`][45095]
2559 - [`fs::copy` now returns the length of the main stream on NTFS.][44895]
2560 - [Properly detect overflow in `Instant += Duration`.][44220]
2561 - [impl `Hasher` for `{&mut Hasher, Box<Hasher>}`][44015]
2562 - [impl `fmt::Debug` for `SplitWhitespace`.][44303]
2563 - [`Option<T>` now impls `Try`][42526] This allows for using `?` with `Option` types.
2564
2565 Stabilized APIs
2566 ---------------
2567
2568 Cargo
2569 -----
2570 - [Cargo will now build multi file examples in subdirectories of the `examples`
2571   folder that have a `main.rs` file.][cargo/4496]
2572 - [Changed `[root]` to `[package]` in `Cargo.lock`][cargo/4571] Packages with
2573   the old format will continue to work and can be updated with `cargo update`.
2574 - [Now supports vendoring git repositories][cargo/3992]
2575
2576 Misc
2577 ----
2578 - [`libbacktrace` is now available on Apple platforms.][44251]
2579 - [Stabilised the `compile_fail` attribute for code fences in doc-comments.][43949]
2580   This now lets you specify that a given code example will fail to compile.
2581
2582 Compatibility Notes
2583 -------------------
2584 - [The minimum Android version that rustc can build for has been bumped
2585   to `4.0` from `2.3`][45656]
2586 - [Allowing `T op= &T` for numeric types has broken some type
2587   inference cases][45480]
2588
2589
2590 [42526]: https://github.com/rust-lang/rust/pull/42526
2591 [43017]: https://github.com/rust-lang/rust/pull/43017
2592 [43716]: https://github.com/rust-lang/rust/pull/43716
2593 [43949]: https://github.com/rust-lang/rust/pull/43949
2594 [44015]: https://github.com/rust-lang/rust/pull/44015
2595 [44220]: https://github.com/rust-lang/rust/pull/44220
2596 [44251]: https://github.com/rust-lang/rust/pull/44251
2597 [44287]: https://github.com/rust-lang/rust/pull/44287
2598 [44303]: https://github.com/rust-lang/rust/pull/44303
2599 [44456]: https://github.com/rust-lang/rust/pull/44456
2600 [44466]: https://github.com/rust-lang/rust/pull/44466
2601 [44895]: https://github.com/rust-lang/rust/pull/44895
2602 [44966]: https://github.com/rust-lang/rust/pull/44966
2603 [44978]: https://github.com/rust-lang/rust/pull/44978
2604 [45041]: https://github.com/rust-lang/rust/pull/45041
2605 [45064]: https://github.com/rust-lang/rust/pull/45064
2606 [45075]: https://github.com/rust-lang/rust/pull/45075
2607 [45094]: https://github.com/rust-lang/rust/pull/45094
2608 [45095]: https://github.com/rust-lang/rust/pull/45095
2609 [45480]: https://github.com/rust-lang/rust/issues/45480
2610 [45656]: https://github.com/rust-lang/rust/pull/45656
2611 [cargo/3992]: https://github.com/rust-lang/cargo/pull/3992
2612 [cargo/4496]: https://github.com/rust-lang/cargo/pull/4496
2613 [cargo/4571]: https://github.com/rust-lang/cargo/pull/4571
2614
2615
2616
2617
2618
2619
2620 Version 1.21.0 (2017-10-12)
2621 ==========================
2622
2623 Language
2624 --------
2625 - [You can now use static references for literals.][43838]
2626   Example:
2627   ```rust
2628   fn main() {
2629       let x: &'static u32 = &0;
2630   }
2631   ```
2632 - [Relaxed path syntax. Optional `::` before `<` is now allowed in all contexts.][43540]
2633   Example:
2634   ```rust
2635   my_macro!(Vec<i32>::new); // Always worked
2636   my_macro!(Vec::<i32>::new); // Now works
2637   ```
2638
2639 Compiler
2640 --------
2641 - [Upgraded jemalloc to 4.5.0][43911]
2642 - [Enabled unwinding panics on Redox][43917]
2643 - [Now runs LLVM in parallel during translation phase.][43506]
2644   This should reduce peak memory usage.
2645
2646 Libraries
2647 ---------
2648 - [Generate builtin impls for `Clone` for all arrays and tuples that
2649   are `T: Clone`][43690]
2650 - [`Stdin`, `Stdout`, and `Stderr` now implement `AsRawFd`.][43459]
2651 - [`Rc` and `Arc` now implement `From<&[T]> where T: Clone`, `From<str>`,
2652   `From<String>`, `From<Box<T>> where T: ?Sized`, and `From<Vec<T>>`.][42565]
2653
2654 Stabilized APIs
2655 ---------------
2656
2657 [`std::mem::discriminant`]
2658
2659 Cargo
2660 -----
2661 - [You can now call `cargo install` with multiple package names][cargo/4216]
2662 - [Cargo commands inside a virtual workspace will now implicitly
2663   pass `--all`][cargo/4335]
2664 - [Added a `[patch]` section to `Cargo.toml` to handle
2665   prepublication dependencies][cargo/4123] [RFC 1969]
2666 - [`include` & `exclude` fields in `Cargo.toml` now accept gitignore
2667   like patterns][cargo/4270]
2668 - [Added the `--all-targets` option][cargo/4400]
2669 - [Using required dependencies as a feature is now deprecated and emits
2670   a warning][cargo/4364]
2671
2672
2673 Misc
2674 ----
2675 - [Cargo docs are moving][43916]
2676   to [doc.rust-lang.org/cargo](https://doc.rust-lang.org/cargo)
2677 - [The rustdoc book is now available][43863]
2678   at [doc.rust-lang.org/rustdoc](https://doc.rust-lang.org/rustdoc)
2679 - [Added a preview of RLS has been made available through rustup][44204]
2680   Install with `rustup component add rls-preview`
2681 - [`std::os` documentation for Unix, Linux, and Windows now appears on doc.rust-lang.org][43348]
2682   Previously only showed `std::os::unix`.
2683
2684 Compatibility Notes
2685 -------------------
2686 - [Changes in method matching against higher-ranked types][43880] This may cause
2687   breakage in subtyping corner cases. [A more in-depth explanation is available.][info/43880]
2688 - [rustc's JSON error output's byte position start at top of file.][42973]
2689   Was previously relative to the rustc's internal `CodeMap` struct which
2690   required the unstable library `libsyntax` to correctly use.
2691 - [`unused_results` lint no longer ignores booleans][43728]
2692
2693 [42565]: https://github.com/rust-lang/rust/pull/42565
2694 [42973]: https://github.com/rust-lang/rust/pull/42973
2695 [43348]: https://github.com/rust-lang/rust/pull/43348
2696 [43459]: https://github.com/rust-lang/rust/pull/43459
2697 [43506]: https://github.com/rust-lang/rust/pull/43506
2698 [43540]: https://github.com/rust-lang/rust/pull/43540
2699 [43690]: https://github.com/rust-lang/rust/pull/43690
2700 [43728]: https://github.com/rust-lang/rust/pull/43728
2701 [43838]: https://github.com/rust-lang/rust/pull/43838
2702 [43863]: https://github.com/rust-lang/rust/pull/43863
2703 [43880]: https://github.com/rust-lang/rust/pull/43880
2704 [43911]: https://github.com/rust-lang/rust/pull/43911
2705 [43916]: https://github.com/rust-lang/rust/pull/43916
2706 [43917]: https://github.com/rust-lang/rust/pull/43917
2707 [44204]: https://github.com/rust-lang/rust/pull/44204
2708 [cargo/4123]: https://github.com/rust-lang/cargo/pull/4123
2709 [cargo/4216]: https://github.com/rust-lang/cargo/pull/4216
2710 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2711 [cargo/4335]: https://github.com/rust-lang/cargo/pull/4335
2712 [cargo/4364]: https://github.com/rust-lang/cargo/pull/4364
2713 [cargo/4400]: https://github.com/rust-lang/cargo/pull/4400
2714 [RFC 1969]: https://github.com/rust-lang/rfcs/pull/1969
2715 [info/43880]: https://github.com/rust-lang/rust/issues/44224#issuecomment-330058902
2716 [`std::mem::discriminant`]: https://doc.rust-lang.org/std/mem/fn.discriminant.html
2717
2718 Version 1.20.0 (2017-08-31)
2719 ===========================
2720
2721 Language
2722 --------
2723 - [Associated constants are now stabilised.][42809]
2724 - [A lot of macro bugs are now fixed.][42913]
2725
2726 Compiler
2727 --------
2728
2729 - [Struct fields are now properly coerced to the expected field type.][42807]
2730 - [Enabled wasm LLVM backend][42571] WASM can now be built with the
2731   `wasm32-experimental-emscripten` target.
2732 - [Changed some of the error messages to be more helpful.][42033]
2733 - [Add support for RELRO(RELocation Read-Only) for platforms that support
2734   it.][43170]
2735 - [rustc now reports the total number of errors on compilation failure][43015]
2736   previously this was only the number of errors in the pass that failed.
2737 - [Expansion in rustc has been sped up 29x.][42533]
2738 - [added `msp430-none-elf` target.][43099]
2739 - [rustc will now suggest one-argument enum variant to fix type mismatch when
2740   applicable][43178]
2741 - [Fixes backtraces on Redox][43228]
2742 - [rustc now identifies different versions of same crate when absolute paths of
2743   different types match in an error message.][42826]
2744
2745 Libraries
2746 ---------
2747
2748
2749 - [Relaxed Debug constraints on `{HashMap,BTreeMap}::{Keys,Values}`.][42854]
2750 - [Impl `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Debug`, `Hash` for unsized
2751   tuples.][43011]
2752 - [Impl `fmt::{Display, Debug}` for `Ref`, `RefMut`, `MutexGuard`,
2753   `RwLockReadGuard`, `RwLockWriteGuard`][42822]
2754 - [Impl `Clone` for `DefaultHasher`.][42799]
2755 - [Impl `Sync` for `SyncSender`.][42397]
2756 - [Impl `FromStr` for `char`][42271]
2757 - [Fixed how `{f32, f64}::{is_sign_negative, is_sign_positive}` handles
2758   NaN.][42431]
2759 - [allow messages in the `unimplemented!()` macro.][42155]
2760   ie. `unimplemented!("Waiting for 1.21 to be stable")`
2761 - [`pub(restricted)` is now supported in the `thread_local!` macro.][43185]
2762 - [Upgrade to Unicode 10.0.0][42999]
2763 - [Reimplemented `{f32, f64}::{min, max}` in Rust instead of using CMath.][42430]
2764 - [Skip the main thread's manual stack guard on Linux][43072]
2765 - [Iterator::nth for `ops::{Range, RangeFrom}` is now done in O(1) time][43077]
2766 - [`#[repr(align(N))]` attribute max number is now 2^31 - 1.][43097] This was
2767   previously 2^15.
2768 - [`{OsStr, Path}::Display` now avoids allocations where possible][42613]
2769
2770 Stabilized APIs
2771 ---------------
2772
2773 - [`CStr::into_c_string`]
2774 - [`CString::as_c_str`]
2775 - [`CString::into_boxed_c_str`]
2776 - [`Chain::get_mut`]
2777 - [`Chain::get_ref`]
2778 - [`Chain::into_inner`]
2779 - [`Option::get_or_insert_with`]
2780 - [`Option::get_or_insert`]
2781 - [`OsStr::into_os_string`]
2782 - [`OsString::into_boxed_os_str`]
2783 - [`Take::get_mut`]
2784 - [`Take::get_ref`]
2785 - [`Utf8Error::error_len`]
2786 - [`char::EscapeDebug`]
2787 - [`char::escape_debug`]
2788 - [`compile_error!`]
2789 - [`f32::from_bits`]
2790 - [`f32::to_bits`]
2791 - [`f64::from_bits`]
2792 - [`f64::to_bits`]
2793 - [`mem::ManuallyDrop`]
2794 - [`slice::sort_unstable_by_key`]
2795 - [`slice::sort_unstable_by`]
2796 - [`slice::sort_unstable`]
2797 - [`str::from_boxed_utf8_unchecked`]
2798 - [`str::as_bytes_mut`]
2799 - [`str::as_bytes_mut`]
2800 - [`str::from_utf8_mut`]
2801 - [`str::from_utf8_unchecked_mut`]
2802 - [`str::get_mut`]
2803 - [`str::get_unchecked_mut`]
2804 - [`str::get_unchecked`]
2805 - [`str::get`]
2806 - [`str::into_boxed_bytes`]
2807
2808
2809 Cargo
2810 -----
2811 - [Cargo API token location moved from `~/.cargo/config` to
2812   `~/.cargo/credentials`.][cargo/3978]
2813 - [Cargo will now build `main.rs` binaries that are in sub-directories of
2814   `src/bin`.][cargo/4214] ie. Having `src/bin/server/main.rs` and
2815   `src/bin/client/main.rs` generates `target/debug/server` and `target/debug/client`
2816 - [You can now specify version of a binary when installed through
2817   `cargo install` using `--vers`.][cargo/4229]
2818 - [Added `--no-fail-fast` flag to cargo to run all benchmarks regardless of
2819   failure.][cargo/4248]
2820 - [Changed the convention around which file is the crate root.][cargo/4259]
2821 - [The `include`/`exclude` property in `Cargo.toml` now accepts gitignore paths
2822   instead of glob patterns][cargo/4270]. Glob patterns are now deprecated.
2823
2824 Compatibility Notes
2825 -------------------
2826
2827 - [Functions with `'static` in their return types will now not be as usable as
2828   if they were using lifetime parameters instead.][42417]
2829 - [The reimplementation of `{f32, f64}::is_sign_{negative, positive}` now
2830   takes the sign of NaN into account where previously didn't.][42430]
2831
2832 [42033]: https://github.com/rust-lang/rust/pull/42033
2833 [42155]: https://github.com/rust-lang/rust/pull/42155
2834 [42271]: https://github.com/rust-lang/rust/pull/42271
2835 [42397]: https://github.com/rust-lang/rust/pull/42397
2836 [42417]: https://github.com/rust-lang/rust/pull/42417
2837 [42430]: https://github.com/rust-lang/rust/pull/42430
2838 [42431]: https://github.com/rust-lang/rust/pull/42431
2839 [42533]: https://github.com/rust-lang/rust/pull/42533
2840 [42571]: https://github.com/rust-lang/rust/pull/42571
2841 [42613]: https://github.com/rust-lang/rust/pull/42613
2842 [42799]: https://github.com/rust-lang/rust/pull/42799
2843 [42807]: https://github.com/rust-lang/rust/pull/42807
2844 [42809]: https://github.com/rust-lang/rust/pull/42809
2845 [42822]: https://github.com/rust-lang/rust/pull/42822
2846 [42826]: https://github.com/rust-lang/rust/pull/42826
2847 [42854]: https://github.com/rust-lang/rust/pull/42854
2848 [42913]: https://github.com/rust-lang/rust/pull/42913
2849 [42999]: https://github.com/rust-lang/rust/pull/42999
2850 [43011]: https://github.com/rust-lang/rust/pull/43011
2851 [43015]: https://github.com/rust-lang/rust/pull/43015
2852 [43072]: https://github.com/rust-lang/rust/pull/43072
2853 [43077]: https://github.com/rust-lang/rust/pull/43077
2854 [43097]: https://github.com/rust-lang/rust/pull/43097
2855 [43099]: https://github.com/rust-lang/rust/pull/43099
2856 [43170]: https://github.com/rust-lang/rust/pull/43170
2857 [43178]: https://github.com/rust-lang/rust/pull/43178
2858 [43185]: https://github.com/rust-lang/rust/pull/43185
2859 [43228]: https://github.com/rust-lang/rust/pull/43228
2860 [cargo/3978]: https://github.com/rust-lang/cargo/pull/3978
2861 [cargo/4214]: https://github.com/rust-lang/cargo/pull/4214
2862 [cargo/4229]: https://github.com/rust-lang/cargo/pull/4229
2863 [cargo/4248]: https://github.com/rust-lang/cargo/pull/4248
2864 [cargo/4259]: https://github.com/rust-lang/cargo/pull/4259
2865 [cargo/4270]: https://github.com/rust-lang/cargo/pull/4270
2866 [`CStr::into_c_string`]: https://doc.rust-lang.org/std/ffi/struct.CStr.html#method.into_c_string
2867 [`CString::as_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.as_c_str
2868 [`CString::into_boxed_c_str`]: https://doc.rust-lang.org/std/ffi/struct.CString.html#method.into_boxed_c_str
2869 [`Chain::get_mut`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_mut
2870 [`Chain::get_ref`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.get_ref
2871 [`Chain::into_inner`]: https://doc.rust-lang.org/std/io/struct.Chain.html#method.into_inner
2872 [`Option::get_or_insert_with`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert_with
2873 [`Option::get_or_insert`]: https://doc.rust-lang.org/std/option/enum.Option.html#method.get_or_insert
2874 [`OsStr::into_os_string`]: https://doc.rust-lang.org/std/ffi/struct.OsStr.html#method.into_os_string
2875 [`OsString::into_boxed_os_str`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.into_boxed_os_str
2876 [`Take::get_mut`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_mut
2877 [`Take::get_ref`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.get_ref
2878 [`Utf8Error::error_len`]: https://doc.rust-lang.org/std/str/struct.Utf8Error.html#method.error_len
2879 [`char::EscapeDebug`]: https://doc.rust-lang.org/std/char/struct.EscapeDebug.html
2880 [`char::escape_debug`]: https://doc.rust-lang.org/std/primitive.char.html#method.escape_debug
2881 [`compile_error!`]: https://doc.rust-lang.org/std/macro.compile_error.html
2882 [`f32::from_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.from_bits
2883 [`f32::to_bits`]: https://doc.rust-lang.org/std/primitive.f32.html#method.to_bits
2884 [`f64::from_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.from_bits
2885 [`f64::to_bits`]: https://doc.rust-lang.org/std/primitive.f64.html#method.to_bits
2886 [`mem::ManuallyDrop`]: https://doc.rust-lang.org/std/mem/union.ManuallyDrop.html
2887 [`slice::sort_unstable_by_key`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by_key
2888 [`slice::sort_unstable_by`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable_by
2889 [`slice::sort_unstable`]: https://doc.rust-lang.org/std/primitive.slice.html#method.sort_unstable
2890 [`str::from_boxed_utf8_unchecked`]: https://doc.rust-lang.org/std/str/fn.from_boxed_utf8_unchecked.html
2891 [`str::as_bytes_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.as_bytes_mut
2892 [`str::from_utf8_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_mut.html
2893 [`str::from_utf8_unchecked_mut`]: https://doc.rust-lang.org/std/str/fn.from_utf8_unchecked_mut.html
2894 [`str::get_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_mut
2895 [`str::get_unchecked_mut`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked_mut
2896 [`str::get_unchecked`]: https://doc.rust-lang.org/std/primitive.str.html#method.get_unchecked
2897 [`str::get`]: https://doc.rust-lang.org/std/primitive.str.html#method.get
2898 [`str::into_boxed_bytes`]: https://doc.rust-lang.org/std/primitive.str.html#method.into_boxed_bytes
2899
2900
2901 Version 1.19.0 (2017-07-20)
2902 ===========================
2903
2904 Language
2905 --------
2906
2907 - [Numeric fields can now be used for creating tuple structs.][41145] [RFC 1506]
2908   For example `struct Point(u32, u32); let x = Point { 0: 7, 1: 0 };`.
2909 - [Macro recursion limit increased to 1024 from 64.][41676]
2910 - [Added lint for detecting unused macros.][41907]
2911 - [`loop` can now return a value with `break`.][42016] [RFC 1624]
2912   For example: `let x = loop { break 7; };`
2913 - [C compatible `union`s are now available.][42068] [RFC 1444] They can only
2914   contain `Copy` types and cannot have a `Drop` implementation.
2915   Example: `union Foo { bar: u8, baz: usize }`
2916 - [Non capturing closures can now be coerced into `fn`s,][42162] [RFC 1558]
2917   Example: `let foo: fn(u8) -> u8 = |v: u8| { v };`
2918
2919 Compiler
2920 --------
2921
2922 - [Add support for bootstrapping the Rust compiler toolchain on Android.][41370]
2923 - [Change `arm-linux-androideabi` to correspond to the `armeabi`
2924   official ABI.][41656] If you wish to continue targeting the `armeabi-v7a` ABI
2925   you should use `--target armv7-linux-androideabi`.
2926 - [Fixed ICE when removing a source file between compilation sessions.][41873]
2927 - [Minor optimisation of string operations.][42037]
2928 - [Compiler error message is now `aborting due to previous error(s)` instead of
2929   `aborting due to N previous errors`][42150] This was previously inaccurate and
2930   would only count certain kinds of errors.
2931 - [The compiler now supports Visual Studio 2017][42225]
2932 - [The compiler is now built against LLVM 4.0.1 by default][42948]
2933 - [Added a lot][42264] of [new error codes][42302]
2934 - [Added `target-feature=+crt-static` option][37406] [RFC 1721] Which allows
2935   libraries with C Run-time Libraries(CRT) to be statically linked.
2936 - [Fixed various ARM codegen bugs][42740]
2937
2938 Libraries
2939 ---------
2940
2941 - [`String` now implements `FromIterator<Cow<'a, str>>` and
2942   `Extend<Cow<'a, str>>`][41449]
2943 - [`Vec` now implements `From<&mut [T]>`][41530]
2944 - [`Box<[u8]>` now implements `From<Box<str>>`][41258]
2945 - [`SplitWhitespace` now implements `Clone`][41659]
2946 - [`[u8]::reverse` is now 5x faster and `[u16]::reverse` is now
2947   1.5x faster][41764]
2948 - [`eprint!` and `eprintln!` macros added to prelude.][41192] Same as the `print!`
2949   macros, but for printing to stderr.
2950
2951 Stabilized APIs
2952 ---------------
2953
2954 - [`OsString::shrink_to_fit`]
2955 - [`cmp::Reverse`]
2956 - [`Command::envs`]
2957 - [`thread::ThreadId`]
2958
2959 Cargo
2960 -----
2961
2962 - [Build scripts can now add environment variables to the environment
2963   the crate is being compiled in.
2964   Example: `println!("cargo:rustc-env=FOO=bar");`][cargo/3929]
2965 - [Subcommands now replace the current process rather than spawning a new
2966   child process][cargo/3970]
2967 - [Workspace members can now accept glob file patterns][cargo/3979]
2968 - [Added `--all` flag to the `cargo bench` subcommand to run benchmarks of all
2969   the members in a given workspace.][cargo/3988]
2970 - [Updated `libssh2-sys` to 0.2.6][cargo/4008]
2971 - [Target directory path is now in the cargo metadata][cargo/4022]
2972 - [Cargo no longer checks out a local working directory for the
2973   crates.io index][cargo/4026] This should provide smaller file size for the
2974   registry, and improve cloning times, especially on Windows machines.
2975 - [Added an `--exclude` option for excluding certain packages when using the
2976   `--all` option][cargo/4031]
2977 - [Cargo will now automatically retry when receiving a 5xx error
2978   from crates.io][cargo/4032]
2979 - [The `--features` option now accepts multiple comma or space
2980   delimited values.][cargo/4084]
2981 - [Added support for custom target specific runners][cargo/3954]
2982
2983 Misc
2984 ----
2985
2986 - [Added `rust-windbg.cmd`][39983] for loading rust `.natvis` files in the
2987   Windows Debugger.
2988 - [Rust will now release XZ compressed packages][rust-installer/57]
2989 - [rustup will now prefer to download rust packages with
2990   XZ compression][rustup/1100] over GZip packages.
2991 - [Added the ability to escape `#` in rust documentation][41785] By adding
2992   additional `#`'s ie. `##` is now `#`
2993
2994 Compatibility Notes
2995 -------------------
2996
2997 - [`MutexGuard<T>` may only be `Sync` if `T` is `Sync`.][41624]
2998 - [`-Z` flags are now no longer allowed to be used on the stable
2999   compiler.][41751] This has been a warning for a year previous to this.
3000 - [As a result of the `-Z` flag change, the `cargo-check` plugin no
3001   longer works][42844]. Users should migrate to the built-in `check`
3002   command, which has been available since 1.16.
3003 - [Ending a float literal with `._` is now a hard error.
3004   Example: `42._` .][41946]
3005 - [Any use of a private `extern crate` outside of its module is now a
3006   hard error.][36886] This was previously a warning.
3007 - [`use ::self::foo;` is now a hard error.][36888] `self` paths are always
3008   relative while the `::` prefix makes a path absolute, but was ignored and the
3009   path was relative regardless.
3010 - [Floating point constants in match patterns is now a hard error][36890]
3011   This was previously a warning.
3012 - [Struct or enum constants that don't derive `PartialEq` & `Eq` used
3013   match patterns is now a hard error][36891] This was previously a warning.
3014 - [Lifetimes named `'_` are no longer allowed.][36892] This was previously
3015   a warning.
3016 - [From the pound escape, lines consisting of multiple `#`s are
3017   now visible][41785]
3018 - [It is an error to re-export private enum variants][42460]. This is
3019   known to break a number of crates that depend on an older version of
3020   mustache.
3021 - [On Windows, if `VCINSTALLDIR` is set incorrectly, `rustc` will try
3022   to use it to find the linker, and the build will fail where it did
3023   not previously][42607]
3024
3025 [36886]: https://github.com/rust-lang/rust/issues/36886
3026 [36888]: https://github.com/rust-lang/rust/issues/36888
3027 [36890]: https://github.com/rust-lang/rust/issues/36890
3028 [36891]: https://github.com/rust-lang/rust/issues/36891
3029 [36892]: https://github.com/rust-lang/rust/issues/36892
3030 [37406]: https://github.com/rust-lang/rust/issues/37406
3031 [39983]: https://github.com/rust-lang/rust/pull/39983
3032 [41145]: https://github.com/rust-lang/rust/pull/41145
3033 [41192]: https://github.com/rust-lang/rust/pull/41192
3034 [41258]: https://github.com/rust-lang/rust/pull/41258
3035 [41370]: https://github.com/rust-lang/rust/pull/41370
3036 [41449]: https://github.com/rust-lang/rust/pull/41449
3037 [41530]: https://github.com/rust-lang/rust/pull/41530
3038 [41624]: https://github.com/rust-lang/rust/pull/41624
3039 [41656]: https://github.com/rust-lang/rust/pull/41656
3040 [41659]: https://github.com/rust-lang/rust/pull/41659
3041 [41676]: https://github.com/rust-lang/rust/pull/41676
3042 [41751]: https://github.com/rust-lang/rust/pull/41751
3043 [41764]: https://github.com/rust-lang/rust/pull/41764
3044 [41785]: https://github.com/rust-lang/rust/pull/41785
3045 [41873]: https://github.com/rust-lang/rust/pull/41873
3046 [41907]: https://github.com/rust-lang/rust/pull/41907
3047 [41946]: https://github.com/rust-lang/rust/pull/41946
3048 [42016]: https://github.com/rust-lang/rust/pull/42016
3049 [42037]: https://github.com/rust-lang/rust/pull/42037
3050 [42068]: https://github.com/rust-lang/rust/pull/42068
3051 [42150]: https://github.com/rust-lang/rust/pull/42150
3052 [42162]: https://github.com/rust-lang/rust/pull/42162
3053 [42225]: https://github.com/rust-lang/rust/pull/42225
3054 [42264]: https://github.com/rust-lang/rust/pull/42264
3055 [42302]: https://github.com/rust-lang/rust/pull/42302
3056 [42460]: https://github.com/rust-lang/rust/issues/42460
3057 [42607]: https://github.com/rust-lang/rust/issues/42607
3058 [42740]: https://github.com/rust-lang/rust/pull/42740
3059 [42844]: https://github.com/rust-lang/rust/issues/42844
3060 [42948]: https://github.com/rust-lang/rust/pull/42948
3061 [RFC 1444]: https://github.com/rust-lang/rfcs/pull/1444
3062 [RFC 1506]: https://github.com/rust-lang/rfcs/pull/1506
3063 [RFC 1558]: https://github.com/rust-lang/rfcs/pull/1558
3064 [RFC 1624]: https://github.com/rust-lang/rfcs/pull/1624
3065 [RFC 1721]: https://github.com/rust-lang/rfcs/pull/1721
3066 [`Command::envs`]: https://doc.rust-lang.org/std/process/struct.Command.html#method.envs
3067 [`OsString::shrink_to_fit`]: https://doc.rust-lang.org/std/ffi/struct.OsString.html#method.shrink_to_fit
3068 [`cmp::Reverse`]: https://doc.rust-lang.org/std/cmp/struct.Reverse.html
3069 [`thread::ThreadId`]: https://doc.rust-lang.org/std/thread/struct.ThreadId.html
3070 [cargo/3929]: https://github.com/rust-lang/cargo/pull/3929
3071 [cargo/3954]: https://github.com/rust-lang/cargo/pull/3954
3072 [cargo/3970]: https://github.com/rust-lang/cargo/pull/3970
3073 [cargo/3979]: https://github.com/rust-lang/cargo/pull/3979
3074 [cargo/3988]: https://github.com/rust-lang/cargo/pull/3988
3075 [cargo/4008]: https://github.com/rust-lang/cargo/pull/4008
3076 [cargo/4022]: https://github.com/rust-lang/cargo/pull/4022
3077 [cargo/4026]: https://github.com/rust-lang/cargo/pull/4026
3078 [cargo/4031]: https://github.com/rust-lang/cargo/pull/4031
3079 [cargo/4032]: https://github.com/rust-lang/cargo/pull/4032
3080 [cargo/4084]: https://github.com/rust-lang/cargo/pull/4084
3081 [rust-installer/57]: https://github.com/rust-lang/rust-installer/pull/57
3082 [rustup/1100]: https://github.com/rust-lang-nursery/rustup.rs/pull/1100
3083
3084
3085 Version 1.18.0 (2017-06-08)
3086 ===========================
3087
3088 Language
3089 --------
3090
3091 - [Stabilize pub(restricted)][40556] `pub` can now accept a module path to
3092   make the item visible to just that module tree. Also accepts the keyword
3093   `crate` to make something public to the whole crate but not users of the
3094   library. Example: `pub(crate) mod utils;`. [RFC 1422].
3095 - [Stabilize `#![windows_subsystem]` attribute][40870] conservative exposure of the
3096   `/SUBSYSTEM` linker flag on Windows platforms. [RFC 1665].
3097 - [Refactor of trait object type parsing][40043] Now `ty` in macros can accept
3098   types like `Write + Send`, trailing `+` are now supported in trait objects,
3099   and better error reporting for trait objects starting with `?Sized`.
3100 - [0e+10 is now a valid floating point literal][40589]
3101 - [Now warns if you bind a lifetime parameter to 'static][40734]
3102 - [Tuples, Enum variant fields, and structs with no `repr` attribute or with
3103   `#[repr(Rust)]` are reordered to minimize padding and produce a smaller
3104   representation in some cases.][40377]
3105
3106 Compiler
3107 --------
3108
3109 - [rustc can now emit mir with `--emit mir`][39891]
3110 - [Improved LLVM IR for trivial functions][40367]
3111 - [Added explanation for E0090(Wrong number of lifetimes are supplied)][40723]
3112 - [rustc compilation is now 15%-20% faster][41469] Thanks to optimisation
3113   opportunities found through profiling
3114 - [Improved backtrace formatting when panicking][38165]
3115
3116 Libraries
3117 ---------
3118
3119 - [Specialized `Vec::from_iter` being passed `vec::IntoIter`][40731] if the
3120   iterator hasn't been advanced the original `Vec` is reassembled with no actual
3121   iteration or reallocation.
3122 - [Simplified HashMap Bucket interface][40561] provides performance
3123   improvements for iterating and cloning.
3124 - [Specialize Vec::from_elem to use calloc][40409]
3125 - [Fixed Race condition in fs::create_dir_all][39799]
3126 - [No longer caching stdio on Windows][40516]
3127 - [Optimized insertion sort in slice][40807] insertion sort in some cases
3128   2.50%~ faster and in one case now 12.50% faster.
3129 - [Optimized `AtomicBool::fetch_nand`][41143]
3130
3131 Stabilized APIs
3132 ---------------
3133
3134 - [`Child::try_wait`]
3135 - [`HashMap::retain`]
3136 - [`HashSet::retain`]
3137 - [`PeekMut::pop`]
3138 - [`TcpStream::peek`]
3139 - [`UdpSocket::peek`]
3140 - [`UdpSocket::peek_from`]
3141
3142 Cargo
3143 -----
3144
3145 - [Added partial Pijul support][cargo/3842] Pijul is a version control system in Rust.
3146   You can now create new cargo projects with Pijul using `cargo new --vcs pijul`
3147 - [Now always emits build script warnings for crates that fail to build][cargo/3847]
3148 - [Added Android build support][cargo/3885]
3149 - [Added `--bins` and `--tests` flags][cargo/3901] now you can build all programs
3150   of a certain type, for example `cargo build --bins` will build all
3151   binaries.
3152 - [Added support for haiku][cargo/3952]
3153
3154 Misc
3155 ----
3156
3157 - [rustdoc can now use pulldown-cmark with the `--enable-commonmark` flag][40338]
3158 - [Added rust-windbg script for better debugging on Windows][39983]
3159 - [Rust now uses the official cross compiler for NetBSD][40612]
3160 - [rustdoc now accepts `#` at the start of files][40828]
3161 - [Fixed jemalloc support for musl][41168]
3162
3163 Compatibility Notes
3164 -------------------
3165
3166 - [Changes to how the `0` flag works in format!][40241] Padding zeroes are now
3167   always placed after the sign if it exists and before the digits. With the `#`
3168   flag the zeroes are placed after the prefix and before the digits.
3169 - [Due to the struct field optimisation][40377], using `transmute` on structs
3170   that have no `repr` attribute or `#[repr(Rust)]` will no longer work. This has
3171   always been undefined behavior, but is now more likely to break in practice.
3172 - [The refactor of trait object type parsing][40043] fixed a bug where `+` was
3173   receiving the wrong priority parsing things like `&for<'a> Tr<'a> + Send` as
3174   `&(for<'a> Tr<'a> + Send)` instead of `(&for<'a> Tr<'a>) + Send`
3175 - [Overlapping inherent `impl`s are now a hard error][40728]
3176 - [`PartialOrd` and `Ord` must agree on the ordering.][41270]
3177 - [`rustc main.rs -o out --emit=asm,llvm-ir`][41085] Now will output
3178   `out.asm` and `out.ll` instead of only one of the filetypes.
3179 - [ calling a function that returns `Self` will no longer work][41805] when
3180   the size of `Self` cannot be statically determined.
3181 - [rustc now builds with a "pthreads" flavour of MinGW for Windows GNU][40805]
3182   this has caused a few regressions namely:
3183
3184   - Changed the link order of local static/dynamic libraries (respecting the
3185     order on given rather than having the compiler reorder).
3186   - Changed how MinGW is linked, native code linked to dynamic libraries
3187     may require manually linking to the gcc support library (for the native
3188     code itself)
3189
3190 [38165]: https://github.com/rust-lang/rust/pull/38165
3191 [39799]: https://github.com/rust-lang/rust/pull/39799
3192 [39891]: https://github.com/rust-lang/rust/pull/39891
3193 [39983]: https://github.com/rust-lang/rust/pull/39983
3194 [40043]: https://github.com/rust-lang/rust/pull/40043
3195 [40241]: https://github.com/rust-lang/rust/pull/40241
3196 [40338]: https://github.com/rust-lang/rust/pull/40338
3197 [40367]: https://github.com/rust-lang/rust/pull/40367
3198 [40377]: https://github.com/rust-lang/rust/pull/40377
3199 [40409]: https://github.com/rust-lang/rust/pull/40409
3200 [40516]: https://github.com/rust-lang/rust/pull/40516
3201 [40556]: https://github.com/rust-lang/rust/pull/40556
3202 [40561]: https://github.com/rust-lang/rust/pull/40561
3203 [40589]: https://github.com/rust-lang/rust/pull/40589
3204 [40612]: https://github.com/rust-lang/rust/pull/40612
3205 [40723]: https://github.com/rust-lang/rust/pull/40723
3206 [40728]: https://github.com/rust-lang/rust/pull/40728
3207 [40731]: https://github.com/rust-lang/rust/pull/40731
3208 [40734]: https://github.com/rust-lang/rust/pull/40734
3209 [40805]: https://github.com/rust-lang/rust/pull/40805
3210 [40807]: https://github.com/rust-lang/rust/pull/40807
3211 [40828]: https://github.com/rust-lang/rust/pull/40828
3212 [40870]: https://github.com/rust-lang/rust/pull/40870
3213 [41085]: https://github.com/rust-lang/rust/pull/41085
3214 [41143]: https://github.com/rust-lang/rust/pull/41143
3215 [41168]: https://github.com/rust-lang/rust/pull/41168
3216 [41270]: https://github.com/rust-lang/rust/issues/41270
3217 [41469]: https://github.com/rust-lang/rust/pull/41469
3218 [41805]: https://github.com/rust-lang/rust/issues/41805
3219 [RFC 1422]: https://github.com/rust-lang/rfcs/blob/master/text/1422-pub-restricted.md
3220 [RFC 1665]: https://github.com/rust-lang/rfcs/blob/master/text/1665-windows-subsystem.md
3221 [`Child::try_wait`]: https://doc.rust-lang.org/std/process/struct.Child.html#method.try_wait
3222 [`HashMap::retain`]: https://doc.rust-lang.org/std/collections/struct.HashMap.html#method.retain
3223 [`HashSet::retain`]: https://doc.rust-lang.org/std/collections/struct.HashSet.html#method.retain
3224 [`PeekMut::pop`]: https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html#method.pop
3225 [`TcpStream::peek`]: https://doc.rust-lang.org/std/net/struct.TcpStream.html#method.peek
3226 [`UdpSocket::peek_from`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek_from
3227 [`UdpSocket::peek`]: https://doc.rust-lang.org/std/net/struct.UdpSocket.html#method.peek
3228 [cargo/3842]: https://github.com/rust-lang/cargo/pull/3842
3229 [cargo/3847]: https://github.com/rust-lang/cargo/pull/3847
3230 [cargo/3885]: https://github.com/rust-lang/cargo/pull/3885
3231 [cargo/3901]: https://github.com/rust-lang/cargo/pull/3901
3232 [cargo/3952]: https://github.com/rust-lang/cargo/pull/3952
3233
3234
3235 Version 1.17.0 (2017-04-27)
3236 ===========================
3237
3238 Language
3239 --------
3240
3241 * [The lifetime of statics and consts defaults to `'static`][39265]. [RFC 1623]
3242 * [Fields of structs may be initialized without duplicating the field/variable
3243   names][39761]. [RFC 1682]
3244 * [`Self` may be included in the `where` clause of `impls`][38864]. [RFC 1647]
3245 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3246   there is no subtyping between `T` and `U` when `T: Unsize<U>`. For example,
3247   coercing `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to
3248   `'b`. Soundness fix.
3249 * [Values passed to the indexing operator, `[]`, automatically coerce][40166]
3250 * [Static variables may contain references to other statics][40027]
3251
3252 Compiler
3253 --------
3254
3255 * [Exit quickly on only `--emit dep-info`][40336]
3256 * [Make `-C relocation-model` more correctly determine whether the linker
3257   creates a position-independent executable][40245]
3258 * [Add `-C overflow-checks` to directly control whether integer overflow
3259   panics][40037]
3260 * [The rustc type checker now checks items on demand instead of in a single
3261   in-order pass][40008]. This is mostly an internal refactoring in support of
3262   future work, including incremental type checking, but also resolves [RFC
3263   1647], allowing `Self` to appear in `impl` `where` clauses.
3264 * [Optimize vtable loads][39995]
3265 * [Turn off vectorization for Emscripten targets][39990]
3266 * [Provide suggestions for unknown macros imported with `use`][39953]
3267 * [Fix ICEs in path resolution][39939]
3268 * [Strip exception handling code on Emscripten when `panic=abort`][39193]
3269 * [Add clearer error message using `&str + &str`][39116]
3270
3271 Stabilized APIs
3272 ---------------
3273
3274 * [`Arc::into_raw`]
3275 * [`Arc::from_raw`]
3276 * [`Arc::ptr_eq`]
3277 * [`Rc::into_raw`]
3278 * [`Rc::from_raw`]
3279 * [`Rc::ptr_eq`]
3280 * [`Ordering::then`]
3281 * [`Ordering::then_with`]
3282 * [`BTreeMap::range`]
3283 * [`BTreeMap::range_mut`]
3284 * [`collections::Bound`]
3285 * [`process::abort`]
3286 * [`ptr::read_unaligned`]
3287 * [`ptr::write_unaligned`]
3288 * [`Result::expect_err`]
3289 * [`Cell::swap`]
3290 * [`Cell::replace`]
3291 * [`Cell::into_inner`]
3292 * [`Cell::take`]
3293
3294 Libraries
3295 ---------
3296
3297 * [`BTreeMap` and `BTreeSet` can iterate over ranges][27787]
3298 * [`Cell` can store non-`Copy` types][39793]. [RFC 1651]
3299 * [`String` implements `FromIterator<&char>`][40028]
3300 * `Box` [implements][40009] a number of new conversions:
3301   `From<Box<str>> for String`,
3302   `From<Box<[T]>> for Vec<T>`,
3303   `From<Box<CStr>> for CString`,
3304   `From<Box<OsStr>> for OsString`,
3305   `From<Box<Path>> for PathBuf`,
3306   `Into<Box<str>> for String`,
3307   `Into<Box<[T]>> for Vec<T>`,
3308   `Into<Box<CStr>> for CString`,
3309   `Into<Box<OsStr>> for OsString`,
3310   `Into<Box<Path>> for PathBuf`,
3311   `Default for Box<str>`,
3312   `Default for Box<CStr>`,
3313   `Default for Box<OsStr>`,
3314   `From<&CStr> for Box<CStr>`,
3315   `From<&OsStr> for Box<OsStr>`,
3316   `From<&Path> for Box<Path>`
3317 * [`ffi::FromBytesWithNulError` implements `Error` and `Display`][39960]
3318 * [Specialize `PartialOrd<A> for [A] where A: Ord`][39642]
3319 * [Slightly optimize `slice::sort`][39538]
3320 * [Add `ToString` trait specialization for `Cow<'a, str>` and `String`][39440]
3321 * [`Box<[T]>` implements `From<&[T]> where T: Copy`,
3322   `Box<str>` implements `From<&str>`][39438]
3323 * [`IpAddr` implements `From` for various arrays. `SocketAddr` implements
3324   `From<(I, u16)> where I: Into<IpAddr>`][39372]
3325 * [`format!` estimates the needed capacity before writing a string][39356]
3326 * [Support unprivileged symlink creation in Windows][38921]
3327 * [`PathBuf` implements `Default`][38764]
3328 * [Implement `PartialEq<[A]>` for `VecDeque<A>`][38661]
3329 * [`HashMap` resizes adaptively][38368] to guard against DOS attacks
3330   and poor hash functions.
3331
3332 Cargo
3333 -----
3334
3335 * [Add `cargo check --all`][cargo/3731]
3336 * [Add an option to ignore SSL revocation checking][cargo/3699]
3337 * [Add `cargo run --package`][cargo/3691]
3338 * [Add `required_features`][cargo/3667]
3339 * [Assume `build.rs` is a build script][cargo/3664]
3340 * [Find workspace via `workspace_root` link in containing member][cargo/3562]
3341
3342 Misc
3343 ----
3344
3345 * [Documentation is rendered with mdbook instead of the obsolete, in-tree
3346   `rustbook`][39633]
3347 * [The "Unstable Book" documents nightly-only features][ubook]
3348 * [Improve the style of the sidebar in rustdoc output][40265]
3349 * [Configure build correctly on 64-bit CPU's with the armhf ABI][40261]
3350 * [Fix MSP430 breakage due to `i128`][40257]
3351 * [Preliminary Solaris/SPARCv9 support][39903]
3352 * [`rustc` is linked statically on Windows MSVC targets][39837], allowing it to
3353   run without installing the MSVC runtime.
3354 * [`rustdoc --test` includes file names in test names][39788]
3355 * This release includes builds of `std` for `sparc64-unknown-linux-gnu`,
3356   `aarch64-unknown-linux-fuchsia`, and `x86_64-unknown-linux-fuchsia`.
3357 * [Initial support for `aarch64-unknown-freebsd`][39491]
3358 * [Initial support for `i686-unknown-netbsd`][39426]
3359 * [This release no longer includes the old makefile build system][39431]. Rust
3360   is built with a custom build system, written in Rust, and with Cargo.
3361 * [Add Debug implementations for libcollection structs][39002]
3362 * [`TypeId` implements `PartialOrd` and `Ord`][38981]
3363 * [`--test-threads=0` produces an error][38945]
3364 * [`rustup` installs documentation by default][40526]
3365 * [The Rust source includes NatVis visualizations][39843]. These can be used by
3366   WinDbg and Visual Studio to improve the debugging experience.
3367
3368 Compatibility Notes
3369 -------------------
3370
3371 * [Rust 1.17 does not correctly detect the MSVC 2017 linker][38584]. As a
3372   workaround, either use MSVC 2015 or run vcvars.bat.
3373 * [When coercing to an unsized type lifetimes must be equal][40319]. That is,
3374   disallow subtyping between `T` and `U` when `T: Unsize<U>`, e.g. coercing
3375   `&mut [&'a X; N]` to `&mut [&'b X]` requires `'a` be equal to `'b`. Soundness
3376   fix.
3377 * [`format!` and `Display::to_string` panic if an underlying formatting
3378   implementation returns an error][40117]. Previously the error was silently
3379   ignored. It is incorrect for `write_fmt` to return an error when writing
3380   to a string.
3381 * [In-tree crates are verified to be unstable][39851]. Previously, some minor
3382   crates were marked stable and could be accessed from the stable toolchain.
3383 * [Rust git source no longer includes vendored crates][39728]. Those that need
3384   to build with vendored crates should build from release tarballs.
3385 * [Fix inert attributes from `proc_macro_derives`][39572]
3386 * [During crate resolution, rustc prefers a crate in the sysroot if two crates
3387   are otherwise identical][39518]. Unlikely to be encountered outside the Rust
3388   build system.
3389 * [Fixed bugs around how type inference interacts with dead-code][39485]. The
3390   existing code generally ignores the type of dead-code unless a type-hint is
3391   provided; this can cause surprising inference interactions particularly around
3392   defaulting. The new code uniformly ignores the result type of dead-code.
3393 * [Tuple-struct constructors with private fields are no longer visible][38932]
3394 * [Lifetime parameters that do not appear in the arguments are now considered
3395   early-bound][38897], resolving a soundness bug (#[32330]). The
3396   `hr_lifetime_in_assoc_type` future-compatibility lint has been in effect since
3397   April of 2016.
3398 * [rustdoc: fix doctests with non-feature crate attributes][38161]
3399 * [Make transmuting from fn item types to pointer-sized types a hard
3400   error][34198]
3401
3402 [27787]: https://github.com/rust-lang/rust/issues/27787
3403 [32330]: https://github.com/rust-lang/rust/issues/32330
3404 [34198]: https://github.com/rust-lang/rust/pull/34198
3405 [38161]: https://github.com/rust-lang/rust/pull/38161
3406 [38368]: https://github.com/rust-lang/rust/pull/38368
3407 [38584]: https://github.com/rust-lang/rust/issues/38584
3408 [38661]: https://github.com/rust-lang/rust/pull/38661
3409 [38764]: https://github.com/rust-lang/rust/pull/38764
3410 [38864]: https://github.com/rust-lang/rust/issues/38864
3411 [38897]: https://github.com/rust-lang/rust/pull/38897
3412 [38921]: https://github.com/rust-lang/rust/pull/38921
3413 [38932]: https://github.com/rust-lang/rust/pull/38932
3414 [38945]: https://github.com/rust-lang/rust/pull/38945
3415 [38981]: https://github.com/rust-lang/rust/pull/38981
3416 [39002]: https://github.com/rust-lang/rust/pull/39002
3417 [39116]: https://github.com/rust-lang/rust/pull/39116
3418 [39193]: https://github.com/rust-lang/rust/pull/39193
3419 [39265]: https://github.com/rust-lang/rust/pull/39265
3420 [39356]: https://github.com/rust-lang/rust/pull/39356
3421 [39372]: https://github.com/rust-lang/rust/pull/39372
3422 [39426]: https://github.com/rust-lang/rust/pull/39426
3423 [39431]: https://github.com/rust-lang/rust/pull/39431
3424 [39438]: https://github.com/rust-lang/rust/pull/39438
3425 [39440]: https://github.com/rust-lang/rust/pull/39440
3426 [39485]: https://github.com/rust-lang/rust/pull/39485
3427 [39491]: https://github.com/rust-lang/rust/pull/39491
3428 [39518]: https://github.com/rust-lang/rust/pull/39518
3429 [39538]: https://github.com/rust-lang/rust/pull/39538
3430 [39572]: https://github.com/rust-lang/rust/pull/39572
3431 [39633]: https://github.com/rust-lang/rust/pull/39633
3432 [39642]: https://github.com/rust-lang/rust/pull/39642
3433 [39728]: https://github.com/rust-lang/rust/pull/39728
3434 [39761]: https://github.com/rust-lang/rust/pull/39761
3435 [39788]: https://github.com/rust-lang/rust/pull/39788
3436 [39793]: https://github.com/rust-lang/rust/pull/39793
3437 [39837]: https://github.com/rust-lang/rust/pull/39837
3438 [39843]: https://github.com/rust-lang/rust/pull/39843
3439 [39851]: https://github.com/rust-lang/rust/pull/39851
3440 [39903]: https://github.com/rust-lang/rust/pull/39903
3441 [39939]: https://github.com/rust-lang/rust/pull/39939
3442 [39953]: https://github.com/rust-lang/rust/pull/39953
3443 [39960]: https://github.com/rust-lang/rust/pull/39960
3444 [39990]: https://github.com/rust-lang/rust/pull/39990
3445 [39995]: https://github.com/rust-lang/rust/pull/39995
3446 [40008]: https://github.com/rust-lang/rust/pull/40008
3447 [40009]: https://github.com/rust-lang/rust/pull/40009
3448 [40027]: https://github.com/rust-lang/rust/pull/40027
3449 [40028]: https://github.com/rust-lang/rust/pull/40028
3450 [40037]: https://github.com/rust-lang/rust/pull/40037
3451 [40117]: https://github.com/rust-lang/rust/pull/40117
3452 [40166]: https://github.com/rust-lang/rust/pull/40166
3453 [40245]: https://github.com/rust-lang/rust/pull/40245
3454 [40257]: https://github.com/rust-lang/rust/pull/40257
3455 [40261]: https://github.com/rust-lang/rust/pull/40261
3456 [40265]: https://github.com/rust-lang/rust/pull/40265
3457 [40319]: https://github.com/rust-lang/rust/pull/40319
3458 [40336]: https://github.com/rust-lang/rust/pull/40336
3459 [40526]: https://github.com/rust-lang/rust/pull/40526
3460 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3461 [RFC 1647]: https://github.com/rust-lang/rfcs/blob/master/text/1647-allow-self-in-where-clauses.md
3462 [RFC 1651]: https://github.com/rust-lang/rfcs/blob/master/text/1651-movecell.md
3463 [RFC 1682]: https://github.com/rust-lang/rfcs/blob/master/text/1682-field-init-shorthand.md
3464 [`Arc::from_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.from_raw
3465 [`Arc::into_raw`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.into_raw
3466 [`Arc::ptr_eq`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.ptr_eq
3467 [`BTreeMap::range_mut`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range_mut
3468 [`BTreeMap::range`]: https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.range
3469 [`Cell::into_inner`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.into_inner
3470 [`Cell::replace`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.replace
3471 [`Cell::swap`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.swap
3472 [`Cell::take`]: https://doc.rust-lang.org/std/cell/struct.Cell.html#method.take
3473 [`Ordering::then_with`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then_with
3474 [`Ordering::then`]: https://doc.rust-lang.org/std/cmp/enum.Ordering.html#method.then
3475 [`Rc::from_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.from_raw
3476 [`Rc::into_raw`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.into_raw
3477 [`Rc::ptr_eq`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.ptr_eq
3478 [`Result::expect_err`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect_err
3479 [`collections::Bound`]: https://doc.rust-lang.org/std/collections/enum.Bound.html
3480 [`process::abort`]: https://doc.rust-lang.org/std/process/fn.abort.html
3481 [`ptr::read_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.read_unaligned.html
3482 [`ptr::write_unaligned`]: https://doc.rust-lang.org/std/ptr/fn.write_unaligned.html
3483 [cargo/3562]: https://github.com/rust-lang/cargo/pull/3562
3484 [cargo/3664]: https://github.com/rust-lang/cargo/pull/3664
3485 [cargo/3667]: https://github.com/rust-lang/cargo/pull/3667
3486 [cargo/3691]: https://github.com/rust-lang/cargo/pull/3691
3487 [cargo/3699]: https://github.com/rust-lang/cargo/pull/3699
3488 [cargo/3731]: https://github.com/rust-lang/cargo/pull/3731
3489 [mdbook]: https://crates.io/crates/mdbook
3490 [ubook]: https://doc.rust-lang.org/unstable-book/
3491
3492
3493 Version 1.16.0 (2017-03-16)
3494 ===========================
3495
3496 Language
3497 --------
3498
3499 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3500 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3501   match patterns][38069]
3502 * [Clean up semantics of `self` in an import list][38313]
3503 * [`Self` may appear in `impl` headers][38920]
3504 * [`Self` may appear in struct expressions][39282]
3505
3506 Compiler
3507 --------
3508
3509 * [`rustc` now supports `--emit=metadata`, which causes rustc to emit
3510   a `.rmeta` file containing only crate metadata][38571]. This can be
3511   used by tools like the Rust Language Service to perform
3512   metadata-only builds.
3513 * [Levenshtein based typo suggestions now work in most places, while
3514   previously they worked only for fields and sometimes for local
3515   variables][38927]. Together with the overhaul of "no
3516   resolution"/"unexpected resolution" errors (#[38154]) they result in
3517   large and systematic improvement in resolution diagnostics.
3518 * [Fix `transmute::<T, U>` where `T` requires a bigger alignment than
3519   `U`][38670]
3520 * [rustc: use -Xlinker when specifying an rpath with ',' in it][38798]
3521 * [`rustc` no longer attempts to provide "consider using an explicit
3522   lifetime" suggestions][37057]. They were inaccurate.
3523
3524 Stabilized APIs
3525 ---------------
3526
3527 * [`VecDeque::truncate`]
3528 * [`VecDeque::resize`]
3529 * [`String::insert_str`]
3530 * [`Duration::checked_add`]
3531 * [`Duration::checked_sub`]
3532 * [`Duration::checked_div`]
3533 * [`Duration::checked_mul`]
3534 * [`str::replacen`]
3535 * [`str::repeat`]
3536 * [`SocketAddr::is_ipv4`]
3537 * [`SocketAddr::is_ipv6`]
3538 * [`IpAddr::is_ipv4`]
3539 * [`IpAddr::is_ipv6`]
3540 * [`Vec::dedup_by`]
3541 * [`Vec::dedup_by_key`]
3542 * [`Result::unwrap_or_default`]
3543 * [`<*const T>::wrapping_offset`]
3544 * [`<*mut T>::wrapping_offset`]
3545 * `CommandExt::creation_flags`
3546 * [`File::set_permissions`]
3547 * [`String::split_off`]
3548
3549 Libraries
3550 ---------
3551
3552 * [`[T]::binary_search` and `[T]::binary_search_by_key` now take
3553   their argument by `Borrow` parameter][37761]
3554 * [All public types in std implement `Debug`][38006]
3555 * [`IpAddr` implements `From<Ipv4Addr>` and `From<Ipv6Addr>`][38327]
3556 * [`Ipv6Addr` implements `From<[u16; 8]>`][38131]
3557 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3558   Windows][38274]
3559 * [std: Fix partial writes in `LineWriter`][38062]
3560 * [std: Clamp max read/write sizes on Unix][38062]
3561 * [Use more specific panic message for `&str` slicing errors][38066]
3562 * [`TcpListener::set_only_v6` is deprecated][38304]. This
3563   functionality cannot be achieved in std currently.
3564 * [`writeln!`, like `println!`, now accepts a form with no string
3565   or formatting arguments, to just print a newline][38469]
3566 * [Implement `iter::Sum` and `iter::Product` for `Result`][38580]
3567 * [Reduce the size of static data in `std_unicode::tables`][38781]
3568 * [`char::EscapeDebug`, `EscapeDefault`, `EscapeUnicode`,
3569   `CaseMappingIter`, `ToLowercase`, `ToUppercase`, implement
3570   `Display`][38909]
3571 * [`Duration` implements `Sum`][38712]
3572 * [`String` implements `ToSocketAddrs`][39048]
3573
3574 Cargo
3575 -----
3576
3577 * [The `cargo check` command does a type check of a project without
3578   building it][cargo/3296]
3579 * [crates.io will display CI badges from Travis and AppVeyor, if
3580   specified in Cargo.toml][cargo/3546]
3581 * [crates.io will display categories listed in Cargo.toml][cargo/3301]
3582 * [Compilation profiles accept integer values for `debug`, in addition
3583   to `true` and `false`. These are passed to `rustc` as the value to
3584   `-C debuginfo`][cargo/3534]
3585 * [Implement `cargo --version --verbose`][cargo/3604]
3586 * [All builds now output 'dep-info' build dependencies compatible with
3587   make and ninja][cargo/3557]
3588 * [Build all workspace members with `build --all`][cargo/3511]
3589 * [Document all workspace members with `doc --all`][cargo/3515]
3590 * [Path deps outside workspace are not members][cargo/3443]
3591
3592 Misc
3593 ----
3594
3595 * [`rustdoc` has a `--sysroot` argument that, like `rustc`, specifies
3596   the path to the Rust implementation][38589]
3597 * [The `armv7-linux-androideabi` target no longer enables NEON
3598   extensions, per Google's ABI guide][38413]
3599 * [The stock standard library can be compiled for Redox OS][38401]
3600 * [Rust has initial SPARC support][38726]. Tier 3. No builds
3601   available.
3602 * [Rust has experimental support for Nvidia PTX][38559]. Tier 3. No
3603   builds available.
3604 * [Fix backtraces on i686-pc-windows-gnu by disabling FPO][39379]
3605
3606 Compatibility Notes
3607 -------------------
3608
3609 * [Uninhabitable enums (those without any variants) no longer permit wildcard
3610   match patterns][38069]
3611 * In this release, references to uninhabited types can not be
3612   pattern-matched. This was accidentally allowed in 1.15.
3613 * [The compiler's `dead_code` lint now accounts for type aliases][38051].
3614 * [Ctrl-Z returns from `Stdin.read()` when reading from the console on
3615   Windows][38274]
3616 * [Clean up semantics of `self` in an import list][38313]
3617 * Reimplemented lifetime elision. This change was almost entirely compatible
3618   with existing code, but it did close a number of small bugs and loopholes,
3619   as well as being more accepting in some other [cases][41105].
3620
3621 [37057]: https://github.com/rust-lang/rust/pull/37057
3622 [37761]: https://github.com/rust-lang/rust/pull/37761
3623 [38006]: https://github.com/rust-lang/rust/pull/38006
3624 [38051]: https://github.com/rust-lang/rust/pull/38051
3625 [38062]: https://github.com/rust-lang/rust/pull/38062
3626 [38062]: https://github.com/rust-lang/rust/pull/38622
3627 [38066]: https://github.com/rust-lang/rust/pull/38066
3628 [38069]: https://github.com/rust-lang/rust/pull/38069
3629 [38131]: https://github.com/rust-lang/rust/pull/38131
3630 [38154]: https://github.com/rust-lang/rust/pull/38154
3631 [38274]: https://github.com/rust-lang/rust/pull/38274
3632 [38304]: https://github.com/rust-lang/rust/pull/38304
3633 [38313]: https://github.com/rust-lang/rust/pull/38313
3634 [38314]: https://github.com/rust-lang/rust/pull/38314
3635 [38327]: https://github.com/rust-lang/rust/pull/38327
3636 [38401]: https://github.com/rust-lang/rust/pull/38401
3637 [38413]: https://github.com/rust-lang/rust/pull/38413
3638 [38469]: https://github.com/rust-lang/rust/pull/38469
3639 [38559]: https://github.com/rust-lang/rust/pull/38559
3640 [38571]: https://github.com/rust-lang/rust/pull/38571
3641 [38580]: https://github.com/rust-lang/rust/pull/38580
3642 [38589]: https://github.com/rust-lang/rust/pull/38589
3643 [38670]: https://github.com/rust-lang/rust/pull/38670
3644 [38712]: https://github.com/rust-lang/rust/pull/38712
3645 [38726]: https://github.com/rust-lang/rust/pull/38726
3646 [38781]: https://github.com/rust-lang/rust/pull/38781
3647 [38798]: https://github.com/rust-lang/rust/pull/38798
3648 [38909]: https://github.com/rust-lang/rust/pull/38909
3649 [38920]: https://github.com/rust-lang/rust/pull/38920
3650 [38927]: https://github.com/rust-lang/rust/pull/38927
3651 [39048]: https://github.com/rust-lang/rust/pull/39048
3652 [39282]: https://github.com/rust-lang/rust/pull/39282
3653 [39379]: https://github.com/rust-lang/rust/pull/39379
3654 [41105]: https://github.com/rust-lang/rust/issues/41105
3655 [`<*const T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3656 [`<*mut T>::wrapping_offset`]: https://doc.rust-lang.org/std/primitive.pointer.html#method.wrapping_offset
3657 [`Duration::checked_add`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_add
3658 [`Duration::checked_div`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_div
3659 [`Duration::checked_mul`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_mul
3660 [`Duration::checked_sub`]: https://doc.rust-lang.org/std/time/struct.Duration.html#method.checked_sub
3661 [`File::set_permissions`]: https://doc.rust-lang.org/std/fs/struct.File.html#method.set_permissions
3662 [`IpAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv4
3663 [`IpAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_ipv6
3664 [`Result::unwrap_or_default`]: https://doc.rust-lang.org/std/result/enum.Result.html#method.unwrap_or_default
3665 [`SocketAddr::is_ipv4`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv4
3666 [`SocketAddr::is_ipv6`]: https://doc.rust-lang.org/std/net/enum.SocketAddr.html#method.is_ipv6
3667 [`String::insert_str`]: https://doc.rust-lang.org/std/string/struct.String.html#method.insert_str
3668 [`String::split_off`]: https://doc.rust-lang.org/std/string/struct.String.html#method.split_off
3669 [`Vec::dedup_by_key`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by_key
3670 [`Vec::dedup_by`]: https://doc.rust-lang.org/std/vec/struct.Vec.html#method.dedup_by
3671 [`VecDeque::resize`]:  https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.resize
3672 [`VecDeque::truncate`]: https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.truncate
3673 [`str::repeat`]: https://doc.rust-lang.org/std/primitive.str.html#method.repeat
3674 [`str::replacen`]: https://doc.rust-lang.org/std/primitive.str.html#method.replacen
3675 [cargo/3296]: https://github.com/rust-lang/cargo/pull/3296
3676 [cargo/3301]: https://github.com/rust-lang/cargo/pull/3301
3677 [cargo/3443]: https://github.com/rust-lang/cargo/pull/3443
3678 [cargo/3511]: https://github.com/rust-lang/cargo/pull/3511
3679 [cargo/3515]: https://github.com/rust-lang/cargo/pull/3515
3680 [cargo/3534]: https://github.com/rust-lang/cargo/pull/3534
3681 [cargo/3546]: https://github.com/rust-lang/cargo/pull/3546
3682 [cargo/3557]: https://github.com/rust-lang/cargo/pull/3557
3683 [cargo/3604]: https://github.com/rust-lang/cargo/pull/3604
3684 [RFC 1623]: https://github.com/rust-lang/rfcs/blob/master/text/1623-static.md
3685
3686
3687 Version 1.15.1 (2017-02-09)
3688 ===========================
3689
3690 * [Fix IntoIter::as_mut_slice's signature][39466]
3691 * [Compile compiler builtins with `-fPIC` on 32-bit platforms][39523]
3692
3693 [39466]: https://github.com/rust-lang/rust/pull/39466
3694 [39523]: https://github.com/rust-lang/rust/pull/39523
3695
3696
3697 Version 1.15.0 (2017-02-02)
3698 ===========================
3699
3700 Language
3701 --------
3702
3703 * Basic procedural macros allowing custom `#[derive]`, aka "macros 1.1", are
3704   stable. This allows popular code-generating crates like Serde and Diesel to
3705   work ergonomically. [RFC 1681].
3706 * [Tuple structs may be empty. Unary and empty tuple structs may be instantiated
3707   with curly braces][36868]. Part of [RFC 1506].
3708 * [A number of minor changes to name resolution have been activated][37127].
3709   They add up to more consistent semantics, allowing for future evolution of
3710   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3711   details of what is different. The breaking changes here have been transitioned
3712   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3713 * [In `macro_rules`, `path` fragments can now be parsed as type parameter
3714   bounds][38279]
3715 * [`?Sized` can be used in `where` clauses][37791]
3716 * [There is now a limit on the size of monomorphized types and it can be
3717   modified with the `#![type_size_limit]` crate attribute, similarly to
3718   the `#![recursion_limit]` attribute][37789]
3719
3720 Compiler
3721 --------
3722
3723 * [On Windows, the compiler will apply dllimport attributes when linking to
3724   extern functions][37973]. Additional attributes and flags can control which
3725   library kind is linked and its name. [RFC 1717].
3726 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3727 * [The `--test` flag works with procedural macro crates][38107]
3728 * [Fix `extern "aapcs" fn` ABI][37814]
3729 * [The `-C no-stack-check` flag is deprecated][37636]. It does nothing.
3730 * [The `format!` expander recognizes incorrect `printf` and shell-style
3731   formatting directives and suggests the correct format][37613].
3732 * [Only report one error for all unused imports in an import list][37456]
3733
3734 Compiler Performance
3735 --------------------
3736
3737 * [Avoid unnecessary `mk_ty` calls in `Ty::super_fold_with`][37705]
3738 * [Avoid more unnecessary `mk_ty` calls in `Ty::super_fold_with`][37979]
3739 * [Don't clone in `UnificationTable::probe`][37848]
3740 * [Remove `scope_auxiliary` to cut RSS by 10%][37764]
3741 * [Use small vectors in type walker][37760]
3742 * [Macro expansion performance was improved][37701]
3743 * [Change `HirVec<P<T>>` to `HirVec<T>` in `hir::Expr`][37642]
3744 * [Replace FNV with a faster hash function][37229]
3745
3746 Stabilized APIs
3747 ---------------
3748
3749 * [`std::iter::Iterator::min_by`]
3750 * [`std::iter::Iterator::max_by`]
3751 * [`std::os::*::fs::FileExt`]
3752 * [`std::sync::atomic::Atomic*::get_mut`]
3753 * [`std::sync::atomic::Atomic*::into_inner`]
3754 * [`std::vec::IntoIter::as_slice`]
3755 * [`std::vec::IntoIter::as_mut_slice`]
3756 * [`std::sync::mpsc::Receiver::try_iter`]
3757 * [`std::os::unix::process::CommandExt::before_exec`]
3758 * [`std::rc::Rc::strong_count`]
3759 * [`std::rc::Rc::weak_count`]
3760 * [`std::sync::Arc::strong_count`]
3761 * [`std::sync::Arc::weak_count`]
3762 * [`std::char::encode_utf8`]
3763 * [`std::char::encode_utf16`]
3764 * [`std::cell::Ref::clone`]
3765 * [`std::io::Take::into_inner`]
3766
3767 Libraries
3768 ---------
3769
3770 * [The standard sorting algorithm has been rewritten for dramatic performance
3771   improvements][38192]. It is a hybrid merge sort, drawing influences from
3772   Timsort. Previously it was a naive merge sort.
3773 * [`Iterator::nth` no longer has a `Sized` bound][38134]
3774 * [`Extend<&T>` is specialized for `Vec` where `T: Copy`][38182] to improve
3775   performance.
3776 * [`chars().count()` is much faster][37888] and so are [`chars().last()`
3777   and `char_indices().last()`][37882]
3778 * [Fix ARM Objective-C ABI in `std::env::args`][38146]
3779 * [Chinese characters display correctly in `fmt::Debug`][37855]
3780 * [Derive `Default` for `Duration`][37699]
3781 * [Support creation of anonymous pipes on WinXP/2k][37677]
3782 * [`mpsc::RecvTimeoutError` implements `Error`][37527]
3783 * [Don't pass overlapped handles to processes][38835]
3784
3785 Cargo
3786 -----
3787
3788 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3789   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3790   should instead check the variable at runtime with `std::env`. That the value
3791   was set at build time was a bug, and incorrect when cross-compiling. This
3792   change is known to cause breakage.
3793 * [Add `--all` flag to `cargo test`][cargo/3221]
3794 * [Compile statically against the MSVC CRT][cargo/3363]
3795 * [Mix feature flags into fingerprint/metadata shorthash][cargo/3102]
3796 * [Link OpenSSL statically on OSX][cargo/3311]
3797 * [Apply new fingerprinting to build dir outputs][cargo/3310]
3798 * [Test for bad path overrides with summaries][cargo/3336]
3799 * [Require `cargo install --vers` to take a semver version][cargo/3338]
3800 * [Fix retrying crate downloads for network errors][cargo/3348]
3801 * [Implement string lookup for `build.rustflags` config key][cargo/3356]
3802 * [Emit more info on --message-format=json][cargo/3319]
3803 * [Assume `build.rs` in the same directory as `Cargo.toml` is a build script][cargo/3361]
3804 * [Don't ignore errors in workspace manifest][cargo/3409]
3805 * [Fix `--message-format JSON` when rustc emits non-JSON warnings][cargo/3410]
3806
3807 Tooling
3808 -------
3809
3810 * [Test runners (binaries built with `--test`) now support a `--list` argument
3811   that lists the tests it contains][38185]
3812 * [Test runners now support a `--exact` argument that makes the test filter
3813   match exactly, instead of matching only a substring of the test name][38181]
3814 * [rustdoc supports a `--playground-url` flag][37763]
3815 * [rustdoc provides more details about `#[should_panic]` errors][37749]
3816
3817 Misc
3818 ----
3819
3820 * [The Rust build system is now written in Rust][37817]. The Makefiles may
3821   continue to be used in this release by passing `--disable-rustbuild` to the
3822   configure script, but they will be deleted soon. Note that the new build
3823   system uses a different on-disk layout that will likely affect any scripts
3824   building Rust.
3825 * [Rust supports i686-unknown-openbsd][38086]. Tier 3 support. No testing or
3826   releases.
3827 * [Rust supports the MSP430][37627]. Tier 3 support. No testing or releases.
3828 * [Rust supports the ARMv5TE architecture][37615]. Tier 3 support. No testing or
3829   releases.
3830
3831 Compatibility Notes
3832 -------------------
3833
3834 * [A number of minor changes to name resolution have been activated][37127].
3835   They add up to more consistent semantics, allowing for future evolution of
3836   Rust macros. Specified in [RFC 1560], see its section on ["changes"] for
3837   details of what is different. The breaking changes here have been transitioned
3838   through the [`legacy_imports`] lint since 1.14, with no known regressions.
3839 * [In this release, Cargo build scripts no longer have access to the `OUT_DIR`
3840   environment variable at build time via `env!("OUT_DIR")`][cargo/3368]. They
3841   should instead check the variable at runtime with `std::env`. That the value
3842   was set at build time was a bug, and incorrect when cross-compiling. This
3843   change is known to cause breakage.
3844 * [Higher-ranked lifetimes are no longer allowed to appear _only_ in associated
3845   types][33685]. The [`hr_lifetime_in_assoc_type` lint] has been a warning since
3846   1.10 and is now an error by default. It will become a hard error in the near
3847   future.
3848 * [The semantics relating modules to file system directories are changing in
3849   minor ways][37602]. This is captured in the new `legacy_directory_ownership`
3850   lint, which is a warning in this release, and will become a hard error in the
3851   future.
3852 * [Rust-ABI symbols are no longer exported from cdylibs][38117]
3853 * [Once `Peekable` peeks a `None` it will return that `None` without re-querying
3854   the underlying iterator][37834]
3855
3856 ["changes"]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md#changes-to-name-resolution-rules
3857 [33685]: https://github.com/rust-lang/rust/issues/33685
3858 [36868]: https://github.com/rust-lang/rust/pull/36868
3859 [37127]: https://github.com/rust-lang/rust/pull/37127
3860 [37229]: https://github.com/rust-lang/rust/pull/37229
3861 [37456]: https://github.com/rust-lang/rust/pull/37456
3862 [37527]: https://github.com/rust-lang/rust/pull/37527
3863 [37602]: https://github.com/rust-lang/rust/pull/37602
3864 [37613]: https://github.com/rust-lang/rust/pull/37613
3865 [37615]: https://github.com/rust-lang/rust/pull/37615
3866 [37636]: https://github.com/rust-lang/rust/pull/37636
3867 [37627]: https://github.com/rust-lang/rust/pull/37627
3868 [37642]: https://github.com/rust-lang/rust/pull/37642
3869 [37677]: https://github.com/rust-lang/rust/pull/37677
3870 [37699]: https://github.com/rust-lang/rust/pull/37699
3871 [37701]: https://github.com/rust-lang/rust/pull/37701
3872 [37705]: https://github.com/rust-lang/rust/pull/37705
3873 [37749]: https://github.com/rust-lang/rust/pull/37749
3874 [37760]: https://github.com/rust-lang/rust/pull/37760
3875 [37763]: https://github.com/rust-lang/rust/pull/37763
3876 [37764]: https://github.com/rust-lang/rust/pull/37764
3877 [37789]: https://github.com/rust-lang/rust/pull/37789
3878 [37791]: https://github.com/rust-lang/rust/pull/37791
3879 [37814]: https://github.com/rust-lang/rust/pull/37814
3880 [37817]: https://github.com/rust-lang/rust/pull/37817
3881 [37834]: https://github.com/rust-lang/rust/pull/37834
3882 [37848]: https://github.com/rust-lang/rust/pull/37848
3883 [37855]: https://github.com/rust-lang/rust/pull/37855
3884 [37882]: https://github.com/rust-lang/rust/pull/37882
3885 [37888]: https://github.com/rust-lang/rust/pull/37888
3886 [37973]: https://github.com/rust-lang/rust/pull/37973
3887 [37979]: https://github.com/rust-lang/rust/pull/37979
3888 [38086]: https://github.com/rust-lang/rust/pull/38086
3889 [38107]: https://github.com/rust-lang/rust/pull/38107
3890 [38117]: https://github.com/rust-lang/rust/pull/38117
3891 [38134]: https://github.com/rust-lang/rust/pull/38134
3892 [38146]: https://github.com/rust-lang/rust/pull/38146
3893 [38181]: https://github.com/rust-lang/rust/pull/38181
3894 [38182]: https://github.com/rust-lang/rust/pull/38182
3895 [38185]: https://github.com/rust-lang/rust/pull/38185
3896 [38192]: https://github.com/rust-lang/rust/pull/38192
3897 [38279]: https://github.com/rust-lang/rust/pull/38279
3898 [38835]: https://github.com/rust-lang/rust/pull/38835
3899 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
3900 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
3901 [RFC 1560]: https://github.com/rust-lang/rfcs/blob/master/text/1560-name-resolution.md
3902 [RFC 1681]: https://github.com/rust-lang/rfcs/blob/master/text/1681-macros-1.1.md
3903 [RFC 1717]: https://github.com/rust-lang/rfcs/blob/master/text/1717-dllimport.md
3904 [`hr_lifetime_in_assoc_type` lint]: https://github.com/rust-lang/rust/issues/33685
3905 [`legacy_imports`]: https://github.com/rust-lang/rust/pull/38271
3906 [cargo/3102]: https://github.com/rust-lang/cargo/pull/3102
3907 [cargo/3221]: https://github.com/rust-lang/cargo/pull/3221
3908 [cargo/3310]: https://github.com/rust-lang/cargo/pull/3310
3909 [cargo/3311]: https://github.com/rust-lang/cargo/pull/3311
3910 [cargo/3319]: https://github.com/rust-lang/cargo/pull/3319
3911 [cargo/3336]: https://github.com/rust-lang/cargo/pull/3336
3912 [cargo/3338]: https://github.com/rust-lang/cargo/pull/3338
3913 [cargo/3348]: https://github.com/rust-lang/cargo/pull/3348
3914 [cargo/3356]: https://github.com/rust-lang/cargo/pull/3356
3915 [cargo/3361]: https://github.com/rust-lang/cargo/pull/3361
3916 [cargo/3363]: https://github.com/rust-lang/cargo/pull/3363
3917 [cargo/3368]: https://github.com/rust-lang/cargo/issues/3368
3918 [cargo/3409]: https://github.com/rust-lang/cargo/pull/3409
3919 [cargo/3410]: https://github.com/rust-lang/cargo/pull/3410
3920 [`std::iter::Iterator::min_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.min_by
3921 [`std::iter::Iterator::max_by`]: https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.max_by
3922 [`std::os::*::fs::FileExt`]: https://doc.rust-lang.org/std/os/unix/fs/trait.FileExt.html
3923 [`std::sync::atomic::Atomic*::get_mut`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.get_mut
3924 [`std::sync::atomic::Atomic*::into_inner`]: https://doc.rust-lang.org/std/sync/atomic/struct.AtomicU8.html#method.into_inner
3925 [`std::vec::IntoIter::as_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_slice
3926 [`std::vec::IntoIter::as_mut_slice`]: https://doc.rust-lang.org/std/vec/struct.IntoIter.html#method.as_mut_slice
3927 [`std::sync::mpsc::Receiver::try_iter`]: https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.try_iter
3928 [`std::os::unix::process::CommandExt::before_exec`]: https://doc.rust-lang.org/std/os/unix/process/trait.CommandExt.html#tymethod.before_exec
3929 [`std::rc::Rc::strong_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.strong_count
3930 [`std::rc::Rc::weak_count`]: https://doc.rust-lang.org/std/rc/struct.Rc.html#method.weak_count
3931 [`std::sync::Arc::strong_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.strong_count
3932 [`std::sync::Arc::weak_count`]: https://doc.rust-lang.org/std/sync/struct.Arc.html#method.weak_count
3933 [`std::char::encode_utf8`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf8
3934 [`std::char::encode_utf16`]: https://doc.rust-lang.org/std/primitive.char.html#method.encode_utf16
3935 [`std::cell::Ref::clone`]: https://doc.rust-lang.org/std/cell/struct.Ref.html#method.clone
3936 [`std::io::Take::into_inner`]: https://doc.rust-lang.org/std/io/struct.Take.html#method.into_inner
3937
3938
3939 Version 1.14.0 (2016-12-22)
3940 ===========================
3941
3942 Language
3943 --------
3944
3945 * [`..` matches multiple tuple fields in enum variants, structs
3946   and tuples][36843]. [RFC 1492].
3947 * [Safe `fn` items can be coerced to `unsafe fn` pointers][37389]
3948 * [`use *` and `use ::*` both glob-import from the crate root][37367]
3949 * [It's now possible to call a `Vec<Box<Fn()>>` without explicit
3950   dereferencing][36822]
3951
3952 Compiler
3953 --------
3954
3955 * [Mark enums with non-zero discriminant as non-zero][37224]
3956 * [Lower-case `static mut` names are linted like other
3957   statics and consts][37162]
3958 * [Fix ICE on some macros in const integer positions
3959    (e.g. `[u8; m!()]`)][36819]
3960 * [Improve error message and snippet for "did you mean `x`"][36798]
3961 * [Add a panic-strategy field to the target specification][36794]
3962 * [Include LLVM version in `--version --verbose`][37200]
3963
3964 Compile-time Optimizations
3965 --------------------------
3966
3967 * [Improve macro expansion performance][37569]
3968 * [Shrink `Expr_::ExprInlineAsm`][37445]
3969 * [Replace all uses of SHA-256 with BLAKE2b][37439]
3970 * [Reduce the number of bytes hashed by `IchHasher`][37427]
3971 * [Avoid more allocations when compiling html5ever][37373]
3972 * [Use `SmallVector` in `CombineFields::instantiate`][37322]
3973 * [Avoid some allocations in the macro parser][37318]
3974 * [Use a faster deflate setting][37298]
3975 * [Add `ArrayVec` and `AccumulateVec` to reduce heap allocations
3976   during interning of slices][37270]
3977 * [Optimize `write_metadata`][37267]
3978 * [Don't process obligation forest cycles when stalled][37231]
3979 * [Avoid many `CrateConfig` clones][37161]
3980 * [Optimize `Substs::super_fold_with`][37108]
3981 * [Optimize `ObligationForest`'s `NodeState` handling][36993]
3982 * [Speed up `plug_leaks`][36917]
3983
3984 Libraries
3985 ---------
3986
3987 * [`println!()`, with no arguments, prints newline][36825].
3988   Previously, an empty string was required to achieve the same.
3989 * [`Wrapping` impls standard binary and unary operators, as well as
3990    the `Sum` and `Product` iterators][37356]
3991 * [Implement `From<Cow<str>> for String` and `From<Cow<[T]>> for
3992   Vec<T>`][37326]
3993 * [Improve `fold` performance for `chain`, `cloned`, `map`, and
3994   `VecDeque` iterators][37315]
3995 * [Improve `SipHasher` performance on small values][37312]
3996 * [Add Iterator trait TrustedLen to enable better FromIterator /
3997   Extend][37306]
3998 * [Expand `.zip()` specialization to `.map()` and `.cloned()`][37230]
3999 * [`ReadDir` implements `Debug`][37221]
4000 * [Implement `RefUnwindSafe` for atomic types][37178]
4001 * [Specialize `Vec::extend` to `Vec::extend_from_slice`][37094]
4002 * [Avoid allocations in `Decoder::read_str`][37064]
4003 * [`io::Error` implements `From<io::ErrorKind>`][37037]
4004 * [Impl `Debug` for raw pointers to unsized data][36880]
4005 * [Don't reuse `HashMap` random seeds][37470]
4006 * [The internal memory layout of `HashMap` is more cache-friendly, for
4007   significant improvements in some operations][36692]
4008 * [`HashMap` uses less memory on 32-bit architectures][36595]
4009 * [Impl `Add<{str, Cow<str>}>` for `Cow<str>`][36430]
4010
4011 Cargo
4012 -----
4013
4014 * [Expose rustc cfg values to build scripts][cargo/3243]
4015 * [Allow cargo to work with read-only `CARGO_HOME`][cargo/3259]
4016 * [Fix passing --features when testing multiple packages][cargo/3280]
4017 * [Use a single profile set per workspace][cargo/3249]
4018 * [Load `replace` sections from lock files][cargo/3220]
4019 * [Ignore `panic` configuration for test/bench profiles][cargo/3175]
4020
4021 Tooling
4022 -------
4023
4024 * [rustup is the recommended Rust installation method][1.14rustup]
4025 * This release includes host (rustc) builds for Linux on MIPS, PowerPC, and
4026   S390x. These are [tier 2] platforms and may have major defects. Follow the
4027   instructions on the website to install, or add the targets to an existing
4028   installation with `rustup target add`. The new target triples are:
4029   - `mips-unknown-linux-gnu`
4030   - `mipsel-unknown-linux-gnu`
4031   - `mips64-unknown-linux-gnuabi64`
4032   - `mips64el-unknown-linux-gnuabi64 `
4033   - `powerpc-unknown-linux-gnu`
4034   - `powerpc64-unknown-linux-gnu`
4035   - `powerpc64le-unknown-linux-gnu`
4036   - `s390x-unknown-linux-gnu `
4037 * This release includes target (std) builds for ARM Linux running MUSL
4038   libc. These are [tier 2] platforms and may have major defects. Add the
4039   following triples to an existing rustup installation with `rustup target add`:
4040   - `arm-unknown-linux-musleabi`
4041   - `arm-unknown-linux-musleabihf`
4042   - `armv7-unknown-linux-musleabihf`
4043 * This release includes [experimental support for WebAssembly][1.14wasm], via
4044   the `wasm32-unknown-emscripten` target. This target is known to have major
4045   defects. Please test, report, and fix.
4046 * rustup no longer installs documentation by default. Run `rustup
4047   component add rust-docs` to install.
4048 * [Fix line stepping in debugger][37310]
4049 * [Enable line number debuginfo in releases][37280]
4050
4051 Misc
4052 ----
4053
4054 * [Disable jemalloc on aarch64/powerpc/mips][37392]
4055 * [Add support for Fuchsia OS][37313]
4056 * [Detect local-rebuild by only MAJOR.MINOR version][37273]
4057
4058 Compatibility Notes
4059 -------------------
4060
4061 * [A number of forward-compatibility lints used by the compiler
4062   to gradually introduce language changes have been converted
4063   to deny by default][36894]:
4064   - ["use of inaccessible extern crate erroneously allowed"][36886]
4065   - ["type parameter default erroneously allowed in invalid location"][36887]
4066   - ["detects super or self keywords at the beginning of global path"][36888]
4067   - ["two overlapping inherent impls define an item with the same name
4068     were erroneously allowed"][36889]
4069   - ["floating-point constants cannot be used in patterns"][36890]
4070   - ["constants of struct or enum type can only be used in a pattern if
4071      the struct or enum has `#[derive(PartialEq, Eq)]`"][36891]
4072   - ["lifetimes or labels named `'_` were erroneously allowed"][36892]
4073 * [Prohibit patterns in trait methods without bodies][37378]
4074 * [The atomic `Ordering` enum may not be matched exhaustively][37351]
4075 * [Future-proofing `#[no_link]` breaks some obscure cases][37247]
4076 * [The `$crate` macro variable is accepted in fewer locations][37213]
4077 * [Impls specifying extra region requirements beyond the trait
4078   they implement are rejected][37167]
4079 * [Enums may not be unsized][37111]. Unsized enums are intended to
4080   work but never have. For now they are forbidden.
4081 * [Enforce the shadowing restrictions from RFC 1560 for today's macros][36767]
4082
4083 [tier 2]: https://forge.rust-lang.org/platform-support.html
4084 [1.14rustup]: https://internals.rust-lang.org/t/beta-testing-rustup-rs/3316/204
4085 [1.14wasm]: https://users.rust-lang.org/t/compiling-to-the-web-with-rust-and-emscripten/7627
4086 [36430]: https://github.com/rust-lang/rust/pull/36430
4087 [36595]: https://github.com/rust-lang/rust/pull/36595
4088 [36595]: https://github.com/rust-lang/rust/pull/36595
4089 [36692]: https://github.com/rust-lang/rust/pull/36692
4090 [36767]: https://github.com/rust-lang/rust/pull/36767
4091 [36794]: https://github.com/rust-lang/rust/pull/36794
4092 [36798]: https://github.com/rust-lang/rust/pull/36798
4093 [36819]: https://github.com/rust-lang/rust/pull/36819
4094 [36822]: https://github.com/rust-lang/rust/pull/36822
4095 [36825]: https://github.com/rust-lang/rust/pull/36825
4096 [36843]: https://github.com/rust-lang/rust/pull/36843
4097 [36880]: https://github.com/rust-lang/rust/pull/36880
4098 [36886]: https://github.com/rust-lang/rust/issues/36886
4099 [36887]: https://github.com/rust-lang/rust/issues/36887
4100 [36888]: https://github.com/rust-lang/rust/issues/36888
4101 [36889]: https://github.com/rust-lang/rust/issues/36889
4102 [36890]: https://github.com/rust-lang/rust/issues/36890
4103 [36891]: https://github.com/rust-lang/rust/issues/36891
4104 [36892]: https://github.com/rust-lang/rust/issues/36892
4105 [36894]: https://github.com/rust-lang/rust/pull/36894
4106 [36917]: https://github.com/rust-lang/rust/pull/36917
4107 [36993]: https://github.com/rust-lang/rust/pull/36993
4108 [37037]: https://github.com/rust-lang/rust/pull/37037
4109 [37064]: https://github.com/rust-lang/rust/pull/37064
4110 [37094]: https://github.com/rust-lang/rust/pull/37094
4111 [37108]: https://github.com/rust-lang/rust/pull/37108
4112 [37111]: https://github.com/rust-lang/rust/pull/37111
4113 [37161]: https://github.com/rust-lang/rust/pull/37161
4114 [37162]: https://github.com/rust-lang/rust/pull/37162
4115 [37167]: https://github.com/rust-lang/rust/pull/37167
4116 [37178]: https://github.com/rust-lang/rust/pull/37178
4117 [37200]: https://github.com/rust-lang/rust/pull/37200
4118 [37213]: https://github.com/rust-lang/rust/pull/37213
4119 [37221]: https://github.com/rust-lang/rust/pull/37221
4120 [37224]: https://github.com/rust-lang/rust/pull/37224
4121 [37230]: https://github.com/rust-lang/rust/pull/37230
4122 [37231]: https://github.com/rust-lang/rust/pull/37231
4123 [37247]: https://github.com/rust-lang/rust/pull/37247
4124 [37267]: https://github.com/rust-lang/rust/pull/37267
4125 [37270]: https://github.com/rust-lang/rust/pull/37270
4126 [37273]: https://github.com/rust-lang/rust/pull/37273
4127 [37280]: https://github.com/rust-lang/rust/pull/37280
4128 [37298]: https://github.com/rust-lang/rust/pull/37298
4129 [37306]: https://github.com/rust-lang/rust/pull/37306
4130 [37310]: https://github.com/rust-lang/rust/pull/37310
4131 [37312]: https://github.com/rust-lang/rust/pull/37312
4132 [37313]: https://github.com/rust-lang/rust/pull/37313
4133 [37315]: https://github.com/rust-lang/rust/pull/37315
4134 [37318]: https://github.com/rust-lang/rust/pull/37318
4135 [37322]: https://github.com/rust-lang/rust/pull/37322
4136 [37326]: https://github.com/rust-lang/rust/pull/37326
4137 [37351]: https://github.com/rust-lang/rust/pull/37351
4138 [37356]: https://github.com/rust-lang/rust/pull/37356
4139 [37367]: https://github.com/rust-lang/rust/pull/37367
4140 [37373]: https://github.com/rust-lang/rust/pull/37373
4141 [37378]: https://github.com/rust-lang/rust/pull/37378
4142 [37389]: https://github.com/rust-lang/rust/pull/37389
4143 [37392]: https://github.com/rust-lang/rust/pull/37392
4144 [37427]: https://github.com/rust-lang/rust/pull/37427
4145 [37439]: https://github.com/rust-lang/rust/pull/37439
4146 [37445]: https://github.com/rust-lang/rust/pull/37445
4147 [37470]: https://github.com/rust-lang/rust/pull/37470
4148 [37569]: https://github.com/rust-lang/rust/pull/37569
4149 [RFC 1492]: https://github.com/rust-lang/rfcs/blob/master/text/1492-dotdot-in-patterns.md
4150 [cargo/3175]: https://github.com/rust-lang/cargo/pull/3175
4151 [cargo/3220]: https://github.com/rust-lang/cargo/pull/3220
4152 [cargo/3243]: https://github.com/rust-lang/cargo/pull/3243
4153 [cargo/3249]: https://github.com/rust-lang/cargo/pull/3249
4154 [cargo/3259]: https://github.com/rust-lang/cargo/pull/3259
4155 [cargo/3280]: https://github.com/rust-lang/cargo/pull/3280
4156
4157
4158 Version 1.13.0 (2016-11-10)
4159 ===========================
4160
4161 Language
4162 --------
4163
4164 * [Stabilize the `?` operator][36995]. `?` is a simple way to propagate
4165   errors, like the `try!` macro, described in [RFC 0243].
4166 * [Stabilize macros in type position][36014]. Described in [RFC 873].
4167 * [Stabilize attributes on statements][36995]. Described in [RFC 0016].
4168 * [Fix `#[derive]` for empty tuple structs/variants][35728]
4169 * [Fix lifetime rules for 'if' conditions][36029]
4170 * [Avoid loading and parsing unconfigured non-inline modules][36482]
4171
4172 Compiler
4173 --------
4174
4175 * [Add the `-C link-arg` argument][36574]
4176 * [Remove the old AST-based backend from rustc_trans][35764]
4177 * [Don't enable NEON by default on armv7 Linux][35814]
4178 * [Fix debug line number info for macro expansions][35238]
4179 * [Do not emit "class method" debuginfo for types that are not
4180   DICompositeType][36008]
4181 * [Warn about multiple conflicting #[repr] hints][34623]
4182 * [When sizing DST, don't double-count nested struct prefixes][36351]
4183 * [Default RUST_MIN_STACK to 16MiB for now][36505]
4184 * [Improve rlib metadata format][36551]. Reduces rlib size significantly.
4185 * [Reject macros with empty repetitions to avoid infinite loop][36721]
4186 * [Expand macros without recursing to avoid stack overflows][36214]
4187
4188 Diagnostics
4189 -----------
4190
4191 * [Replace macro backtraces with labeled local uses][35702]
4192 * [Improve error message for misplaced doc comments][33922]
4193 * [Buffer unix and lock windows to prevent message interleaving][35975]
4194 * [Update lifetime errors to specifically note temporaries][36171]
4195 * [Special case a few colors for Windows][36178]
4196 * [Suggest `use self` when such an import resolves][36289]
4197 * [Be more specific when type parameter shadows primitive type][36338]
4198 * Many minor improvements
4199
4200 Compile-time Optimizations
4201 --------------------------
4202
4203 * [Compute and cache HIR hashes at beginning][35854]
4204 * [Don't hash types in loan paths][36004]
4205 * [Cache projections in trans][35761]
4206 * [Optimize the parser's last token handling][36527]
4207 * [Only instantiate #[inline] functions in codegen units referencing
4208   them][36524]. This leads to big improvements in cases where crates export
4209   define many inline functions without using them directly.
4210 * [Lazily allocate TypedArena's first chunk][36592]
4211 * [Don't allocate during default HashSet creation][36734]
4212
4213 Stabilized APIs
4214 ---------------
4215
4216 * [`checked_abs`]
4217 * [`wrapping_abs`]
4218 * [`overflowing_abs`]
4219 * [`RefCell::try_borrow`]
4220 * [`RefCell::try_borrow_mut`]
4221
4222 Libraries
4223 ---------
4224
4225 * [Add `assert_ne!` and `debug_assert_ne!`][35074]
4226 * [Make `vec_deque::Drain`, `hash_map::Drain`, and `hash_set::Drain`
4227   covariant][35354]
4228 * [Implement `AsRef<[T]>` for `std::slice::Iter`][35559]
4229 * [Implement `Debug` for `std::vec::IntoIter`][35707]
4230 * [`CString`: avoid excessive growth just to 0-terminate][35871]
4231 * [Implement `CoerceUnsized` for `{Cell, RefCell, UnsafeCell}`][35627]
4232 * [Use arc4rand on FreeBSD][35884]
4233 * [memrchr: Correct aligned offset computation][35969]
4234 * [Improve Demangling of Rust Symbols][36059]
4235 * [Use monotonic time in condition variables][35048]
4236 * [Implement `Debug` for `std::path::{Components,Iter}`][36101]
4237 * [Implement conversion traits for `char`][35755]
4238 * [Fix illegal instruction caused by overflow in channel cloning][36104]
4239 * [Zero first byte of CString on drop][36264]
4240 * [Inherit overflow checks for sum and product][36372]
4241 * [Add missing Eq implementations][36423]
4242 * [Implement `Debug` for `DirEntry`][36631]
4243 * [When `getaddrinfo` returns `EAI_SYSTEM` retrieve actual error from
4244   `errno`][36754]
4245 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4246 * [Implement more traits for `std::io::ErrorKind`][35911]
4247 * [Optimize BinaryHeap bounds checking][36072]
4248 * [Work around pointer aliasing issue in `Vec::extend_from_slice`,
4249   `extend_with_element`][36355]
4250 * [Fix overflow checking in unsigned pow()][34942]
4251
4252 Cargo
4253 -----
4254
4255 * This release includes security fixes to both curl and OpenSSL.
4256 * [Fix transitive doctests when panic=abort][cargo/3021]
4257 * [Add --all-features flag to cargo][cargo/3038]
4258 * [Reject path-based dependencies in `cargo package`][cargo/3060]
4259 * [Don't parse the home directory more than once][cargo/3078]
4260 * [Don't try to generate Cargo.lock on empty workspaces][cargo/3092]
4261 * [Update OpenSSL to 1.0.2j][cargo/3121]
4262 * [Add license and license_file to cargo metadata output][cargo/3110]
4263 * [Make crates-io registry URL optional in config; ignore all changes to
4264   source.crates-io][cargo/3089]
4265 * [Don't download dependencies from other platforms][cargo/3123]
4266 * [Build transitive dev-dependencies when needed][cargo/3125]
4267 * [Add support for per-target rustflags in .cargo/config][cargo/3157]
4268 * [Avoid updating registry when adding existing deps][cargo/3144]
4269 * [Warn about path overrides that won't work][cargo/3136]
4270 * [Use workspaces during `cargo install`][cargo/3146]
4271 * [Leak mspdbsrv.exe processes on Windows][cargo/3162]
4272 * [Add --message-format flag][cargo/3000]
4273 * [Pass target environment for rustdoc][cargo/3205]
4274 * [Use `CommandExt::exec` for `cargo run` on Unix][cargo/2818]
4275 * [Update curl and curl-sys][cargo/3241]
4276 * [Call rustdoc test with the correct cfg flags of a package][cargo/3242]
4277
4278 Tooling
4279 -------
4280
4281 * [rustdoc: Add the `--sysroot` argument][36586]
4282 * [rustdoc: Fix a couple of issues with the search results][35655]
4283 * [rustdoc: remove the `!` from macro URLs and titles][35234]
4284 * [gdb: Fix pretty-printing special-cased Rust types][35585]
4285 * [rustdoc: Filter more incorrect methods inherited through Deref][36266]
4286
4287 Misc
4288 ----
4289
4290 * [Remove unmaintained style guide][35124]
4291 * [Add s390x support][36369]
4292 * [Initial work at Haiku OS support][36727]
4293 * [Add mips-uclibc targets][35734]
4294 * [Crate-ify compiler-rt into compiler-builtins][35021]
4295 * [Add rustc version info (git hash + date) to dist tarball][36213]
4296 * Many documentation improvements
4297
4298 Compatibility Notes
4299 -------------------
4300
4301 * [`SipHasher`] is deprecated. Use [`DefaultHasher`].
4302 * [Deny (by default) transmuting from fn item types to pointer-sized
4303   types][34923]. Continuing the long transition to zero-sized fn items,
4304   per [RFC 401].
4305 * [Fix `#[derive]` for empty tuple structs/variants][35728].
4306   Part of [RFC 1506].
4307 * [Issue deprecation warnings for safe accesses to extern statics][36173]
4308 * [Fix lifetime rules for 'if' conditions][36029].
4309 * [Inherit overflow checks for sum and product][36372].
4310 * [Forbid user-defined macros named "macro_rules"][36730].
4311
4312 [33922]: https://github.com/rust-lang/rust/pull/33922
4313 [34623]: https://github.com/rust-lang/rust/pull/34623
4314 [34923]: https://github.com/rust-lang/rust/pull/34923
4315 [34942]: https://github.com/rust-lang/rust/pull/34942
4316 [34982]: https://github.com/rust-lang/rust/pull/34982
4317 [35021]: https://github.com/rust-lang/rust/pull/35021
4318 [35048]: https://github.com/rust-lang/rust/pull/35048
4319 [35074]: https://github.com/rust-lang/rust/pull/35074
4320 [35124]: https://github.com/rust-lang/rust/pull/35124
4321 [35234]: https://github.com/rust-lang/rust/pull/35234
4322 [35238]: https://github.com/rust-lang/rust/pull/35238
4323 [35354]: https://github.com/rust-lang/rust/pull/35354
4324 [35559]: https://github.com/rust-lang/rust/pull/35559
4325 [35585]: https://github.com/rust-lang/rust/pull/35585
4326 [35627]: https://github.com/rust-lang/rust/pull/35627
4327 [35655]: https://github.com/rust-lang/rust/pull/35655
4328 [35702]: https://github.com/rust-lang/rust/pull/35702
4329 [35707]: https://github.com/rust-lang/rust/pull/35707
4330 [35728]: https://github.com/rust-lang/rust/pull/35728
4331 [35734]: https://github.com/rust-lang/rust/pull/35734
4332 [35755]: https://github.com/rust-lang/rust/pull/35755
4333 [35761]: https://github.com/rust-lang/rust/pull/35761
4334 [35764]: https://github.com/rust-lang/rust/pull/35764
4335 [35814]: https://github.com/rust-lang/rust/pull/35814
4336 [35854]: https://github.com/rust-lang/rust/pull/35854
4337 [35871]: https://github.com/rust-lang/rust/pull/35871
4338 [35884]: https://github.com/rust-lang/rust/pull/35884
4339 [35911]: https://github.com/rust-lang/rust/pull/35911
4340 [35969]: https://github.com/rust-lang/rust/pull/35969
4341 [35975]: https://github.com/rust-lang/rust/pull/35975
4342 [36004]: https://github.com/rust-lang/rust/pull/36004
4343 [36008]: https://github.com/rust-lang/rust/pull/36008
4344 [36014]: https://github.com/rust-lang/rust/pull/36014
4345 [36029]: https://github.com/rust-lang/rust/pull/36029
4346 [36059]: https://github.com/rust-lang/rust/pull/36059
4347 [36072]: https://github.com/rust-lang/rust/pull/36072
4348 [36101]: https://github.com/rust-lang/rust/pull/36101
4349 [36104]: https://github.com/rust-lang/rust/pull/36104
4350 [36171]: https://github.com/rust-lang/rust/pull/36171
4351 [36173]: https://github.com/rust-lang/rust/pull/36173
4352 [36178]: https://github.com/rust-lang/rust/pull/36178
4353 [36213]: https://github.com/rust-lang/rust/pull/36213
4354 [36214]: https://github.com/rust-lang/rust/pull/36214
4355 [36264]: https://github.com/rust-lang/rust/pull/36264
4356 [36266]: https://github.com/rust-lang/rust/pull/36266
4357 [36289]: https://github.com/rust-lang/rust/pull/36289
4358 [36338]: https://github.com/rust-lang/rust/pull/36338
4359 [36351]: https://github.com/rust-lang/rust/pull/36351
4360 [36355]: https://github.com/rust-lang/rust/pull/36355
4361 [36369]: https://github.com/rust-lang/rust/pull/36369
4362 [36372]: https://github.com/rust-lang/rust/pull/36372
4363 [36423]: https://github.com/rust-lang/rust/pull/36423
4364 [36482]: https://github.com/rust-lang/rust/pull/36482
4365 [36505]: https://github.com/rust-lang/rust/pull/36505
4366 [36524]: https://github.com/rust-lang/rust/pull/36524
4367 [36527]: https://github.com/rust-lang/rust/pull/36527
4368 [36551]: https://github.com/rust-lang/rust/pull/36551
4369 [36574]: https://github.com/rust-lang/rust/pull/36574
4370 [36586]: https://github.com/rust-lang/rust/pull/36586
4371 [36592]: https://github.com/rust-lang/rust/pull/36592
4372 [36631]: https://github.com/rust-lang/rust/pull/36631
4373 [36639]: https://github.com/rust-lang/rust/pull/36639
4374 [36721]: https://github.com/rust-lang/rust/pull/36721
4375 [36727]: https://github.com/rust-lang/rust/pull/36727
4376 [36730]: https://github.com/rust-lang/rust/pull/36730
4377 [36734]: https://github.com/rust-lang/rust/pull/36734
4378 [36754]: https://github.com/rust-lang/rust/pull/36754
4379 [36995]: https://github.com/rust-lang/rust/pull/36995
4380 [RFC 0016]: https://github.com/rust-lang/rfcs/blob/master/text/0016-more-attributes.md
4381 [RFC 0243]: https://github.com/rust-lang/rfcs/blob/master/text/0243-trait-based-exception-handling.md
4382 [RFC 1506]: https://github.com/rust-lang/rfcs/blob/master/text/1506-adt-kinds.md
4383 [RFC 401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
4384 [RFC 873]: https://github.com/rust-lang/rfcs/blob/master/text/0873-type-macros.md
4385 [cargo/2818]: https://github.com/rust-lang/cargo/pull/2818
4386 [cargo/3000]: https://github.com/rust-lang/cargo/pull/3000
4387 [cargo/3021]: https://github.com/rust-lang/cargo/pull/3021
4388 [cargo/3038]: https://github.com/rust-lang/cargo/pull/3038
4389 [cargo/3060]: https://github.com/rust-lang/cargo/pull/3060
4390 [cargo/3078]: https://github.com/rust-lang/cargo/pull/3078
4391 [cargo/3089]: https://github.com/rust-lang/cargo/pull/3089
4392 [cargo/3092]: https://github.com/rust-lang/cargo/pull/3092
4393 [cargo/3110]: https://github.com/rust-lang/cargo/pull/3110
4394 [cargo/3121]: https://github.com/rust-lang/cargo/pull/3121
4395 [cargo/3123]: https://github.com/rust-lang/cargo/pull/3123
4396 [cargo/3125]: https://github.com/rust-lang/cargo/pull/3125
4397 [cargo/3136]: https://github.com/rust-lang/cargo/pull/3136
4398 [cargo/3144]: https://github.com/rust-lang/cargo/pull/3144
4399 [cargo/3146]: https://github.com/rust-lang/cargo/pull/3146
4400 [cargo/3157]: https://github.com/rust-lang/cargo/pull/3157
4401 [cargo/3162]: https://github.com/rust-lang/cargo/pull/3162
4402 [cargo/3205]: https://github.com/rust-lang/cargo/pull/3205
4403 [cargo/3241]: https://github.com/rust-lang/cargo/pull/3241
4404 [cargo/3242]: https://github.com/rust-lang/cargo/pull/3242
4405 [rustup]: https://www.rustup.rs
4406 [`checked_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.checked_abs
4407 [`wrapping_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.wrapping_abs
4408 [`overflowing_abs`]: https://doc.rust-lang.org/std/primitive.i32.html#method.overflowing_abs
4409 [`RefCell::try_borrow`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow
4410 [`RefCell::try_borrow_mut`]: https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.try_borrow_mut
4411 [`SipHasher`]: https://doc.rust-lang.org/std/hash/struct.SipHasher.html
4412 [`DefaultHasher`]: https://doc.rust-lang.org/std/collections/hash_map/struct.DefaultHasher.html
4413
4414
4415 Version 1.12.1 (2016-10-20)
4416 ===========================
4417
4418 Regression Fixes
4419 ----------------
4420
4421 * [ICE: 'rustc' panicked at 'assertion failed: concrete_substs.is_normalized_for_trans()' #36381][36381]
4422 * [Confusion with double negation and booleans][36856]
4423 * [rustc 1.12.0 fails with SIGSEGV in release mode (syn crate 0.8.0)][36875]
4424 * [Rustc 1.12.0 Windows build of `ethcore` crate fails with LLVM error][36924]
4425 * [1.12.0: High memory usage when linking in release mode with debug info][36926]
4426 * [Corrupted memory after updated to 1.12][36936]
4427 * ["Let NullaryConstructor = something;" causes internal compiler error: "tried to overwrite interned AdtDef"][37026]
4428 * [Fix ICE: inject bitcast if types mismatch for invokes/calls/stores][37112]
4429 * [debuginfo: Handle spread_arg case in MIR-trans in a more stable way.][37153]
4430
4431 [36381]: https://github.com/rust-lang/rust/issues/36381
4432 [36856]: https://github.com/rust-lang/rust/issues/36856
4433 [36875]: https://github.com/rust-lang/rust/issues/36875
4434 [36924]: https://github.com/rust-lang/rust/issues/36924
4435 [36926]: https://github.com/rust-lang/rust/issues/36926
4436 [36936]: https://github.com/rust-lang/rust/issues/36936
4437 [37026]: https://github.com/rust-lang/rust/issues/37026
4438 [37112]: https://github.com/rust-lang/rust/issues/37112
4439 [37153]: https://github.com/rust-lang/rust/issues/37153
4440
4441
4442 Version 1.12.0 (2016-09-29)
4443 ===========================
4444
4445 Highlights
4446 ----------
4447
4448 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4449   This translation pass is far simpler than the previous AST->LLVM pass, and
4450   creates opportunities to perform new optimizations directly on the MIR. It
4451   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4452 * [`rustc` presents a new, more readable error format, along with
4453   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4454   Most common editors supporting Rust have been updated to work with it. It was
4455   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4456
4457 Compiler
4458 --------
4459
4460 * [`rustc` translates code to LLVM IR via its own "middle" IR (MIR)](https://github.com/rust-lang/rust/pull/34096).
4461   This translation pass is far simpler than the previous AST->LLVM pass, and
4462   creates opportunities to perform new optimizations directly on the MIR. It
4463   was previously described [on the Rust blog](https://blog.rust-lang.org/2016/04/19/MIR.html).
4464 * [Print the Rust target name, not the LLVM target name, with
4465   `--print target-list`](https://github.com/rust-lang/rust/pull/35489)
4466 * [The computation of `TypeId` is correct in some cases where it was previously
4467   producing inconsistent results](https://github.com/rust-lang/rust/pull/35267)
4468 * [The `mips-unknown-linux-gnu` target uses hardware floating point by default](https://github.com/rust-lang/rust/pull/34910)
4469 * [The `rustc` arguments, `--print target-cpus`, `--print target-features`,
4470   `--print relocation-models`, and `--print code-models` print the available
4471   options to the `-C target-cpu`, `-C target-feature`, `-C relocation-model` and
4472   `-C code-model` code generation arguments](https://github.com/rust-lang/rust/pull/34845)
4473 * [`rustc` supports three new MUSL targets on ARM: `arm-unknown-linux-musleabi`,
4474   `arm-unknown-linux-musleabihf`, and `armv7-unknown-linux-musleabihf`](https://github.com/rust-lang/rust/pull/35060).
4475   These targets produce statically-linked binaries. There are no binary release
4476   builds yet though.
4477
4478 Diagnostics
4479 -----------
4480
4481 * [`rustc` presents a new, more readable error format, along with
4482   machine-readable JSON error output for use by IDEs](https://github.com/rust-lang/rust/pull/35401).
4483   Most common editors supporting Rust have been updated to work with it. It was
4484   previously described [on the Rust blog](https://blog.rust-lang.org/2016/08/10/Shape-of-errors-to-come.html).
4485 * [In error descriptions, references are now described in plain English,
4486   instead of as "&-ptr"](https://github.com/rust-lang/rust/pull/35611)
4487 * [In error type descriptions, unknown numeric types are named `{integer}` or
4488   `{float}` instead of `_`](https://github.com/rust-lang/rust/pull/35080)
4489 * [`rustc` emits a clearer error when inner attributes follow a doc comment](https://github.com/rust-lang/rust/pull/34676)
4490
4491 Language
4492 --------
4493
4494 * [`macro_rules!` invocations can be made within `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34925)
4495 * [`macro_rules!` meta-variables are hygienic](https://github.com/rust-lang/rust/pull/35453)
4496 * [`macro_rules!` `tt` matchers can be reparsed correctly, making them much more
4497   useful](https://github.com/rust-lang/rust/pull/34908)
4498 * [`macro_rules!` `stmt` matchers correctly consume the entire contents when
4499   inside non-braces invocations](https://github.com/rust-lang/rust/pull/34886)
4500 * [Semicolons are properly required as statement delimiters inside
4501   `macro_rules!` invocations](https://github.com/rust-lang/rust/pull/34660)
4502 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4503
4504 Stabilized APIs
4505 ---------------
4506
4507 * [`Cell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.as_ptr)
4508 * [`RefCell::as_ptr`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.as_ptr)
4509 * [`IpAddr::is_unspecified`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_unspecified)
4510 * [`IpAddr::is_loopback`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_loopback)
4511 * [`IpAddr::is_multicast`](https://doc.rust-lang.org/std/net/enum.IpAddr.html#method.is_multicast)
4512 * [`Ipv4Addr::is_unspecified`](https://doc.rust-lang.org/std/net/struct.Ipv4Addr.html#method.is_unspecified)
4513 * [`Ipv6Addr::octets`](https://doc.rust-lang.org/std/net/struct.Ipv6Addr.html#method.octets)
4514 * [`LinkedList::contains`](https://doc.rust-lang.org/std/collections/linked_list/struct.LinkedList.html#method.contains)
4515 * [`VecDeque::contains`](https://doc.rust-lang.org/std/collections/vec_deque/struct.VecDeque.html#method.contains)
4516 * [`ExitStatusExt::from_raw`](https://doc.rust-lang.org/std/os/unix/process/trait.ExitStatusExt.html#tymethod.from_raw).
4517   Both on Unix and Windows.
4518 * [`Receiver::recv_timeout`](https://doc.rust-lang.org/std/sync/mpsc/struct.Receiver.html#method.recv_timeout)
4519 * [`RecvTimeoutError`](https://doc.rust-lang.org/std/sync/mpsc/enum.RecvTimeoutError.html)
4520 * [`BinaryHeap::peek_mut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.peek_mut)
4521 * [`PeekMut`](https://doc.rust-lang.org/std/collections/binary_heap/struct.PeekMut.html)
4522 * [`iter::Product`](https://doc.rust-lang.org/std/iter/trait.Product.html)
4523 * [`iter::Sum`](https://doc.rust-lang.org/std/iter/trait.Sum.html)
4524 * [`OccupiedEntry::remove_entry`](https://doc.rust-lang.org/std/collections/btree_map/struct.OccupiedEntry.html#method.remove_entry)
4525 * [`VacantEntry::into_key`](https://doc.rust-lang.org/std/collections/btree_map/struct.VacantEntry.html#method.into_key)
4526
4527 Libraries
4528 ---------
4529
4530 * [The `format!` macro and friends now allow a single argument to be formatted
4531   in multiple styles](https://github.com/rust-lang/rust/pull/33642)
4532 * [The lifetime bounds on `[T]::binary_search_by` and
4533   `[T]::binary_search_by_key` have been adjusted to be more flexible](https://github.com/rust-lang/rust/pull/34762)
4534 * [`Option` implements `From` for its contained type](https://github.com/rust-lang/rust/pull/34828)
4535 * [`Cell`, `RefCell` and `UnsafeCell` implement `From` for their contained type](https://github.com/rust-lang/rust/pull/35392)
4536 * [`RwLock` panics if the reader count overflows](https://github.com/rust-lang/rust/pull/35378)
4537 * [`vec_deque::Drain`, `hash_map::Drain` and `hash_set::Drain` are covariant](https://github.com/rust-lang/rust/pull/35354)
4538 * [`vec::Drain` and `binary_heap::Drain` are covariant](https://github.com/rust-lang/rust/pull/34951)
4539 * [`Cow<str>` implements `FromIterator` for `char`, `&str` and `String`](https://github.com/rust-lang/rust/pull/35064)
4540 * [Sockets on Linux are correctly closed in subprocesses via `SOCK_CLOEXEC`](https://github.com/rust-lang/rust/pull/34946)
4541 * [`hash_map::Entry`, `hash_map::VacantEntry` and `hash_map::OccupiedEntry`
4542   implement `Debug`](https://github.com/rust-lang/rust/pull/34937)
4543 * [`btree_map::Entry`, `btree_map::VacantEntry` and `btree_map::OccupiedEntry`
4544   implement `Debug`](https://github.com/rust-lang/rust/pull/34885)
4545 * [`String` implements `AddAssign`](https://github.com/rust-lang/rust/pull/34890)
4546 * [Variadic `extern fn` pointers implement the `Clone`, `PartialEq`, `Eq`,
4547   `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and `fmt::Debug` traits](https://github.com/rust-lang/rust/pull/34879)
4548 * [`FileType` implements `Debug`](https://github.com/rust-lang/rust/pull/34757)
4549 * [References to `Mutex` and `RwLock` are unwind-safe](https://github.com/rust-lang/rust/pull/34756)
4550 * [`mpsc::sync_channel` `Receiver`s return any available message before
4551   reporting a disconnect](https://github.com/rust-lang/rust/pull/34731)
4552 * [Unicode definitions have been updated to 9.0](https://github.com/rust-lang/rust/pull/34599)
4553 * [`env` iterators implement `DoubleEndedIterator`](https://github.com/rust-lang/rust/pull/33312)
4554
4555 Cargo
4556 -----
4557
4558 * [Support local mirrors of registries](https://github.com/rust-lang/cargo/pull/2857)
4559 * [Add support for command aliases](https://github.com/rust-lang/cargo/pull/2679)
4560 * [Allow `opt-level="s"` / `opt-level="z"` in profile overrides](https://github.com/rust-lang/cargo/pull/3007)
4561 * [Make `cargo doc --open --target` work as expected](https://github.com/rust-lang/cargo/pull/2988)
4562 * [Speed up noop registry updates](https://github.com/rust-lang/cargo/pull/2974)
4563 * [Update OpenSSL](https://github.com/rust-lang/cargo/pull/2971)
4564 * [Fix `--panic=abort` with plugins](https://github.com/rust-lang/cargo/pull/2954)
4565 * [Always pass `-C metadata` to the compiler](https://github.com/rust-lang/cargo/pull/2946)
4566 * [Fix depending on git repos with workspaces](https://github.com/rust-lang/cargo/pull/2938)
4567 * [Add a `--lib` flag to `cargo new`](https://github.com/rust-lang/cargo/pull/2921)
4568 * [Add `http.cainfo` for custom certs](https://github.com/rust-lang/cargo/pull/2917)
4569 * [Indicate the compilation profile after compiling](https://github.com/rust-lang/cargo/pull/2909)
4570 * [Allow enabling features for dependencies with `--features`](https://github.com/rust-lang/cargo/pull/2876)
4571 * [Add `--jobs` flag to `cargo package`](https://github.com/rust-lang/cargo/pull/2867)
4572 * [Add `--dry-run` to `cargo publish`](https://github.com/rust-lang/cargo/pull/2849)
4573 * [Add support for `RUSTDOCFLAGS`](https://github.com/rust-lang/cargo/pull/2794)
4574
4575 Performance
4576 -----------
4577
4578 * [`panic::catch_unwind` is more optimized](https://github.com/rust-lang/rust/pull/35444)
4579 * [`panic::catch_unwind` no longer accesses thread-local storage on entry](https://github.com/rust-lang/rust/pull/34866)
4580
4581 Tooling
4582 -------
4583
4584 * [Test binaries now support a `--test-threads` argument to specify the number
4585   of threads used to run tests, and which acts the same as the
4586   `RUST_TEST_THREADS` environment variable](https://github.com/rust-lang/rust/pull/35414)
4587 * [The test runner now emits a warning when tests run over 60 seconds](https://github.com/rust-lang/rust/pull/35405)
4588 * [rustdoc: Fix methods in search results](https://github.com/rust-lang/rust/pull/34752)
4589 * [`rust-lldb` warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4590 * [Rust releases now come with source packages that can be installed by rustup
4591   via `rustup component add rust-src`](https://github.com/rust-lang/rust/pull/34366).
4592   The resulting source code can be used by tools and IDES, located in the
4593   sysroot under `lib/rustlib/src`.
4594
4595 Misc
4596 ----
4597
4598 * [The compiler can now be built against LLVM 3.9](https://github.com/rust-lang/rust/pull/35594)
4599 * Many minor improvements to the documentation.
4600 * [The Rust exception handling "personality" routine is now written in Rust](https://github.com/rust-lang/rust/pull/34832)
4601
4602 Compatibility Notes
4603 -------------------
4604
4605 * [When printing Windows `OsStr`s, unpaired surrogate codepoints are escaped
4606   with the lowercase format instead of the uppercase](https://github.com/rust-lang/rust/pull/35084)
4607 * [When formatting strings, if "precision" is specified, the "fill",
4608   "align" and "width" specifiers are no longer ignored](https://github.com/rust-lang/rust/pull/34544)
4609 * [The `Debug` impl for strings no longer escapes all non-ASCII characters](https://github.com/rust-lang/rust/pull/34485)
4610
4611
4612 Version 1.11.0 (2016-08-18)
4613 ===========================
4614
4615 Language
4616 --------
4617
4618 * [`cfg_attr` works on `path` attributes](https://github.com/rust-lang/rust/pull/34546)
4619 * [Support nested `cfg_attr` attributes](https://github.com/rust-lang/rust/pull/34216)
4620 * [Allow statement-generating braced macro invocations at the end of blocks](https://github.com/rust-lang/rust/pull/34436)
4621 * [Macros can be expanded inside of trait definitions](https://github.com/rust-lang/rust/pull/34213)
4622 * [`#[macro_use]` works properly when it is itself expanded from a macro](https://github.com/rust-lang/rust/pull/34032)
4623
4624 Stabilized APIs
4625 ---------------
4626
4627 * [`BinaryHeap::append`](https://doc.rust-lang.org/std/collections/binary_heap/struct.BinaryHeap.html#method.append)
4628 * [`BTreeMap::append`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.append)
4629 * [`BTreeMap::split_off`](https://doc.rust-lang.org/std/collections/btree_map/struct.BTreeMap.html#method.split_off)
4630 * [`BTreeSet::append`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.append)
4631 * [`BTreeSet::split_off`](https://doc.rust-lang.org/std/collections/btree_set/struct.BTreeSet.html#method.split_off)
4632 * [`f32::to_degrees`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_degrees)
4633   (in libcore - previously stabilized in libstd)
4634 * [`f32::to_radians`](https://doc.rust-lang.org/std/primitive.f32.html#method.to_radians)
4635   (in libcore - previously stabilized in libstd)
4636 * [`f64::to_degrees`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_degrees)
4637   (in libcore - previously stabilized in libstd)
4638 * [`f64::to_radians`](https://doc.rust-lang.org/std/primitive.f64.html#method.to_radians)
4639   (in libcore - previously stabilized in libstd)
4640 * [`Iterator::sum`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4641 * [`Iterator::product`](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.sum)
4642 * [`Cell::get_mut`](https://doc.rust-lang.org/std/cell/struct.Cell.html#method.get_mut)
4643 * [`RefCell::get_mut`](https://doc.rust-lang.org/std/cell/struct.RefCell.html#method.get_mut)
4644
4645 Libraries
4646 ---------
4647
4648 * [The `thread_local!` macro supports multiple definitions in a single
4649    invocation, and can apply attributes](https://github.com/rust-lang/rust/pull/34077)
4650 * [`Cow` implements `Default`](https://github.com/rust-lang/rust/pull/34305)
4651 * [`Wrapping` implements binary, octal, lower-hex and upper-hex
4652   `Display` formatting](https://github.com/rust-lang/rust/pull/34190)
4653 * [The range types implement `Hash`](https://github.com/rust-lang/rust/pull/34180)
4654 * [`lookup_host` ignores unknown address types](https://github.com/rust-lang/rust/pull/34067)
4655 * [`assert_eq!` accepts a custom error message, like `assert!` does](https://github.com/rust-lang/rust/pull/33976)
4656 * [The main thread is now called "main" instead of "&lt;main&gt;"](https://github.com/rust-lang/rust/pull/33803)
4657
4658 Cargo
4659 -----
4660
4661 * [Disallow specifying features of transitive deps](https://github.com/rust-lang/cargo/pull/2821)
4662 * [Add color support for Windows consoles](https://github.com/rust-lang/cargo/pull/2804)
4663 * [Fix `harness = false` on `[lib]` sections](https://github.com/rust-lang/cargo/pull/2795)
4664 * [Don't panic when `links` contains a '.'](https://github.com/rust-lang/cargo/pull/2787)
4665 * [Build scripts can emit warnings](https://github.com/rust-lang/cargo/pull/2630),
4666   and `-vv` prints warnings for all crates.
4667 * [Ignore file locks on OS X NFS mounts](https://github.com/rust-lang/cargo/pull/2720)
4668 * [Don't warn about `package.metadata` keys](https://github.com/rust-lang/cargo/pull/2668).
4669   This provides room for expansion by arbitrary tools.
4670 * [Add support for cdylib crate types](https://github.com/rust-lang/cargo/pull/2741)
4671 * [Prevent publishing crates when files are dirty](https://github.com/rust-lang/cargo/pull/2781)
4672 * [Don't fetch all crates on clean](https://github.com/rust-lang/cargo/pull/2704)
4673 * [Propagate --color option to rustc](https://github.com/rust-lang/cargo/pull/2779)
4674 * [Fix `cargo doc --open` on Windows](https://github.com/rust-lang/cargo/pull/2780)
4675 * [Improve autocompletion](https://github.com/rust-lang/cargo/pull/2772)
4676 * [Configure colors of stderr as well as stdout](https://github.com/rust-lang/cargo/pull/2739)
4677
4678 Performance
4679 -----------
4680
4681 * [Caching projections speeds up type check dramatically for some
4682   workloads](https://github.com/rust-lang/rust/pull/33816)
4683 * [The default `HashMap` hasher is SipHash 1-3 instead of SipHash 2-4](https://github.com/rust-lang/rust/pull/33940)
4684   This hasher is faster, but is believed to provide sufficient
4685   protection from collision attacks.
4686 * [Comparison of `Ipv4Addr` is 10x faster](https://github.com/rust-lang/rust/pull/33891)
4687
4688 Rustdoc
4689 -------
4690
4691 * [Fix empty implementation section on some module pages](https://github.com/rust-lang/rust/pull/34536)
4692 * [Fix inlined renamed re-exports in import lists](https://github.com/rust-lang/rust/pull/34479)
4693 * [Fix search result layout for enum variants and struct fields](https://github.com/rust-lang/rust/pull/34477)
4694 * [Fix issues with source links to external crates](https://github.com/rust-lang/rust/pull/34387)
4695 * [Fix redirect pages for renamed re-exports](https://github.com/rust-lang/rust/pull/34245)
4696
4697 Tooling
4698 -------
4699
4700 * [rustc is better at finding the MSVC toolchain](https://github.com/rust-lang/rust/pull/34492)
4701 * [When emitting debug info, rustc emits frame pointers for closures,
4702   shims and glue, as it does for all other functions](https://github.com/rust-lang/rust/pull/33909)
4703 * [rust-lldb warns about unsupported versions of LLDB](https://github.com/rust-lang/rust/pull/34646)
4704 * Many more errors have been given error codes and extended
4705   explanations
4706 * API documentation continues to be improved, with many new examples
4707
4708 Misc
4709 ----
4710
4711 * [rustc no longer hangs when dependencies recursively re-export
4712   submodules](https://github.com/rust-lang/rust/pull/34542)
4713 * [rustc requires LLVM 3.7+](https://github.com/rust-lang/rust/pull/34104)
4714 * [The 'How Safe and Unsafe Interact' chapter of The Rustonomicon was
4715   rewritten](https://github.com/rust-lang/rust/pull/33895)
4716 * [rustc support 16-bit pointer sizes](https://github.com/rust-lang/rust/pull/33460).
4717   No targets use this yet, but it works toward AVR support.
4718
4719 Compatibility Notes
4720 -------------------
4721
4722 * [`const`s and `static`s may not have unsized types](https://github.com/rust-lang/rust/pull/34443)
4723 * [The new follow-set rules that place restrictions on `macro_rules!`
4724   in order to ensure syntax forward-compatibility have been enabled](https://github.com/rust-lang/rust/pull/33982)
4725   This was an [amendment to RFC 550](https://github.com/rust-lang/rfcs/pull/1384),
4726   and has been a warning since 1.10.
4727 * [`cfg` attribute process has been refactored to fix various bugs](https://github.com/rust-lang/rust/pull/33706).
4728   This causes breakage in some corner cases.
4729
4730
4731 Version 1.10.0 (2016-07-07)
4732 ===========================
4733
4734 Language
4735 --------
4736
4737 * [Allow `concat_idents!` in type positions as well as in expression
4738   positions](https://github.com/rust-lang/rust/pull/33735).
4739 * [`Copy` types are required to have a trivial implementation of `Clone`](https://github.com/rust-lang/rust/pull/33420).
4740   [RFC 1521](https://github.com/rust-lang/rfcs/blob/master/text/1521-copy-clone-semantics.md).
4741 * [Single-variant enums support the `#[repr(..)]` attribute](https://github.com/rust-lang/rust/pull/33355).
4742 * [Fix `#[derive(RustcEncodable)]` in the presence of other `encode` methods](https://github.com/rust-lang/rust/pull/32908).
4743 * [`panic!` can be converted to a runtime abort with the
4744   `-C panic=abort` flag](https://github.com/rust-lang/rust/pull/32900).
4745   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4746 * [Add a new crate type, 'cdylib'](https://github.com/rust-lang/rust/pull/33553).
4747   cdylibs are dynamic libraries suitable for loading by non-Rust hosts.
4748   [RFC 1510](https://github.com/rust-lang/rfcs/blob/master/text/1510-cdylib.md).
4749   Note that Cargo does not yet directly support cdylibs.
4750
4751 Stabilized APIs
4752 ---------------
4753
4754 * `os::windows::fs::OpenOptionsExt::access_mode`
4755 * `os::windows::fs::OpenOptionsExt::share_mode`
4756 * `os::windows::fs::OpenOptionsExt::custom_flags`
4757 * `os::windows::fs::OpenOptionsExt::attributes`
4758 * `os::windows::fs::OpenOptionsExt::security_qos_flags`
4759 * `os::unix::fs::OpenOptionsExt::custom_flags`
4760 * [`sync::Weak::new`](http://doc.rust-lang.org/alloc/arc/struct.Weak.html#method.new)
4761 * `Default for sync::Weak`
4762 * [`panic::set_hook`](http://doc.rust-lang.org/std/panic/fn.set_hook.html)
4763 * [`panic::take_hook`](http://doc.rust-lang.org/std/panic/fn.take_hook.html)
4764 * [`panic::PanicInfo`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html)
4765 * [`panic::PanicInfo::payload`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.payload)
4766 * [`panic::PanicInfo::location`](http://doc.rust-lang.org/std/panic/struct.PanicInfo.html#method.location)
4767 * [`panic::Location`](http://doc.rust-lang.org/std/panic/struct.Location.html)
4768 * [`panic::Location::file`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.file)
4769 * [`panic::Location::line`](http://doc.rust-lang.org/std/panic/struct.Location.html#method.line)
4770 * [`ffi::CStr::from_bytes_with_nul`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul)
4771 * [`ffi::CStr::from_bytes_with_nul_unchecked`](http://doc.rust-lang.org/std/ffi/struct.CStr.html#method.from_bytes_with_nul_unchecked)
4772 * [`ffi::FromBytesWithNulError`](http://doc.rust-lang.org/std/ffi/struct.FromBytesWithNulError.html)
4773 * [`fs::Metadata::modified`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.modified)
4774 * [`fs::Metadata::accessed`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.accessed)
4775 * [`fs::Metadata::created`](http://doc.rust-lang.org/std/fs/struct.Metadata.html#method.created)
4776 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange`
4777 * `sync::atomic::Atomic{Usize,Isize,Bool,Ptr}::compare_exchange_weak`
4778 * `collections::{btree,hash}_map::{Occupied,Vacant,}Entry::key`
4779 * `os::unix::net::{UnixStream, UnixListener, UnixDatagram, SocketAddr}`
4780 * [`SocketAddr::is_unnamed`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.is_unnamed)
4781 * [`SocketAddr::as_pathname`](http://doc.rust-lang.org/std/os/unix/net/struct.SocketAddr.html#method.as_pathname)
4782 * [`UnixStream::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.connect)
4783 * [`UnixStream::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.pair)
4784 * [`UnixStream::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.try_clone)
4785 * [`UnixStream::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.local_addr)
4786 * [`UnixStream::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.peer_addr)
4787 * [`UnixStream::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4788 * [`UnixStream::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4789 * [`UnixStream::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.read_timeout)
4790 * [`UnixStream::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.write_timeout)
4791 * [`UnixStream::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.set_nonblocking)
4792 * [`UnixStream::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.take_error)
4793 * [`UnixStream::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixStream.html#method.shutdown)
4794 * Read/Write/RawFd impls for `UnixStream`
4795 * [`UnixListener::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.bind)
4796 * [`UnixListener::accept`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.accept)
4797 * [`UnixListener::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.try_clone)
4798 * [`UnixListener::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.local_addr)
4799 * [`UnixListener::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.set_nonblocking)
4800 * [`UnixListener::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.take_error)
4801 * [`UnixListener::incoming`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixListener.html#method.incoming)
4802 * RawFd impls for `UnixListener`
4803 * [`UnixDatagram::bind`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.bind)
4804 * [`UnixDatagram::unbound`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.unbound)
4805 * [`UnixDatagram::pair`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.pair)
4806 * [`UnixDatagram::connect`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.connect)
4807 * [`UnixDatagram::try_clone`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.try_clone)
4808 * [`UnixDatagram::local_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.local_addr)
4809 * [`UnixDatagram::peer_addr`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.peer_addr)
4810 * [`UnixDatagram::recv_from`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv_from)
4811 * [`UnixDatagram::recv`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.recv)
4812 * [`UnixDatagram::send_to`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send_to)
4813 * [`UnixDatagram::send`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.send)
4814 * [`UnixDatagram::set_read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_read_timeout)
4815 * [`UnixDatagram::set_write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_write_timeout)
4816 * [`UnixDatagram::read_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.read_timeout)
4817 * [`UnixDatagram::write_timeout`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.write_timeout)
4818 * [`UnixDatagram::set_nonblocking`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.set_nonblocking)
4819 * [`UnixDatagram::take_error`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.take_error)
4820 * [`UnixDatagram::shutdown`](http://doc.rust-lang.org/std/os/unix/net/struct.UnixDatagram.html#method.shutdown)
4821 * RawFd impls for `UnixDatagram`
4822 * `{BTree,Hash}Map::values_mut`
4823 * [`<[_]>::binary_search_by_key`](http://doc.rust-lang.org/std/primitive.slice.html#method.binary_search_by_key)
4824
4825 Libraries
4826 ---------
4827
4828 * [The `abs_sub` method of floats is deprecated](https://github.com/rust-lang/rust/pull/33664).
4829   The semantics of this minor method are subtle and probably not what
4830   most people want.
4831 * [Add implementation of Ord for Cell<T> and RefCell<T> where T: Ord](https://github.com/rust-lang/rust/pull/33306).
4832 * [On Linux, if `HashMap`s can't be initialized with `getrandom` they
4833   will fall back to `/dev/urandom` temporarily to avoid blocking
4834   during early boot](https://github.com/rust-lang/rust/pull/33086).
4835 * [Implemented negation for wrapping numerals](https://github.com/rust-lang/rust/pull/33067).
4836 * [Implement `Clone` for `binary_heap::IntoIter`](https://github.com/rust-lang/rust/pull/33050).
4837 * [Implement `Display` and `Hash` for `std::num::Wrapping`](https://github.com/rust-lang/rust/pull/33023).
4838 * [Add `Default` implementation for `&CStr`, `CString`](https://github.com/rust-lang/rust/pull/32990).
4839 * [Implement `From<Vec<T>>` and `Into<Vec<T>>` for `VecDeque<T>`](https://github.com/rust-lang/rust/pull/32866).
4840 * [Implement `Default` for `UnsafeCell`, `fmt::Error`, `Condvar`,
4841   `Mutex`, `RwLock`](https://github.com/rust-lang/rust/pull/32785).
4842
4843 Cargo
4844 -----
4845 * [Cargo.toml supports the `profile.*.panic` option](https://github.com/rust-lang/cargo/pull/2687).
4846   This controls the runtime behavior of the `panic!` macro
4847   and can be either "unwind" (the default), or "abort".
4848   [RFC 1513](https://github.com/rust-lang/rfcs/blob/master/text/1513-less-unwinding.md).
4849 * [Don't throw away errors with `-p` arguments](https://github.com/rust-lang/cargo/pull/2723).
4850 * [Report status to stderr instead of stdout](https://github.com/rust-lang/cargo/pull/2693).
4851 * [Build scripts are passed a `CARGO_MANIFEST_LINKS` environment
4852   variable that corresponds to the `links` field of the manifest](https://github.com/rust-lang/cargo/pull/2710).
4853 * [Ban keywords from crate names](https://github.com/rust-lang/cargo/pull/2707).
4854 * [Canonicalize `CARGO_HOME` on Windows](https://github.com/rust-lang/cargo/pull/2604).
4855 * [Retry network requests](https://github.com/rust-lang/cargo/pull/2396).
4856   By default they are retried twice, which can be customized with the
4857   `net.retry` value in `.cargo/config`.
4858 * [Don't print extra error info for failing subcommands](https://github.com/rust-lang/cargo/pull/2674).
4859 * [Add `--force` flag to `cargo install`](https://github.com/rust-lang/cargo/pull/2405).
4860 * [Don't use `flock` on NFS mounts](https://github.com/rust-lang/cargo/pull/2623).
4861 * [Prefer building `cargo install` artifacts in temporary directories](https://github.com/rust-lang/cargo/pull/2610).
4862   Makes it possible to install multiple crates in parallel.
4863 * [Add `cargo test --doc`](https://github.com/rust-lang/cargo/pull/2578).
4864 * [Add `cargo --explain`](https://github.com/rust-lang/cargo/pull/2551).
4865 * [Don't print warnings when `-q` is passed](https://github.com/rust-lang/cargo/pull/2576).
4866 * [Add `cargo doc --lib` and `--bin`](https://github.com/rust-lang/cargo/pull/2577).
4867 * [Don't require build script output to be UTF-8](https://github.com/rust-lang/cargo/pull/2560).
4868 * [Correctly attempt multiple git usernames](https://github.com/rust-lang/cargo/pull/2584).
4869
4870 Performance
4871 -----------
4872
4873 * [rustc memory usage was reduced by refactoring the context used for
4874   type checking](https://github.com/rust-lang/rust/pull/33425).
4875 * [Speed up creation of `HashMap`s by caching the random keys used
4876   to initialize the hash state](https://github.com/rust-lang/rust/pull/33318).
4877 * [The `find` implementation for `Chain` iterators is 2x faster](https://github.com/rust-lang/rust/pull/33289).
4878 * [Trait selection optimizations speed up type checking by 15%](https://github.com/rust-lang/rust/pull/33138).
4879 * [Efficient trie lookup for boolean Unicode properties](https://github.com/rust-lang/rust/pull/33098).
4880   10x faster than the previous lookup tables.
4881 * [Special case `#[derive(Copy, Clone)]` to avoid bloat](https://github.com/rust-lang/rust/pull/31414).
4882
4883 Usability
4884 ---------
4885
4886 * Many incremental improvements to documentation and rustdoc.
4887 * [rustdoc: List blanket trait impls](https://github.com/rust-lang/rust/pull/33514).
4888 * [rustdoc: Clean up ABI rendering](https://github.com/rust-lang/rust/pull/33151).
4889 * [Indexing with the wrong type produces a more informative error](https://github.com/rust-lang/rust/pull/33401).
4890 * [Improve diagnostics for constants being used in irrefutable patterns](https://github.com/rust-lang/rust/pull/33406).
4891 * [When many method candidates are in scope limit the suggestions to 10](https://github.com/rust-lang/rust/pull/33338).
4892 * [Remove confusing suggestion when calling a `fn` type](https://github.com/rust-lang/rust/pull/33325).
4893 * [Do not suggest changing `&mut self` to `&mut mut self`](https://github.com/rust-lang/rust/pull/33319).
4894
4895 Misc
4896 ----
4897
4898 * [Update i686-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33651).
4899 * [Update aarch64-linux-android features to match Android ABI](https://github.com/rust-lang/rust/pull/33500).
4900 * [`std` no longer prints backtraces on platforms where the running
4901   module must be loaded with `env::current_exe`, which can't be relied
4902   on](https://github.com/rust-lang/rust/pull/33554).
4903 * This release includes std binaries for the i586-unknown-linux-gnu,
4904   i686-unknown-linux-musl, and armv7-linux-androideabi targets. The
4905   i586 target is for old x86 hardware without SSE2, and the armv7
4906   target is for Android running on modern ARM architectures.
4907 * [The `rust-gdb` and `rust-lldb` scripts are distributed on all
4908   Unix platforms](https://github.com/rust-lang/rust/pull/32835).
4909 * [On Unix the runtime aborts by calling `libc::abort` instead of
4910   generating an illegal instruction](https://github.com/rust-lang/rust/pull/31457).
4911 * [Rust is now bootstrapped from the previous release of Rust,
4912   instead of a snapshot from an arbitrary commit](https://github.com/rust-lang/rust/pull/32942).
4913
4914 Compatibility Notes
4915 -------------------
4916
4917 * [`AtomicBool` is now bool-sized, not word-sized](https://github.com/rust-lang/rust/pull/33579).
4918 * [`target_env` for Linux ARM targets is just `gnu`, not
4919   `gnueabihf`, `gnueabi`, etc](https://github.com/rust-lang/rust/pull/33403).
4920 * [Consistently panic on overflow in `Duration::new`](https://github.com/rust-lang/rust/pull/33072).
4921 * [Change `String::truncate` to panic less](https://github.com/rust-lang/rust/pull/32977).
4922 * [Add `:block` to the follow set for `:ty` and `:path`](https://github.com/rust-lang/rust/pull/32945).
4923   Affects how macros are parsed.
4924 * [Fix macro hygiene bug](https://github.com/rust-lang/rust/pull/32923).
4925 * [Feature-gated attributes on macro-generated macro invocations are
4926   now rejected](https://github.com/rust-lang/rust/pull/32791).
4927 * [Suppress fallback and ambiguity errors during type inference](https://github.com/rust-lang/rust/pull/32258).
4928   This caused some minor changes to type inference.
4929
4930
4931 Version 1.9.0 (2016-05-26)
4932 ==========================
4933
4934 Language
4935 --------
4936
4937 * The `#[deprecated]` attribute when applied to an API will generate
4938   warnings when used. The warnings may be suppressed with
4939   `#[allow(deprecated)]`. [RFC 1270].
4940 * [`fn` item types are zero sized, and each `fn` names a unique
4941   type][1.9fn]. This will break code that transmutes `fn`s, so calling
4942   `transmute` on a `fn` type will generate a warning for a few cycles,
4943   then will be converted to an error.
4944 * [Field and method resolution understand visibility, so private
4945   fields and methods cannot prevent the proper use of public fields
4946   and methods][1.9fv].
4947 * [The parser considers unicode codepoints in the
4948   `PATTERN_WHITE_SPACE` category to be whitespace][1.9ws].
4949
4950 Stabilized APIs
4951 ---------------
4952
4953 * [`std::panic`]
4954 * [`std::panic::catch_unwind`][] (renamed from `recover`)
4955 * [`std::panic::resume_unwind`][] (renamed from `propagate`)
4956 * [`std::panic::AssertUnwindSafe`][] (renamed from `AssertRecoverSafe`)
4957 * [`std::panic::UnwindSafe`][] (renamed from `RecoverSafe`)
4958 * [`str::is_char_boundary`]
4959 * [`<*const T>::as_ref`]
4960 * [`<*mut T>::as_ref`]
4961 * [`<*mut T>::as_mut`]
4962 * [`AsciiExt::make_ascii_uppercase`]
4963 * [`AsciiExt::make_ascii_lowercase`]
4964 * [`char::decode_utf16`]
4965 * [`char::DecodeUtf16`]
4966 * [`char::DecodeUtf16Error`]
4967 * [`char::DecodeUtf16Error::unpaired_surrogate`]
4968 * [`BTreeSet::take`]
4969 * [`BTreeSet::replace`]
4970 * [`BTreeSet::get`]
4971 * [`HashSet::take`]
4972 * [`HashSet::replace`]
4973 * [`HashSet::get`]
4974 * [`OsString::with_capacity`]
4975 * [`OsString::clear`]
4976 * [`OsString::capacity`]
4977 * [`OsString::reserve`]
4978 * [`OsString::reserve_exact`]
4979 * [`OsStr::is_empty`]
4980 * [`OsStr::len`]
4981 * [`std::os::unix::thread`]
4982 * [`RawPthread`]
4983 * [`JoinHandleExt`]
4984 * [`JoinHandleExt::as_pthread_t`]
4985 * [`JoinHandleExt::into_pthread_t`]
4986 * [`HashSet::hasher`]
4987 * [`HashMap::hasher`]
4988 * [`CommandExt::exec`]
4989 * [`File::try_clone`]
4990 * [`SocketAddr::set_ip`]
4991 * [`SocketAddr::set_port`]
4992 * [`SocketAddrV4::set_ip`]
4993 * [`SocketAddrV4::set_port`]
4994 * [`SocketAddrV6::set_ip`]
4995 * [`SocketAddrV6::set_port`]
4996 * [`SocketAddrV6::set_flowinfo`]
4997 * [`SocketAddrV6::set_scope_id`]
4998 * [`slice::copy_from_slice`]
4999 * [`ptr::read_volatile`]
5000 * [`ptr::write_volatile`]
5001 * [`OpenOptions::create_new`]
5002 * [`TcpStream::set_nodelay`]
5003 * [`TcpStream::nodelay`]
5004 * [`TcpStream::set_ttl`]
5005 * [`TcpStream::ttl`]
5006 * [`TcpStream::set_only_v6`]
5007 * [`TcpStream::only_v6`]
5008 * [`TcpStream::take_error`]
5009 * [`TcpStream::set_nonblocking`]
5010 * [`TcpListener::set_ttl`]
5011 * [`TcpListener::ttl`]
5012 * [`TcpListener::set_only_v6`]
5013 * [`TcpListener::only_v6`]
5014 * [`TcpListener::take_error`]
5015 * [`TcpListener::set_nonblocking`]
5016 * [`UdpSocket::set_broadcast`]
5017 * [`UdpSocket::broadcast`]
5018 * [`UdpSocket::set_multicast_loop_v4`]
5019 * [`UdpSocket::multicast_loop_v4`]
5020 * [`UdpSocket::set_multicast_ttl_v4`]
5021 * [`UdpSocket::multicast_ttl_v4`]
5022 * [`UdpSocket::set_multicast_loop_v6`]
5023 * [`UdpSocket::multicast_loop_v6`]
5024 * [`UdpSocket::set_multicast_ttl_v6`]
5025 * [`UdpSocket::multicast_ttl_v6`]
5026 * [`UdpSocket::set_ttl`]
5027 * [`UdpSocket::ttl`]
5028 * [`UdpSocket::set_only_v6`]
5029 * [`UdpSocket::only_v6`]
5030 * [`UdpSocket::join_multicast_v4`]
5031 * [`UdpSocket::join_multicast_v6`]
5032 * [`UdpSocket::leave_multicast_v4`]
5033 * [`UdpSocket::leave_multicast_v6`]
5034 * [`UdpSocket::take_error`]
5035 * [`UdpSocket::connect`]
5036 * [`UdpSocket::send`]
5037 * [`UdpSocket::recv`]
5038 * [`UdpSocket::set_nonblocking`]
5039
5040 Libraries
5041 ---------
5042
5043 * [`std::sync::Once` is poisoned if its initialization function
5044   fails][1.9o].
5045 * [`cell::Ref` and `cell::RefMut` can contain unsized types][1.9cu].
5046 * [Most types implement `fmt::Debug`][1.9db].
5047 * [The default buffer size used by `BufReader` and `BufWriter` was
5048   reduced to 8K, from 64K][1.9bf]. This is in line with the buffer size
5049   used by other languages.
5050 * [`Instant`, `SystemTime` and `Duration` implement `+=` and `-=`.
5051   `Duration` additionally implements `*=` and `/=`][1.9ta].
5052 * [`Skip` is a `DoubleEndedIterator`][1.9sk].
5053 * [`From<[u8; 4]>` is implemented for `Ipv4Addr`][1.9fi].
5054 * [`Chain` implements `BufRead`][1.9ch].
5055 * [`HashMap`, `HashSet` and iterators are covariant][1.9hc].
5056
5057 Cargo
5058 -----
5059
5060 * [Cargo can now run concurrently][1.9cc].
5061 * [Top-level overrides allow specific revisions of crates to be
5062   overridden through the entire crate graph][1.9ct].  This is intended
5063   to make upgrades easier for large projects, by allowing crates to be
5064   forked temporarily until they've been upgraded and republished.
5065 * [Cargo exports a `CARGO_PKG_AUTHORS` environment variable][1.9cp].
5066 * [Cargo will pass the contents of the `RUSTFLAGS` variable to `rustc`
5067   on the commandline][1.9cf]. `rustc` arguments can also be specified
5068   in the `build.rustflags` configuration key.
5069
5070 Performance
5071 -----------
5072
5073 * [The time complexity of comparing variables for equivalence during type
5074   unification is reduced from _O_(_n_!) to _O_(_n_)][1.9tu]. This leads
5075   to major compilation time improvement in some scenarios.
5076 * [`ToString` is specialized for `str`, giving it the same performance
5077   as `to_owned`][1.9ts].
5078 * [Spawning processes with `Command::output` no longer creates extra
5079   threads][1.9sp].
5080 * [`#[derive(PartialEq)]` and `#[derive(PartialOrd)]` emit less code
5081   for C-like enums][1.9cl].
5082
5083 Misc
5084 ----
5085
5086 * [Passing the `--quiet` flag to a test runner will produce
5087   much-abbreviated output][1.9q].
5088 * The Rust Project now publishes std binaries for the
5089   `mips-unknown-linux-musl`, `mipsel-unknown-linux-musl`, and
5090   `i586-pc-windows-msvc` targets.
5091
5092 Compatibility Notes
5093 -------------------
5094
5095 * [`std::sync::Once` is poisoned if its initialization function
5096   fails][1.9o].
5097 * [It is illegal to define methods with the same name in overlapping
5098   inherent `impl` blocks][1.9sn].
5099 * [`fn` item types are zero sized, and each `fn` names a unique
5100   type][1.9fn]. This will break code that transmutes `fn`s, so calling
5101   `transmute` on a `fn` type will generate a warning for a few cycles,
5102   then will be converted to an error.
5103 * [Improvements to const evaluation may trigger new errors when integer
5104   literals are out of range][1.9ce].
5105
5106
5107 [1.9bf]: https://github.com/rust-lang/rust/pull/32695
5108 [1.9cc]: https://github.com/rust-lang/cargo/pull/2486
5109 [1.9ce]: https://github.com/rust-lang/rust/pull/30587
5110 [1.9cf]: https://github.com/rust-lang/cargo/pull/2241
5111 [1.9ch]: https://github.com/rust-lang/rust/pull/32541
5112 [1.9cl]: https://github.com/rust-lang/rust/pull/31977
5113 [1.9cp]: https://github.com/rust-lang/cargo/pull/2465
5114 [1.9ct]: https://github.com/rust-lang/cargo/pull/2385
5115 [1.9cu]: https://github.com/rust-lang/rust/pull/32652
5116 [1.9db]: https://github.com/rust-lang/rust/pull/32054
5117 [1.9fi]: https://github.com/rust-lang/rust/pull/32050
5118 [1.9fn]: https://github.com/rust-lang/rust/pull/31710
5119 [1.9fv]: https://github.com/rust-lang/rust/pull/31938
5120 [1.9hc]: https://github.com/rust-lang/rust/pull/32635
5121 [1.9o]: https://github.com/rust-lang/rust/pull/32325
5122 [1.9q]: https://github.com/rust-lang/rust/pull/31887
5123 [1.9sk]: https://github.com/rust-lang/rust/pull/31700
5124 [1.9sn]: https://github.com/rust-lang/rust/pull/31925
5125 [1.9sp]: https://github.com/rust-lang/rust/pull/31618
5126 [1.9ta]: https://github.com/rust-lang/rust/pull/32448
5127 [1.9ts]: https://github.com/rust-lang/rust/pull/32586
5128 [1.9tu]: https://github.com/rust-lang/rust/pull/32062
5129 [1.9ws]: https://github.com/rust-lang/rust/pull/29734
5130 [RFC 1270]: https://github.com/rust-lang/rfcs/blob/master/text/1270-deprecation.md
5131 [`<*const T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5132 [`<*mut T>::as_mut`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_mut
5133 [`<*mut T>::as_ref`]: http://doc.rust-lang.org/nightly/std/primitive.pointer.html#method.as_ref
5134 [`slice::copy_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.copy_from_slice
5135 [`AsciiExt::make_ascii_lowercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_lowercase
5136 [`AsciiExt::make_ascii_uppercase`]: http://doc.rust-lang.org/nightly/std/ascii/trait.AsciiExt.html#tymethod.make_ascii_uppercase
5137 [`BTreeSet::get`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.get
5138 [`BTreeSet::replace`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.replace
5139 [`BTreeSet::take`]: http://doc.rust-lang.org/nightly/collections/btree/set/struct.BTreeSet.html#method.take
5140 [`CommandExt::exec`]: http://doc.rust-lang.org/nightly/std/os/unix/process/trait.CommandExt.html#tymethod.exec
5141 [`File::try_clone`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html#method.try_clone
5142 [`HashMap::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.hasher
5143 [`HashSet::get`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.get
5144 [`HashSet::hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.hasher
5145 [`HashSet::replace`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.replace
5146 [`HashSet::take`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.take
5147 [`JoinHandleExt::as_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.as_pthread_t
5148 [`JoinHandleExt::into_pthread_t`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html#tymethod.into_pthread_t
5149 [`JoinHandleExt`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/trait.JoinHandleExt.html
5150 [`OpenOptions::create_new`]: http://doc.rust-lang.org/nightly/std/fs/struct.OpenOptions.html#method.create_new
5151 [`OsStr::is_empty`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.is_empty
5152 [`OsStr::len`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsStr.html#method.len
5153 [`OsString::capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.capacity
5154 [`OsString::clear`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.clear
5155 [`OsString::reserve_exact`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve_exact
5156 [`OsString::reserve`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.reserve
5157 [`OsString::with_capacity`]: http://doc.rust-lang.org/nightly/std/ffi/struct.OsString.html#method.with_capacity
5158 [`RawPthread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/type.RawPthread.html
5159 [`SocketAddr::set_ip`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_ip
5160 [`SocketAddr::set_port`]: http://doc.rust-lang.org/nightly/std/net/enum.SocketAddr.html#method.set_port
5161 [`SocketAddrV4::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_ip
5162 [`SocketAddrV4::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV4.html#method.set_port
5163 [`SocketAddrV6::set_flowinfo`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_flowinfo
5164 [`SocketAddrV6::set_ip`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_ip
5165 [`SocketAddrV6::set_port`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_port
5166 [`SocketAddrV6::set_scope_id`]: http://doc.rust-lang.org/nightly/std/net/struct.SocketAddrV6.html#method.set_scope_id
5167 [`TcpListener::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5168 [`TcpListener::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5169 [`TcpListener::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5170 [`TcpListener::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5171 [`TcpListener::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5172 [`TcpListener::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5173 [`TcpStream::nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.nodelay
5174 [`TcpStream::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.only_v6
5175 [`TcpStream::set_nodelay`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nodelay
5176 [`TcpStream::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_nonblocking
5177 [`TcpStream::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_only_v6
5178 [`TcpStream::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_ttl
5179 [`TcpStream::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.take_error
5180 [`TcpStream::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.ttl
5181 [`UdpSocket::broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.broadcast
5182 [`UdpSocket::connect`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.connect
5183 [`UdpSocket::join_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v4
5184 [`UdpSocket::join_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.join_multicast_v6
5185 [`UdpSocket::leave_multicast_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v4
5186 [`UdpSocket::leave_multicast_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.leave_multicast_v6
5187 [`UdpSocket::multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v4
5188 [`UdpSocket::multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_loop_v6
5189 [`UdpSocket::multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v4
5190 [`UdpSocket::multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.multicast_ttl_v6
5191 [`UdpSocket::only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.only_v6
5192 [`UdpSocket::recv`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.recv
5193 [`UdpSocket::send`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.send
5194 [`UdpSocket::set_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_broadcast
5195 [`UdpSocket::set_multicast_loop_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v4
5196 [`UdpSocket::set_multicast_loop_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_loop_v6
5197 [`UdpSocket::set_multicast_ttl_v4`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v4
5198 [`UdpSocket::set_multicast_ttl_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_multicast_ttl_v6
5199 [`UdpSocket::set_nonblocking`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_nonblocking
5200 [`UdpSocket::set_only_v6`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_only_v6
5201 [`UdpSocket::set_ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.set_ttl
5202 [`UdpSocket::take_error`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.take_error
5203 [`UdpSocket::ttl`]: http://doc.rust-lang.org/nightly/std/net/struct.UdpSocket.html#method.ttl
5204 [`char::DecodeUtf16Error::unpaired_surrogate`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html#method.unpaired_surrogate
5205 [`char::DecodeUtf16Error`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16Error.html
5206 [`char::DecodeUtf16`]: http://doc.rust-lang.org/nightly/std/char/struct.DecodeUtf16.html
5207 [`char::decode_utf16`]: http://doc.rust-lang.org/nightly/std/char/fn.decode_utf16.html
5208 [`ptr::read_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.read_volatile.html
5209 [`ptr::write_volatile`]: http://doc.rust-lang.org/nightly/std/ptr/fn.write_volatile.html
5210 [`std::os::unix::thread`]: http://doc.rust-lang.org/nightly/std/os/unix/thread/index.html
5211 [`std::panic::AssertUnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/struct.AssertUnwindSafe.html
5212 [`std::panic::UnwindSafe`]: http://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html
5213 [`std::panic::catch_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.catch_unwind.html
5214 [`std::panic::resume_unwind`]: http://doc.rust-lang.org/nightly/std/panic/fn.resume_unwind.html
5215 [`std::panic`]: http://doc.rust-lang.org/nightly/std/panic/index.html
5216 [`str::is_char_boundary`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.is_char_boundary
5217
5218
5219 Version 1.8.0 (2016-04-14)
5220 ==========================
5221
5222 Language
5223 --------
5224
5225 * Rust supports overloading of compound assignment statements like
5226   `+=` by implementing the [`AddAssign`], [`SubAssign`],
5227   [`MulAssign`], [`DivAssign`], [`RemAssign`], [`BitAndAssign`],
5228   [`BitOrAssign`], [`BitXorAssign`], [`ShlAssign`], or [`ShrAssign`]
5229   traits. [RFC 953].
5230 * Empty structs can be defined with braces, as in `struct Foo { }`, in
5231   addition to the non-braced form, `struct Foo;`. [RFC 218].
5232
5233 Libraries
5234 ---------
5235
5236 * Stabilized APIs:
5237   * [`str::encode_utf16`][] (renamed from `utf16_units`)
5238   * [`str::EncodeUtf16`][] (renamed from `Utf16Units`)
5239   * [`Ref::map`]
5240   * [`RefMut::map`]
5241   * [`ptr::drop_in_place`]
5242   * [`time::Instant`]
5243   * [`time::SystemTime`]
5244   * [`Instant::now`]
5245   * [`Instant::duration_since`][] (renamed from `duration_from_earlier`)
5246   * [`Instant::elapsed`]
5247   * [`SystemTime::now`]
5248   * [`SystemTime::duration_since`][] (renamed from `duration_from_earlier`)
5249   * [`SystemTime::elapsed`]
5250   * Various `Add`/`Sub` impls for `Time` and `SystemTime`
5251   * [`SystemTimeError`]
5252   * [`SystemTimeError::duration`]
5253   * Various impls for `SystemTimeError`
5254   * [`UNIX_EPOCH`]
5255   * [`AddAssign`], [`SubAssign`], [`MulAssign`], [`DivAssign`],
5256     [`RemAssign`], [`BitAndAssign`], [`BitOrAssign`],
5257     [`BitXorAssign`], [`ShlAssign`], [`ShrAssign`].
5258 * [The `write!` and `writeln!` macros correctly emit errors if any of
5259   their arguments can't be formatted][1.8w].
5260 * [Various I/O functions support large files on 32-bit Linux][1.8l].
5261 * [The Unix-specific `raw` modules, which contain a number of
5262   redefined C types are deprecated][1.8r], including `os::raw::unix`,
5263   `os::raw::macos`, and `os::raw::linux`. These modules defined types
5264   such as `ino_t` and `dev_t`. The inconsistency of these definitions
5265   across platforms was making it difficult to implement `std`
5266   correctly. Those that need these definitions should use the `libc`
5267   crate. [RFC 1415].
5268 * The Unix-specific `MetadataExt` traits, including
5269   `os::unix::fs::MetadataExt`, which expose values such as inode
5270   numbers [no longer return platform-specific types][1.8r], but
5271   instead return widened integers. [RFC 1415].
5272 * [`btree_set::{IntoIter, Iter, Range}` are covariant][1.8cv].
5273 * [Atomic loads and stores are not volatile][1.8a].
5274 * [All types in `sync::mpsc` implement `fmt::Debug`][1.8mp].
5275
5276 Performance
5277 -----------
5278
5279 * [Inlining hash functions lead to a 3% compile-time improvement in
5280   some workloads][1.8h].
5281 * When using jemalloc, its symbols are [unprefixed so that it
5282   overrides the libc malloc implementation][1.8h]. This means that for
5283   rustc, LLVM is now using jemalloc, which results in a 6%
5284   compile-time improvement on a specific workload.
5285 * [Avoid quadratic growth in function size due to cleanups][1.8cu].
5286
5287 Misc
5288 ----
5289
5290 * [32-bit MSVC builds finally implement unwinding][1.8ms].
5291   i686-pc-windows-msvc is now considered a tier-1 platform.
5292 * [The `--print targets` flag prints a list of supported targets][1.8t].
5293 * [The `--print cfg` flag prints the `cfg`s defined for the current
5294   target][1.8cf].
5295 * [`rustc` can be built with an new Cargo-based build system, written
5296   in Rust][1.8b].  It will eventually replace Rust's Makefile-based
5297   build system. To enable it configure with `configure --rustbuild`.
5298 * [Errors for non-exhaustive `match` patterns now list up to 3 missing
5299   variants while also indicating the total number of missing variants
5300   if more than 3][1.8m].
5301 * [Executable stacks are disabled on Linux and BSD][1.8nx].
5302 * The Rust Project now publishes binary releases of the standard
5303   library for a number of tier-2 targets:
5304   `armv7-unknown-linux-gnueabihf`, `powerpc-unknown-linux-gnu`,
5305   `powerpc64-unknown-linux-gnu`, `powerpc64le-unknown-linux-gnu`
5306   `x86_64-rumprun-netbsd`. These can be installed with
5307   tools such as [multirust][1.8mr].
5308
5309 Cargo
5310 -----
5311
5312 * [`cargo init` creates a new Cargo project in the current
5313   directory][1.8ci].  It is otherwise like `cargo new`.
5314 * [Cargo has configuration keys for `-v` and
5315   `--color`][1.8cc]. `verbose` and `color`, respectively, go in the
5316   `[term]` section of `.cargo/config`.
5317 * [Configuration keys that evaluate to strings or integers can be set
5318   via environment variables][1.8ce]. For example the `build.jobs` key
5319   can be set via `CARGO_BUILD_JOBS`. Environment variables take
5320   precedence over config files.
5321 * [Target-specific dependencies support Rust `cfg` syntax for
5322   describing targets][1.8cfg] so that dependencies for multiple
5323   targets can be specified together. [RFC 1361].
5324 * [The environment variables `CARGO_TARGET_ROOT`, `RUSTC`, and
5325   `RUSTDOC` take precedence over the `build.target-dir`,
5326   `build.rustc`, and `build.rustdoc` configuration values][1.8cv].
5327 * [The child process tree is killed on Windows when Cargo is
5328   killed][1.8ck].
5329 * [The `build.target` configuration value sets the target platform,
5330   like `--target`][1.8ct].
5331
5332 Compatibility Notes
5333 -------------------
5334
5335 * [Unstable compiler flags have been further restricted][1.8u]. Since
5336   1.0 `-Z` flags have been considered unstable, and other flags that
5337   were considered unstable additionally required passing `-Z
5338   unstable-options` to access. Unlike unstable language and library
5339   features though, these options have been accessible on the stable
5340   release channel. Going forward, *new unstable flags will not be
5341   available on the stable release channel*, and old unstable flags
5342   will warn about their usage. In the future, all unstable flags will
5343   be unavailable on the stable release channel.
5344 * [It is no longer possible to `match` on empty enum variants using
5345   the `Variant(..)` syntax][1.8v]. This has been a warning since 1.6.
5346 * The Unix-specific `MetadataExt` traits, including
5347   `os::unix::fs::MetadataExt`, which expose values such as inode
5348   numbers [no longer return platform-specific types][1.8r], but
5349   instead return widened integers. [RFC 1415].
5350 * [Modules sourced from the filesystem cannot appear within arbitrary
5351   blocks, but only within other modules][1.8mf].
5352 * [`--cfg` compiler flags are parsed strictly as identifiers][1.8c].
5353 * On Unix, [stack overflow triggers a runtime abort instead of a
5354   SIGSEGV][1.8so].
5355 * [`Command::spawn` and its equivalents return an error if any of
5356   its command-line arguments contain interior `NUL`s][1.8n].
5357 * [Tuple and unit enum variants from other crates are in the type
5358   namespace][1.8tn].
5359 * [On Windows `rustc` emits `.lib` files for the `staticlib` library
5360   type instead of `.a` files][1.8st]. Additionally, for the MSVC
5361   toolchain, `rustc` emits import libraries named `foo.dll.lib`
5362   instead of `foo.lib`.
5363
5364
5365 [1.8a]: https://github.com/rust-lang/rust/pull/30962
5366 [1.8b]: https://github.com/rust-lang/rust/pull/31123
5367 [1.8c]: https://github.com/rust-lang/rust/pull/31530
5368 [1.8cc]: https://github.com/rust-lang/cargo/pull/2397
5369 [1.8ce]: https://github.com/rust-lang/cargo/pull/2398
5370 [1.8cf]: https://github.com/rust-lang/rust/pull/31278
5371 [1.8cfg]: https://github.com/rust-lang/cargo/pull/2328
5372 [1.8ci]: https://github.com/rust-lang/cargo/pull/2081
5373 [1.8ck]: https://github.com/rust-lang/cargo/pull/2370
5374 [1.8ct]: https://github.com/rust-lang/cargo/pull/2335
5375 [1.8cu]: https://github.com/rust-lang/rust/pull/31390
5376 [1.8cv]: https://github.com/rust-lang/cargo/issues/2365
5377 [1.8cv]: https://github.com/rust-lang/rust/pull/30998
5378 [1.8h]: https://github.com/rust-lang/rust/pull/31460
5379 [1.8l]: https://github.com/rust-lang/rust/pull/31668
5380 [1.8m]: https://github.com/rust-lang/rust/pull/31020
5381 [1.8mf]: https://github.com/rust-lang/rust/pull/31534
5382 [1.8mp]: https://github.com/rust-lang/rust/pull/30894
5383 [1.8mr]: https://users.rust-lang.org/t/multirust-0-8-with-cross-std-installation/4901
5384 [1.8ms]: https://github.com/rust-lang/rust/pull/30448
5385 [1.8n]: https://github.com/rust-lang/rust/pull/31056
5386 [1.8nx]: https://github.com/rust-lang/rust/pull/30859
5387 [1.8r]: https://github.com/rust-lang/rust/pull/31551
5388 [1.8so]: https://github.com/rust-lang/rust/pull/31333
5389 [1.8st]: https://github.com/rust-lang/rust/pull/29520
5390 [1.8t]: https://github.com/rust-lang/rust/pull/31358
5391 [1.8tn]: https://github.com/rust-lang/rust/pull/30882
5392 [1.8u]: https://github.com/rust-lang/rust/pull/31793
5393 [1.8v]: https://github.com/rust-lang/rust/pull/31757
5394 [1.8w]: https://github.com/rust-lang/rust/pull/31904
5395 [RFC 1361]: https://github.com/rust-lang/rfcs/blob/master/text/1361-cargo-cfg-dependencies.md
5396 [RFC 1415]: https://github.com/rust-lang/rfcs/blob/master/text/1415-trim-std-os.md
5397 [RFC 218]: https://github.com/rust-lang/rfcs/blob/master/text/0218-empty-struct-with-braces.md
5398 [RFC 953]: https://github.com/rust-lang/rfcs/blob/master/text/0953-op-assign.md
5399 [`AddAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.AddAssign.html
5400 [`BitAndAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitAndAssign.html
5401 [`BitOrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitOrAssign.html
5402 [`BitXorAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.BitXorAssign.html
5403 [`DivAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.DivAssign.html
5404 [`Instant::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.duration_since
5405 [`Instant::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.elapsed
5406 [`Instant::now`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html#method.now
5407 [`MulAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.MulAssign.html
5408 [`Ref::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.Ref.html#method.map
5409 [`RefMut::map`]: http://doc.rust-lang.org/nightly/std/cell/struct.RefMut.html#method.map
5410 [`RemAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.RemAssign.html
5411 [`ShlAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShlAssign.html
5412 [`ShrAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.ShrAssign.html
5413 [`SubAssign`]: http://doc.rust-lang.org/nightly/std/ops/trait.SubAssign.html
5414 [`SystemTime::duration_since`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.duration_since
5415 [`SystemTime::elapsed`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.elapsed
5416 [`SystemTime::now`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html#method.now
5417 [`SystemTimeError::duration`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html#method.duration
5418 [`SystemTimeError`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTimeError.html
5419 [`UNIX_EPOCH`]: http://doc.rust-lang.org/nightly/std/time/constant.UNIX_EPOCH.html
5420 [`ptr::drop_in_place`]: http://doc.rust-lang.org/nightly/std/ptr/fn.drop_in_place.html
5421 [`str::EncodeUtf16`]: http://doc.rust-lang.org/nightly/std/str/struct.EncodeUtf16.html
5422 [`str::encode_utf16`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.encode_utf16
5423 [`time::Instant`]: http://doc.rust-lang.org/nightly/std/time/struct.Instant.html
5424 [`time::SystemTime`]: http://doc.rust-lang.org/nightly/std/time/struct.SystemTime.html
5425
5426
5427 Version 1.7.0 (2016-03-03)
5428 ==========================
5429
5430 Libraries
5431 ---------
5432
5433 * Stabilized APIs
5434   * `Path`
5435     * [`Path::strip_prefix`][] (renamed from relative_from)
5436     * [`path::StripPrefixError`][] (new error type returned from strip_prefix)
5437   * `Ipv4Addr`
5438     * [`Ipv4Addr::is_loopback`]
5439     * [`Ipv4Addr::is_private`]
5440     * [`Ipv4Addr::is_link_local`]
5441     * [`Ipv4Addr::is_multicast`]
5442     * [`Ipv4Addr::is_broadcast`]
5443     * [`Ipv4Addr::is_documentation`]
5444   * `Ipv6Addr`
5445     * [`Ipv6Addr::is_unspecified`]
5446     * [`Ipv6Addr::is_loopback`]
5447     * [`Ipv6Addr::is_multicast`]
5448   * `Vec`
5449     * [`Vec::as_slice`]
5450     * [`Vec::as_mut_slice`]
5451   * `String`
5452     * [`String::as_str`]
5453     * [`String::as_mut_str`]
5454   * Slices
5455     * `<[T]>::`[`clone_from_slice`], which now requires the two slices to
5456     be the same length
5457     * `<[T]>::`[`sort_by_key`]
5458   * checked, saturated, and overflowing operations
5459     * [`i32::checked_rem`], [`i32::checked_neg`], [`i32::checked_shl`], [`i32::checked_shr`]
5460     * [`i32::saturating_mul`]
5461     * [`i32::overflowing_add`], [`i32::overflowing_sub`], [`i32::overflowing_mul`], [`i32::overflowing_div`]
5462     * [`i32::overflowing_rem`], [`i32::overflowing_neg`], [`i32::overflowing_shl`], [`i32::overflowing_shr`]
5463     * [`u32::checked_rem`], [`u32::checked_neg`], [`u32::checked_shl`], [`u32::checked_shl`]
5464     * [`u32::saturating_mul`]
5465     * [`u32::overflowing_add`], [`u32::overflowing_sub`], [`u32::overflowing_mul`], [`u32::overflowing_div`]
5466     * [`u32::overflowing_rem`], [`u32::overflowing_neg`], [`u32::overflowing_shl`], [`u32::overflowing_shr`]
5467     * and checked, saturated, and overflowing operations for other primitive types
5468   * FFI
5469     * [`ffi::IntoStringError`]
5470     * [`CString::into_string`]
5471     * [`CString::into_bytes`]
5472     * [`CString::into_bytes_with_nul`]
5473     * `From<CString> for Vec<u8>`
5474   * `IntoStringError`
5475     * [`IntoStringError::into_cstring`]
5476     * [`IntoStringError::utf8_error`]
5477     * `Error for IntoStringError`
5478   * Hashing
5479     * [`std::hash::BuildHasher`]
5480     * [`BuildHasher::Hasher`]
5481     * [`BuildHasher::build_hasher`]
5482     * [`std::hash::BuildHasherDefault`]
5483     * [`HashMap::with_hasher`]
5484     * [`HashMap::with_capacity_and_hasher`]
5485     * [`HashSet::with_hasher`]
5486     * [`HashSet::with_capacity_and_hasher`]
5487     * [`std::collections::hash_map::RandomState`]
5488     * [`RandomState::new`]
5489 * [Validating UTF-8 is faster by a factor of between 7 and 14x for
5490   ASCII input][1.7utf8]. This means that creating `String`s and `str`s
5491   from bytes is faster.
5492 * [The performance of `LineWriter` (and thus `io::stdout`) was
5493   improved by using `memchr` to search for newlines][1.7m].
5494 * [`f32::to_degrees` and `f32::to_radians` are stable][1.7f]. The
5495   `f64` variants were stabilized previously.
5496 * [`BTreeMap` was rewritten to use less memory and improve the performance
5497   of insertion and iteration, the latter by as much as 5x][1.7bm].
5498 * [`BTreeSet` and its iterators, `Iter`, `IntoIter`, and `Range` are
5499   covariant over their contained type][1.7bt].
5500 * [`LinkedList` and its iterators, `Iter` and `IntoIter` are covariant
5501   over their contained type][1.7ll].
5502 * [`str::replace` now accepts a `Pattern`][1.7rp], like other string
5503   searching methods.
5504 * [`Any` is implemented for unsized types][1.7a].
5505 * [`Hash` is implemented for `Duration`][1.7h].
5506
5507 Misc
5508 ----
5509
5510 * [When running tests with `--test`, rustdoc will pass `--cfg`
5511   arguments to the compiler][1.7dt].
5512 * [The compiler is built with RPATH information by default][1.7rpa].
5513   This means that it will be possible to run `rustc` when installed in
5514   unusual configurations without configuring the dynamic linker search
5515   path explicitly.
5516 * [`rustc` passes `--enable-new-dtags` to GNU ld][1.7dta]. This makes
5517   any RPATH entries (emitted with `-C rpath`) *not* take precedence
5518   over `LD_LIBRARY_PATH`.
5519
5520 Cargo
5521 -----
5522
5523 * [`cargo rustc` accepts a `--profile` flag that runs `rustc` under
5524   any of the compilation profiles, 'dev', 'bench', or 'test'][1.7cp].
5525 * [The `rerun-if-changed` build script directive no longer causes the
5526   build script to incorrectly run twice in certain scenarios][1.7rr].
5527
5528 Compatibility Notes
5529 -------------------
5530
5531 * Soundness fixes to the interactions between associated types and
5532   lifetimes, specified in [RFC 1214], [now generate errors][1.7sf] for
5533   code that violates the new rules. This is a significant change that
5534   is known to break existing code, so it has emitted warnings for the
5535   new error cases since 1.4 to give crate authors time to adapt. The
5536   details of what is changing are subtle; read the RFC for more.
5537 * [Several bugs in the compiler's visibility calculations were
5538   fixed][1.7v]. Since this was found to break significant amounts of
5539   code, the new errors will be emitted as warnings for several release
5540   cycles, under the `private_in_public` lint.
5541 * Defaulted type parameters were accidentally accepted in positions
5542   that were not intended. In this release, [defaulted type parameters
5543   appearing outside of type definitions will generate a
5544   warning][1.7d], which will become an error in future releases.
5545 * [Parsing "." as a float results in an error instead of 0][1.7p].
5546   That is, `".".parse::<f32>()` returns `Err`, not `Ok(0.0)`.
5547 * [Borrows of closure parameters may not outlive the closure][1.7bc].
5548
5549 [1.7a]: https://github.com/rust-lang/rust/pull/30928
5550 [1.7bc]: https://github.com/rust-lang/rust/pull/30341
5551 [1.7bm]: https://github.com/rust-lang/rust/pull/30426
5552 [1.7bt]: https://github.com/rust-lang/rust/pull/30998
5553 [1.7cp]: https://github.com/rust-lang/cargo/pull/2224
5554 [1.7d]: https://github.com/rust-lang/rust/pull/30724
5555 [1.7dt]: https://github.com/rust-lang/rust/pull/30372
5556 [1.7dta]: https://github.com/rust-lang/rust/pull/30394
5557 [1.7f]: https://github.com/rust-lang/rust/pull/30672
5558 [1.7h]: https://github.com/rust-lang/rust/pull/30818
5559 [1.7ll]: https://github.com/rust-lang/rust/pull/30663
5560 [1.7m]: https://github.com/rust-lang/rust/pull/30381
5561 [1.7p]: https://github.com/rust-lang/rust/pull/30681
5562 [1.7rp]: https://github.com/rust-lang/rust/pull/29498
5563 [1.7rpa]: https://github.com/rust-lang/rust/pull/30353
5564 [1.7rr]: https://github.com/rust-lang/cargo/pull/2279
5565 [1.7sf]: https://github.com/rust-lang/rust/pull/30389
5566 [1.7utf8]: https://github.com/rust-lang/rust/pull/30740
5567 [1.7v]: https://github.com/rust-lang/rust/pull/29973
5568 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5569 [`BuildHasher::Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
5570 [`BuildHasher::build_hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html#tymethod.build_hasher
5571 [`CString::into_bytes_with_nul`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes_with_nul
5572 [`CString::into_bytes`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_bytes
5573 [`CString::into_string`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_string
5574 [`HashMap::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_capacity_and_hasher
5575 [`HashMap::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashMap.html#method.with_hasher
5576 [`HashSet::with_capacity_and_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_capacity_and_hasher
5577 [`HashSet::with_hasher`]: http://doc.rust-lang.org/nightly/std/collections/struct.HashSet.html#method.with_hasher
5578 [`IntoStringError::into_cstring`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.into_cstring
5579 [`IntoStringError::utf8_error`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html#method.utf8_error
5580 [`Ipv4Addr::is_broadcast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_broadcast
5581 [`Ipv4Addr::is_documentation`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_documentation
5582 [`Ipv4Addr::is_link_local`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_link_local
5583 [`Ipv4Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_loopback
5584 [`Ipv4Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_multicast
5585 [`Ipv4Addr::is_private`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv4Addr.html#method.is_private
5586 [`Ipv6Addr::is_loopback`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_loopback
5587 [`Ipv6Addr::is_multicast`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_multicast
5588 [`Ipv6Addr::is_unspecified`]: http://doc.rust-lang.org/nightly/std/net/struct.Ipv6Addr.html#method.is_unspecified
5589 [`Path::strip_prefix`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.strip_prefix
5590 [`RandomState::new`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html#method.new
5591 [`String::as_mut_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_mut_str
5592 [`String::as_str`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.as_str
5593 [`Vec::as_mut_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_mut_slice
5594 [`Vec::as_slice`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.as_slice
5595 [`clone_from_slice`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.clone_from_slice
5596 [`ffi::IntoStringError`]: http://doc.rust-lang.org/nightly/std/ffi/struct.IntoStringError.html
5597 [`i32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_neg
5598 [`i32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_rem
5599 [`i32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shl
5600 [`i32::checked_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.checked_shr
5601 [`i32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_add
5602 [`i32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_div
5603 [`i32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_mul
5604 [`i32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_neg
5605 [`i32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_rem
5606 [`i32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shl
5607 [`i32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_shr
5608 [`i32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.overflowing_sub
5609 [`i32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.i32.html#method.saturating_mul
5610 [`path::StripPrefixError`]: http://doc.rust-lang.org/nightly/std/path/struct.StripPrefixError.html
5611 [`sort_by_key`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.sort_by_key
5612 [`std::collections::hash_map::RandomState`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.RandomState.html
5613 [`std::hash::BuildHasherDefault`]: http://doc.rust-lang.org/nightly/std/hash/struct.BuildHasherDefault.html
5614 [`std::hash::BuildHasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.BuildHasher.html
5615 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5616 [`u32::checked_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_rem
5617 [`u32::checked_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_neg
5618 [`u32::checked_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.checked_shl
5619 [`u32::overflowing_add`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_add
5620 [`u32::overflowing_div`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_div
5621 [`u32::overflowing_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_mul
5622 [`u32::overflowing_neg`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_neg
5623 [`u32::overflowing_rem`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_rem
5624 [`u32::overflowing_shl`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shl
5625 [`u32::overflowing_shr`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_shr
5626 [`u32::overflowing_sub`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.overflowing_sub
5627 [`u32::saturating_mul`]: http://doc.rust-lang.org/nightly/std/primitive.u32.html#method.saturating_mul
5628
5629
5630 Version 1.6.0 (2016-01-21)
5631 ==========================
5632
5633 Language
5634 --------
5635
5636 * The `#![no_std]` attribute causes a crate to not be linked to the
5637   standard library, but only the [core library][1.6co], as described
5638   in [RFC 1184]. The core library defines common types and traits but
5639   has no platform dependencies whatsoever, and is the basis for Rust
5640   software in environments that cannot support a full port of the
5641   standard library, such as operating systems. Most of the core
5642   library is now stable.
5643
5644 Libraries
5645 ---------
5646
5647 * Stabilized APIs:
5648   [`Read::read_exact`],
5649   [`ErrorKind::UnexpectedEof`][] (renamed from `UnexpectedEOF`),
5650   [`fs::DirBuilder`], [`fs::DirBuilder::new`],
5651   [`fs::DirBuilder::recursive`], [`fs::DirBuilder::create`],
5652   [`os::unix::fs::DirBuilderExt`],
5653   [`os::unix::fs::DirBuilderExt::mode`], [`vec::Drain`],
5654   [`vec::Vec::drain`], [`string::Drain`], [`string::String::drain`],
5655   [`vec_deque::Drain`], [`vec_deque::VecDeque::drain`],
5656   [`collections::hash_map::Drain`],
5657   [`collections::hash_map::HashMap::drain`],
5658   [`collections::hash_set::Drain`],
5659   [`collections::hash_set::HashSet::drain`],
5660   [`collections::binary_heap::Drain`],
5661   [`collections::binary_heap::BinaryHeap::drain`],
5662   [`Vec::extend_from_slice`][] (renamed from `push_all`),
5663   [`Mutex::get_mut`], [`Mutex::into_inner`], [`RwLock::get_mut`],
5664   [`RwLock::into_inner`],
5665   [`Iterator::min_by_key`][] (renamed from `min_by`),
5666   [`Iterator::max_by_key`][] (renamed from `max_by`).
5667 * The [core library][1.6co] is stable, as are most of its APIs.
5668 * [The `assert_eq!` macro supports arguments that don't implement
5669   `Sized`][1.6ae], such as arrays. In this way it behaves more like
5670   `assert!`.
5671 * Several timer functions that take duration in milliseconds [are
5672   deprecated in favor of those that take `Duration`][1.6ms]. These
5673   include `Condvar::wait_timeout_ms`, `thread::sleep_ms`, and
5674   `thread::park_timeout_ms`.
5675 * The algorithm by which `Vec` reserves additional elements was
5676   [tweaked to not allocate excessive space][1.6a] while still growing
5677   exponentially.
5678 * `From` conversions are [implemented from integers to floats][1.6f]
5679   in cases where the conversion is lossless. Thus they are not
5680   implemented for 32-bit ints to `f32`, nor for 64-bit ints to `f32`
5681   or `f64`. They are also not implemented for `isize` and `usize`
5682   because the implementations would be platform-specific. `From` is
5683   also implemented from `f32` to `f64`.
5684 * `From<&Path>` and `From<PathBuf>` are implemented for `Cow<Path>`.
5685 * `From<T>` is implemented for `Box<T>`, `Rc<T>` and `Arc<T>`.
5686 * `IntoIterator` is implemented for `&PathBuf` and `&Path`.
5687 * [`BinaryHeap` was refactored][1.6bh] for modest performance
5688   improvements.
5689 * Sorting slices that are already sorted [is 50% faster in some
5690   cases][1.6s].
5691
5692 Cargo
5693 -----
5694
5695 * Cargo will look in `$CARGO_HOME/bin` for subcommands [by default][1.6c].
5696 * Cargo build scripts can specify their dependencies by emitting the
5697   [`rerun-if-changed`][1.6rr] key.
5698 * crates.io will reject publication of crates with dependencies that
5699   have a wildcard version constraint. Crates with wildcard
5700   dependencies were seen to cause a variety of problems, as described
5701   in [RFC 1241]. Since 1.5 publication of such crates has emitted a
5702   warning.
5703 * `cargo clean` [accepts a `--release` flag][1.6cc] to clean the
5704   release folder.  A variety of artifacts that Cargo failed to clean
5705   are now correctly deleted.
5706
5707 Misc
5708 ----
5709
5710 * The `unreachable_code` lint [warns when a function call's argument
5711   diverges][1.6dv].
5712 * The parser indicates [failures that may be caused by
5713   confusingly-similar Unicode characters][1.6uc]
5714 * Certain macro errors [are reported at definition time][1.6m], not
5715   expansion.
5716
5717 Compatibility Notes
5718 -------------------
5719
5720 * The compiler no longer makes use of the [`RUST_PATH`][1.6rp]
5721   environment variable when locating crates. This was a pre-cargo
5722   feature for integrating with the package manager that was
5723   accidentally never removed.
5724 * [A number of bugs were fixed in the privacy checker][1.6p] that
5725   could cause previously-accepted code to break.
5726 * [Modules and unit/tuple structs may not share the same name][1.6ts].
5727 * [Bugs in pattern matching unit structs were fixed][1.6us]. The tuple
5728   struct pattern syntax (`Foo(..)`) can no longer be used to match
5729   unit structs. This is a warning now, but will become an error in
5730   future releases. Patterns that share the same name as a const are
5731   now an error.
5732 * A bug was fixed that causes [rustc not to apply default type
5733   parameters][1.6xc] when resolving certain method implementations of
5734   traits defined in other crates.
5735
5736 [1.6a]: https://github.com/rust-lang/rust/pull/29454
5737 [1.6ae]: https://github.com/rust-lang/rust/pull/29770
5738 [1.6bh]: https://github.com/rust-lang/rust/pull/29811
5739 [1.6c]: https://github.com/rust-lang/cargo/pull/2192
5740 [1.6cc]: https://github.com/rust-lang/cargo/pull/2131
5741 [1.6co]: http://doc.rust-lang.org/core/index.html
5742 [1.6dv]: https://github.com/rust-lang/rust/pull/30000
5743 [1.6f]: https://github.com/rust-lang/rust/pull/29129
5744 [1.6m]: https://github.com/rust-lang/rust/pull/29828
5745 [1.6ms]: https://github.com/rust-lang/rust/pull/29604
5746 [1.6p]: https://github.com/rust-lang/rust/pull/29726
5747 [1.6rp]: https://github.com/rust-lang/rust/pull/30034
5748 [1.6rr]: https://github.com/rust-lang/cargo/pull/2134
5749 [1.6s]: https://github.com/rust-lang/rust/pull/29675
5750 [1.6ts]: https://github.com/rust-lang/rust/issues/21546
5751 [1.6uc]: https://github.com/rust-lang/rust/pull/29837
5752 [1.6us]: https://github.com/rust-lang/rust/pull/29383
5753 [1.6xc]: https://github.com/rust-lang/rust/issues/30123
5754 [RFC 1184]: https://github.com/rust-lang/rfcs/blob/master/text/1184-stabilize-no_std.md
5755 [RFC 1241]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5756 [`ErrorKind::UnexpectedEof`]: http://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html#variant.UnexpectedEof
5757 [`Iterator::max_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.max_by_key
5758 [`Iterator::min_by_key`]: http://doc.rust-lang.org/nightly/std/iter/trait.Iterator.html#method.min_by_key
5759 [`Mutex::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.get_mut
5760 [`Mutex::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html#method.into_inner
5761 [`Read::read_exact`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_exact
5762 [`RwLock::get_mut`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.get_mut
5763 [`RwLock::into_inner`]: http://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html#method.into_inner
5764 [`Vec::extend_from_slice`]: http://doc.rust-lang.org/nightly/collections/vec/struct.Vec.html#method.extend_from_slice
5765 [`collections::binary_heap::BinaryHeap::drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.BinaryHeap.html#method.drain
5766 [`collections::binary_heap::Drain`]: http://doc.rust-lang.org/nightly/std/collections/binary_heap/struct.Drain.html
5767 [`collections::hash_map::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.Drain.html
5768 [`collections::hash_map::HashMap::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_map/struct.HashMap.html#method.drain
5769 [`collections::hash_set::Drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.Drain.html
5770 [`collections::hash_set::HashSet::drain`]: http://doc.rust-lang.org/nightly/std/collections/hash_set/struct.HashSet.html#method.drain
5771 [`fs::DirBuilder::create`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.create
5772 [`fs::DirBuilder::new`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.new
5773 [`fs::DirBuilder::recursive`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html#method.recursive
5774 [`fs::DirBuilder`]: http://doc.rust-lang.org/nightly/std/fs/struct.DirBuilder.html
5775 [`os::unix::fs::DirBuilderExt::mode`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
5776 [`os::unix::fs::DirBuilderExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html
5777 [`string::Drain`]: http://doc.rust-lang.org/nightly/std/string/struct.Drain.html
5778 [`string::String::drain`]: http://doc.rust-lang.org/nightly/std/string/struct.String.html#method.drain
5779 [`vec::Drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Drain.html
5780 [`vec::Vec::drain`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.drain
5781 [`vec_deque::Drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.Drain.html
5782 [`vec_deque::VecDeque::drain`]: http://doc.rust-lang.org/nightly/std/collections/vec_deque/struct.VecDeque.html#method.drain
5783
5784
5785 Version 1.5.0 (2015-12-10)
5786 ==========================
5787
5788 * ~700 changes, numerous bugfixes
5789
5790 Highlights
5791 ----------
5792
5793 * Stabilized APIs:
5794   [`BinaryHeap::from`], [`BinaryHeap::into_sorted_vec`],
5795   [`BinaryHeap::into_vec`], [`Condvar::wait_timeout`],
5796   [`FileTypeExt::is_block_device`], [`FileTypeExt::is_char_device`],
5797   [`FileTypeExt::is_fifo`], [`FileTypeExt::is_socket`],
5798   [`FileTypeExt`], [`Formatter::alternate`], [`Formatter::fill`],
5799   [`Formatter::precision`], [`Formatter::sign_aware_zero_pad`],
5800   [`Formatter::sign_minus`], [`Formatter::sign_plus`],
5801   [`Formatter::width`], [`Iterator::cmp`], [`Iterator::eq`],
5802   [`Iterator::ge`], [`Iterator::gt`], [`Iterator::le`],
5803   [`Iterator::lt`], [`Iterator::ne`], [`Iterator::partial_cmp`],
5804   [`Path::canonicalize`], [`Path::exists`], [`Path::is_dir`],
5805   [`Path::is_file`], [`Path::metadata`], [`Path::read_dir`],
5806   [`Path::read_link`], [`Path::symlink_metadata`],
5807   [`Utf8Error::valid_up_to`], [`Vec::resize`],
5808   [`VecDeque::as_mut_slices`], [`VecDeque::as_slices`],
5809   [`VecDeque::insert`], [`VecDeque::shrink_to_fit`],
5810   [`VecDeque::swap_remove_back`], [`VecDeque::swap_remove_front`],
5811   [`slice::split_first_mut`], [`slice::split_first`],
5812   [`slice::split_last_mut`], [`slice::split_last`],
5813   [`char::from_u32_unchecked`], [`fs::canonicalize`],
5814   [`str::MatchIndices`], [`str::RMatchIndices`],
5815   [`str::match_indices`], [`str::rmatch_indices`],
5816   [`str::slice_mut_unchecked`], [`string::ParseError`].
5817 * Rust applications hosted on crates.io can be installed locally to
5818   `~/.cargo/bin` with the [`cargo install`] command. Among other
5819   things this makes it easier to augment Cargo with new subcommands:
5820   when a binary named e.g. `cargo-foo` is found in `$PATH` it can be
5821   invoked as `cargo foo`.
5822 * Crates with wildcard (`*`) dependencies will [emit warnings when
5823   published][1.5w]. In 1.6 it will no longer be possible to publish
5824   crates with wildcard dependencies.
5825
5826 Breaking Changes
5827 ----------------
5828
5829 * The rules determining when a particular lifetime must outlive
5830   a particular value (known as '[dropck]') have been [modified
5831   to not rely on parametricity][1.5p].
5832 * [Implementations of `AsRef` and `AsMut` were added to `Box`, `Rc`,
5833   and `Arc`][1.5a]. Because these smart pointer types implement
5834   `Deref`, this causes breakage in cases where the interior type
5835   contains methods of the same name.
5836 * [Correct a bug in Rc/Arc][1.5c] that caused [dropck] to be unaware
5837   that they could drop their content. Soundness fix.
5838 * All method invocations are [properly checked][1.5wf1] for
5839   [well-formedness][1.5wf2]. Soundness fix.
5840 * Traits whose supertraits contain `Self` are [not object
5841   safe][1.5o]. Soundness fix.
5842 * Target specifications support a [`no_default_libraries`][1.5nd]
5843   setting that controls whether `-nodefaultlibs` is passed to the
5844   linker, and in turn the `is_like_windows` setting no longer affects
5845   the `-nodefaultlibs` flag.
5846 * `#[derive(Show)]`, long-deprecated, [has been removed][1.5ds].
5847 * The `#[inline]` and `#[repr]` attributes [can only appear
5848   in valid locations][1.5at].
5849 * Native libraries linked from the local crate are [passed to
5850   the linker before native libraries from upstream crates][1.5nl].
5851 * Two rarely-used attributes, `#[no_debug]` and
5852   `#[omit_gdb_pretty_printer_section]` [are feature gated][1.5fg].
5853 * Negation of unsigned integers, which has been a warning for
5854   several releases, [is now behind a feature gate and will
5855   generate errors][1.5nu].
5856 * The parser accidentally accepted visibility modifiers on
5857   enum variants, a bug [which has been fixed][1.5ev].
5858 * [A bug was fixed that allowed `use` statements to import unstable
5859   features][1.5use].
5860
5861 Language
5862 --------
5863
5864 * When evaluating expressions at compile-time that are not
5865   compile-time constants (const-evaluating expressions in non-const
5866   contexts), incorrect code such as overlong bitshifts and arithmetic
5867   overflow will [generate a warning instead of an error][1.5ce],
5868   delaying the error until runtime. This will allow the
5869   const-evaluator to be expanded in the future backwards-compatibly.
5870 * The `improper_ctypes` lint [no longer warns about using `isize` and
5871   `usize` in FFI][1.5ict].
5872
5873 Libraries
5874 ---------
5875
5876 * `Arc<T>` and `Rc<T>` are [covariant with respect to `T` instead of
5877   invariant][1.5c].
5878 * `Default` is [implemented for mutable slices][1.5d].
5879 * `FromStr` is [implemented for `SockAddrV4` and `SockAddrV6`][1.5s].
5880 * There are now `From` conversions [between floating point
5881   types][1.5f] where the conversions are lossless.
5882 * There are now `From` conversions [between integer types][1.5i] where
5883   the conversions are lossless.
5884 * [`fs::Metadata` implements `Clone`][1.5fs].
5885 * The `parse` method [accepts a leading "+" when parsing
5886   integers][1.5pi].
5887 * [`AsMut` is implemented for `Vec`][1.5am].
5888 * The `clone_from` implementations for `String` and `BinaryHeap` [have
5889   been optimized][1.5cf] and no longer rely on the default impl.
5890 * The `extern "Rust"`, `extern "C"`, `unsafe extern "Rust"` and
5891   `unsafe extern "C"` function types now [implement `Clone`,
5892   `PartialEq`, `Eq`, `PartialOrd`, `Ord`, `Hash`, `fmt::Pointer`, and
5893   `fmt::Debug` for up to 12 arguments][1.5fp].
5894 * [Dropping `Vec`s is much faster in unoptimized builds when the
5895   element types don't implement `Drop`][1.5dv].
5896 * A bug that caused in incorrect behavior when [combining `VecDeque`
5897   with zero-sized types][1.5vdz] was resolved.
5898 * [`PartialOrd` for slices is faster][1.5po].
5899
5900 Miscellaneous
5901 -------------
5902
5903 * [Crate metadata size was reduced by 20%][1.5md].
5904 * [Improvements to code generation reduced the size of libcore by 3.3
5905   MB and rustc's memory usage by 18MB][1.5m].
5906 * [Improvements to deref translation increased performance in
5907   unoptimized builds][1.5dr].
5908 * Various errors in trait resolution [are deduplicated to only be
5909   reported once][1.5te].
5910 * Rust has preliminary [support for rumprun kernels][1.5rr].
5911 * Rust has preliminary [support for NetBSD on amd64][1.5na].
5912
5913 [1.5use]: https://github.com/rust-lang/rust/pull/28364
5914 [1.5po]: https://github.com/rust-lang/rust/pull/28436
5915 [1.5ev]: https://github.com/rust-lang/rust/pull/28442
5916 [1.5nu]: https://github.com/rust-lang/rust/pull/28468
5917 [1.5dr]: https://github.com/rust-lang/rust/pull/28491
5918 [1.5vdz]: https://github.com/rust-lang/rust/pull/28494
5919 [1.5md]: https://github.com/rust-lang/rust/pull/28521
5920 [1.5fg]: https://github.com/rust-lang/rust/pull/28522
5921 [1.5dv]: https://github.com/rust-lang/rust/pull/28531
5922 [1.5na]: https://github.com/rust-lang/rust/pull/28543
5923 [1.5fp]: https://github.com/rust-lang/rust/pull/28560
5924 [1.5rr]: https://github.com/rust-lang/rust/pull/28593
5925 [1.5cf]: https://github.com/rust-lang/rust/pull/28602
5926 [1.5nl]: https://github.com/rust-lang/rust/pull/28605
5927 [1.5te]: https://github.com/rust-lang/rust/pull/28645
5928 [1.5at]: https://github.com/rust-lang/rust/pull/28650
5929 [1.5am]: https://github.com/rust-lang/rust/pull/28663
5930 [1.5m]: https://github.com/rust-lang/rust/pull/28778
5931 [1.5ict]: https://github.com/rust-lang/rust/pull/28779
5932 [1.5a]: https://github.com/rust-lang/rust/pull/28811
5933 [1.5pi]: https://github.com/rust-lang/rust/pull/28826
5934 [1.5ce]: https://github.com/rust-lang/rfcs/blob/master/text/1229-compile-time-asserts.md
5935 [1.5p]: https://github.com/rust-lang/rfcs/blob/master/text/1238-nonparametric-dropck.md
5936 [1.5i]: https://github.com/rust-lang/rust/pull/28921
5937 [1.5fs]: https://github.com/rust-lang/rust/pull/29021
5938 [1.5f]: https://github.com/rust-lang/rust/pull/29129
5939 [1.5ds]: https://github.com/rust-lang/rust/pull/29148
5940 [1.5s]: https://github.com/rust-lang/rust/pull/29190
5941 [1.5d]: https://github.com/rust-lang/rust/pull/29245
5942 [1.5o]: https://github.com/rust-lang/rust/pull/29259
5943 [1.5nd]: https://github.com/rust-lang/rust/pull/28578
5944 [1.5wf2]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
5945 [1.5wf1]: https://github.com/rust-lang/rust/pull/28669
5946 [dropck]: https://doc.rust-lang.org/nightly/nomicon/dropck.html
5947 [1.5c]: https://github.com/rust-lang/rust/pull/29110
5948 [1.5w]: https://github.com/rust-lang/rfcs/blob/master/text/1241-no-wildcard-deps.md
5949 [`cargo install`]: https://github.com/rust-lang/rfcs/blob/master/text/1200-cargo-install.md
5950 [`BinaryHeap::from`]: http://doc.rust-lang.org/nightly/std/convert/trait.From.html#method.from
5951 [`BinaryHeap::into_sorted_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_sorted_vec
5952 [`BinaryHeap::into_vec`]: http://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html#method.into_vec
5953 [`Condvar::wait_timeout`]: http://doc.rust-lang.org/nightly/std/sync/struct.Condvar.html#method.wait_timeout
5954 [`FileTypeExt::is_block_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_block_device
5955 [`FileTypeExt::is_char_device`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_char_device
5956 [`FileTypeExt::is_fifo`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_fifo
5957 [`FileTypeExt::is_socket`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html#tymethod.is_socket
5958 [`FileTypeExt`]: http://doc.rust-lang.org/nightly/std/os/unix/fs/trait.FileTypeExt.html
5959 [`Formatter::alternate`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.alternate
5960 [`Formatter::fill`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.fill
5961 [`Formatter::precision`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.precision
5962 [`Formatter::sign_aware_zero_pad`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_aware_zero_pad
5963 [`Formatter::sign_minus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_minus
5964 [`Formatter::sign_plus`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.sign_plus
5965 [`Formatter::width`]: http://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.width
5966 [`Iterator::cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.cmp
5967 [`Iterator::eq`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.eq
5968 [`Iterator::ge`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ge
5969 [`Iterator::gt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.gt
5970 [`Iterator::le`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.le
5971 [`Iterator::lt`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.lt
5972 [`Iterator::ne`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.ne
5973 [`Iterator::partial_cmp`]: http://doc.rust-lang.org/nightly/core/iter/trait.Iterator.html#method.partial_cmp
5974 [`Path::canonicalize`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.canonicalize
5975 [`Path::exists`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.exists
5976 [`Path::is_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_dir
5977 [`Path::is_file`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.is_file
5978 [`Path::metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.metadata
5979 [`Path::read_dir`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_dir
5980 [`Path::read_link`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.read_link
5981 [`Path::symlink_metadata`]: http://doc.rust-lang.org/nightly/std/path/struct.Path.html#method.symlink_metadata
5982 [`Utf8Error::valid_up_to`]: http://doc.rust-lang.org/nightly/core/str/struct.Utf8Error.html#method.valid_up_to
5983 [`Vec::resize`]: http://doc.rust-lang.org/nightly/std/vec/struct.Vec.html#method.resize
5984 [`VecDeque::as_mut_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_mut_slices
5985 [`VecDeque::as_slices`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.as_slices
5986 [`VecDeque::insert`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.insert
5987 [`VecDeque::shrink_to_fit`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.shrink_to_fit
5988 [`VecDeque::swap_remove_back`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_back
5989 [`VecDeque::swap_remove_front`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.swap_remove_front
5990 [`slice::split_first_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first_mut
5991 [`slice::split_first`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_first
5992 [`slice::split_last_mut`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last_mut
5993 [`slice::split_last`]: http://doc.rust-lang.org/nightly/std/primitive.slice.html#method.split_last
5994 [`char::from_u32_unchecked`]: http://doc.rust-lang.org/nightly/std/char/fn.from_u32_unchecked.html
5995 [`fs::canonicalize`]: http://doc.rust-lang.org/nightly/std/fs/fn.canonicalize.html
5996 [`str::MatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.MatchIndices.html
5997 [`str::RMatchIndices`]: http://doc.rust-lang.org/nightly/std/str/struct.RMatchIndices.html
5998 [`str::match_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.match_indices
5999 [`str::rmatch_indices`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatch_indices
6000 [`str::slice_mut_unchecked`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.slice_mut_unchecked
6001 [`string::ParseError`]: http://doc.rust-lang.org/nightly/std/string/enum.ParseError.html
6002
6003 Version 1.4.0 (2015-10-29)
6004 ==========================
6005
6006 * ~1200 changes, numerous bugfixes
6007
6008 Highlights
6009 ----------
6010
6011 * Windows builds targeting the 64-bit MSVC ABI and linker (instead of
6012   GNU) are now supported and recommended for use.
6013
6014 Breaking Changes
6015 ----------------
6016
6017 * [Several changes have been made to fix type soundness and improve
6018   the behavior of associated types][sound]. See [RFC 1214]. Although
6019   we have mostly introduced these changes as warnings this release, to
6020   become errors next release, there are still some scenarios that will
6021   see immediate breakage.
6022 * [The `str::lines` and `BufRead::lines` iterators treat `\r\n` as
6023   line breaks in addition to `\n`][crlf].
6024 * [Loans of `'static` lifetime extend to the end of a function][stat].
6025 * [`str::parse` no longer introduces avoidable rounding error when
6026   parsing floating point numbers. Together with earlier changes to
6027   float formatting/output, "round trips" like f.to_string().parse()
6028   now preserve the value of f exactly. Additionally, leading plus
6029   signs are now accepted][fp3].
6030
6031
6032 Language
6033 --------
6034
6035 * `use` statements that import multiple items [can now rename
6036   them][i], as in `use foo::{bar as kitten, baz as puppy}`.
6037 * [Binops work correctly on fat pointers][binfat].
6038 * `pub extern crate`, which does not behave as expected, [issues a
6039   warning][pec] until a better solution is found.
6040
6041 Libraries
6042 ---------
6043
6044 * [Many APIs were stabilized][stab]: `<Box<str>>::into_string`,
6045   [`Arc::downgrade`], [`Arc::get_mut`], [`Arc::make_mut`],
6046   [`Arc::try_unwrap`], [`Box::from_raw`], [`Box::into_raw`], [`CStr::to_str`],
6047   [`CStr::to_string_lossy`], [`CString::from_raw`], [`CString::into_raw`],
6048   [`IntoRawFd::into_raw_fd`], [`IntoRawFd`],
6049   `IntoRawHandle::into_raw_handle`, `IntoRawHandle`,
6050   `IntoRawSocket::into_raw_socket`, `IntoRawSocket`, [`Rc::downgrade`],
6051   [`Rc::get_mut`], [`Rc::make_mut`], [`Rc::try_unwrap`], [`Result::expect`],
6052   [`String::into_boxed_str`], [`TcpStream::read_timeout`],
6053   [`TcpStream::set_read_timeout`], [`TcpStream::set_write_timeout`],
6054   [`TcpStream::write_timeout`], [`UdpSocket::read_timeout`],
6055   [`UdpSocket::set_read_timeout`], [`UdpSocket::set_write_timeout`],
6056   [`UdpSocket::write_timeout`], `Vec::append`, `Vec::split_off`,
6057   [`VecDeque::append`], [`VecDeque::retain`], [`VecDeque::split_off`],
6058   [`rc::Weak::upgrade`], [`rc::Weak`], [`slice::Iter::as_slice`],
6059   [`slice::IterMut::into_slice`], [`str::CharIndices::as_str`],
6060   [`str::Chars::as_str`], [`str::split_at_mut`], [`str::split_at`],
6061   [`sync::Weak::upgrade`], [`sync::Weak`], [`thread::park_timeout`],
6062   [`thread::sleep`].
6063 * [Some APIs were deprecated][dep]: `BTreeMap::with_b`,
6064   `BTreeSet::with_b`, `Option::as_mut_slice`, `Option::as_slice`,
6065   `Result::as_mut_slice`, `Result::as_slice`, `f32::from_str_radix`,
6066   `f64::from_str_radix`.
6067 * [Reverse-searching strings is faster with the 'two-way'
6068   algorithm][s].
6069 * [`std::io::copy` allows `?Sized` arguments][cc].
6070 * The `Windows`, `Chunks`, and `ChunksMut` iterators over slices all
6071   [override `count`, `nth` and `last` with an O(1)
6072   implementation][it].
6073 * [`Default` is implemented for arrays up to `[T; 32]`][d].
6074 * [`IntoRawFd` has been added to the Unix-specific prelude,
6075   `IntoRawSocket` and `IntoRawHandle` to the Windows-specific
6076   prelude][pr].
6077 * [`Extend<String>` and `FromIterator<String` are both implemented for
6078   `String`][es].
6079 * [`IntoIterator` is implemented for references to `Option` and
6080   `Result`][into2].
6081 * [`HashMap` and `HashSet` implement `Extend<&T>` where `T:
6082   Copy`][ext] as part of [RFC 839]. This will cause type inference
6083   breakage in rare situations.
6084 * [`BinaryHeap` implements `Debug`][bh2].
6085 * [`Borrow` and `BorrowMut` are implemented for fixed-size
6086   arrays][bm].
6087 * [`extern fn`s with the "Rust" and "C" ABIs implement common
6088   traits including `Eq`, `Ord`, `Debug`, `Hash`][fp].
6089 * [String comparison is faster][faststr].
6090 * `&mut T` where `T: std::fmt::Write` [also implements
6091   `std::fmt::Write`][mutw].
6092 * [A stable regression in `VecDeque::push_back` and other
6093   capacity-altering methods that caused panics for zero-sized types
6094   was fixed][vd].
6095 * [Function pointers implement traits for up to 12 parameters][fp2].
6096
6097 Miscellaneous
6098 -------------
6099
6100 * The compiler [no longer uses the 'morestack' feature to prevent
6101   stack overflow][mm]. Instead it uses guard pages and stack
6102   probes (though stack probes are not yet implemented on any platform
6103   but Windows).
6104 * [The compiler matches traits faster when projections are involved][p].
6105 * The 'improper_ctypes' lint [no longer warns about use of `isize` and
6106   `usize`][ffi].
6107 * [Cargo now displays useful information about what its doing during
6108   `cargo update`][cu].
6109
6110 [`Arc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.downgrade
6111 [`Arc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.make_mut
6112 [`Arc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.get_mut
6113 [`Arc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/arc/struct.Arc.html#method.try_unwrap
6114 [`Box::from_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.from_raw
6115 [`Box::into_raw`]: http://doc.rust-lang.org/nightly/alloc/boxed/struct.Box.html#method.into_raw
6116 [`CStr::to_str`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_str
6117 [`CStr::to_string_lossy`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html#method.to_string_lossy
6118 [`CString::from_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.from_raw
6119 [`CString::into_raw`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html#method.into_raw
6120 [`IntoRawFd::into_raw_fd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html#tymethod.into_raw_fd
6121 [`IntoRawFd`]: http://doc.rust-lang.org/nightly/std/os/unix/io/trait.IntoRawFd.html
6122 [`Rc::downgrade`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.downgrade
6123 [`Rc::get_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.get_mut
6124 [`Rc::make_mut`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.make_mut
6125 [`Rc::try_unwrap`]: http://doc.rust-lang.org/nightly/alloc/rc/struct.Rc.html#method.try_unwrap
6126 [`Result::expect`]: http://doc.rust-lang.org/nightly/core/result/enum.Result.html#method.expect
6127 [`String::into_boxed_str`]: http://doc.rust-lang.org/nightly/collections/string/struct.String.html#method.into_boxed_str
6128 [`TcpStream::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6129 [`TcpStream::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6130 [`TcpStream::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6131 [`TcpStream::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6132 [`UdpSocket::read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read_timeout
6133 [`UdpSocket::set_read_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_read_timeout
6134 [`UdpSocket::write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.write_timeout
6135 [`UdpSocket::set_write_timeout`]: http://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.set_write_timeout
6136 [`VecDeque::append`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.append
6137 [`VecDeque::retain`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.retain
6138 [`VecDeque::split_off`]: http://doc.rust-lang.org/nightly/std/collections/struct.VecDeque.html#method.split_off
6139 [`rc::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html#method.upgrade
6140 [`rc::Weak`]: http://doc.rust-lang.org/nightly/std/rc/struct.Weak.html
6141 [`slice::Iter::as_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.Iter.html#method.as_slice
6142 [`slice::IterMut::into_slice`]: http://doc.rust-lang.org/nightly/std/slice/struct.IterMut.html#method.into_slice
6143 [`str::CharIndices::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.CharIndices.html#method.as_str
6144 [`str::Chars::as_str`]: http://doc.rust-lang.org/nightly/std/str/struct.Chars.html#method.as_str
6145 [`str::split_at_mut`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at_mut
6146 [`str::split_at`]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_at
6147 [`sync::Weak::upgrade`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html#method.upgrade
6148 [`sync::Weak`]: http://doc.rust-lang.org/nightly/std/sync/struct.Weak.html
6149 [`thread::park_timeout`]: http://doc.rust-lang.org/nightly/std/thread/fn.park_timeout.html
6150 [`thread::sleep`]: http://doc.rust-lang.org/nightly/std/thread/fn.sleep.html
6151 [bh2]: https://github.com/rust-lang/rust/pull/28156
6152 [binfat]: https://github.com/rust-lang/rust/pull/28270
6153 [bm]: https://github.com/rust-lang/rust/pull/28197
6154 [cc]: https://github.com/rust-lang/rust/pull/27531
6155 [crlf]: https://github.com/rust-lang/rust/pull/28034
6156 [cu]: https://github.com/rust-lang/cargo/pull/1931
6157 [d]: https://github.com/rust-lang/rust/pull/27825
6158 [dep]: https://github.com/rust-lang/rust/pull/28339
6159 [es]: https://github.com/rust-lang/rust/pull/27956
6160 [ext]: https://github.com/rust-lang/rust/pull/28094
6161 [faststr]: https://github.com/rust-lang/rust/pull/28338
6162 [ffi]: https://github.com/rust-lang/rust/pull/28779
6163 [fp]: https://github.com/rust-lang/rust/pull/28268
6164 [fp2]: https://github.com/rust-lang/rust/pull/28560
6165 [fp3]: https://github.com/rust-lang/rust/pull/27307
6166 [i]: https://github.com/rust-lang/rust/pull/27451
6167 [into2]: https://github.com/rust-lang/rust/pull/28039
6168 [it]: https://github.com/rust-lang/rust/pull/27652
6169 [mm]: https://github.com/rust-lang/rust/pull/27338
6170 [mutw]: https://github.com/rust-lang/rust/pull/28368
6171 [sound]: https://github.com/rust-lang/rust/pull/27641
6172 [p]: https://github.com/rust-lang/rust/pull/27866
6173 [pec]: https://github.com/rust-lang/rust/pull/28486
6174 [pr]: https://github.com/rust-lang/rust/pull/27896
6175 [RFC 839]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6176 [RFC 1214]: https://github.com/rust-lang/rfcs/blob/master/text/1214-projections-lifetimes-and-wf.md
6177 [s]: https://github.com/rust-lang/rust/pull/27474
6178 [stab]: https://github.com/rust-lang/rust/pull/28339
6179 [stat]: https://github.com/rust-lang/rust/pull/28321
6180 [vd]: https://github.com/rust-lang/rust/pull/28494
6181
6182 Version 1.3.0 (2015-09-17)
6183 ==============================
6184
6185 * ~900 changes, numerous bugfixes
6186
6187 Highlights
6188 ----------
6189
6190 * The [new object lifetime defaults][nold] have been [turned
6191   on][nold2] after a cycle of warnings about the change. Now types
6192   like `&'a Box<Trait>` (or `&'a Rc<Trait>`, etc) will change from
6193   being interpreted as `&'a Box<Trait+'a>` to `&'a
6194   Box<Trait+'static>`.
6195 * [The Rustonomicon][nom] is a new book in the official documentation
6196   that dives into writing unsafe Rust.
6197 * The [`Duration`] API, [has been stabilized][ds]. This basic unit of
6198   timekeeping is employed by other std APIs, as well as out-of-tree
6199   time crates.
6200
6201 Breaking Changes
6202 ----------------
6203
6204 * The [new object lifetime defaults][nold] have been [turned
6205   on][nold2] after a cycle of warnings about the change.
6206 * There is a known [regression][lr] in how object lifetime elision is
6207   interpreted, the proper solution for which is undetermined.
6208 * The `#[prelude_import]` attribute, an internal implementation
6209   detail, was accidentally stabilized previously. [It has been put
6210   behind the `prelude_import` feature gate][pi]. This change is
6211   believed to break no existing code.
6212 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6213   [more sane for dynamically sized types][dst3]. Code that relied on
6214   the previous behavior is thought to be broken.
6215 * The `dropck` rules, which checks that destructors can't access
6216   destroyed values, [have been updated][dropck] to match the
6217   [RFC][dropckrfc]. This fixes some soundness holes, and as such will
6218   cause some previously-compiling code to no longer build.
6219
6220 Language
6221 --------
6222
6223 * The [new object lifetime defaults][nold] have been [turned
6224   on][nold2] after a cycle of warnings about the change.
6225 * Semicolons may [now follow types and paths in
6226   macros](https://github.com/rust-lang/rust/pull/27000).
6227 * The behavior of [`size_of_val`][dst1] and [`align_of_val`][dst2] is
6228   [more sane for dynamically sized types][dst3]. Code that relied on
6229   the previous behavior is not known to exist, and suspected to be
6230   broken.
6231 * `'static` variables [may now be recursive][st].
6232 * `ref` bindings choose between [`Deref`] and [`DerefMut`]
6233   implementations correctly.
6234 * The `dropck` rules, which checks that destructors can't access
6235   destroyed values, [have been updated][dropck] to match the
6236   [RFC][dropckrfc].
6237
6238 Libraries
6239 ---------
6240
6241 * The [`Duration`] API, [has been stabilized][ds], as well as the
6242   `std::time` module, which presently contains only `Duration`.
6243 * `Box<str>` and `Box<[T]>` both implement `Clone`.
6244 * The owned C string, [`CString`], implements [`Borrow`] and the
6245   borrowed C string, [`CStr`], implements [`ToOwned`]. The two of
6246   these allow C strings to be borrowed and cloned in generic code.
6247 * [`CStr`] implements [`Debug`].
6248 * [`AtomicPtr`] implements [`Debug`].
6249 * [`Error`] trait objects [can be downcast to their concrete types][e]
6250   in many common configurations, using the [`is`], [`downcast`],
6251   [`downcast_ref`] and [`downcast_mut`] methods, similarly to the
6252   [`Any`] trait.
6253 * Searching for substrings now [employs the two-way algorithm][search]
6254   instead of doing a naive search. This gives major speedups to a
6255   number of methods, including [`contains`][sc], [`find`][sf],
6256   [`rfind`][srf], [`split`][ss]. [`starts_with`][ssw] and
6257   [`ends_with`][sew] are also faster.
6258 * The performance of `PartialEq` for slices is [much faster][ps].
6259 * The [`Hash`] trait offers the default method, [`hash_slice`], which
6260   is overridden and optimized by the implementations for scalars.
6261 * The [`Hasher`] trait now has a number of specialized `write_*`
6262   methods for primitive types, for efficiency.
6263 * The I/O-specific error type, [`std::io::Error`][ie], gained a set of
6264   methods for accessing the 'inner error', if any: [`get_ref`][iegr],
6265   [`get_mut`][iegm], [`into_inner`][ieii]. As well, the implementation
6266   of [`std::error::Error::cause`][iec] also delegates to the inner
6267   error.
6268 * [`process::Child`][pc] gained the [`id`] method, which returns a
6269   `u32` representing the platform-specific process identifier.
6270 * The [`connect`] method on slices is deprecated, replaced by the new
6271   [`join`] method (note that both of these are on the *unstable*
6272   [`SliceConcatExt`] trait, but through the magic of the prelude are
6273   available to stable code anyway).
6274 * The [`Div`] operator is implemented for [`Wrapping`] types.
6275 * [`DerefMut` is implemented for `String`][dms].
6276 * Performance of SipHash (the default hasher for `HashMap`) is
6277   [better for long data][sh].
6278 * [`AtomicPtr`] implements [`Send`].
6279 * The [`read_to_end`] implementations for [`Stdin`] and [`File`]
6280   are now [specialized to use uninitialized buffers for increased
6281   performance][rte].
6282 * Lifetime parameters of foreign functions [are now resolved
6283   properly][f].
6284
6285 Misc
6286 ----
6287
6288 * Rust can now, with some coercion, [produce programs that run on
6289   Windows XP][xp], though XP is not considered a supported platform.
6290 * Porting Rust on Windows from the GNU toolchain to MSVC continues
6291   ([1][win1], [2][win2], [3][win3], [4][win4]). It is still not
6292   recommended for use in 1.3, though should be fully-functional
6293   in the [64-bit 1.4 beta][b14].
6294 * On Fedora-based systems installation will [properly configure the
6295   dynamic linker][fl].
6296 * The compiler gained many new extended error descriptions, which can
6297   be accessed with the `--explain` flag.
6298 * The `dropck` pass, which checks that destructors can't access
6299   destroyed values, [has been rewritten][dropck]. This fixes some
6300   soundness holes, and as such will cause some previously-compiling
6301   code to no longer build.
6302 * `rustc` now uses [LLVM to write archive files where possible][ar].
6303   Eventually this will eliminate the compiler's dependency on the ar
6304   utility.
6305 * Rust has [preliminary support for i686 FreeBSD][fb] (it has long
6306   supported FreeBSD on x86_64).
6307 * The [`unused_mut`][lum], [`unconditional_recursion`][lur],
6308   [`improper_ctypes`][lic], and [`negate_unsigned`][lnu] lints are
6309   more strict.
6310 * If landing pads are disabled (with `-Z no-landing-pads`), [`panic!`
6311   will kill the process instead of leaking][nlp].
6312
6313 [`Any`]: http://doc.rust-lang.org/nightly/std/any/trait.Any.html
6314 [`AtomicPtr`]: http://doc.rust-lang.org/nightly/std/sync/atomic/struct.AtomicPtr.html
6315 [`Borrow`]: http://doc.rust-lang.org/nightly/std/borrow/trait.Borrow.html
6316 [`CStr`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CStr.html
6317 [`CString`]: http://doc.rust-lang.org/nightly/std/ffi/struct.CString.html
6318 [`Debug`]: http://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6319 [`DerefMut`]: http://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6320 [`Deref`]: http://doc.rust-lang.org/nightly/std/ops/trait.Deref.html
6321 [`Div`]: http://doc.rust-lang.org/nightly/std/ops/trait.Div.html
6322 [`Duration`]: http://doc.rust-lang.org/nightly/std/time/struct.Duration.html
6323 [`Error`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html
6324 [`File`]: http://doc.rust-lang.org/nightly/std/fs/struct.File.html
6325 [`Hash`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html
6326 [`Hasher`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hasher.html
6327 [`Send`]: http://doc.rust-lang.org/nightly/std/marker/trait.Send.html
6328 [`SliceConcatExt`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html
6329 [`Stdin`]: http://doc.rust-lang.org/nightly/std/io/struct.Stdin.html
6330 [`ToOwned`]: http://doc.rust-lang.org/nightly/std/borrow/trait.ToOwned.html
6331 [`Wrapping`]: http://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6332 [`connect`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.connect
6333 [`downcast_mut`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_mut
6334 [`downcast_ref`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast_ref
6335 [`downcast`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.downcast
6336 [`hash_slice`]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6337 [`id`]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html#method.id
6338 [`is`]: http://doc.rust-lang.org/nightly/std/error/trait.Error.html#method.is
6339 [`join`]: http://doc.rust-lang.org/nightly/std/slice/trait.SliceConcatExt.html#method.join
6340 [`read_to_end`]: http://doc.rust-lang.org/nightly/std/io/trait.Read.html#method.read_to_end
6341 [ar]: https://github.com/rust-lang/rust/pull/26926
6342 [b14]: https://static.rust-lang.org/dist/rust-beta-x86_64-pc-windows-msvc.msi
6343 [dms]: https://github.com/rust-lang/rust/pull/26241
6344 [dropck]: https://github.com/rust-lang/rust/pull/27261
6345 [dropckrfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6346 [ds]: https://github.com/rust-lang/rust/pull/26818
6347 [dst1]: http://doc.rust-lang.org/nightly/std/mem/fn.size_of_val.html
6348 [dst2]: http://doc.rust-lang.org/nightly/std/mem/fn.align_of_val.html
6349 [dst3]: https://github.com/rust-lang/rust/pull/27351
6350 [e]: https://github.com/rust-lang/rust/pull/24793
6351 [f]: https://github.com/rust-lang/rust/pull/26588
6352 [fb]: https://github.com/rust-lang/rust/pull/26959
6353 [fl]: https://github.com/rust-lang/rust-installer/pull/41
6354 [hs]: http://doc.rust-lang.org/nightly/std/hash/trait.Hash.html#method.hash_slice
6355 [ie]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html
6356 [iec]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.cause
6357 [iegm]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_mut
6358 [iegr]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.get_ref
6359 [ieii]: http://doc.rust-lang.org/nightly/std/io/struct.Error.html#method.into_inner
6360 [lic]: https://github.com/rust-lang/rust/pull/26583
6361 [lnu]: https://github.com/rust-lang/rust/pull/27026
6362 [lr]: https://github.com/rust-lang/rust/issues/27248
6363 [lum]: https://github.com/rust-lang/rust/pull/26378
6364 [lur]: https://github.com/rust-lang/rust/pull/26783
6365 [nlp]: https://github.com/rust-lang/rust/pull/27176
6366 [nold2]: https://github.com/rust-lang/rust/pull/27045
6367 [nold]: https://github.com/rust-lang/rfcs/blob/master/text/1156-adjust-default-object-bounds.md
6368 [nom]: http://doc.rust-lang.org/nightly/nomicon/
6369 [pc]: http://doc.rust-lang.org/nightly/std/process/struct.Child.html
6370 [pi]: https://github.com/rust-lang/rust/pull/26699
6371 [ps]: https://github.com/rust-lang/rust/pull/26884
6372 [rte]: https://github.com/rust-lang/rust/pull/26950
6373 [sc]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.contains
6374 [search]: https://github.com/rust-lang/rust/pull/26327
6375 [sew]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.ends_with
6376 [sf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.find
6377 [sh]: https://github.com/rust-lang/rust/pull/27280
6378 [srf]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.rfind
6379 [ss]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.split
6380 [ssw]: http://doc.rust-lang.org/nightly/std/primitive.str.html#method.starts_with
6381 [st]: https://github.com/rust-lang/rust/pull/26630
6382 [win1]: https://github.com/rust-lang/rust/pull/26569
6383 [win2]: https://github.com/rust-lang/rust/pull/26741
6384 [win3]: https://github.com/rust-lang/rust/pull/26741
6385 [win4]: https://github.com/rust-lang/rust/pull/27210
6386 [xp]: https://github.com/rust-lang/rust/pull/26569
6387
6388 Version 1.2.0 (2015-08-07)
6389 ==========================
6390
6391 * ~1200 changes, numerous bugfixes
6392
6393 Highlights
6394 ----------
6395
6396 * [Dynamically-sized-type coercions][dst] allow smart pointer types
6397   like `Rc` to contain types without a fixed size, arrays and trait
6398   objects, finally enabling use of `Rc<[T]>` and completing the
6399   implementation of DST.
6400 * [Parallel codegen][parcodegen] is now working again, which can
6401   substantially speed up large builds in debug mode; It also gets
6402   another ~33% speedup when bootstrapping on a 4 core machine (using 8
6403   jobs). It's not enabled by default, but will be "in the near
6404   future". It can be activated with the `-C codegen-units=N` flag to
6405   `rustc`.
6406 * This is the first release with [experimental support for linking
6407   with the MSVC linker and lib C on Windows (instead of using the GNU
6408   variants via MinGW)][win]. It is yet recommended only for the most
6409   intrepid Rustaceans.
6410 * Benchmark compilations are showing a 30% improvement in
6411   bootstrapping over 1.1.
6412
6413 Breaking Changes
6414 ----------------
6415
6416 * The [`to_uppercase`] and [`to_lowercase`] methods on `char` now do
6417   unicode case mapping, which is a previously-planned change in
6418   behavior and considered a bugfix.
6419 * [`mem::align_of`] now specifies [the *minimum alignment* for
6420   T][align], which is usually the alignment programs are interested
6421   in, and the same value reported by clang's
6422   `alignof`. [`mem::min_align_of`] is deprecated. This is not known to
6423   break real code.
6424 * [The `#[packed]` attribute is no longer silently accepted by the
6425   compiler][packed]. This attribute did nothing and code that
6426   mentioned it likely did not work as intended.
6427 * Associated type defaults are [now behind the
6428   `associated_type_defaults` feature gate][ad]. In 1.1 associated type
6429   defaults *did not work*, but could be mentioned syntactically. As
6430   such this breakage has minimal impact.
6431
6432 Language
6433 --------
6434
6435 * Patterns with `ref mut` now correctly invoke [`DerefMut`] when
6436   matching against dereferenceable values.
6437
6438 Libraries
6439 ---------
6440
6441 * The [`Extend`] trait, which grows a collection from an iterator, is
6442   implemented over iterators of references, for `String`, `Vec`,
6443   `LinkedList`, `VecDeque`, `EnumSet`, `BinaryHeap`, `VecMap`,
6444   `BTreeSet` and `BTreeMap`. [RFC][extend-rfc].
6445 * The [`iter::once`] function returns an iterator that yields a single
6446   element, and [`iter::empty`] returns an iterator that yields no
6447   elements.
6448 * The [`matches`] and [`rmatches`] methods on `str` return iterators
6449   over substring matches.
6450 * [`Cell`] and [`RefCell`] both implement `Eq`.
6451 * A number of methods for wrapping arithmetic are added to the
6452   integral types, [`wrapping_div`], [`wrapping_rem`],
6453   [`wrapping_neg`], [`wrapping_shl`], [`wrapping_shr`]. These are in
6454   addition to the existing [`wrapping_add`], [`wrapping_sub`], and
6455   [`wrapping_mul`] methods, and alternatives to the [`Wrapping`]
6456   type.. It is illegal for the default arithmetic operations in Rust
6457   to overflow; the desire to wrap must be explicit.
6458 * The `{:#?}` formatting specifier [displays the alternate,
6459   pretty-printed][debugfmt] form of the `Debug` formatter. This
6460   feature was actually introduced prior to 1.0 with little
6461   fanfare.
6462 * [`fmt::Formatter`] implements [`fmt::Write`], a `fmt`-specific trait
6463   for writing data to formatted strings, similar to [`io::Write`].
6464 * [`fmt::Formatter`] adds 'debug builder' methods, [`debug_struct`],
6465   [`debug_tuple`], [`debug_list`], [`debug_set`], [`debug_map`]. These
6466   are used by code generators to emit implementations of [`Debug`].
6467 * `str` has new [`to_uppercase`][strup] and [`to_lowercase`][strlow]
6468   methods that convert case, following Unicode case mapping.
6469 * It is now easier to handle poisoned locks. The [`PoisonError`]
6470   type, returned by failing lock operations, exposes `into_inner`,
6471   `get_ref`, and `get_mut`, which all give access to the inner lock
6472   guard, and allow the poisoned lock to continue to operate. The
6473   `is_poisoned` method of [`RwLock`] and [`Mutex`] can poll for a
6474   poisoned lock without attempting to take the lock.
6475 * On Unix the [`FromRawFd`] trait is implemented for [`Stdio`], and
6476   [`AsRawFd`] for [`ChildStdin`], [`ChildStdout`], [`ChildStderr`].
6477   On Windows the `FromRawHandle` trait is implemented for `Stdio`,
6478   and `AsRawHandle` for `ChildStdin`, `ChildStdout`,
6479   `ChildStderr`.
6480 * [`io::ErrorKind`] has a new variant, `InvalidData`, which indicates
6481   malformed input.
6482
6483 Misc
6484 ----
6485
6486 * `rustc` employs smarter heuristics for guessing at [typos].
6487 * `rustc` emits more efficient code for [no-op conversions between
6488   unsafe pointers][nop].
6489 * Fat pointers are now [passed in pairs of immediate arguments][fat],
6490   resulting in faster compile times and smaller code.
6491
6492 [`Extend`]: https://doc.rust-lang.org/nightly/std/iter/trait.Extend.html
6493 [extend-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0839-embrace-extend-extinguish.md
6494 [`iter::once`]: https://doc.rust-lang.org/nightly/std/iter/fn.once.html
6495 [`iter::empty`]: https://doc.rust-lang.org/nightly/std/iter/fn.empty.html
6496 [`matches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.matches
6497 [`rmatches`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.rmatches
6498 [`Cell`]: https://doc.rust-lang.org/nightly/std/cell/struct.Cell.html
6499 [`RefCell`]: https://doc.rust-lang.org/nightly/std/cell/struct.RefCell.html
6500 [`wrapping_add`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_add
6501 [`wrapping_sub`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_sub
6502 [`wrapping_mul`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_mul
6503 [`wrapping_div`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_div
6504 [`wrapping_rem`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_rem
6505 [`wrapping_neg`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_neg
6506 [`wrapping_shl`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shl
6507 [`wrapping_shr`]: https://doc.rust-lang.org/nightly/std/primitive.i8.html#method.wrapping_shr
6508 [`Wrapping`]: https://doc.rust-lang.org/nightly/std/num/struct.Wrapping.html
6509 [`fmt::Formatter`]: https://doc.rust-lang.org/nightly/std/fmt/struct.Formatter.html
6510 [`fmt::Write`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Write.html
6511 [`io::Write`]: https://doc.rust-lang.org/nightly/std/io/trait.Write.html
6512 [`debug_struct`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_struct
6513 [`debug_tuple`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_tuple
6514 [`debug_list`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_list
6515 [`debug_set`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_set
6516 [`debug_map`]: https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html#method.debug_map
6517 [`Debug`]: https://doc.rust-lang.org/nightly/std/fmt/trait.Debug.html
6518 [strup]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_uppercase
6519 [strlow]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.to_lowercase
6520 [`to_uppercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_uppercase
6521 [`to_lowercase`]: https://doc.rust-lang.org/nightly/std/primitive.char.html#method.to_lowercase
6522 [`PoisonError`]: https://doc.rust-lang.org/nightly/std/sync/struct.PoisonError.html
6523 [`RwLock`]: https://doc.rust-lang.org/nightly/std/sync/struct.RwLock.html
6524 [`Mutex`]: https://doc.rust-lang.org/nightly/std/sync/struct.Mutex.html
6525 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6526 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6527 [`Stdio`]: https://doc.rust-lang.org/nightly/std/process/struct.Stdio.html
6528 [`ChildStdin`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdin.html
6529 [`ChildStdout`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStdout.html
6530 [`ChildStderr`]: https://doc.rust-lang.org/nightly/std/process/struct.ChildStderr.html
6531 [`io::ErrorKind`]: https://doc.rust-lang.org/nightly/std/io/enum.ErrorKind.html
6532 [debugfmt]: https://www.reddit.com/r/rust/comments/3ceaui/psa_produces_prettyprinted_debug_output/
6533 [`DerefMut`]: https://doc.rust-lang.org/nightly/std/ops/trait.DerefMut.html
6534 [`mem::align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.align_of.html
6535 [align]: https://github.com/rust-lang/rust/pull/25646
6536 [`mem::min_align_of`]: https://doc.rust-lang.org/nightly/std/mem/fn.min_align_of.html
6537 [typos]: https://github.com/rust-lang/rust/pull/26087
6538 [nop]: https://github.com/rust-lang/rust/pull/26336
6539 [fat]: https://github.com/rust-lang/rust/pull/26411
6540 [dst]: https://github.com/rust-lang/rfcs/blob/master/text/0982-dst-coercion.md
6541 [parcodegen]: https://github.com/rust-lang/rust/pull/26018
6542 [packed]: https://github.com/rust-lang/rust/pull/25541
6543 [ad]: https://github.com/rust-lang/rust/pull/27382
6544 [win]: https://github.com/rust-lang/rust/pull/25350
6545
6546 Version 1.1.0 (2015-06-25)
6547 =========================
6548
6549 * ~850 changes, numerous bugfixes
6550
6551 Highlights
6552 ----------
6553
6554 * The [`std::fs` module has been expanded][fs] to expand the set of
6555   functionality exposed:
6556   * `DirEntry` now supports optimizations like `file_type` and `metadata` which
6557     don't incur a syscall on some platforms.
6558   * A `symlink_metadata` function has been added.
6559   * The `fs::Metadata` structure now lowers to its OS counterpart, providing
6560     access to all underlying information.
6561 * The compiler now contains extended explanations of many errors. When an error
6562   with an explanation occurs the compiler suggests using the `--explain` flag
6563   to read the explanation. Error explanations are also [available online][err-index].
6564 * Thanks to multiple [improvements][sk] to [type checking][pre], as
6565   well as other work, the time to bootstrap the compiler decreased by
6566   32%.
6567
6568 Libraries
6569 ---------
6570
6571 * The [`str::split_whitespace`] method splits a string on unicode
6572   whitespace boundaries.
6573 * On both Windows and Unix, new extension traits provide conversion of
6574   I/O types to and from the underlying system handles. On Unix, these
6575   traits are [`FromRawFd`] and [`AsRawFd`], on Windows `FromRawHandle`
6576   and `AsRawHandle`. These are implemented for `File`, `TcpStream`,
6577   `TcpListener`, and `UpdSocket`. Further implementations for
6578   `std::process` will be stabilized later.
6579 * On Unix, [`std::os::unix::symlink`] creates symlinks. On
6580   Windows, symlinks can be created with
6581   `std::os::windows::symlink_dir` and
6582   `std::os::windows::symlink_file`.
6583 * The `mpsc::Receiver` type can now be converted into an iterator with
6584   `into_iter` on the [`IntoIterator`] trait.
6585 * `Ipv4Addr` can be created from `u32` with the `From<u32>`
6586   implementation of the [`From`] trait.
6587 * The `Debug` implementation for `RangeFull` [creates output that is
6588   more consistent with other implementations][rf].
6589 * [`Debug` is implemented for `File`][file].
6590 * The `Default` implementation for `Arc` [no longer requires `Sync +
6591   Send`][arc].
6592 * [The `Iterator` methods `count`, `nth`, and `last` have been
6593   overridden for slices to have O(1) performance instead of O(n)][si].
6594 * Incorrect handling of paths on Windows has been improved in both the
6595   compiler and the standard library.
6596 * [`AtomicPtr` gained a `Default` implementation][ap].
6597 * In accordance with Rust's policy on arithmetic overflow `abs` now
6598   [panics on overflow when debug assertions are enabled][abs].
6599 * The [`Cloned`] iterator, which was accidentally left unstable for
6600   1.0 [has been stabilized][c].
6601 * The [`Incoming`] iterator, which iterates over incoming TCP
6602   connections, and which was accidentally unnamable in 1.0, [is now
6603   properly exported][inc].
6604 * [`BinaryHeap`] no longer corrupts itself [when functions called by
6605   `sift_up` or `sift_down` panic][bh].
6606 * The [`split_off`] method of `LinkedList` [no longer corrupts
6607   the list in certain scenarios][ll].
6608
6609 Misc
6610 ----
6611
6612 * Type checking performance [has improved notably][sk] with
6613   [multiple improvements][pre].
6614 * The compiler [suggests code changes][ch] for more errors.
6615 * rustc and it's build system have experimental support for [building
6616   toolchains against MUSL][m] instead of glibc on Linux.
6617 * The compiler defines the `target_env` cfg value, which is used for
6618   distinguishing toolchains that are otherwise for the same
6619   platform. Presently this is set to `gnu` for common GNU Linux
6620   targets and for MinGW targets, and `musl` for MUSL Linux targets.
6621 * The [`cargo rustc`][crc] command invokes a build with custom flags
6622   to rustc.
6623 * [Android executables are always position independent][pie].
6624 * [The `drop_with_repr_extern` lint warns about mixing `repr(C)`
6625   with `Drop`][drop].
6626
6627 [`str::split_whitespace`]: https://doc.rust-lang.org/nightly/std/primitive.str.html#method.split_whitespace
6628 [`FromRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.FromRawFd.html
6629 [`AsRawFd`]: https://doc.rust-lang.org/nightly/std/os/unix/io/trait.AsRawFd.html
6630 [`std::os::unix::symlink`]: https://doc.rust-lang.org/nightly/std/os/unix/fs/fn.symlink.html
6631 [`IntoIterator`]: https://doc.rust-lang.org/nightly/std/iter/trait.IntoIterator.html
6632 [`From`]: https://doc.rust-lang.org/nightly/std/convert/trait.From.html
6633 [rf]: https://github.com/rust-lang/rust/pull/24491
6634 [err-index]: https://doc.rust-lang.org/error-index.html
6635 [sk]: https://github.com/rust-lang/rust/pull/24615
6636 [pre]: https://github.com/rust-lang/rust/pull/25323
6637 [file]: https://github.com/rust-lang/rust/pull/24598
6638 [ch]: https://github.com/rust-lang/rust/pull/24683
6639 [arc]: https://github.com/rust-lang/rust/pull/24695
6640 [si]: https://github.com/rust-lang/rust/pull/24701
6641 [ap]: https://github.com/rust-lang/rust/pull/24834
6642 [m]: https://github.com/rust-lang/rust/pull/24777
6643 [fs]: https://github.com/rust-lang/rfcs/blob/master/text/1044-io-fs-2.1.md
6644 [crc]: https://github.com/rust-lang/cargo/pull/1568
6645 [pie]: https://github.com/rust-lang/rust/pull/24953
6646 [abs]: https://github.com/rust-lang/rust/pull/25441
6647 [c]: https://github.com/rust-lang/rust/pull/25496
6648 [`Cloned`]: https://doc.rust-lang.org/nightly/std/iter/struct.Cloned.html
6649 [`Incoming`]: https://doc.rust-lang.org/nightly/std/net/struct.Incoming.html
6650 [inc]: https://github.com/rust-lang/rust/pull/25522
6651 [bh]: https://github.com/rust-lang/rust/pull/25856
6652 [`BinaryHeap`]: https://doc.rust-lang.org/nightly/std/collections/struct.BinaryHeap.html
6653 [ll]: https://github.com/rust-lang/rust/pull/26022
6654 [`split_off`]: https://doc.rust-lang.org/nightly/collections/linked_list/struct.LinkedList.html#method.split_off
6655 [drop]: https://github.com/rust-lang/rust/pull/24935
6656
6657 Version 1.0.0 (2015-05-15)
6658 ========================
6659
6660 * ~1500 changes, numerous bugfixes
6661
6662 Highlights
6663 ----------
6664
6665 * The vast majority of the standard library is now `#[stable]`. It is
6666   no longer possible to use unstable features with a stable build of
6667   the compiler.
6668 * Many popular crates on [crates.io] now work on the stable release
6669   channel.
6670 * Arithmetic on basic integer types now [checks for overflow in debug
6671   builds][overflow].
6672
6673 Language
6674 --------
6675
6676 * Several [restrictions have been added to trait coherence][coh] in
6677   order to make it easier for upstream authors to change traits
6678   without breaking downstream code.
6679 * Digits of binary and octal literals are [lexed more eagerly][lex] to
6680   improve error messages and macro behavior. For example, `0b1234` is
6681   now lexed as `0b1234` instead of two tokens, `0b1` and `234`.
6682 * Trait bounds [are always invariant][inv], eliminating the need for
6683   the `PhantomFn` and `MarkerTrait` lang items, which have been
6684   removed.
6685 * ["-" is no longer a valid character in crate names][cr], the `extern crate
6686   "foo" as bar` syntax has been replaced with `extern crate foo as
6687   bar`, and Cargo now automatically translates "-" in *package* names
6688   to underscore for the crate name.
6689 * [Lifetime shadowing is an error][lt].
6690 * [`Send` no longer implies `'static`][send-rfc].
6691 * [UFCS now supports trait-less associated paths][moar-ufcs] like
6692   `MyType::default()`.
6693 * Primitive types [now have inherent methods][prim-inherent],
6694   obviating the need for extension traits like `SliceExt`.
6695 * Methods with `Self: Sized` in their `where` clause are [considered
6696   object-safe][self-sized], allowing many extension traits like
6697   `IteratorExt` to be merged into the traits they extended.
6698 * You can now [refer to associated types][assoc-where] whose
6699   corresponding trait bounds appear only in a `where` clause.
6700 * The final bits of [OIBIT landed][oibit-final], meaning that traits
6701   like `Send` and `Sync` are now library-defined.
6702 * A [Reflect trait][reflect] was introduced, which means that
6703   downcasting via the `Any` trait is effectively limited to concrete
6704   types. This helps retain the potentially-important "parametricity"
6705   property: generic code cannot behave differently for different type
6706   arguments except in minor ways.
6707 * The `unsafe_destructor` feature is now deprecated in favor of the
6708   [new `dropck`][dropck]. This change is a major reduction in unsafe
6709   code.
6710
6711 Libraries
6712 ---------
6713
6714 * The `thread_local` module [has been renamed to `std::thread`][th].
6715 * The methods of `IteratorExt` [have been moved to the `Iterator`
6716   trait itself][ie].
6717 * Several traits that implement Rust's conventions for type
6718   conversions, `AsMut`, `AsRef`, `From`, and `Into` have been
6719   [centralized in the `std::convert` module][con].
6720 * The `FromError` trait [was removed in favor of `From`][fe].
6721 * The basic sleep function [has moved to
6722   `std::thread::sleep_ms`][slp].
6723 * The `splitn` function now takes an `n` parameter that represents the
6724   number of items yielded by the returned iterator [instead of the
6725   number of 'splits'][spl].
6726 * [On Unix, all file descriptors are `CLOEXEC` by default][clo].
6727 * [Derived implementations of `PartialOrd` now order enums according
6728   to their explicitly-assigned discriminants][po].
6729 * [Methods for searching strings are generic over `Pattern`s][pat],
6730   implemented presently by `&char`, `&str`, `FnMut(char) -> bool` and
6731   some others.
6732 * [In method resolution, object methods are resolved before inherent
6733   methods][meth].
6734 * [`String::from_str` has been deprecated in favor of the `From` impl,
6735   `String::from`][sf].
6736 * [`io::Error` implements `Sync`][ios].
6737 * [The `words` method on `&str` has been replaced with
6738   `split_whitespace`][sw], to avoid answering the tricky question, 'what is
6739   a word?'
6740 * The new path and IO modules are complete and `#[stable]`. This
6741   was the major library focus for this cycle.
6742 * The path API was [revised][path-normalize] to normalize `.`,
6743   adjusting the tradeoffs in favor of the most common usage.
6744 * A large number of remaining APIs in `std` were also stabilized
6745   during this cycle; about 75% of the non-deprecated API surface
6746   is now stable.
6747 * The new [string pattern API][string-pattern] landed, which makes
6748   the string slice API much more internally consistent and flexible.
6749 * A new set of [generic conversion traits][conversion] replaced
6750   many existing ad hoc traits.
6751 * Generic numeric traits were [completely removed][num-traits]. This
6752   was made possible thanks to inherent methods for primitive types,
6753   and the removal gives maximal flexibility for designing a numeric
6754   hierarchy in the future.
6755 * The `Fn` traits are now related via [inheritance][fn-inherit]
6756   and provide ergonomic [blanket implementations][fn-blanket].
6757 * The `Index` and `IndexMut` traits were changed to
6758   [take the index by value][index-value], enabling code like
6759   `hash_map["string"]` to work.
6760 * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
6761   `Copy` data is known to be `Clone` as well.
6762
6763 Misc
6764 ----
6765
6766 * Many errors now have extended explanations that can be accessed with
6767   the `--explain` flag to `rustc`.
6768 * Many new examples have been added to the standard library
6769   documentation.
6770 * rustdoc has received a number of improvements focused on completion
6771   and polish.
6772 * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
6773 * Much headway was made on ecosystem-wide CI, making it possible
6774   to [compare builds for breakage][ci-compare].
6775
6776
6777 [crates.io]: http://crates.io
6778 [clo]: https://github.com/rust-lang/rust/pull/24034
6779 [coh]: https://github.com/rust-lang/rfcs/blob/master/text/1023-rebalancing-coherence.md
6780 [con]: https://github.com/rust-lang/rust/pull/23875
6781 [cr]: https://github.com/rust-lang/rust/pull/23419
6782 [fe]: https://github.com/rust-lang/rust/pull/23879
6783 [ie]: https://github.com/rust-lang/rust/pull/23300
6784 [inv]: https://github.com/rust-lang/rust/pull/23938
6785 [ios]: https://github.com/rust-lang/rust/pull/24133
6786 [lex]: https://github.com/rust-lang/rfcs/blob/master/text/0879-small-base-lexing.md
6787 [lt]: https://github.com/rust-lang/rust/pull/24057
6788 [meth]: https://github.com/rust-lang/rust/pull/24056
6789 [pat]: https://github.com/rust-lang/rfcs/blob/master/text/0528-string-patterns.md
6790 [po]: https://github.com/rust-lang/rust/pull/24270
6791 [sf]: https://github.com/rust-lang/rust/pull/24517
6792 [slp]: https://github.com/rust-lang/rust/pull/23949
6793 [spl]: https://github.com/rust-lang/rfcs/blob/master/text/0979-align-splitn-with-other-languages.md
6794 [sw]: https://github.com/rust-lang/rfcs/blob/master/text/1054-str-words.md
6795 [th]: https://github.com/rust-lang/rfcs/blob/master/text/0909-move-thread-local-to-std-thread.md
6796 [send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
6797 [moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
6798 [prim-inherent]: https://github.com/rust-lang/rust/pull/23104
6799 [overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
6800 [metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
6801 [self-sized]: https://github.com/rust-lang/rust/pull/22301
6802 [assoc-where]: https://github.com/rust-lang/rust/pull/22512
6803 [string-pattern]: https://github.com/rust-lang/rust/pull/22466
6804 [oibit-final]: https://github.com/rust-lang/rust/pull/21689
6805 [reflect]: https://github.com/rust-lang/rust/pull/23712
6806 [conversion]: https://github.com/rust-lang/rfcs/pull/529
6807 [num-traits]: https://github.com/rust-lang/rust/pull/23549
6808 [index-value]: https://github.com/rust-lang/rust/pull/23601
6809 [dropck]: https://github.com/rust-lang/rfcs/pull/769
6810 [ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
6811 [fn-inherit]: https://github.com/rust-lang/rust/pull/23282
6812 [fn-blanket]: https://github.com/rust-lang/rust/pull/23895
6813 [copy-clone]: https://github.com/rust-lang/rust/pull/23860
6814 [path-normalize]: https://github.com/rust-lang/rust/pull/23229
6815
6816
6817 Version 1.0.0-alpha.2 (2015-02-20)
6818 =====================================
6819
6820 * ~1300 changes, numerous bugfixes
6821
6822 * Highlights
6823
6824     * The various I/O modules were [overhauled][io-rfc] to reduce
6825       unnecessary abstractions and provide better interoperation with
6826       the underlying platform. The old `io` module remains temporarily
6827       at `std::old_io`.
6828     * The standard library now [participates in feature gating][feat],
6829       so use of unstable libraries now requires a `#![feature(...)]`
6830       attribute. The impact of this change is [described on the
6831       forum][feat-forum]. [RFC][feat-rfc].
6832
6833 * Language
6834
6835     * `for` loops [now operate on the `IntoIterator` trait][into],
6836       which eliminates the need to call `.iter()`, etc. to iterate
6837       over collections. There are some new subtleties to remember
6838       though regarding what sort of iterators various types yield, in
6839       particular that `for foo in bar { }` yields values from a move
6840       iterator, destroying the original collection. [RFC][into-rfc].
6841     * Objects now have [default lifetime bounds][obj], so you don't
6842       have to write `Box<Trait+'static>` when you don't care about
6843       storing references. [RFC][obj-rfc].
6844     * In types that implement `Drop`, [lifetimes must outlive the
6845       value][drop]. This will soon make it possible to safely
6846       implement `Drop` for types where `#[unsafe_destructor]` is now
6847       required. Read the [gorgeous RFC][drop-rfc] for details.
6848     * The fully qualified <T as Trait>::X syntax lets you set the Self
6849       type for a trait method or associated type. [RFC][ufcs-rfc].
6850     * References to types that implement `Deref<U>` now [automatically
6851       coerce to references][deref] to the dereferenced type `U`,
6852       e.g. `&T where T: Deref<U>` automatically coerces to `&U`. This
6853       should eliminate many unsightly uses of `&*`, as when converting
6854       from references to vectors into references to
6855       slices. [RFC][deref-rfc].
6856     * The explicit [closure kind syntax][close] (`|&:|`, `|&mut:|`,
6857       `|:|`) is obsolete and closure kind is inferred from context.
6858     * [`Self` is a keyword][Self].
6859
6860 * Libraries
6861
6862     * The `Show` and `String` formatting traits [have been
6863       renamed][fmt] to `Debug` and `Display` to more clearly reflect
6864       their related purposes. Automatically getting a string
6865       conversion to use with `format!("{:?}", something_to_debug)` is
6866       now written `#[derive(Debug)]`.
6867     * Abstract [OS-specific string types][osstr], `std::ff::{OsString,
6868       OsStr}`, provide strings in platform-specific encodings for easier
6869       interop with system APIs. [RFC][osstr-rfc].
6870     * The `boxed::into_raw` and `Box::from_raw` functions [convert
6871       between `Box<T>` and `*mut T`][boxraw], a common pattern for
6872       creating raw pointers.
6873
6874 * Tooling
6875
6876     * Certain long error messages of the form 'expected foo found bar'
6877       are now [split neatly across multiple
6878       lines][multiline]. Examples in the PR.
6879     * On Unix Rust can be [uninstalled][un] by running
6880       `/usr/local/lib/rustlib/uninstall.sh`.
6881     * The `#[rustc_on_unimplemented]` attribute, requiring the
6882       'on_unimplemented' feature, lets rustc [display custom error
6883       messages when a trait is expected to be implemented for a type
6884       but is not][onun].
6885
6886 * Misc
6887
6888     * Rust is tested against a [LALR grammar][lalr], which parses
6889       almost all the Rust files that rustc does.
6890
6891 [boxraw]: https://github.com/rust-lang/rust/pull/21318
6892 [close]: https://github.com/rust-lang/rust/pull/21843
6893 [deref]: https://github.com/rust-lang/rust/pull/21351
6894 [deref-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0241-deref-conversions.md
6895 [drop]: https://github.com/rust-lang/rust/pull/21972
6896 [drop-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0769-sound-generic-drop.md
6897 [feat]: https://github.com/rust-lang/rust/pull/21248
6898 [feat-forum]: https://users.rust-lang.org/t/psa-important-info-about-rustcs-new-feature-staging/82/5
6899 [feat-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0507-release-channels.md
6900 [fmt]: https://github.com/rust-lang/rust/pull/21457
6901 [into]: https://github.com/rust-lang/rust/pull/20790
6902 [into-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md#intoiterator-and-iterable
6903 [io-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6904 [lalr]: https://github.com/rust-lang/rust/pull/21452
6905 [multiline]: https://github.com/rust-lang/rust/pull/19870
6906 [obj]: https://github.com/rust-lang/rust/pull/22230
6907 [obj-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0599-default-object-bound.md
6908 [onun]: https://github.com/rust-lang/rust/pull/20889
6909 [osstr]: https://github.com/rust-lang/rust/pull/21488
6910 [osstr-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0517-io-os-reform.md
6911 [Self]: https://github.com/rust-lang/rust/pull/22158
6912 [ufcs-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0132-ufcs.md
6913 [un]: https://github.com/rust-lang/rust/pull/22256
6914
6915
6916 Version 1.0.0-alpha (2015-01-09)
6917 ==================================
6918
6919   * ~2400 changes, numerous bugfixes
6920
6921   * Highlights
6922
6923     * The language itself is considered feature complete for 1.0,
6924       though there will be many usability improvements and bugfixes
6925       before the final release.
6926     * Nearly 50% of the public API surface of the standard library has
6927       been declared 'stable'. Those interfaces are unlikely to change
6928       before 1.0.
6929     * The long-running debate over integer types has been
6930       [settled][ints]: Rust will ship with types named `isize` and
6931       `usize`, rather than `int` and `uint`, for pointer-sized
6932       integers. Guidelines will be rolled out during the alpha cycle.
6933     * Most crates that are not `std` have been moved out of the Rust
6934       distribution into the Cargo ecosystem so they can evolve
6935       separately and don't need to be stabilized as quickly, including
6936       'time', 'getopts', 'num', 'regex', and 'term'.
6937     * Documentation continues to be expanded with more API coverage, more
6938       examples, and more in-depth explanations. The guides have been
6939       consolidated into [The Rust Programming Language][trpl].
6940     * "[Rust By Example][rbe]" is now maintained by the Rust team.
6941     * All official Rust binary installers now come with [Cargo], the
6942       Rust package manager.
6943
6944 * Language
6945
6946     * Closures have been [completely redesigned][unboxed] to be
6947       implemented in terms of traits, can now be used as generic type
6948       bounds and thus monomorphized and inlined, or via an opaque
6949       pointer (boxed) as in the old system. The new system is often
6950       referred to as 'unboxed' closures.
6951     * Traits now support [associated types][assoc], allowing families
6952       of related types to be defined together and used generically in
6953       powerful ways.
6954     * Enum variants are [namespaced by their type names][enum].
6955     * [`where` clauses][where] provide a more versatile and attractive
6956       syntax for specifying generic bounds, though the previous syntax
6957       remains valid.
6958     * Rust again picks a [fallback][fb] (either i32 or f64) for uninferred
6959       numeric types.
6960     * Rust [no longer has a runtime][rt] of any description, and only
6961       supports OS threads, not green threads.
6962     * At long last, Rust has been overhauled for 'dynamically-sized
6963       types' ([DST]), which integrates 'fat pointers' (object types,
6964       arrays, and `str`) more deeply into the type system, making it
6965       more consistent.
6966     * Rust now has a general [range syntax][range], `i..j`, `i..`, and
6967       `..j` that produce range types and which, when combined with the
6968       `Index` operator and multidispatch, leads to a convenient slice
6969       notation, `[i..j]`.
6970     * The new range syntax revealed an ambiguity in the fixed-length
6971       array syntax, so now fixed length arrays [are written `[T;
6972       N]`][arrays].
6973     * The `Copy` trait is no longer implemented automatically. Unsafe
6974       pointers no longer implement `Sync` and `Send` so types
6975       containing them don't automatically either. `Sync` and `Send`
6976       are now 'unsafe traits' so one can "forcibly" implement them via
6977       `unsafe impl` if a type confirms to the requirements for them
6978       even though the internals do not (e.g. structs containing unsafe
6979       pointers like `Arc`). These changes are intended to prevent some
6980       footguns and are collectively known as [opt-in built-in
6981       traits][oibit] (though `Sync` and `Send` will soon become pure
6982       library types unknown to the compiler).
6983     * Operator traits now take their operands [by value][ops], and
6984       comparison traits can use multidispatch to compare one type
6985       against multiple other types, allowing e.g. `String` to be
6986       compared with `&str`.
6987     * `if let` and `while let` are no longer feature-gated.
6988     * Rust has adopted a more [uniform syntax for escaping unicode
6989       characters][unicode].
6990     * `macro_rules!` [has been declared stable][mac]. Though it is a
6991       flawed system it is sufficiently popular that it must be usable
6992       for 1.0. Effort has gone into [future-proofing][mac-future] it
6993       in ways that will allow other macro systems to be developed in
6994       parallel, and won't otherwise impact the evolution of the
6995       language.
6996     * The prelude has been [pared back significantly][prelude] such
6997       that it is the minimum necessary to support the most pervasive
6998       code patterns, and through [generalized where clauses][where]
6999       many of the prelude extension traits have been consolidated.
7000     * Rust's rudimentary reflection [has been removed][refl], as it
7001       incurred too much code generation for little benefit.
7002     * [Struct variants][structvars] are no longer feature-gated.
7003     * Trait bounds can be [polymorphic over lifetimes][hrtb]. Also
7004       known as 'higher-ranked trait bounds', this crucially allows
7005       unboxed closures to work.
7006     * Macros invocations surrounded by parens or square brackets and
7007       not terminated by a semicolon are [parsed as
7008       expressions][macros], which makes expressions like `vec![1i32,
7009       2, 3].len()` work as expected.
7010     * Trait objects now implement their traits automatically, and
7011       traits that can be coerced to objects now must be [object
7012       safe][objsafe].
7013     * Automatically deriving traits is now done with `#[derive(...)]`
7014       not `#[deriving(...)]` for [consistency with other naming
7015       conventions][derive].
7016     * Importing the containing module or enum at the same time as
7017       items or variants they contain is [now done with `self` instead
7018       of `mod`][self], as in use `foo::{self, bar}`
7019     * Glob imports are no longer feature-gated.
7020     * The `box` operator and `box` patterns have been feature-gated
7021       pending a redesign. For now unique boxes should be allocated
7022       like other containers, with `Box::new`.
7023
7024 * Libraries
7025
7026     * A [series][coll1] of [efforts][coll2] to establish
7027       [conventions][coll3] for collections types has resulted in API
7028       improvements throughout the standard library.
7029     * New [APIs for error handling][err] provide ergonomic interop
7030       between error types, and [new conventions][err-conv] describe
7031       more clearly the recommended error handling strategies in Rust.
7032     * The `fail!` macro has been renamed to [`panic!`][panic] so that
7033       it is easier to discuss failure in the context of error handling
7034       without making clarifications as to whether you are referring to
7035       the 'fail' macro or failure more generally.
7036     * On Linux, `OsRng` prefers the new, more reliable `getrandom`
7037       syscall when available.
7038     * The 'serialize' crate has been renamed 'rustc-serialize' and
7039       moved out of the distribution to Cargo. Although it is widely
7040       used now, it is expected to be superseded in the near future.
7041     * The `Show` formatter, typically implemented with
7042       `#[derive(Show)]` is [now requested with the `{:?}`
7043       specifier][show] and is intended for use by all types, for uses
7044       such as `println!` debugging. The new `String` formatter must be
7045       implemented by hand, uses the `{}` specifier, and is intended
7046       for full-fidelity conversions of things that can logically be
7047       represented as strings.
7048
7049 * Tooling
7050
7051     * [Flexible target specification][flex] allows rustc's code
7052       generation to be configured to support otherwise-unsupported
7053       platforms.
7054     * Rust comes with rust-gdb and rust-lldb scripts that launch their
7055       respective debuggers with Rust-appropriate pretty-printing.
7056     * The Windows installation of Rust is distributed with the
7057       MinGW components currently required to link binaries on that
7058       platform.
7059
7060 * Misc
7061
7062     * Nullable enum optimizations have been extended to more types so
7063       that e.g. `Option<Vec<T>>` and `Option<String>` take up no more
7064       space than the inner types themselves.
7065     * Work has begun on supporting AArch64.
7066
7067 [Cargo]: https://crates.io
7068 [unboxed]: http://smallcultfollowing.com/babysteps/blog/2014/11/26/purging-proc/
7069 [enum]: https://github.com/rust-lang/rfcs/blob/master/text/0390-enum-namespacing.md
7070 [flex]: https://github.com/rust-lang/rfcs/blob/master/text/0131-target-specification.md
7071 [err]: https://github.com/rust-lang/rfcs/blob/master/text/0201-error-chaining.md
7072 [err-conv]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md
7073 [rt]: https://github.com/rust-lang/rfcs/blob/master/text/0230-remove-runtime.md
7074 [mac]: https://github.com/rust-lang/rfcs/blob/master/text/0453-macro-reform.md
7075 [mac-future]: https://github.com/rust-lang/rfcs/pull/550
7076 [DST]: http://smallcultfollowing.com/babysteps/blog/2014/01/05/dst-take-5/
7077 [coll1]: https://github.com/rust-lang/rfcs/blob/master/text/0235-collections-conventions.md
7078 [coll2]: https://github.com/rust-lang/rfcs/blob/master/text/0509-collections-reform-part-2.md
7079 [coll3]: https://github.com/rust-lang/rfcs/blob/master/text/0216-collection-views.md
7080 [ops]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md
7081 [prelude]: https://github.com/rust-lang/rfcs/blob/master/text/0503-prelude-stabilization.md
7082 [where]: https://github.com/rust-lang/rfcs/blob/master/text/0135-where.md
7083 [refl]: https://github.com/rust-lang/rfcs/blob/master/text/0379-remove-reflection.md
7084 [panic]: https://github.com/rust-lang/rfcs/blob/master/text/0221-panic.md
7085 [structvars]: https://github.com/rust-lang/rfcs/blob/master/text/0418-struct-variants.md
7086 [hrtb]: https://github.com/rust-lang/rfcs/blob/master/text/0387-higher-ranked-trait-bounds.md
7087 [unicode]: https://github.com/rust-lang/rfcs/blob/master/text/0446-es6-unicode-escapes.md
7088 [oibit]: https://github.com/rust-lang/rfcs/blob/master/text/0019-opt-in-builtin-traits.md
7089 [macros]: https://github.com/rust-lang/rfcs/blob/master/text/0378-expr-macros.md
7090 [range]: https://github.com/rust-lang/rfcs/blob/master/text/0439-cmp-ops-reform.md#indexing-and-slicing
7091 [arrays]: https://github.com/rust-lang/rfcs/blob/master/text/0520-new-array-repeat-syntax.md
7092 [show]: https://github.com/rust-lang/rfcs/blob/master/text/0504-show-stabilization.md
7093 [derive]: https://github.com/rust-lang/rfcs/blob/master/text/0534-deriving2derive.md
7094 [self]: https://github.com/rust-lang/rfcs/blob/master/text/0532-self-in-use.md
7095 [fb]: https://github.com/rust-lang/rfcs/blob/master/text/0212-restore-int-fallback.md
7096 [objsafe]: https://github.com/rust-lang/rfcs/blob/master/text/0255-object-safety.md
7097 [assoc]: https://github.com/rust-lang/rfcs/blob/master/text/0195-associated-items.md
7098 [ints]: https://github.com/rust-lang/rfcs/pull/544#issuecomment-68760871
7099 [trpl]: https://doc.rust-lang.org/book/index.html
7100 [rbe]: http://rustbyexample.com/
7101
7102
7103 Version 0.12.0 (2014-10-09)
7104 =============================
7105
7106   * ~1900 changes, numerous bugfixes
7107
7108   * Highlights
7109
7110     * The introductory documentation (now called The Rust Guide) has
7111       been completely rewritten, as have a number of supplementary
7112       guides.
7113     * Rust's package manager, Cargo, continues to improve and is
7114       sometimes considered to be quite awesome.
7115     * Many API's in `std` have been reviewed and updated for
7116       consistency with the in-development Rust coding
7117       guidelines. The standard library documentation tracks
7118       stabilization progress.
7119     * Minor libraries have been moved out-of-tree to the rust-lang org
7120       on GitHub: uuid, semver, glob, num, hexfloat, fourcc. They can
7121       be installed with Cargo.
7122     * Lifetime elision allows lifetime annotations to be left off of
7123       function declarations in many common scenarios.
7124     * Rust now works on 64-bit Windows.
7125
7126   * Language
7127     * Indexing can be overloaded with the `Index` and `IndexMut`
7128       traits.
7129     * The `if let` construct takes a branch only if the `let` pattern
7130       matches, currently behind the 'if_let' feature gate.
7131     * 'where clauses', a more flexible syntax for specifying trait
7132       bounds that is more aesthetic, have been added for traits and
7133       free functions. Where clauses will in the future make it
7134       possible to constrain associated types, which would be
7135       impossible with the existing syntax.
7136     * A new slicing syntax (e.g. `[0..4]`) has been introduced behind
7137       the 'slicing_syntax' feature gate, and can be overloaded with
7138       the `Slice` or `SliceMut` traits.
7139     * The syntax for matching of sub-slices has been changed to use a
7140       postfix `..` instead of prefix (.e.g. `[a, b, c..]`), for
7141       consistency with other uses of `..` and to future-proof
7142       potential additional uses of the syntax.
7143     * The syntax for matching inclusive ranges in patterns has changed
7144       from `0..3` to `0...4` to be consistent with the exclusive range
7145       syntax for slicing.
7146     * Matching of sub-slices in non-tail positions (e.g.  `[a.., b,
7147       c]`) has been put behind the 'advanced_slice_patterns' feature
7148       gate and may be removed in the future.
7149     * Components of tuples and tuple structs can be extracted using
7150       the `value.0` syntax, currently behind the `tuple_indexing`
7151       feature gate.
7152     * The `#[crate_id]` attribute is no longer supported; versioning
7153       is handled by the package manager.
7154     * Renaming crate imports are now written `extern crate foo as bar`
7155       instead of `extern crate bar = foo`.
7156     * Renaming use statements are now written `use foo as bar` instead
7157       of `use bar = foo`.
7158     * `let` and `match` bindings and argument names in macros are now
7159       hygienic.
7160     * The new, more efficient, closure types ('unboxed closures') have
7161       been added under a feature gate, 'unboxed_closures'. These will
7162       soon replace the existing closure types, once higher-ranked
7163       trait lifetimes are added to the language.
7164     * `move` has been added as a keyword, for indicating closures
7165       that capture by value.
7166     * Mutation and assignment is no longer allowed in pattern guards.
7167     * Generic structs and enums can now have trait bounds.
7168     * The `Share` trait is now called `Sync` to free up the term
7169       'shared' to refer to 'shared reference' (the default reference
7170       type.
7171     * Dynamically-sized types have been mostly implemented,
7172       unifying the behavior of fat-pointer types with the rest of the
7173       type system.
7174     * As part of dynamically-sized types, the `Sized` trait has been
7175       introduced, which qualifying types implement by default, and
7176       which type parameters expect by default. To specify that a type
7177       parameter does not need to be sized, write `<Sized? T>`. Most
7178       types are `Sized`, notable exceptions being unsized arrays
7179       (`[T]`) and trait types.
7180     * Closures can return `!`, as in `|| -> !` or `proc() -> !`.
7181     * Lifetime bounds can now be applied to type parameters and object
7182       types.
7183     * The old, reference counted GC type, `Gc<T>` which was once
7184       denoted by the `@` sigil, has finally been removed. GC will be
7185       revisited in the future.
7186
7187   * Libraries
7188     * Library documentation has been improved for a number of modules.
7189     * Bit-vectors, collections::bitv has been modernized.
7190     * The url crate is deprecated in favor of
7191       http://github.com/servo/rust-url, which can be installed with
7192       Cargo.
7193     * Most I/O stream types can be cloned and subsequently closed from
7194       a different thread.
7195     * A `std::time::Duration` type has been added for use in I/O
7196       methods that rely on timers, as well as in the 'time' crate's
7197       `Timespec` arithmetic.
7198     * The runtime I/O abstraction layer that enabled the green thread
7199       scheduler to do non-thread-blocking I/O has been removed, along
7200       with the libuv-based implementation employed by the green thread
7201       scheduler. This will greatly simplify the future I/O work.
7202     * `collections::btree` has been rewritten to have a more
7203       idiomatic and efficient design.
7204
7205   * Tooling
7206     * rustdoc output now indicates the stability levels of API's.
7207     * The `--crate-name` flag can specify the name of the crate
7208       being compiled, like `#[crate_name]`.
7209     * The `-C metadata` specifies additional metadata to hash into
7210       symbol names, and `-C extra-filename` specifies additional
7211       information to put into the output filename, for use by the
7212       package manager for versioning.
7213     * debug info generation has continued to improve and should be
7214       more reliable under both gdb and lldb.
7215     * rustc has experimental support for compiling in parallel
7216       using the `-C codegen-units` flag.
7217     * rustc no longer encodes rpath information into binaries by
7218       default.
7219
7220   * Misc
7221     * Stack usage has been optimized with LLVM lifetime annotations.
7222     * Official Rust binaries on Linux are more compatible with older
7223       kernels and distributions, built on CentOS 5.10.
7224
7225
7226 Version 0.11.0 (2014-07-02)
7227 ==========================
7228
7229   * ~1700 changes, numerous bugfixes
7230
7231   * Language
7232     * ~[T] has been removed from the language. This type is superseded by
7233       the Vec<T> type.
7234     * ~str has been removed from the language. This type is superseded by
7235       the String type.
7236     * ~T has been removed from the language. This type is superseded by the
7237       Box<T> type.
7238     * @T has been removed from the language. This type is superseded by the
7239       standard library's std::gc::Gc<T> type.
7240     * Struct fields are now all private by default.
7241     * Vector indices and shift amounts are both required to be a `uint`
7242       instead of any integral type.
7243     * Byte character, byte string, and raw byte string literals are now all
7244       supported by prefixing the normal literal with a `b`.
7245     * Multiple ABIs are no longer allowed in an ABI string
7246     * The syntax for lifetimes on closures/procedures has been tweaked
7247       slightly: `<'a>|A, B|: 'b + K -> T`
7248     * Floating point modulus has been removed from the language; however it
7249       is still provided by a library implementation.
7250     * Private enum variants are now disallowed.
7251     * The `priv` keyword has been removed from the language.
7252     * A closure can no longer be invoked through a &-pointer.
7253     * The `use foo, bar, baz;` syntax has been removed from the language.
7254     * The transmute intrinsic no longer works on type parameters.
7255     * Statics now allow blocks/items in their definition.
7256     * Trait bounds are separated from objects with + instead of : now.
7257     * Objects can no longer be read while they are mutably borrowed.
7258     * The address of a static is now marked as insignificant unless the
7259       #[inline(never)] attribute is placed it.
7260     * The #[unsafe_destructor] attribute is now behind a feature gate.
7261     * Struct literals are no longer allowed in ambiguous positions such as
7262       if, while, match, and for..in.
7263     * Declaration of lang items and intrinsics are now feature-gated by
7264       default.
7265     * Integral literals no longer default to `int`, and floating point
7266       literals no longer default to `f64`. Literals must be suffixed with an
7267       appropriate type if inference cannot determine the type of the
7268       literal.
7269     * The Box<T> type is no longer implicitly borrowed to &mut T.
7270     * Procedures are now required to not capture borrowed references.
7271
7272   * Libraries
7273     * The standard library is now a "facade" over a number of underlying
7274       libraries. This means that development on the standard library should
7275       be speedier due to smaller crates, as well as a clearer line between
7276       all dependencies.
7277     * A new library, libcore, lives under the standard library's facade
7278       which is Rust's "0-assumption" library, suitable for embedded and
7279       kernel development for example.
7280     * A regex crate has been added to the standard distribution. This crate
7281       includes statically compiled regular expressions.
7282     * The unwrap/unwrap_err methods on Result require a Show bound for
7283       better error messages.
7284     * The return types of the std::comm primitives have been centralized
7285       around the Result type.
7286     * A number of I/O primitives have gained the ability to time out their
7287       operations.
7288     * A number of I/O primitives have gained the ability to close their
7289       reading/writing halves to cancel pending operations.
7290     * Reverse iterator methods have been removed in favor of `rev()` on
7291       their forward-iteration counterparts.
7292     * A bitflags! macro has been added to enable easy interop with C and
7293       management of bit flags.
7294     * A debug_assert! macro is now provided which is disabled when
7295       `--cfg ndebug` is passed to the compiler.
7296     * A graphviz crate has been added for creating .dot files.
7297     * The std::cast module has been migrated into std::mem.
7298     * The std::local_data api has been migrated from freestanding functions
7299       to being based on methods.
7300     * The Pod trait has been renamed to Copy.
7301     * jemalloc has been added as the default allocator for types.
7302     * The API for allocating memory has been changed to use proper alignment
7303       and sized deallocation
7304     * Connecting a TcpStream or binding a TcpListener is now based on a
7305       string address and a u16 port. This allows connecting to a hostname as
7306       opposed to an IP.
7307     * The Reader trait now contains a core method, read_at_least(), which
7308       correctly handles many repeated 0-length reads.
7309     * The process-spawning API is now centered around a builder-style
7310       Command struct.
7311     * The :? printing qualifier has been moved from the standard library to
7312       an external libdebug crate.
7313     * Eq/Ord have been renamed to PartialEq/PartialOrd. TotalEq/TotalOrd
7314       have been renamed to Eq/Ord.
7315     * The select/plural methods have been removed from format!. The escapes
7316       for { and } have also changed from \{ and \} to {{ and }},
7317       respectively.
7318     * The TaskBuilder API has been re-worked to be a true builder, and
7319       extension traits for spawning native/green tasks have been added.
7320
7321   * Tooling
7322     * All breaking changes to the language or libraries now have their
7323       commit message annotated with `[breaking-change]` to allow for easy
7324       discovery of breaking changes.
7325     * The compiler will now try to suggest how to annotate lifetimes if a
7326       lifetime-related error occurs.
7327     * Debug info continues to be improved greatly with general bug fixes and
7328       better support for situations like link time optimization (LTO).
7329     * Usage of syntax extensions when cross-compiling has been fixed.
7330     * Functionality equivalent to GCC & Clang's -ffunction-sections,
7331       -fdata-sections and --gc-sections has been enabled by default
7332     * The compiler is now stricter about where it will load module files
7333       from when a module is declared via `mod foo;`.
7334     * The #[phase(syntax)] attribute has been renamed to #[phase(plugin)].
7335       Syntax extensions are now discovered via a "plugin registrar" type
7336       which will be extended in the future to other various plugins.
7337     * Lints have been restructured to allow for dynamically loadable lints.
7338     * A number of rustdoc improvements:
7339       * The HTML output has been visually redesigned.
7340       * Markdown is now powered by hoedown instead of sundown.
7341       * Searching heuristics have been greatly improved.
7342       * The search index has been reduced in size by a great amount.
7343       * Cross-crate documentation via `pub use` has been greatly improved.
7344       * Primitive types are now hyperlinked and documented.
7345     * Documentation has been moved from static.rust-lang.org/doc to
7346       doc.rust-lang.org
7347     * A new sandbox, play.rust-lang.org, is available for running and
7348       sharing rust code examples on-line.
7349     * Unused attributes are now more robustly warned about.
7350     * The dead_code lint now warns about unused struct fields.
7351     * Cross-compiling to iOS is now supported.
7352     * Cross-compiling to mipsel is now supported.
7353     * Stability attributes are now inherited by default and no longer apply
7354       to intra-crate usage, only inter-crate usage.
7355     * Error message related to non-exhaustive match expressions have been
7356       greatly improved.
7357
7358
7359 Version 0.10 (2014-04-03)
7360 =========================
7361
7362   * ~1500 changes, numerous bugfixes
7363
7364   * Language
7365     * A new RFC process is now in place for modifying the language.
7366     * Patterns with `@`-pointers have been removed from the language.
7367     * Patterns with unique vectors (`~[T]`) have been removed from the
7368       language.
7369     * Patterns with unique strings (`~str`) have been removed from the
7370       language.
7371     * `@str` has been removed from the language.
7372     * `@[T]` has been removed from the language.
7373     * `@self` has been removed from the language.
7374     * `@Trait` has been removed from the language.
7375     * Headers on `~` allocations which contain `@` boxes inside the type for
7376       reference counting have been removed.
7377     * The semantics around the lifetimes of temporary expressions have changed,
7378       see #3511 and #11585 for more information.
7379     * Cross-crate syntax extensions are now possible, but feature gated. See
7380       #11151 for more information. This includes both `macro_rules!` macros as
7381       well as syntax extensions such as `format!`.
7382     * New lint modes have been added, and older ones have been turned on to be
7383       warn-by-default.
7384       * Unnecessary parentheses
7385       * Uppercase statics
7386       * Camel Case types
7387       * Uppercase variables
7388       * Publicly visible private types
7389       * `#[deriving]` with raw pointers
7390     * Unsafe functions can no longer be coerced to closures.
7391     * Various obscure macros such as `log_syntax!` are now behind feature gates.
7392     * The `#[simd]` attribute is now behind a feature gate.
7393     * Visibility is no longer allowed on `extern crate` statements, and
7394       unnecessary visibility (`priv`) is no longer allowed on `use` statements.
7395     * Trailing commas are now allowed in argument lists and tuple patterns.
7396     * The `do` keyword has been removed, it is now a reserved keyword.
7397     * Default type parameters have been implemented, but are feature gated.
7398     * Borrowed variables through captures in closures are now considered soundly.
7399     * `extern mod` is now `extern crate`
7400     * The `Freeze` trait has been removed.
7401     * The `Share` trait has been added for types that can be shared among
7402       threads.
7403     * Labels in macros are now hygienic.
7404     * Expression/statement macro invocations can be delimited with `{}` now.
7405     * Treatment of types allowed in `static mut` locations has been tweaked.
7406     * The `*` and `.` operators are now overloadable through the `Deref` and
7407       `DerefMut` traits.
7408     * `~Trait` and `proc` no longer have `Send` bounds by default.
7409     * Partial type hints are now supported with the `_` type marker.
7410     * An `Unsafe` type was introduced for interior mutability. It is now
7411       considered undefined to transmute from `&T` to `&mut T` without using the
7412       `Unsafe` type.
7413     * The #[linkage] attribute was implemented for extern statics/functions.
7414     * The inner attribute syntax has changed from `#[foo];` to `#![foo]`.
7415     * `Pod` was renamed to `Copy`.
7416
7417   * Libraries
7418     * The `libextra` library has been removed. It has now been decomposed into
7419       component libraries with smaller and more focused nuggets of
7420       functionality. The full list of libraries can be found on the
7421       documentation index page.
7422     * std: `std::condition` has been removed. All I/O errors are now propagated
7423       through the `Result` type. In order to assist with error handling, a
7424       `try!` macro for unwrapping errors with an early return and a lint for
7425       unused results has been added. See #12039 for more information.
7426     * std: The `vec` module has been renamed to `slice`.
7427     * std: A new vector type, `Vec<T>`, has been added in preparation for DST.
7428       This will become the only growable vector in the future.
7429     * std: `std::io` now has more public re-exports. Types such as `BufferedReader`
7430       are now found at `std::io::BufferedReader` instead of
7431       `std::io::buffered::BufferedReader`.
7432     * std: `print` and `println` are no longer in the prelude, the `print!` and
7433       `println!` macros are intended to be used instead.
7434     * std: `Rc` now has a `Weak` pointer for breaking cycles, and it no longer
7435       attempts to statically prevent cycles.
7436     * std: The standard distribution is adopting the policy of pushing failure
7437       to the user rather than failing in libraries. Many functions (such as
7438       `slice::last()`) now return `Option<T>` instead of `T` + failing.
7439     * std: `fmt::Default` has been renamed to `fmt::Show`, and it now has a new
7440       deriving mode: `#[deriving(Show)]`.
7441     * std: `ToStr` is now implemented for all types implementing `Show`.
7442     * std: The formatting trait methods now take `&self` instead of `&T`
7443     * std: The `invert()` method on iterators has been renamed to `rev()`
7444     * std: `std::num` has seen a reduction in the genericity of its traits,
7445       consolidating functionality into a few core traits.
7446     * std: Backtraces are now printed on task failure if the environment
7447       variable `RUST_BACKTRACE` is present.
7448     * std: Naming conventions for iterators have been standardized. More details
7449       can be found on the wiki's style guide.
7450     * std: `eof()` has been removed from the `Reader` trait. Specific types may
7451       still implement the function.
7452     * std: Networking types are now cloneable to allow simultaneous reads/writes.
7453     * std: `assert_approx_eq!` has been removed
7454     * std: The `e` and `E` formatting specifiers for floats have been added to
7455       print them in exponential notation.
7456     * std: The `Times` trait has been removed
7457     * std: Indications of variance and opting out of builtin bounds is done
7458       through marker types in `std::kinds::marker` now
7459     * std: `hash` has been rewritten, `IterBytes` has been removed, and
7460       `#[deriving(Hash)]` is now possible.
7461     * std: `SharedChan` has been removed, `Sender` is now cloneable.
7462     * std: `Chan` and `Port` were renamed to `Sender` and `Receiver`.
7463     * std: `Chan::new` is now `channel()`.
7464     * std: A new synchronous channel type has been implemented.
7465     * std: A `select!` macro is now provided for selecting over `Receiver`s.
7466     * std: `hashmap` and `trie` have been moved to `libcollections`
7467     * std: `run` has been rolled into `io::process`
7468     * std: `assert_eq!` now uses `{}` instead of `{:?}`
7469     * std: The equality and comparison traits have seen some reorganization.
7470     * std: `rand` has moved to `librand`.
7471     * std: `to_{lower,upper}case` has been implemented for `char`.
7472     * std: Logging has been moved to `liblog`.
7473     * collections: `HashMap` has been rewritten for higher performance and less
7474       memory usage.
7475     * native: The default runtime is now `libnative`. If `libgreen` is desired,
7476       it can be booted manually. The runtime guide has more information and
7477       examples.
7478     * native: All I/O functionality except signals has been implemented.
7479     * green: Task spawning with `libgreen` has been optimized with stack caching
7480       and various trimming of code.
7481     * green: Tasks spawned by `libgreen` now have an unmapped guard page.
7482     * sync: The `extra::sync` module has been updated to modern rust (and moved
7483       to the `sync` library), tweaking and improving various interfaces while
7484       dropping redundant functionality.
7485     * sync: A new `Barrier` type has been added to the `sync` library.
7486     * sync: An efficient mutex for native and green tasks has been implemented.
7487     * serialize: The `base64` module has seen some improvement. It treats
7488       newlines better, has non-string error values, and has seen general
7489       cleanup.
7490     * fourcc: A `fourcc!` macro was introduced
7491     * hexfloat: A `hexfloat!` macro was implemented for specifying floats via a
7492       hexadecimal literal.
7493
7494   * Tooling
7495     * `rustpkg` has been deprecated and removed from the main repository. Its
7496       replacement, `cargo`, is under development.
7497     * Nightly builds of rust are now available
7498     * The memory usage of rustc has been improved many times throughout this
7499       release cycle.
7500     * The build process supports disabling rpath support for the rustc binary
7501       itself.
7502     * Code generation has improved in some cases, giving more information to the
7503       LLVM optimization passes to enable more extensive optimizations.
7504     * Debuginfo compatibility with lldb on OSX has been restored.
7505     * The master branch is now gated on an android bot, making building for
7506       android much more reliable.
7507     * Output flags have been centralized into one `--emit` flag.
7508     * Crate type flags have been centralized into one `--crate-type` flag.
7509     * Codegen flags have been consolidated behind a `-C` flag.
7510     * Linking against outdated crates now has improved error messages.
7511     * Error messages with lifetimes will often suggest how to annotate the
7512       function to fix the error.
7513     * Many more types are documented in the standard library, and new guides
7514       were written.
7515     * Many `rustdoc` improvements:
7516       * code blocks are syntax highlighted.
7517       * render standalone markdown files.
7518       * the --test flag tests all code blocks by default.
7519       * exported macros are displayed.
7520       * re-exported types have their documentation inlined at the location of the
7521         first re-export.
7522       * search works across crates that have been rendered to the same output
7523         directory.
7524
7525
7526 Version 0.9 (2014-01-09)
7527 ==========================
7528
7529    * ~1800 changes, numerous bugfixes
7530
7531    * Language
7532       * The `float` type has been removed. Use `f32` or `f64` instead.
7533       * A new facility for enabling experimental features (feature gating) has
7534         been added, using the crate-level `#[feature(foo)]` attribute.
7535       * Managed boxes (@) are now behind a feature gate
7536         (`#[feature(managed_boxes)]`) in preparation for future removal. Use the
7537         standard library's `Gc` or `Rc` types instead.
7538       * `@mut` has been removed. Use `std::cell::{Cell, RefCell}` instead.
7539       * Jumping back to the top of a loop is now done with `continue` instead of
7540         `loop`.
7541       * Strings can no longer be mutated through index assignment.
7542       * Raw strings can be created via the basic `r"foo"` syntax or with matched
7543         hash delimiters, as in `r###"foo"###`.
7544       * `~fn` is now written `proc (args) -> retval { ... }` and may only be
7545         called once.
7546       * The `&fn` type is now written `|args| -> ret` to match the literal form.
7547       * `@fn`s have been removed.
7548       * `do` only works with procs in order to make it obvious what the cost
7549         of `do` is.
7550       * Single-element tuple-like structs can no longer be dereferenced to
7551         obtain the inner value. A more comprehensive solution for overloading
7552         the dereference operator will be provided in the future.
7553       * The `#[link(...)]` attribute has been replaced with
7554         `#[crate_id = "name#vers"]`.
7555       * Empty `impl`s must be terminated with empty braces and may not be
7556         terminated with a semicolon.
7557       * Keywords are no longer allowed as lifetime names; the `self` lifetime
7558         no longer has any special meaning.
7559       * The old `fmt!` string formatting macro has been removed.
7560       * `printf!` and `printfln!` (old-style formatting) removed in favor of
7561         `print!` and `println!`.
7562       * `mut` works in patterns now, as in `let (mut x, y) = (1, 2);`.
7563       * The `extern mod foo (name = "bar")` syntax has been removed. Use
7564         `extern mod foo = "bar"` instead.
7565       * New reserved keywords: `alignof`, `offsetof`, `sizeof`.
7566       * Macros can have attributes.
7567       * Macros can expand to items with attributes.
7568       * Macros can expand to multiple items.
7569       * The `asm!` macro is feature-gated (`#[feature(asm)]`).
7570       * Comments may be nested.
7571       * Values automatically coerce to trait objects they implement, without
7572         an explicit `as`.
7573       * Enum discriminants are no longer an entire word but as small as needed to
7574         contain all the variants. The `repr` attribute can be used to override
7575         the discriminant size, as in `#[repr(int)]` for integer-sized, and
7576         `#[repr(C)]` to match C enums.
7577       * Non-string literals are not allowed in attributes (they never worked).
7578       * The FFI now supports variadic functions.
7579       * Octal numeric literals, as in `0o7777`.
7580       * The `concat!` syntax extension performs compile-time string concatenation.
7581       * The `#[fixed_stack_segment]` and `#[rust_stack]` attributes have been
7582         removed as Rust no longer uses segmented stacks.
7583       * Non-ascii identifiers are feature-gated (`#[feature(non_ascii_idents)]`).
7584       * Ignoring all fields of an enum variant or tuple-struct is done with `..`,
7585         not `*`; ignoring remaining fields of a struct is also done with `..`,
7586         not `_`; ignoring a slice of a vector is done with `..`, not `.._`.
7587       * `rustc` supports the "win64" calling convention via `extern "win64"`.
7588       * `rustc` supports the "system" calling convention, which defaults to the
7589         preferred convention for the target platform, "stdcall" on 32-bit Windows,
7590         "C" elsewhere.
7591       * The `type_overflow` lint (default: warn) checks literals for overflow.
7592       * The `unsafe_block` lint (default: allow) checks for usage of `unsafe`.
7593       * The `attribute_usage` lint (default: warn) warns about unknown
7594         attributes.
7595       * The `unknown_features` lint (default: warn) warns about unknown
7596         feature gates.
7597       * The `dead_code` lint (default: warn) checks for dead code.
7598       * Rust libraries can be linked statically to one another
7599       * `#[link_args]` is behind the `link_args` feature gate.
7600       * Native libraries are now linked with `#[link(name = "foo")]`
7601       * Native libraries can be statically linked to a rust crate
7602         (`#[link(name = "foo", kind = "static")]`).
7603       * Native OS X frameworks are now officially supported
7604         (`#[link(name = "foo", kind = "framework")]`).
7605       * The `#[thread_local]` attribute creates thread-local (not task-local)
7606         variables. Currently behind the `thread_local` feature gate.
7607       * The `return` keyword may be used in closures.
7608       * Types that can be copied via a memcpy implement the `Pod` kind.
7609       * The `cfg` attribute can now be used on struct fields and enum variants.
7610
7611    * Libraries
7612       * std: The `option` and `result` API's have been overhauled to make them
7613         simpler, more consistent, and more composable.
7614       * std: The entire `std::io` module has been replaced with one that is
7615         more comprehensive and that properly interfaces with the underlying
7616         scheduler. File, TCP, UDP, Unix sockets, pipes, and timers are all
7617         implemented.
7618       * std: `io::util` contains a number of useful implementations of
7619         `Reader` and `Writer`, including `NullReader`, `NullWriter`,
7620         `ZeroReader`, `TeeReader`.
7621       * std: The reference counted pointer type `extra::rc` moved into std.
7622       * std: The `Gc` type in the `gc` module will replace `@` (it is currently
7623         just a wrapper around it).
7624       * std: The `Either` type has been removed.
7625       * std: `fmt::Default` can be implemented for any type to provide default
7626         formatting to the `format!` macro, as in `format!("{}", myfoo)`.
7627       * std: The `rand` API continues to be tweaked.
7628       * std: The `rust_begin_unwind` function, useful for inserting breakpoints
7629         on failure in gdb, is now named `rust_fail`.
7630       * std: The `each_key` and `each_value` methods on `HashMap` have been
7631         replaced by the `keys` and `values` iterators.
7632       * std: Functions dealing with type size and alignment have moved from the
7633         `sys` module to the `mem` module.
7634       * std: The `path` module was written and API changed.
7635       * std: `str::from_utf8` has been changed to cast instead of allocate.
7636       * std: `starts_with` and `ends_with` methods added to vectors via the
7637         `ImmutableEqVector` trait, which is in the prelude.
7638       * std: Vectors can be indexed with the `get_opt` method, which returns `None`
7639         if the index is out of bounds.
7640       * std: Task failure no longer propagates between tasks, as the model was
7641         complex, expensive, and incompatible with thread-based tasks.
7642       * std: The `Any` type can be used for dynamic typing.
7643       * std: `~Any` can be passed to the `fail!` macro and retrieved via
7644         `task::try`.
7645       * std: Methods that produce iterators generally do not have an `_iter`
7646         suffix now.
7647       * std: `cell::Cell` and `cell::RefCell` can be used to introduce mutability
7648         roots (mutable fields, etc.). Use instead of e.g. `@mut`.
7649       * std: `util::ignore` renamed to `prelude::drop`.
7650       * std: Slices have `sort` and `sort_by` methods via the `MutableVector`
7651         trait.
7652       * std: `vec::raw` has seen a lot of cleanup and API changes.
7653       * std: The standard library no longer includes any C++ code, and very
7654         minimal C, eliminating the dependency on libstdc++.
7655       * std: Runtime scheduling and I/O functionality has been factored out into
7656         extensible interfaces and is now implemented by two different crates:
7657         libnative, for native threading and I/O; and libgreen, for green threading
7658         and I/O. This paves the way for using the standard library in more limited
7659         embedded environments.
7660       * std: The `comm` module has been rewritten to be much faster, have a
7661         simpler, more consistent API, and to work for both native and green
7662         threading.
7663       * std: All libuv dependencies have been moved into the rustuv crate.
7664       * native: New implementations of runtime scheduling on top of OS threads.
7665       * native: New native implementations of TCP, UDP, file I/O, process spawning,
7666         and other I/O.
7667       * green: The green thread scheduler and message passing types are almost
7668         entirely lock-free.
7669       * extra: The `flatpipes` module had bitrotted and was removed.
7670       * extra: All crypto functions have been removed and Rust now has a policy of
7671         not reimplementing crypto in the standard library. In the future crypto
7672         will be provided by external crates with bindings to established libraries.
7673       * extra: `c_vec` has been modernized.
7674       * extra: The `sort` module has been removed. Use the `sort` method on
7675         mutable slices.
7676
7677    * Tooling
7678       * The `rust` and `rusti` commands have been removed, due to lack of
7679         maintenance.
7680       * `rustdoc` was completely rewritten.
7681       * `rustdoc` can test code examples in documentation.
7682       * `rustpkg` can test packages with the argument, 'test'.
7683       * `rustpkg` supports arbitrary dependencies, including C libraries.
7684       * `rustc`'s support for generating debug info is improved again.
7685       * `rustc` has better error reporting for unbalanced delimiters.
7686       * `rustc`'s JIT support was removed due to bitrot.
7687       * Executables and static libraries can be built with LTO (-Z lto)
7688       * `rustc` adds a `--dep-info` flag for communicating dependencies to
7689         build tools.
7690
7691
7692 Version 0.8 (2013-09-26)
7693 ============================
7694
7695    * ~2200 changes, numerous bugfixes
7696
7697    * Language
7698       * The `for` loop syntax has changed to work with the `Iterator` trait.
7699       * At long last, unwinding works on Windows.
7700       * Default methods are ready for use.
7701       * Many trait inheritance bugs fixed.
7702       * Owned and borrowed trait objects work more reliably.
7703       * `copy` is no longer a keyword. It has been replaced by the `Clone` trait.
7704       * rustc can omit emission of code for the `debug!` macro if it is passed
7705         `--cfg ndebug`
7706       * mod.rs is now "blessed". When loading `mod foo;`, rustc will now look
7707         for foo.rs, then foo/mod.rs, and will generate an error when both are
7708         present.
7709       * Strings no longer contain trailing nulls. The new `std::c_str` module
7710         provides new mechanisms for converting to C strings.
7711       * The type of foreign functions is now `extern "C" fn` instead of `*u8'.
7712       * The FFI has been overhauled such that foreign functions are called directly,
7713         instead of through a stack-switching wrapper.
7714       * Calling a foreign function must be done through a Rust function with the
7715         `#[fixed_stack_segment]` attribute.
7716       * The `externfn!` macro can be used to declare both a foreign function and
7717         a `#[fixed_stack_segment]` wrapper at once.
7718       * `pub` and `priv` modifiers on `extern` blocks are no longer parsed.
7719       * `unsafe` is no longer allowed on extern fns - they are all unsafe.
7720       * `priv` is disallowed everywhere except for struct fields and enum variants.
7721       * `&T` (besides `&'static T`) is no longer allowed in `@T`.
7722       * `ref` bindings in irrefutable patterns work correctly now.
7723       * `char` is now prevented from containing invalid code points.
7724       * Casting to `bool` is no longer allowed.
7725       * `\0` is now accepted as an escape in chars and strings.
7726       * `yield` is a reserved keyword.
7727       * `typeof` is a reserved keyword.
7728       * Crates may be imported by URL with `extern mod foo = "url";`.
7729       * Explicit enum discriminants may be given as uints as in `enum E { V = 0u }`
7730       * Static vectors can be initialized with repeating elements,
7731         e.g. `static foo: [u8, .. 100]: [0, .. 100];`.
7732       * Static structs can be initialized with functional record update,
7733         e.g. `static foo: Foo = Foo { a: 5, .. bar };`.
7734       * `cfg!` can be used to conditionally execute code based on the crate
7735         configuration, similarly to `#[cfg(...)]`.
7736       * The `unnecessary_qualification` lint detects unneeded module
7737         prefixes (default: allow).
7738       * Arithmetic operations have been implemented on the SIMD types in
7739         `std::unstable::simd`.
7740       * Exchange allocation headers were removed, reducing memory usage.
7741       * `format!` implements a completely new, extensible, and higher-performance
7742         string formatting system. It will replace `fmt!`.
7743       * `print!` and `println!` write formatted strings (using the `format!`
7744         extension) to stdout.
7745       * `write!` and `writeln!` write formatted strings (using the `format!`
7746         extension) to the new Writers in `std::rt::io`.
7747       * The library section in which a function or static is placed may
7748         be specified with `#[link_section = "..."]`.
7749       * The `proto!` syntax extension for defining bounded message protocols
7750         was removed.
7751       * `macro_rules!` is hygienic for `let` declarations.
7752       * The `#[export_name]` attribute specifies the name of a symbol.
7753       * `unreachable!` can be used to indicate unreachable code, and fails
7754         if executed.
7755
7756    * Libraries
7757       * std: Transitioned to the new runtime, written in Rust.
7758       * std: Added an experimental I/O library, `rt::io`, based on the new
7759         runtime.
7760       * std: A new generic `range` function was added to the prelude, replacing
7761         `uint::range` and friends.
7762       * std: `range_rev` no longer exists. Since range is an iterator it can be
7763         reversed with `range(lo, hi).invert()`.
7764       * std: The `chain` method on option renamed to `and_then`; `unwrap_or_default`
7765         renamed to `unwrap_or`.
7766       * std: The `iterator` module was renamed to `iter`.
7767       * std: Integral types now support the `checked_add`, `checked_sub`, and
7768         `checked_mul` operations for detecting overflow.
7769       * std: Many methods in `str`, `vec`, `option, `result` were renamed for
7770         consistency.
7771       * std: Methods are standardizing on conventions for casting methods:
7772         `to_foo` for copying, `into_foo` for moving, `as_foo` for temporary
7773         and cheap casts.
7774       * std: The `CString` type in `c_str` provides new ways to convert to and
7775         from C strings.
7776       * std: `DoubleEndedIterator` can yield elements in two directions.
7777       * std: The `mut_split` method on vectors partitions an `&mut [T]` into
7778         two splices.
7779       * std: `str::from_bytes` renamed to `str::from_utf8`.
7780       * std: `pop_opt` and `shift_opt` methods added to vectors.
7781       * std: The task-local data interface no longer uses @, and keys are
7782         no longer function pointers.
7783       * std: The `swap_unwrap` method of `Option` renamed to `take_unwrap`.
7784       * std: Added `SharedPort` to `comm`.
7785       * std: `Eq` has a default method for `ne`; only `eq` is required
7786         in implementations.
7787       * std: `Ord` has default methods for `le`, `gt` and `ge`; only `lt`
7788         is required in implementations.
7789       * std: `is_utf8` performance is improved, impacting many string functions.
7790       * std: `os::MemoryMap` provides cross-platform mmap.
7791       * std: `ptr::offset` is now unsafe, but also more optimized. Offsets that
7792         are not 'in-bounds' are considered undefined.
7793       * std: Many freestanding functions in `vec` removed in favor of methods.
7794       * std: Many freestanding functions on scalar types removed in favor of
7795         methods.
7796       * std: Many options to task builders were removed since they don't make
7797         sense in the new scheduler design.
7798       * std: More containers implement `FromIterator` so can be created by the
7799         `collect` method.
7800       * std: More complete atomic types in `unstable::atomics`.
7801       * std: `comm::PortSet` removed.
7802       * std: Mutating methods in the `Set` and `Map` traits have been moved into
7803         the `MutableSet` and `MutableMap` traits. `Container::is_empty`,
7804         `Map::contains_key`, `MutableMap::insert`, and `MutableMap::remove` have
7805         default implementations.
7806       * std: Various `from_str` functions were removed in favor of a generic
7807         `from_str` which is available in the prelude.
7808       * std: `util::unreachable` removed in favor of the `unreachable!` macro.
7809       * extra: `dlist`, the doubly-linked list was modernized.
7810       * extra: Added a `hex` module with `ToHex` and `FromHex` traits.
7811       * extra: Added `glob` module, replacing `std::os::glob`.
7812       * extra: `rope` was removed.
7813       * extra: `deque` was renamed to `ringbuf`. `RingBuf` implements `Deque`.
7814       * extra: `net`, and `timer` were removed. The experimental replacements
7815         are `std::rt::io::net` and `std::rt::io::timer`.
7816       * extra: Iterators implemented for `SmallIntMap`.
7817       * extra: Iterators implemented for `Bitv` and `BitvSet`.
7818       * extra: `SmallIntSet` removed. Use `BitvSet`.
7819       * extra: Performance of JSON parsing greatly improved.
7820       * extra: `semver` updated to SemVer 2.0.0.
7821       * extra: `term` handles more terminals correctly.
7822       * extra: `dbg` module removed.
7823       * extra: `par` module removed.
7824       * extra: `future` was cleaned up, with some method renames.
7825       * extra: Most free functions in `getopts` were converted to methods.
7826
7827    * Other
7828       * rustc's debug info generation (`-Z debug-info`) is greatly improved.
7829       * rustc accepts `--target-cpu` to compile to a specific CPU architecture,
7830         similarly to gcc's `--march` flag.
7831       * rustc's performance compiling small crates is much better.
7832       * rustpkg has received many improvements.
7833       * rustpkg supports git tags as package IDs.
7834       * rustpkg builds into target-specific directories so it can be used for
7835         cross-compiling.
7836       * The number of concurrent test tasks is controlled by the environment
7837         variable RUST_TEST_TASKS.
7838       * The test harness can now report metrics for benchmarks.
7839       * All tools have man pages.
7840       * Programs compiled with `--test` now support the `-h` and `--help` flags.
7841       * The runtime uses jemalloc for allocations.
7842       * Segmented stacks are temporarily disabled as part of the transition to
7843         the new runtime. Stack overflows are possible!
7844       * A new documentation backend, rustdoc_ng, is available for use. It is
7845         still invoked through the normal `rustdoc` command.
7846
7847
7848 Version 0.7 (2013-07-03)
7849 =======================
7850
7851    * ~2000 changes, numerous bugfixes
7852
7853    * Language
7854       * `impl`s no longer accept a visibility qualifier. Put them on methods
7855         instead.
7856       * The borrow checker has been rewritten with flow-sensitivity, fixing
7857         many bugs and inconveniences.
7858       * The `self` parameter no longer implicitly means `&'self self`,
7859         and can be explicitly marked with a lifetime.
7860       * Overloadable compound operators (`+=`, etc.) have been temporarily
7861         removed due to bugs.
7862       * The `for` loop protocol now requires `for`-iterators to return `bool`
7863         so they compose better.
7864       * The `Durable` trait is replaced with the `'static` bounds.
7865       * Trait default methods work more often.
7866       * Structs with the `#[packed]` attribute have byte alignment and
7867         no padding between fields.
7868       * Type parameters bound by `Copy` must now be copied explicitly with
7869         the `copy` keyword.
7870       * It is now illegal to move out of a dereferenced unsafe pointer.
7871       * `Option<~T>` is now represented as a nullable pointer.
7872       * `@mut` does dynamic borrow checks correctly.
7873       * The `main` function is only detected at the topmost level of the crate.
7874         The `#[main]` attribute is still valid anywhere.
7875       * Struct fields may no longer be mutable. Use inherited mutability.
7876       * The `#[no_send]` attribute makes a type that would otherwise be
7877         `Send`, not.
7878       * The `#[no_freeze]` attribute makes a type that would otherwise be
7879         `Freeze`, not.
7880       * Unbounded recursion will abort the process after reaching the limit
7881         specified by the `RUST_MAX_STACK` environment variable (default: 1GB).
7882       * The `vecs_implicitly_copyable` lint mode has been removed. Vectors
7883         are never implicitly copyable.
7884       * `#[static_assert]` makes compile-time assertions about static bools.
7885       * At long last, 'argument modes' no longer exist.
7886       * The rarely used `use mod` statement no longer exists.
7887
7888    * Syntax extensions
7889       * `fail!` and `assert!` accept `~str`, `&'static str` or `fmt!`-style
7890         argument list.
7891       * `Encodable`, `Decodable`, `Ord`, `TotalOrd`, `TotalEq`, `DeepClone`,
7892         `Rand`, `Zero` and `ToStr` can all be automatically derived with
7893         `#[deriving(...)]`.
7894       * The `bytes!` macro returns a vector of bytes for string, u8, char,
7895         and unsuffixed integer literals.
7896
7897    * Libraries
7898       * The `core` crate was renamed to `std`.
7899       * The `std` crate was renamed to `extra`.
7900       * More and improved documentation.
7901       * std: `iterator` module for external iterator objects.
7902       * Many old-style (internal, higher-order function) iterators replaced by
7903         implementations of `Iterator`.
7904       * std: Many old internal vector and string iterators,
7905         incl. `any`, `all`. removed.
7906       * std: The `finalize` method of `Drop` renamed to `drop`.
7907       * std: The `drop` method now takes `&mut self` instead of `&self`.
7908       * std: The prelude no longer re-exports any modules, only types and traits.
7909       * std: Prelude additions: `print`, `println`, `FromStr`, `ApproxEq`, `Equiv`,
7910         `Iterator`, `IteratorUtil`, many numeric traits, many tuple traits.
7911       * std: New numeric traits: `Fractional`, `Real`, `RealExt`, `Integer`, `Ratio`,
7912         `Algebraic`, `Trigonometric`, `Exponential`, `Primitive`.
7913       * std: Tuple traits and accessors defined for up to 12-tuples, e.g.
7914         `(0, 1, 2).n2()` or `(0, 1, 2).n2_ref()`.
7915       * std: Many types implement `Clone`.
7916       * std: `path` type renamed to `Path`.
7917       * std: `mut` module and `Mut` type removed.
7918       * std: Many standalone functions removed in favor of methods and iterators
7919         in `vec`, `str`. In the future methods will also work as functions.
7920       * std: `reinterpret_cast` removed. Use `transmute`.
7921       * std: ascii string handling in `std::ascii`.
7922       * std: `Rand` is implemented for ~/@.
7923       * std: `run` module for spawning processes overhauled.
7924       * std: Various atomic types added to `unstable::atomic`.
7925       * std: Various types implement `Zero`.
7926       * std: `LinearMap` and `LinearSet` renamed to `HashMap` and `HashSet`.
7927       * std: Borrowed pointer functions moved from `ptr` to `borrow`.
7928       * std: Added `os::mkdir_recursive`.
7929       * std: Added `os::glob` function performs filesystems globs.
7930       * std: `FuzzyEq` renamed to `ApproxEq`.
7931       * std: `Map` now defines `pop` and `swap` methods.
7932       * std: `Cell` constructors converted to static methods.
7933       * extra: `rc` module adds the reference counted pointers, `Rc` and `RcMut`.
7934       * extra: `flate` module moved from `std` to `extra`.
7935       * extra: `fileinput` module for iterating over a series of files.
7936       * extra: `Complex` number type and `complex` module.
7937       * extra: `Rational` number type and `rational` module.
7938       * extra: `BigInt`, `BigUint` implement numeric and comparison traits.
7939       * extra: `term` uses terminfo now, is more correct.
7940       * extra: `arc` functions converted to methods.
7941       * extra: Implementation of fixed output size variations of SHA-2.
7942
7943    * Tooling
7944       * `unused_variables` lint mode for unused variables (default: warn).
7945       * `unused_unsafe` lint mode for detecting unnecessary `unsafe` blocks
7946         (default: warn).
7947       * `unused_mut` lint mode for identifying unused `mut` qualifiers
7948         (default: warn).
7949       * `dead_assignment` lint mode for unread variables (default: warn).
7950       * `unnecessary_allocation` lint mode detects some heap allocations that are
7951         immediately borrowed so could be written without allocating (default: warn).
7952       * `missing_doc` lint mode (default: allow).
7953       * `unreachable_code` lint mode (default: warn).
7954       * The `rusti` command has been rewritten and a number of bugs addressed.
7955       * rustc outputs in color on more terminals.
7956       * rustc accepts a `--link-args` flag to pass arguments to the linker.
7957       * rustc accepts a `-Z print-link-args` flag for debugging linkage.
7958       * Compiling with `-g` will make the binary record information about
7959         dynamic borrowcheck failures for debugging.
7960       * rustdoc has a nicer stylesheet.
7961       * Various improvements to rustdoc.
7962       * Improvements to rustpkg (see the detailed release notes).
7963
7964
7965 Version 0.6 (2013-04-03)
7966 ========================
7967
7968    * ~2100 changes, numerous bugfixes
7969
7970    * Syntax changes
7971       * The self type parameter in traits is now spelled `Self`
7972       * The `self` parameter in trait and impl methods must now be explicitly
7973         named (for example: `fn f(&self) { }`). Implicit self is deprecated.
7974       * Static methods no longer require the `static` keyword and instead
7975         are distinguished by the lack of a `self` parameter
7976       * Replaced the `Durable` trait with the `'static` lifetime
7977       * The old closure type syntax with the trailing sigil has been
7978         removed in favor of the more consistent leading sigil
7979       * `super` is a keyword, and may be prefixed to paths
7980       * Trait bounds are separated with `+` instead of whitespace
7981       * Traits are implemented with `impl Trait for Type`
7982         instead of `impl Type: Trait`
7983       * Lifetime syntax is now `&'l foo` instead of `&l/foo`
7984       * The `export` keyword has finally been removed
7985       * The `move` keyword has been removed (see "Semantic changes")
7986       * The interior mutability qualifier on vectors, `[mut T]`, has been
7987         removed. Use `&mut [T]`, etc.
7988       * `mut` is no longer valid in `~mut T`. Use inherited mutability
7989       * `fail` is no longer a keyword. Use `fail!()`
7990       * `assert` is no longer a keyword. Use `assert!()`
7991       * `log` is no longer a keyword. use `debug!`, etc.
7992       * 1-tuples may be represented as `(T,)`
7993       * Struct fields may no longer be `mut`. Use inherited mutability,
7994         `@mut T`, `core::mut` or `core::cell`
7995       * `extern mod { ... }` is no longer valid syntax for foreign
7996         function modules. Use extern blocks: `extern { ... }`
7997       * Newtype enums removed. Use tuple-structs.
7998       * Trait implementations no longer support visibility modifiers
7999       * Pattern matching over vectors improved and expanded
8000       * `const` renamed to `static` to correspond to lifetime name,
8001         and make room for future `static mut` unsafe mutable globals.
8002       * Replaced `#[deriving_eq]` with `#[deriving(Eq)]`, etc.
8003       * `Clone` implementations can be automatically generated with
8004         `#[deriving(Clone)]`
8005       * Casts to traits must use a pointer sigil, e.g. `@foo as @Bar`
8006         instead of `foo as Bar`.
8007       * Fixed length vector types are now written as `[int, .. 3]`
8008         instead of `[int * 3]`.
8009       * Fixed length vector types can express the length as a constant
8010         expression. (ex: `[int, .. GL_BUFFER_SIZE - 2]`)
8011
8012    * Semantic changes
8013       * Types with owned pointers or custom destructors move by default,
8014         eliminating the `move` keyword
8015       * All foreign functions are considered unsafe
8016       * &mut is now unaliasable
8017       * Writes to borrowed @mut pointers are prevented dynamically
8018       * () has size 0
8019       * The name of the main function can be customized using #[main]
8020       * The default type of an inferred closure is &fn instead of @fn
8021       * `use` statements may no longer be "chained" - they cannot import
8022         identifiers imported by previous `use` statements
8023       * `use` statements are crate relative, importing from the "top"
8024         of the crate by default. Paths may be prefixed with `super::`
8025         or `self::` to change the search behavior.
8026       * Method visibility is inherited from the implementation declaration
8027       * Structural records have been removed
8028       * Many more types can be used in static items, including enums
8029         'static-lifetime pointers and vectors
8030       * Pattern matching over vectors improved and expanded
8031       * Typechecking of closure types has been overhauled to
8032         improve inference and eliminate unsoundness
8033       * Macros leave scope at the end of modules, unless that module is
8034         tagged with #[macro_escape]
8035
8036    * Libraries
8037       * Added big integers to `std::bigint`
8038       * Removed `core::oldcomm` module
8039       * Added pipe-based `core::comm` module
8040       * Numeric traits have been reorganized under `core::num`
8041       * `vec::slice` finally returns a slice
8042       * `debug!` and friends don't require a format string, e.g. `debug!(Foo)`
8043       * Containers reorganized around traits in `core::container`
8044       * `core::dvec` removed, `~[T]` is a drop-in replacement
8045       * `core::send_map` renamed to `core::hashmap`
8046       * `std::map` removed; replaced with `core::hashmap`
8047       * `std::treemap` reimplemented as an owned balanced tree
8048       * `std::deque` and `std::smallintmap` reimplemented as owned containers
8049       * `core::trie` added as a fast ordered map for integer keys
8050       * Set types added to `core::hashmap`, `core::trie` and `std::treemap`
8051       * `Ord` split into `Ord` and `TotalOrd`. `Ord` is still used to
8052         overload the comparison operators, whereas `TotalOrd` is used
8053         by certain container types
8054
8055    * Other
8056       * Replaced the 'cargo' package manager with 'rustpkg'
8057       * Added all-purpose 'rust' tool
8058       * `rustc --test` now supports benchmarks with the `#[bench]` attribute
8059       * rustc now *attempts* to offer spelling suggestions
8060       * Improved support for ARM and Android
8061       * Preliminary MIPS backend
8062       * Improved foreign function ABI implementation for x86, x86_64
8063       * Various memory usage improvements
8064       * Rust code may be embedded in foreign code under limited circumstances
8065       * Inline assembler supported by new asm!() syntax extension.
8066
8067
8068 Version 0.5 (2012-12-21)
8069 ===========================
8070
8071    * ~900 changes, numerous bugfixes
8072
8073    * Syntax changes
8074       * Removed `<-` move operator
8075       * Completed the transition from the `#fmt` extension syntax to `fmt!`
8076       * Removed old fixed length vector syntax - `[T]/N`
8077       * New token-based quasi-quoters, `quote_tokens!`, `quote_expr!`, etc.
8078       * Macros may now expand to items and statements
8079       * `a.b()` is always parsed as a method call, never as a field projection
8080       * `Eq` and `IterBytes` implementations can be automatically generated
8081         with `#[deriving_eq]` and `#[deriving_iter_bytes]` respectively
8082       * Removed the special crate language for `.rc` files
8083       * Function arguments may consist of any irrefutable pattern
8084
8085    * Semantic changes
8086       * `&` and `~` pointers may point to objects
8087       * Tuple structs - `struct Foo(Bar, Baz)`. Will replace newtype enums.
8088       * Enum variants may be structs
8089       * Destructors can be added to all nominal types with the Drop trait
8090       * Structs and nullary enum variants may be constants
8091       * Values that cannot be implicitly copied are now automatically moved
8092         without writing `move` explicitly
8093       * `&T` may now be coerced to `*T`
8094       * Coercions happen in `let` statements as well as function calls
8095       * `use` statements now take crate-relative paths
8096       * The module and type namespaces have been merged so that static
8097         method names can be resolved under the trait in which they are
8098         declared
8099
8100    * Improved support for language features
8101       * Trait inheritance works in many scenarios
8102       * More support for explicit self arguments in methods - `self`, `&self`
8103         `@self`, and `~self` all generally work as expected
8104       * Static methods work in more situations
8105       * Experimental: Traits may declare default methods for the implementations
8106         to use
8107
8108    * Libraries
8109       * New condition handling system in `core::condition`
8110       * Timsort added to `std::sort`
8111       * New priority queue, `std::priority_queue`
8112       * Pipes for serializable types, `std::flatpipes'
8113       * Serialization overhauled to be trait-based
8114       * Expanded `getopts` definitions
8115       * Moved futures to `std`
8116       * More functions are pure now
8117       * `core::comm` renamed to `oldcomm`. Still deprecated
8118       * `rustdoc` and `cargo` are libraries now
8119
8120    * Misc
8121       * Added a preliminary REPL, `rusti`
8122       * License changed from MIT to dual MIT/APL2
8123
8124
8125 Version 0.4 (2012-10-15)
8126 ==========================
8127
8128    * ~2000 changes, numerous bugfixes
8129
8130    * Syntax
8131       * All keywords are now strict and may not be used as identifiers anywhere
8132       * Keyword removal: 'again', 'import', 'check', 'new', 'owned', 'send',
8133         'of', 'with', 'to', 'class'.
8134       * Classes are replaced with simpler structs
8135       * Explicit method self types
8136       * `ret` became `return` and `alt` became `match`
8137       * `import` is now `use`; `use is now `extern mod`
8138       * `extern mod { ... }` is now `extern { ... }`
8139       * `use mod` is the recommended way to import modules
8140       * `pub` and `priv` replace deprecated export lists
8141       * The syntax of `match` pattern arms now uses fat arrow (=>)
8142       * `main` no longer accepts an args vector; use `os::args` instead
8143
8144    * Semantics
8145       * Trait implementations are now coherent, ala Haskell typeclasses
8146       * Trait methods may be static
8147       * Argument modes are deprecated
8148       * Borrowed pointers are much more mature and recommended for use
8149       * Strings and vectors in the static region are stored in constant memory
8150       * Typestate was removed
8151       * Resolution rewritten to be more reliable
8152       * Support for 'dual-mode' data structures (freezing and thawing)
8153
8154    * Libraries
8155       * Most binary operators can now be overloaded via the traits in
8156         `core::ops'
8157       * `std::net::url` for representing URLs
8158       * Sendable hash maps in `core::send_map`
8159       * `core::task' gained a (currently unsafe) task-local storage API
8160
8161    * Concurrency
8162       * An efficient new intertask communication primitive called the pipe,
8163         along with a number of higher-level channel types, in `core::pipes`
8164       * `std::arc`, an atomically reference counted, immutable, shared memory
8165         type
8166       * `std::sync`, various exotic synchronization tools based on arcs and pipes
8167       * Futures are now based on pipes and sendable
8168       * More robust linked task failure
8169       * Improved task builder API
8170
8171    * Other
8172       * Improved error reporting
8173       * Preliminary JIT support
8174       * Preliminary work on precise GC
8175       * Extensive architectural improvements to rustc
8176       * Begun a transition away from buggy C++-based reflection (shape) code to
8177         Rust-based (visitor) code
8178       * All hash functions and tables converted to secure, randomized SipHash
8179
8180
8181 Version 0.3  (2012-07-12)
8182 ========================
8183
8184    * ~1900 changes, numerous bugfixes
8185
8186    * New coding conveniences
8187       * Integer-literal suffix inference
8188       * Per-item control over warnings, errors
8189       * #[cfg(windows)] and #[cfg(unix)] attributes
8190       * Documentation comments
8191       * More compact closure syntax
8192       * 'do' expressions for treating higher-order functions as
8193         control structures
8194       * *-patterns (wildcard extended to all constructor fields)
8195
8196    * Semantic cleanup
8197       * Name resolution pass and exhaustiveness checker rewritten
8198       * Region pointers and borrow checking supersede alias
8199         analysis
8200       * Init-ness checking is now provided by a region-based liveness
8201         pass instead of the typestate pass; same for last-use analysis
8202       * Extensive work on region pointers
8203
8204    * Experimental new language features
8205       * Slices and fixed-size, interior-allocated vectors
8206       * #!-comments for lang versioning, shell execution
8207       * Destructors and iface implementation for classes;
8208         type-parameterized classes and class methods
8209       * 'const' type kind for types that can be used to implement
8210         shared-memory concurrency patterns
8211
8212    * Type reflection
8213
8214    * Removal of various obsolete features
8215       * Keywords: 'be', 'prove', 'syntax', 'note', 'mutable', 'bind',
8216                  'crust', 'native' (now 'extern'), 'cont' (now 'again')
8217
8218       * Constructs: do-while loops ('do' repurposed), fn binding,
8219                     resources (replaced by destructors)
8220
8221    * Compiler reorganization
8222       * Syntax-layer of compiler split into separate crate
8223       * Clang (from LLVM project) integrated into build
8224       * Typechecker split into sub-modules
8225
8226    * New library code
8227       * New time functions
8228       * Extension methods for many built-in types
8229       * Arc: atomic-refcount read-only / exclusive-use shared cells
8230       * Par: parallel map and search routines
8231       * Extensive work on libuv interface
8232       * Much vector code moved to libraries
8233       * Syntax extensions: #line, #col, #file, #mod, #stringify,
8234         #include, #include_str, #include_bin
8235
8236    * Tool improvements
8237       * Cargo automatically resolves dependencies
8238
8239
8240 Version 0.2  (2012-03-29)
8241 =========================
8242
8243    * >1500 changes, numerous bugfixes
8244
8245    * New docs and doc tooling
8246
8247    * New port: FreeBSD x86_64
8248
8249    * Compilation model enhancements
8250       * Generics now specialized, multiply instantiated
8251       * Functions now inlined across separate crates
8252
8253    * Scheduling, stack and threading fixes
8254       * Noticeably improved message-passing performance
8255       * Explicit schedulers
8256       * Callbacks from C
8257       * Helgrind clean
8258
8259    * Experimental new language features
8260       * Operator overloading
8261       * Region pointers
8262       * Classes
8263
8264    * Various language extensions
8265       * C-callback function types: 'crust fn ...'
8266       * Infinite-loop construct: 'loop { ... }'
8267       * Shorten 'mutable' to 'mut'
8268       * Required mutable-local qualifier: 'let mut ...'
8269       * Basic glob-exporting: 'export foo::*;'
8270       * Alt now exhaustive, 'alt check' for runtime-checked
8271       * Block-function form of 'for' loop, with 'break' and 'ret'.
8272
8273    * New library code
8274       * AST quasi-quote syntax extension
8275       * Revived libuv interface
8276       * New modules: core::{future, iter}, std::arena
8277       * Merged per-platform std::{os*, fs*} to core::{libc, os}
8278       * Extensive cleanup, regularization in libstd, libcore
8279
8280
8281 Version 0.1  (2012-01-20)
8282 ===============================
8283
8284    * Most language features work, including:
8285       * Unique pointers, unique closures, move semantics
8286       * Interface-constrained generics
8287       * Static interface dispatch
8288       * Stack growth
8289       * Multithread task scheduling
8290       * Typestate predicates
8291       * Failure unwinding, destructors
8292       * Pattern matching and destructuring assignment
8293       * Lightweight block-lambda syntax
8294       * Preliminary macro-by-example
8295
8296    * Compiler works with the following configurations:
8297       * Linux: x86 and x86_64 hosts and targets
8298       * macOS: x86 and x86_64 hosts and targets
8299       * Windows: x86 hosts and targets
8300
8301    * Cross compilation / multi-target configuration supported.
8302
8303    * Preliminary API-documentation and package-management tools included.
8304
8305 Known issues:
8306
8307    * Documentation is incomplete.
8308
8309    * Performance is below intended target.
8310
8311    * Standard library APIs are subject to extensive change, reorganization.
8312
8313    * Language-level versioning is not yet operational - future code will
8314      break unexpectedly.